@memberjunction/integration-connectors 0.0.1 → 5.9.0

package/dist/HubSpotConnector.js

@@ -0,0 +1,446 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { Metadata } from '@memberjunction/core';
+import { BaseIntegrationConnector, BaseRESTIntegrationConnector, } from '@memberjunction/integration-engine';
+// ─── Constants ────────────────────────────────────────────────────────
+const HUBSPOT_API_BASE = 'https://api.hubapi.com';
+const DEFAULT_API_VERSION = 'v3';
+/** Maximum retries for rate-limited or failed requests */
+const MAX_RETRIES = 5;
+/** HTTP request timeout in milliseconds */
+const REQUEST_TIMEOUT_MS = 30000;
+/** Minimum milliseconds between API requests (HubSpot: 100 req/10s for private apps) */
+const MIN_REQUEST_INTERVAL_MS = 100;
+/**
+ * Known properties to request per object type. HubSpot's list endpoint
+ * only returns a handful of default properties unless you explicitly
+ * specify which properties to include via the `properties` query param.
+ */
+const HUBSPOT_PROPERTIES = {
+    contacts: [
+        'email', 'firstname', 'lastname', 'phone', 'mobilephone', 'company',
+        'jobtitle', 'lifecyclestage', 'hs_lead_status', 'address', 'city',
+        'state', 'zip', 'country', 'website', 'industry',
+        'annualrevenue', 'numberofemployees', 'hs_object_id',
+        'createdate', 'lastmodifieddate', 'associatedcompanyid',
+        'notes_last_contacted', 'notes_last_updated', 'hs_email_optout',
+    ],
+    companies: [
+        'name', 'domain', 'industry', 'phone', 'address', 'address2',
+        'city', 'state', 'zip', 'country', 'website', 'description',
+        'numberofemployees', 'annualrevenue', 'lifecyclestage',
+        'type', 'hs_object_id', 'createdate', 'hs_lastmodifieddate',
+        'founded_year', 'is_public',
+    ],
+    deals: [
+        'dealname', 'amount', 'dealstage', 'pipeline', 'closedate',
+        'createdate', 'hs_object_id', 'hs_lastmodifieddate',
+        'dealtype', 'description', 'hs_deal_stage_probability',
+        'hs_projected_amount', 'hs_priority', 'hubspot_owner_id',
+        'notes_last_contacted', 'num_associated_contacts',
+    ],
+    tickets: [
+        'subject', 'content', 'hs_pipeline', 'hs_pipeline_stage',
+        'hs_ticket_priority', 'hs_ticket_category', 'createdate',
+        'hs_lastmodifieddate', 'hs_object_id', 'closed_date',
+        'source_type', 'hubspot_owner_id',
+    ],
+    products: [
+        'name', 'description', 'price', 'hs_cost_of_goods_sold',
+        'hs_recurring_billing_period', 'hs_sku', 'tax',
+        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    line_items: [
+        'name', 'description', 'quantity', 'price', 'amount',
+        'discount', 'tax', 'hs_product_id', 'hs_line_item_currency_code',
+        'hs_sku', 'hs_cost_of_goods_sold', 'hs_recurring_billing_period',
+        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    quotes: [
+        'hs_title', 'hs_expiration_date', 'hs_status', 'hs_quote_amount',
+        'hs_currency', 'hs_sender_firstname', 'hs_sender_lastname',
+        'hs_sender_email', 'hs_sender_company_name', 'hs_language',
+        'hs_locale', 'hs_slug', 'hs_public_url_key',
+        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    calls: [
+        'hs_call_title', 'hs_call_body', 'hs_call_status',
+        'hs_call_direction', 'hs_call_duration', 'hs_call_from_number',
+        'hs_call_to_number', 'hs_call_disposition',
+        'hs_call_recording_url', 'hubspot_owner_id',
+        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    emails: [
+        'hs_email_subject', 'hs_email_text', 'hs_email_html',
+        'hs_email_status', 'hs_email_direction',
+        'hs_email_sender_email', 'hs_email_sender_firstname',
+        'hs_email_sender_lastname', 'hs_email_to_email',
+        'hubspot_owner_id',
+        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    notes: [
+        'hs_note_body', 'hs_timestamp', 'hubspot_owner_id',
+        'hs_attachment_ids', 'hs_body_preview', 'hs_body_preview_is_truncated',
+        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    tasks: [
+        'hs_task_subject', 'hs_task_body', 'hs_task_status',
+        'hs_task_priority', 'hs_task_type', 'hs_timestamp',
+        'hs_task_completion_date', 'hs_queue_membership_ids',
+        'hubspot_owner_id',
+        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    meetings: [
+        'hs_meeting_title', 'hs_meeting_body', 'hs_meeting_start_time',
+        'hs_meeting_end_time', 'hs_meeting_outcome', 'hs_meeting_location',
+        'hs_meeting_external_url', 'hs_internal_meeting_notes',
+        'hs_activity_type', 'hubspot_owner_id',
+        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+    feedback_submissions: [
+        'hs_survey_id', 'hs_survey_name', 'hs_survey_type',
+        'hs_submission_name', 'hs_content', 'hs_response_group',
+        'hs_sentiment', 'hs_survey_channel',
+        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
+    ],
+};
+// ─── Connector ────────────────────────────────────────────────────────
+/**
+ * Connector for HubSpot CRM via the HubSpot REST API v3.
+ *
+ * Extends BaseRESTIntegrationConnector to leverage metadata-driven object/field
+ * discovery from IntegrationEngineBase cache and generic pagination handling.
+ *
+ * Uses Bearer token authentication (private app key or OAuth access token).
+ * Supports cursor-based pagination and automatic response flattening.
+ *
+ * DATA SAFETY: This connector is READ-ONLY. It never writes data back to HubSpot.
+ */
+let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnector {
+    constructor() {
+        super(...arguments);
+        /** Timestamp of the last API request, used for throttling */
+        this.lastRequestTime = 0;
+    }
+    // ─── Abstract method implementations (BaseRESTIntegrationConnector) ──
+    async Authenticate(companyIntegration) {
+        const credentials = await this.LoadCredentials(companyIntegration);
+        const auth = {
+            Token: credentials.AccessToken,
+            Credentials: credentials,
+        };
+        return auth;
+    }
+    BuildHeaders(auth) {
+        return {
+            'Authorization': `Bearer ${auth.Token}`,
+            'Accept': 'application/json',
+        };
+    }
+    async MakeHTTPRequest(_auth, url, method, headers, _body) {
+        // Throttle: ensure minimum interval between 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 response = await this.FetchWithTimeout(url, method, headers);
+            this.lastRequestTime = Date.now();
+            if (response.status === 429) {
+                const delayMs = this.CalculateRetryDelay(response, attempt);
+                console.warn(`[HubSpot] Rate limited (429), retrying in ${delayMs}ms ` +
+                    `(attempt ${attempt + 1}/${MAX_RETRIES})`);
+                await this.Sleep(delayMs);
+                continue;
+            }
+            const body = await response.json();
+            return this.BuildRESTResponse(response, body);
+        }
+        throw new Error(`HubSpot API request failed after ${MAX_RETRIES} retries: ${url}`);
+    }
+    NormalizeResponse(rawBody, responseDataKey) {
+        const body = rawBody;
+        // Extract the records array using the responseDataKey (typically "results")
+        let records;
+        if (responseDataKey != null) {
+            const data = body[responseDataKey];
+            if (!data || !Array.isArray(data))
+                return [];
+            records = data;
+        }
+        else if (Array.isArray(rawBody)) {
+            records = rawBody;
+        }
+        else {
+            return [];
+        }
+        // Flatten HubSpot's nested { id, properties: {...}, createdAt, updatedAt, archived }
+        return records.map(r => this.FlattenHubSpotRecord(r));
+    }
+    ExtractPaginationInfo(rawBody, _paginationType, _currentPage, _currentOffset, _pageSize) {
+        const body = rawBody;
+        const paging = body['paging'];
+        const nextCursor = paging?.next?.after;
+        if (nextCursor) {
+            return { HasMore: true, NextCursor: nextCursor };
+        }
+        return { HasMore: false };
+    }
+    GetBaseURL(_companyIntegration) {
+        return HUBSPOT_API_BASE;
+    }
+    // ─── HubSpot-specific pagination ─────────────────────────────────
+    /**
+     * Overrides base pagination URL building to use HubSpot's parameter names.
+     * HubSpot uses `after` for cursor pagination (not `cursor`), and needs
+     * `limit` instead of `pageSize`. Also appends `properties` query param.
+     */
+    BuildPaginatedURL(basePath, obj, _page, _offset, cursor) {
+        const separator = basePath.includes('?') ? '&' : '?';
+        const objectName = this.ExtractObjectNameFromPath(basePath);
+        const propertiesParam = this.BuildPropertiesParam(objectName);
+        if (cursor) {
+            return `${basePath}${separator}limit=${obj.DefaultPageSize}&after=${encodeURIComponent(cursor)}${propertiesParam}`;
+        }
+        return `${basePath}${separator}limit=${obj.DefaultPageSize}${propertiesParam}`;
+    }
+    // ─── TestConnection ─────────────────────────────────────────────
+    /** Tests connectivity by authenticating and fetching 1 contact. */
+    async TestConnection(companyIntegration, _contextUser) {
+        try {
+            const auth = await this.Authenticate(companyIntegration);
+            const headers = this.BuildHeaders(auth);
+            const response = await this.MakeHTTPRequest(auth, `${HUBSPOT_API_BASE}/crm/v3/objects/contacts?limit=1`, 'GET', headers);
+            if (response.Status >= 200 && response.Status < 300) {
+                const hubSpotAuth = auth;
+                return {
+                    Success: true,
+                    Message: 'Successfully connected to HubSpot CRM API',
+                    ServerVersion: `HubSpot CRM API ${hubSpotAuth.Credentials.ApiVersion}`,
+                };
+            }
+            const bodyPreview = typeof response.Body === 'string'
+                ? response.Body.slice(0, 500)
+                : JSON.stringify(response.Body).slice(0, 500);
+            return {
+                Success: false,
+                Message: `HubSpot API returned ${response.Status}: ${bodyPreview}`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { Success: false, Message: `Connection failed: ${message}` };
+        }
+    }
+    // ─── GetDefaultFieldMappings ──────────────────────────────────
+    GetDefaultFieldMappings(objectName, _entityName) {
+        switch (objectName) {
+            case 'contacts':
+                return [
+                    { SourceFieldName: 'email', DestinationFieldName: 'Email', IsKeyField: true },
+                    { SourceFieldName: 'firstname', DestinationFieldName: 'FirstName' },
+                    { SourceFieldName: 'lastname', DestinationFieldName: 'LastName' },
+                    { SourceFieldName: 'phone', DestinationFieldName: 'Phone' },
+                    { SourceFieldName: 'company', DestinationFieldName: 'CompanyName' },
+                    { SourceFieldName: 'lifecyclestage', DestinationFieldName: 'Status' },
+                ];
+            case 'companies':
+                return [
+                    { SourceFieldName: 'name', DestinationFieldName: 'Name', IsKeyField: true },
+                    { SourceFieldName: 'domain', DestinationFieldName: 'Website' },
+                    { SourceFieldName: 'industry', DestinationFieldName: 'Industry' },
+                    { SourceFieldName: 'city', DestinationFieldName: 'City' },
+                    { SourceFieldName: 'state', DestinationFieldName: 'State' },
+                ];
+            case 'deals':
+                return [
+                    { SourceFieldName: 'dealname', DestinationFieldName: 'Name', IsKeyField: true },
+                    { SourceFieldName: 'amount', DestinationFieldName: 'Amount' },
+                    { SourceFieldName: 'dealstage', DestinationFieldName: 'Stage' },
+                    { SourceFieldName: 'closedate', DestinationFieldName: 'CloseDate' },
+                    { SourceFieldName: 'pipeline', DestinationFieldName: 'Pipeline' },
+                ];
+            default:
+                return [];
+        }
+    }
+    // ─── Default Configuration ──────────────────────────────────────
+    GetDefaultConfiguration() {
+        return {
+            DefaultSchemaName: 'HubSpot',
+            DefaultObjects: [], // Objects are auto-discovered from metadata via DiscoverObjects
+        };
+    }
+    // ─── Schema Discovery Helpers ────────────────────────────────────
+    /** Converts a HubSpot property definition to ExternalFieldSchema format */
+    MapPropertyToField(prop) {
+        return {
+            Name: prop.name,
+            Label: prop.label || prop.name,
+            DataType: this.MapHubSpotType(prop.type, prop.fieldType),
+            IsRequired: false, // HubSpot doesn't expose required via properties API
+            IsUniqueKey: prop.hasUniqueValue,
+            IsReadOnly: prop.calculated || (prop.modificationMetadata?.readOnlyValue ?? false),
+        };
+    }
+    /** Maps HubSpot type + fieldType to a simplified data type string */
+    MapHubSpotType(type, fieldType) {
+        switch (type) {
+            case 'string':
+                if (fieldType === 'textarea')
+                    return 'text';
+                if (fieldType === 'html')
+                    return 'html';
+                return 'string';
+            case 'number':
+                return 'number';
+            case 'date':
+            case 'datetime':
+                return 'datetime';
+            case 'bool':
+                return 'boolean';
+            case 'enumeration':
+                return 'enum';
+            default:
+                return type;
+        }
+    }
+    // ─── Credential management ────────────────────────────────────
+    /**
+     * Reads credentials from CompanyIntegration.CredentialID -> Credential.Values JSON,
+     * or falls back to CompanyIntegration Configuration JSON for backwards compat.
+     */
+    async LoadCredentials(companyIntegration) {
+        // Try loading from linked Credential entity first
+        const credentialID = companyIntegration.Get('CredentialID');
+        if (credentialID) {
+            const creds = await this.LoadFromCredentialEntity(credentialID);
+            if (creds)
+                return creds;
+        }
+        // Fallback: read from CompanyIntegration Configuration JSON
+        const configJson = companyIntegration.Get('Configuration');
+        if (configJson) {
+            const creds = this.ParseCredentialJson(configJson);
+            if (creds)
+                return creds;
+        }
+        throw new Error('No HubSpot credentials found. Attach a credential with an accessToken or apiKey, ' +
+            'or set Configuration JSON on the CompanyIntegration.');
+    }
+    /** Loads credentials from a Credential entity by ID. */
+    async LoadFromCredentialEntity(credentialID) {
+        const md = new Metadata();
+        const credential = await md.GetEntityObject('MJ: Credentials');
+        const loaded = await credential.Load(credentialID);
+        if (!loaded || !credential.Values)
+            return null;
+        return this.ParseCredentialJson(credential.Values);
+    }
+    /** Parses a JSON string to extract HubSpot credentials. Returns null if no token found. */
+    ParseCredentialJson(json) {
+        try {
+            const parsed = JSON.parse(json);
+            const token = parsed['accessToken'] ?? parsed['AccessToken'] ?? parsed['apiKey'] ?? parsed['ApiKey'];
+            if (token) {
+                return {
+                    AccessToken: token,
+                    ApiVersion: parsed['apiVersion'] ?? DEFAULT_API_VERSION,
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Response flattening ─────────────────────────────────────────
+    /**
+     * Flattens a HubSpot CRM record from the nested format:
+     *   { id, properties: { field1, field2 }, createdAt, updatedAt, archived }
+     * into a flat record with all properties at the top level,
+     * plus system fields (hs_object_id, createdAt, updatedAt, archived).
+     */
+    FlattenHubSpotRecord(record) {
+        const properties = record['properties'];
+        const result = {};
+        // Add flattened properties first
+        if (properties) {
+            for (const [key, value] of Object.entries(properties)) {
+                result[key] = value;
+            }
+        }
+        // Add system fields (these override any conflicting property names)
+        result['hs_object_id'] = record['id'];
+        result['createdAt'] = record['createdAt'];
+        result['updatedAt'] = record['updatedAt'];
+        result['archived'] = record['archived'];
+        return result;
+    }
+    // ─── URL helpers ─────────────────────────────────────────────────
+    /**
+     * Extracts the HubSpot object name from an API path.
+     * E.g., "/crm/v3/objects/contacts" -> "contacts"
+     */
+    ExtractObjectNameFromPath(path) {
+        // Remove query string
+        const pathOnly = path.split('?')[0];
+        // Get the last path segment
+        const segments = pathOnly.split('/').filter(s => s.length > 0);
+        return segments[segments.length - 1] ?? '';
+    }
+    /**
+     * Builds the `properties` query parameter for a HubSpot object type.
+     * Returns empty string if no properties are configured for the object.
+     */
+    BuildPropertiesParam(objectName) {
+        const properties = HUBSPOT_PROPERTIES[objectName];
+        if (properties && properties.length > 0) {
+            return `&properties=${properties.join(',')}`;
+        }
+        return '';
+    }
+    // ─── HTTP helpers ────────────────────────────────────────────────
+    /** Executes an HTTP request with a timeout. */
+    async FetchWithTimeout(url, method, headers) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            return await fetch(url, { method, headers, signal: controller.signal });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new Error(`HubSpot API request timed out after ${REQUEST_TIMEOUT_MS / 1000}s: ${url}`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /** Calculates retry delay from Retry-After header or exponential backoff. */
+    CalculateRetryDelay(response, attempt) {
+        const retryAfter = parseInt(response.headers.get('Retry-After') ?? '0', 10);
+        return retryAfter > 0 ? retryAfter * 1000 : Math.min(1000 * Math.pow(2, attempt), 30000);
+    }
+    /** Converts a fetch Response + parsed body into a RESTResponse. */
+    BuildRESTResponse(response, body) {
+        const headers = {};
+        response.headers.forEach((v, k) => { headers[k.toLowerCase()] = v; });
+        return { Status: response.status, Body: body, Headers: headers };
+    }
+    /** Returns a promise that resolves after the specified number of milliseconds. */
+    Sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+};
+HubSpotConnector = __decorate([
+    RegisterClass(BaseIntegrationConnector, 'HubSpotConnector')
+], HubSpotConnector);
+export { HubSpotConnector };
+//# sourceMappingURL=HubSpotConnector.js.map

package/dist/HubSpotConnector.js.map

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

package/dist/RelationalDBConnector.d.ts

@@ -0,0 +1,101 @@
+import type { UserInfo } from '@memberjunction/core';
+import type { MJCompanyIntegrationEntity } from '@memberjunction/core-entities';
+import { BaseIntegrationConnector, type ConnectionTestResult, type ExternalObjectSchema, type ExternalFieldSchema, type FetchContext, type FetchBatchResult, type ExternalRecord } from '@memberjunction/integration-engine';
+import sql from 'mssql';
+/** Connection configuration parsed from CompanyIntegration.Configuration JSON */
+export interface ConnectionConfig {
+    /** SQL Server hostname */
+    Server: string;
+    /** Database name */
+    Database: string;
+    /** Database user */
+    User: string;
+    /** Database password */
+    Password: string;
+    /** Database schema (e.g., 'hs', 'sf', 'ym'). Defaults to 'dbo'. */
+    Schema: string;
+}
+/**
+ * Abstract base class for connectors that read from relational databases via mssql.
+ * Handles connection management, object/field discovery, and connection testing.
+ * Subclasses must implement FetchChanges to define record extraction logic.
+ */
+export declare abstract class RelationalDBConnector extends BaseIntegrationConnector {
+    /** Cache of open connection pools keyed by "server|database" */
+    private poolCache;
+    /**
+     * Parses the Configuration JSON on a CompanyIntegration to extract connection details.
+     * @param companyIntegration - The entity containing Configuration JSON
+     * @returns Parsed connection configuration
+     * @throws Error if Configuration is missing or malformed
+     */
+    protected ParseConnectionConfig(companyIntegration: MJCompanyIntegrationEntity): ConnectionConfig;
+    /**
+     * Opens or reuses a mssql ConnectionPool for the given configuration.
+     * Pools are cached by server+database to avoid redundant connections.
+     * @param config - Connection configuration
+     * @returns An open ConnectionPool
+     */
+    protected GetPool(config: ConnectionConfig): Promise<sql.ConnectionPool>;
+    /**
+     * Tests connectivity to the source database by running SELECT 1.
+     * @param companyIntegration - The company integration with connection configuration
+     * @param _contextUser - User context for authorization
+     * @returns Connection test result with success/failure and message
+     */
+    TestConnection(companyIntegration: MJCompanyIntegrationEntity, _contextUser: UserInfo): Promise<ConnectionTestResult>;
+    /**
+     * Discovers all user tables in the source database via INFORMATION_SCHEMA.
+     * @param companyIntegration - The company integration with connection configuration
+     * @param _contextUser - User context for authorization
+     * @returns Array of object schemas for each table found
+     */
+    DiscoverObjects(companyIntegration: MJCompanyIntegrationEntity, _contextUser: UserInfo): Promise<ExternalObjectSchema[]>;
+    /**
+     * Discovers columns on a specific table via INFORMATION_SCHEMA.COLUMNS.
+     * @param companyIntegration - The company integration with connection configuration
+     * @param objectName - Table name to inspect
+     * @param _contextUser - User context for authorization
+     * @returns Array of field schemas for the specified table
+     */
+    DiscoverFields(companyIntegration: MJCompanyIntegrationEntity, objectName: string, _contextUser: UserInfo): Promise<ExternalFieldSchema[]>;
+    /**
+     * Converts a row from INFORMATION_SCHEMA.COLUMNS to an ExternalFieldSchema.
+     * @param row - Column metadata row
+     * @returns Mapped field schema
+     */
+    private mapColumnToFieldSchema;
+    /**
+     * Builds an ExternalRecord from a SQL result row.
+     * @param row - Raw database row
+     * @param idField - Column name to use as ExternalID
+     * @param objectType - Object type name for the record
+     * @param modifiedAtField - Column name for the modification timestamp
+     * @param deletedField - Column name for the deleted flag (optional)
+     * @returns An ExternalRecord
+     */
+    protected BuildExternalRecord(row: Record<string, unknown>, idField: string, objectType: string, modifiedAtField: string, deletedField?: string): ExternalRecord;
+    /**
+     * Fetches changed records from a table, ordered by a modification timestamp column.
+     * Applies watermark filtering and batch size limiting.
+     * @param ctx - Fetch context with integration, object, watermark, and batch details
+     * @param idField - Column name for the primary key
+     * @param modifiedAtField - Column name for the modification timestamp
+     * @param deletedField - Column name for the deleted flag (optional)
+     * @returns Batch of external records with pagination info
+     */
+    protected FetchChangesFromTable(ctx: FetchContext, idField: string, modifiedAtField: string, deletedField?: string): Promise<FetchBatchResult>;
+    /**
+     * Extracts the full-precision watermark string from the last row's __mj_raw_ts column.
+     * Uses CONVERT(varchar, ..., 126) output which preserves datetimeoffset(7) precision,
+     * avoiding the sub-millisecond truncation that JavaScript Date introduces.
+     * @param rows - Array of database rows containing __mj_raw_ts
+     * @returns Full-precision datetimeoffset string, or undefined
+     */
+    private extractRawWatermark;
+    /**
+     * Closes all cached connection pools. Call during cleanup/shutdown.
+     */
+    CloseAllPools(): Promise<void>;
+}
+//# sourceMappingURL=RelationalDBConnector.d.ts.map

package/dist/RelationalDBConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationalDBConnector.d.ts","sourceRoot":"","sources":["../src/RelationalDBConnector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EACH,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,GAAG,MAAM,OAAO,CAAC;AAExB,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,8BAAsB,qBAAsB,SAAQ,wBAAwB;IACxE,gEAAgE;IAChE,OAAO,CAAC,SAAS,CAAyC;IAE1D;;;;;OAKG;IACH,SAAS,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,0BAA0B,GAAG,gBAAgB;IAsBjG;;;;;OAKG;cACa,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAuB9E;;;;;OAKG;IACU,cAAc,CACvB,kBAAkB,EAAE,0BAA0B,EAC9C,YAAY,EAAE,QAAQ,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAoBhC;;;;;OAKG;IACU,eAAe,CACxB,kBAAkB,EAAE,0BAA0B,EAC9C,YAAY,EAAE,QAAQ,GACvB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkBlC;;;;;;OAMG;IACU,cAAc,CACvB,kBAAkB,EAAE,0BAA0B,EAC9C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,QAAQ,GACvB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAkBjC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;;;;;;OAQG;IACH,SAAS,CAAC,mBAAmB,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACtB,cAAc;IAcjB;;;;;;;;OAQG;cACa,qBAAqB,CACjC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAsC5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ9C"}