@memberjunction/connector-propfuel 1.0.0

package/dist/PropFuelConnector.d.ts

@@ -0,0 +1,152 @@
+import { type UserInfo } from '@memberjunction/core';
+import type { MJCompanyIntegrationEntity } from '@memberjunction/core-entities';
+import { BaseRESTIntegrationConnector, type RESTAuthContext, type RESTResponse, type PaginationState, type PaginationType, type ConnectionTestResult, type ExternalObjectSchema, type ExternalFieldSchema, type FetchContext, type FetchBatchResult } from '@memberjunction/integration-engine';
+/**
+ * PropFuel data-export file-feed connector.
+ *
+ * PropFuel exposes a per-tenant hourly data-export feed as a set of JSON files. There is NO
+ * public OpenAPI spec and NO describe/introspection endpoint, so this connector encodes the
+ * DISCOVERY MECHANISM, never a baked answer:
+ *
+ *  - {@link DiscoverObjects} calls `GET /dataexport/{AccountID}/list` and derives each object
+ *    from the `[microtime]-[datatype].json` filename suffix. The concrete data-type set is
+ *    whatever the live listing actually contains — never a static `PROPFUEL_STREAMS` array.
+ *  - {@link DiscoverFields} lists the files for a data type, downloads ONE sample file, and
+ *    streams its records through the base {@link DiscoverFieldsViaStream} helper to derive the
+ *    field set + data-informed soft-PK from real values — never a frozen `STREAM_FIELDS` catalog.
+ *
+ * Incremental sync uses a SYNTHETIC, FILE-LEVEL, CLIENT-SIDE cursor `__file_microtime`: the feed
+ * is append-only and chronologically sortable by the filename microtime prefix, so the connector
+ * resumes by tracking the max microtime seen across processed files (WatermarkService). The vendor
+ * `ack` endpoint is operational state and is NOT used as the read-only incremental cursor.
+ *
+ * READ-ONLY: the data-export feed creates/updates/deletes no source records, so all write
+ * capability getters stay false and no ack/POST/delete path is exercised.
+ *
+ * AccountID and the bearer Token both come from the credential (or Configuration JSON) — the
+ * AccountID is per-tenant config and is NEVER hardcoded.
+ */
+export declare class PropFuelConnector extends BaseRESTIntegrationConnector {
+    /** Verbatim three-way invariant name: ClassName / IntegrationName getter / MJ: Integrations.Name. */
+    get IntegrationName(): string;
+    /**
+     * KEYSET / no-watermark resume hint: every PropFuel object is a data-export file stream ordered
+     * by the filename microtime prefix, so 'microtime' is the stable, monotonic ordering key for all
+     * of them (the docs-provable feed object and every runtime-discovered data-type stream alike).
+     */
+    StableOrderingKey(_objectName: string): string | null;
+    /**
+     * The file-feed microtime IS a reliable monotonic high-water mark: PropFuel emits export files in
+     * ascending microtime order, and an updated record re-appears in a NEW (higher-microtime) file. So
+     * `NewWatermarkValue` (= max microtime seen) is the true global max — the engine can NARROW the next
+     * incremental to `microtime > watermark` instead of clearing the keyset position and re-scanning the
+     * whole stream every run. Without this, a clean sync's keyset-resume marker is cleared and every
+     * incremental re-walks the entire object (correct via content-hash, but wasteful at scale).
+     */
+    get MonotonicWatermark(): boolean;
+    /**
+     * Resolves the bearer Token + per-tenant AccountID from the linked Credential entity, falling
+     * back to the CompanyIntegration.Configuration JSON. The credential bytes never leave this scope.
+     */
+    protected Authenticate(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<PropFuelAuthContext>;
+    /** Static Bearer header. No crypto/signing is required for a static token, so no auth-helper is used. */
+    protected BuildHeaders(auth: PropFuelAuthContext): Record<string, string>;
+    /** Base URL for the data-export feed, tenant-scoped by the resolved AccountID. */
+    protected GetBaseURL(_companyIntegration: MJCompanyIntegrationEntity, auth: PropFuelAuthContext): string;
+    /**
+     * Executes an HTTP request via fetch. Parses JSON when the response is JSON, else returns the
+     * raw text body. The concrete connector owns the transport seam so tests can override it.
+     */
+    protected MakeHTTPRequest(_auth: PropFuelAuthContext, url: string, method: string, headers: Record<string, string>, body?: unknown): Promise<RESTResponse>;
+    /**
+     * The download response for a data-export file is a JSON array of records (no envelope). When a
+     * vendor wraps records under a key, that key is honored; otherwise a root array / single object
+     * is normalized to an array.
+     */
+    protected NormalizeResponse(rawBody: unknown, responseDataKey: string | null): Record<string, unknown>[];
+    /**
+     * The file feed has no in-file pagination — each downloaded file is read whole. File-level
+     * paging across the listing is handled by {@link FetchChanges} via the microtime cursor.
+     */
+    protected ExtractPaginationInfo(_rawBody: unknown, _paginationType: PaginationType, _currentPage: number, _currentOffset: number, _pageSize: number): PaginationState;
+    /** Tests connectivity by listing the tenant's available data-export files. */
+    TestConnection(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ConnectionTestResult>;
+    /**
+     * Discovers objects by listing the live data-export files and deriving the distinct data-type
+     * suffix from each `[microtime]-[datatype].json` filename. The returned object set is exactly
+     * what the source currently exposes — the frozen contract's `propfuel_data_export_file` is the
+     * VERIFICATION FLOOR (discovery must surface at least the feed), never a ceiling.
+     */
+    DiscoverObjects(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ExternalObjectSchema[]>;
+    /**
+     * Discovers fields by downloading ONE sample file for the data type and streaming its records
+     * through the base data-informed discovery helper. The field set + soft-PK come from the real
+     * values the source returns — never a static `STREAM_FIELDS` map. READ-ONLY: the sample file is
+     * fetched and parsed, never acked.
+     */
+    DiscoverFields(companyIntegration: MJCompanyIntegrationEntity, objectName: string, contextUser: UserInfo): Promise<ExternalFieldSchema[]>;
+    /**
+     * Fetches records for a data type using the synthetic `__file_microtime` cursor.
+     *
+     * Mechanism: load the stored cursor (max microtime processed), list the live files, select the
+     * files of this data type whose microtime exceeds the cursor (ascending microtime order), and
+     * download each, emitting every record with full-record pass-through. The max microtime seen
+     * across the processed files is persisted as the new cursor — ONLY on full-batch success, so a
+     * partial failure leaves the cursor unchanged and the next run resumes from the same point.
+     */
+    FetchChanges(ctx: FetchContext): Promise<FetchBatchResult>;
+    /** Issues the list call. Path is relative; BuildHeaders + GetBaseURL supply auth + host. */
+    private ListFiles;
+    /** Downloads one file by name and returns its records (read-only; never acked). */
+    private DownloadFileRecords;
+    /**
+     * Parses the list endpoint body into an array of file names. The listing may be a bare array of
+     * strings, an array of objects with a name/file/filename key, or an object wrapping such an array.
+     */
+    private ParseFileListing;
+    /** Finds the first array-valued property of an object (the file listing under a wrapper key). */
+    private FindArrayInObject;
+    /**
+     * Builds a stable record identity. The per-record schema is undocumented (no provable PK), so
+     * the connector prefers a common id key when one is present and otherwise falls back to a
+     * deterministic content hash scoped to the file's microtime — the base engine dedupes by the
+     * record-map + content hash regardless.
+     */
+    private BuildRecordIdentity;
+    /** Throws a descriptive error on a non-2xx response (404 included, since a missing file is unexpected here). */
+    private AssertOK;
+    /**
+     * Resolves the bearer Token + per-tenant AccountID from the linked Credential entity, falling
+     * back to the CompanyIntegration.Configuration JSON. AccountID is per-tenant config — NEVER hardcoded.
+     */
+    private LoadCredentials;
+    /** Loads Token/AccountID from a Credential entity's Values JSON. */
+    private LoadFromCredentialEntity;
+    /** Parses a JSON string to extract Token + AccountID (tolerant of casing/aliases). */
+    private ParseCredentialJson;
+}
+/** Auth context: resolved bearer token + per-tenant AccountID. */
+interface PropFuelAuthContext extends RESTAuthContext {
+    Token: string;
+    AccountID: string;
+    /** Non-secret host override (e.g. a local mock for replay testing). Defaults to PROPFUEL_HOST. */
+    BaseHost?: string;
+}
+/** Parsed `[microtime]-[datatype].json` filename. */
+interface ParsedFileName {
+    microtime: string;
+    dataType: string;
+}
+/**
+ * Parses a PropFuel data-export filename of the form `[microtime]-[datatype].json`.
+ * The microtime is the leading numeric segment (PHP microtime, e.g. `1717804800.123456`); the data
+ * type is everything between the first `-` and the `.json` suffix. Returns null when the name does
+ * not match the convention.
+ */
+export declare function parseFileName(fileName: string): ParsedFileName | null;
+/**
+ * Compares two microtime strings chronologically. Microtimes are numeric (possibly fractional);
+ * numeric comparison avoids lexical pitfalls (e.g. different integer widths). Returns >0 when a>b.
+ */
+export declare function compareMicrotime(a: string, b: string): number;
+export {};

package/dist/PropFuelConnector.js

@@ -0,0 +1,450 @@
+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';
+import { z } from 'zod';
+/**
+ * PropFuel data-export file-feed connector.
+ *
+ * PropFuel exposes a per-tenant hourly data-export feed as a set of JSON files. There is NO
+ * public OpenAPI spec and NO describe/introspection endpoint, so this connector encodes the
+ * DISCOVERY MECHANISM, never a baked answer:
+ *
+ *  - {@link DiscoverObjects} calls `GET /dataexport/{AccountID}/list` and derives each object
+ *    from the `[microtime]-[datatype].json` filename suffix. The concrete data-type set is
+ *    whatever the live listing actually contains — never a static `PROPFUEL_STREAMS` array.
+ *  - {@link DiscoverFields} lists the files for a data type, downloads ONE sample file, and
+ *    streams its records through the base {@link DiscoverFieldsViaStream} helper to derive the
+ *    field set + data-informed soft-PK from real values — never a frozen `STREAM_FIELDS` catalog.
+ *
+ * Incremental sync uses a SYNTHETIC, FILE-LEVEL, CLIENT-SIDE cursor `__file_microtime`: the feed
+ * is append-only and chronologically sortable by the filename microtime prefix, so the connector
+ * resumes by tracking the max microtime seen across processed files (WatermarkService). The vendor
+ * `ack` endpoint is operational state and is NOT used as the read-only incremental cursor.
+ *
+ * READ-ONLY: the data-export feed creates/updates/deletes no source records, so all write
+ * capability getters stay false and no ack/POST/delete path is exercised.
+ *
+ * AccountID and the bearer Token both come from the credential (or Configuration JSON) — the
+ * AccountID is per-tenant config and is NEVER hardcoded.
+ */
+let PropFuelConnector = class PropFuelConnector extends BaseRESTIntegrationConnector {
+    /** Verbatim three-way invariant name: ClassName / IntegrationName getter / MJ: Integrations.Name. */
+    get IntegrationName() {
+        return 'PropFuel';
+    }
+    // ─── Capability surface (read-only file feed) ────────────────────
+    // SupportsCreate/Update/Delete stay false (BaseIntegrationConnector defaults). The data-export
+    // feed is a pull-only source; the ack endpoint is operational and is not modelled as a write.
+    /**
+     * KEYSET / no-watermark resume hint: every PropFuel object is a data-export file stream ordered
+     * by the filename microtime prefix, so 'microtime' is the stable, monotonic ordering key for all
+     * of them (the docs-provable feed object and every runtime-discovered data-type stream alike).
+     */
+    StableOrderingKey(_objectName) {
+        return MICROTIME_ORDERING_KEY;
+    }
+    /**
+     * The file-feed microtime IS a reliable monotonic high-water mark: PropFuel emits export files in
+     * ascending microtime order, and an updated record re-appears in a NEW (higher-microtime) file. So
+     * `NewWatermarkValue` (= max microtime seen) is the true global max — the engine can NARROW the next
+     * incremental to `microtime > watermark` instead of clearing the keyset position and re-scanning the
+     * whole stream every run. Without this, a clean sync's keyset-resume marker is cleared and every
+     * incremental re-walks the entire object (correct via content-hash, but wasteful at scale).
+     */
+    get MonotonicWatermark() {
+        return true;
+    }
+    // ─── Auth + transport (BaseRESTIntegrationConnector abstracts) ────
+    /**
+     * Resolves the bearer Token + per-tenant AccountID from the linked Credential entity, falling
+     * back to the CompanyIntegration.Configuration JSON. The credential bytes never leave this scope.
+     */
+    async Authenticate(companyIntegration, contextUser) {
+        const creds = await this.LoadCredentials(companyIntegration, contextUser);
+        return { Token: creds.Token, AccountID: creds.AccountID, BaseHost: creds.BaseHost };
+    }
+    /** Static Bearer header. No crypto/signing is required for a static token, so no auth-helper is used. */
+    BuildHeaders(auth) {
+        return {
+            'Authorization': `Bearer ${auth.Token}`,
+            'Accept': 'application/json',
+        };
+    }
+    /** Base URL for the data-export feed, tenant-scoped by the resolved AccountID. */
+    GetBaseURL(_companyIntegration, auth) {
+        return `${auth.BaseHost ?? PROPFUEL_HOST}/dataexport/${encodeURIComponent(auth.AccountID)}`;
+    }
+    /**
+     * Executes an HTTP request via fetch. Parses JSON when the response is JSON, else returns the
+     * raw text body. The concrete connector owns the transport seam so tests can override it.
+     */
+    async MakeHTTPRequest(_auth, url, method, headers, body) {
+        const init = { method, headers };
+        if (body !== undefined && method !== 'GET' && method !== 'HEAD') {
+            init.body = typeof body === 'string' ? body : JSON.stringify(body);
+            init.headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, init);
+        const responseHeaders = {};
+        response.headers.forEach((value, key) => { responseHeaders[key.toLowerCase()] = value; });
+        const text = await response.text();
+        let parsed = text;
+        const contentType = responseHeaders['content-type'] ?? '';
+        if (contentType.includes('json') || (text.length > 0 && (text[0] === '{' || text[0] === '['))) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+        return { Status: response.status, Body: parsed, Headers: responseHeaders };
+    }
+    /**
+     * The download response for a data-export file is a JSON array of records (no envelope). When a
+     * vendor wraps records under a key, that key is honored; otherwise a root array / single object
+     * is normalized to an array.
+     */
+    NormalizeResponse(rawBody, responseDataKey) {
+        if (responseDataKey && rawBody && typeof rawBody === 'object' && !Array.isArray(rawBody)) {
+            const inner = rawBody[responseDataKey];
+            if (Array.isArray(inner))
+                return inner.filter(isRecord);
+        }
+        if (Array.isArray(rawBody))
+            return rawBody.filter(isRecord);
+        if (isRecord(rawBody))
+            return [rawBody];
+        return [];
+    }
+    /**
+     * The file feed has no in-file pagination — each downloaded file is read whole. File-level
+     * paging across the listing is handled by {@link FetchChanges} via the microtime cursor.
+     */
+    ExtractPaginationInfo(_rawBody, _paginationType, _currentPage, _currentOffset, _pageSize) {
+        return { HasMore: false };
+    }
+    /** Tests connectivity by listing the tenant's available data-export files. */
+    async TestConnection(companyIntegration, contextUser) {
+        try {
+            const auth = await this.Authenticate(companyIntegration, contextUser);
+            const response = await this.ListFiles(auth);
+            if (response.Status === 401 || response.Status === 403) {
+                return { Success: false, Message: `Authentication failed (HTTP ${response.Status}) listing PropFuel data-export files.` };
+            }
+            if (response.Status < 200 || response.Status >= 300) {
+                return { Success: false, Message: `PropFuel list endpoint returned HTTP ${response.Status}.` };
+            }
+            const files = this.ParseFileListing(response.Body);
+            return { Success: true, Message: `Connected to PropFuel account ${auth.AccountID}; ${files.length} data-export file(s) available.` };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { Success: false, Message: `PropFuel connection error: ${message}` };
+        }
+    }
+    // ─── Runtime discovery MECHANISM (NOT a baked catalog) ───────────
+    /**
+     * Discovers objects by listing the live data-export files and deriving the distinct data-type
+     * suffix from each `[microtime]-[datatype].json` filename. The returned object set is exactly
+     * what the source currently exposes — the frozen contract's `propfuel_data_export_file` is the
+     * VERIFICATION FLOOR (discovery must surface at least the feed), never a ceiling.
+     */
+    async DiscoverObjects(companyIntegration, contextUser) {
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const response = await this.ListFiles(auth);
+        this.AssertOK(response, 'list data-export files');
+        const files = this.ParseFileListing(response.Body);
+        const dataTypes = new Set();
+        for (const f of files) {
+            const parsed = parseFileName(f);
+            if (parsed)
+                dataTypes.add(parsed.dataType);
+        }
+        return [...dataTypes].sort().map(dataType => ({
+            Name: dataType,
+            Label: dataType,
+            Description: `PropFuel data-export stream "${dataType}" (discovered from the data-export file listing).`,
+            SupportsIncrementalSync: true,
+            SupportsWrite: false,
+        }));
+    }
+    /**
+     * Discovers fields by downloading ONE sample file for the data type and streaming its records
+     * through the base data-informed discovery helper. The field set + soft-PK come from the real
+     * values the source returns — never a static `STREAM_FIELDS` map. READ-ONLY: the sample file is
+     * fetched and parsed, never acked.
+     */
+    async DiscoverFields(companyIntegration, objectName, contextUser) {
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const response = await this.ListFiles(auth);
+        this.AssertOK(response, 'list data-export files');
+        const files = this.ParseFileListing(response.Body);
+        // Pick the most-recent file (max microtime) of this data type as the discovery sample.
+        const sample = files
+            .map(f => ({ file: f, parsed: parseFileName(f) }))
+            .filter(x => x.parsed && x.parsed.dataType === objectName)
+            .sort((a, b) => compareMicrotime(b.parsed.microtime, a.parsed.microtime))[0];
+        if (!sample)
+            return [];
+        const records = await this.DownloadFileRecords(auth, sample.file);
+        // Data-informed discovery: full field corpus + statistics-first soft-PK over the real records.
+        // Default Pk options let the helper combine uniqueness/null statistics with the built-in
+        // naming-convention rank (defaultPkNameRank) to pick a best-available soft key.
+        return this.DiscoverFieldsViaStream(records, { ReadOnly: true });
+    }
+    // ─── Incremental fetch via the synthetic file-level microtime cursor ──
+    /**
+     * Fetches records for a data type using the synthetic `__file_microtime` cursor.
+     *
+     * Mechanism: load the stored cursor (max microtime processed), list the live files, select the
+     * files of this data type whose microtime exceeds the cursor (ascending microtime order), and
+     * download each, emitting every record with full-record pass-through. The max microtime seen
+     * across the processed files is persisted as the new cursor — ONLY on full-batch success, so a
+     * partial failure leaves the cursor unchanged and the next run resumes from the same point.
+     */
+    async FetchChanges(ctx) {
+        const auth = await this.Authenticate(ctx.CompanyIntegration, ctx.ContextUser);
+        const listResponse = await this.ListFiles(auth);
+        this.AssertOK(listResponse, 'list data-export files');
+        const allFiles = this.ParseFileListing(listResponse.Body);
+        // The resume cursor: prefer the engine-provided keyset position, else the watermark value.
+        const cursor = ctx.AfterKeyValue ?? ctx.WatermarkValue ?? null;
+        const candidates = allFiles
+            .map(f => ({ file: f, parsed: parseFileName(f) }))
+            .filter((x) => x.parsed != null && x.parsed.dataType === ctx.ObjectName)
+            .filter(x => cursor == null || compareMicrotime(x.parsed.microtime, cursor) > 0)
+            .sort((a, b) => compareMicrotime(a.parsed.microtime, b.parsed.microtime));
+        const records = [];
+        let maxMicrotime = cursor ?? '';
+        const batchLimit = ctx.BatchSize && ctx.BatchSize > 0 ? ctx.BatchSize : Number.MAX_SAFE_INTEGER;
+        let filesProcessed = 0;
+        for (const candidate of candidates) {
+            if (records.length >= batchLimit)
+                break;
+            const fileRecords = await this.DownloadFileRecords(auth, candidate.file);
+            for (const raw of fileRecords) {
+                // Full-record pass-through: the COMPLETE source record reaches ExternalRecord.Fields
+                // so the framework's custom-column capture sees every key the source returned.
+                records.push({
+                    ExternalID: this.BuildRecordIdentity(raw, candidate.parsed),
+                    ObjectType: ctx.ObjectName,
+                    Fields: raw,
+                });
+            }
+            if (compareMicrotime(candidate.parsed.microtime, maxMicrotime) > 0) {
+                maxMicrotime = candidate.parsed.microtime;
+            }
+            filesProcessed++;
+        }
+        const moreFiles = filesProcessed < candidates.length;
+        const result = {
+            Records: records,
+            HasMore: moreFiles,
+        };
+        if (maxMicrotime && maxMicrotime !== (cursor ?? '')) {
+            // Surface the new cursor both as the watermark value and the keyset resume position.
+            result.NewWatermarkValue = maxMicrotime;
+            result.NextAfterKeyValue = maxMicrotime;
+        }
+        return result;
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────
+    /** Issues the list call. Path is relative; BuildHeaders + GetBaseURL supply auth + host. */
+    async ListFiles(auth) {
+        const url = `${this.GetBaseURL({}, auth)}/list`;
+        return this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+    }
+    /** Downloads one file by name and returns its records (read-only; never acked). */
+    async DownloadFileRecords(auth, file) {
+        const url = `${this.GetBaseURL({}, auth)}/download/${encodeURIComponent(file)}`;
+        const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+        this.AssertOK(response, `download file ${file}`);
+        return this.NormalizeResponse(response.Body, null);
+    }
+    /**
+     * Parses the list endpoint body into an array of file names. The listing may be a bare array of
+     * strings, an array of objects with a name/file/filename key, or an object wrapping such an array.
+     */
+    ParseFileListing(body) {
+        const arr = Array.isArray(body)
+            ? body
+            : (isRecord(body) ? this.FindArrayInObject(body) : []);
+        const files = [];
+        for (const item of arr) {
+            if (typeof item === 'string') {
+                files.push(item);
+            }
+            else if (isRecord(item)) {
+                const name = item['name'] ?? item['file'] ?? item['filename'] ?? item['fileName'] ?? item['key'];
+                if (typeof name === 'string')
+                    files.push(name);
+            }
+        }
+        return files;
+    }
+    /** Finds the first array-valued property of an object (the file listing under a wrapper key). */
+    FindArrayInObject(obj) {
+        for (const v of Object.values(obj)) {
+            if (Array.isArray(v))
+                return v;
+        }
+        return [];
+    }
+    /**
+     * Builds a stable record identity. The per-record schema is undocumented (no provable PK), so
+     * the connector prefers a common id key when one is present and otherwise falls back to a
+     * deterministic content hash scoped to the file's microtime — the base engine dedupes by the
+     * record-map + content hash regardless.
+     */
+    BuildRecordIdentity(raw, parsed) {
+        for (const k of ['id', 'ID', 'Id', 'uuid', 'externalID', 'ExternalID']) {
+            const v = raw[k];
+            if (typeof v === 'string' && v.length > 0)
+                return v;
+            if (typeof v === 'number')
+                return String(v);
+        }
+        return `${parsed.microtime}:${stableHash(raw)}`;
+    }
+    /** Throws a descriptive error on a non-2xx response (404 included, since a missing file is unexpected here). */
+    AssertOK(response, action) {
+        if (response.Status < 200 || response.Status >= 300) {
+            throw new Error(`PropFuel failed to ${action}: HTTP ${response.Status}`);
+        }
+    }
+    /**
+     * Resolves the bearer Token + per-tenant AccountID from the linked Credential entity, falling
+     * back to the CompanyIntegration.Configuration JSON. AccountID is per-tenant config — NEVER hardcoded.
+     */
+    async LoadCredentials(companyIntegration, contextUser) {
+        let token;
+        let accountID;
+        let baseHost;
+        const credentialID = companyIntegration.CredentialID;
+        if (credentialID) {
+            const fromCred = await this.LoadFromCredentialEntity(credentialID, contextUser);
+            if (fromCred) {
+                token = fromCred.Token ?? token;
+                accountID = fromCred.AccountID ?? accountID;
+            }
+        }
+        // Configuration JSON supplies AccountID (and a token fallback) when not on the credential.
+        const configJson = companyIntegration.Configuration;
+        if (configJson) {
+            const fromConfig = this.ParseCredentialJson(configJson);
+            if (fromConfig) {
+                token = token ?? fromConfig.Token;
+                accountID = accountID ?? fromConfig.AccountID;
+                baseHost = baseHost ?? fromConfig.BaseHost;
+            }
+        }
+        if (!token) {
+            throw new Error('No PropFuel credential or Configuration JSON found — a "Token" is required.');
+        }
+        if (!accountID) {
+            throw new Error('No PropFuel AccountID found — set "AccountID" on the credential or Configuration JSON (it is per-tenant, never hardcoded).');
+        }
+        return { Token: token, AccountID: accountID, BaseHost: baseHost };
+    }
+    /** Loads Token/AccountID from a Credential entity's Values JSON. */
+    async LoadFromCredentialEntity(credentialID, contextUser, provider) {
+        const md = provider ?? new Metadata();
+        const credential = await md.GetEntityObject('MJ: Credentials', contextUser);
+        const loaded = await credential.Load(credentialID);
+        if (!loaded || !credential.Values)
+            return null;
+        return this.ParseCredentialJson(credential.Values);
+    }
+    /** Parses a JSON string to extract Token + AccountID (tolerant of casing/aliases). */
+    ParseCredentialJson(json) {
+        try {
+            const result = PropFuelCredentialSchema.safeParse(JSON.parse(json));
+            if (!result.success)
+                return null;
+            const p = result.data;
+            const token = p.Token ?? p.token ?? p.apiKey ?? p.ApiKey;
+            const accountID = p.AccountID ?? p.accountId ?? p.accountID;
+            if (!token && accountID == null)
+                return null;
+            const baseHost = p.apiBaseUrl ?? p.BaseURL;
+            return { Token: token ?? '', AccountID: accountID != null ? String(accountID) : '', BaseHost: baseHost };
+        }
+        catch {
+            return null;
+        }
+    }
+};
+PropFuelConnector = __decorate([
+    RegisterClass(BaseIntegrationConnector, '@memberjunction/connector-propfuel')
+], PropFuelConnector);
+export { PropFuelConnector };
+// ─── Module-level constants + helpers (mechanism, NOT a catalog) ──────
+/** PropFuel host root. Tenant + endpoint are appended at runtime. */
+const PROPFUEL_HOST = 'https://app.propfuel.com';
+/** Stable ordering key name for keyset/no-watermark resume — the filename microtime prefix. */
+const MICROTIME_ORDERING_KEY = 'microtime';
+/** Zod schema for the credential/Configuration JSON shape (tolerant of casing aliases). */
+const PropFuelCredentialSchema = z.object({
+    Token: z.string().optional(),
+    token: z.string().optional(),
+    apiKey: z.string().optional(),
+    ApiKey: z.string().optional(),
+    AccountID: z.union([z.string(), z.number()]).optional(),
+    accountId: z.union([z.string(), z.number()]).optional(),
+    accountID: z.union([z.string(), z.number()]).optional(),
+    apiBaseUrl: z.string().optional(),
+    BaseURL: z.string().optional(),
+}).passthrough();
+/** Narrows an unknown value to a plain record. */
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Parses a PropFuel data-export filename of the form `[microtime]-[datatype].json`.
+ * The microtime is the leading numeric segment (PHP microtime, e.g. `1717804800.123456`); the data
+ * type is everything between the first `-` and the `.json` suffix. Returns null when the name does
+ * not match the convention.
+ */
+export function parseFileName(fileName) {
+    // Strip any path prefix and the .json extension.
+    const base = fileName.split('/').pop() ?? fileName;
+    const noExt = base.replace(/\.json$/i, '');
+    const dashIndex = noExt.indexOf('-');
+    if (dashIndex <= 0)
+        return null;
+    const microtime = noExt.slice(0, dashIndex);
+    const dataType = noExt.slice(dashIndex + 1);
+    if (!/^[0-9]+(\.[0-9]+)?$/.test(microtime) || dataType.length === 0)
+        return null;
+    return { microtime, dataType };
+}
+/**
+ * Compares two microtime strings chronologically. Microtimes are numeric (possibly fractional);
+ * numeric comparison avoids lexical pitfalls (e.g. different integer widths). Returns >0 when a>b.
+ */
+export function compareMicrotime(a, b) {
+    const na = Number(a);
+    const nb = Number(b);
+    if (Number.isFinite(na) && Number.isFinite(nb)) {
+        return na === nb ? 0 : (na > nb ? 1 : -1);
+    }
+    return a === b ? 0 : (a > b ? 1 : -1);
+}
+/** Small deterministic hash for record identity fallback (FNV-1a, hex). */
+function stableHash(record) {
+    const json = JSON.stringify(record, Object.keys(record).sort());
+    let h = 0x811c9dc5;
+    for (let i = 0; i < json.length; i++) {
+        h ^= json.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16);
+}
+//# sourceMappingURL=PropFuelConnector.js.map

package/dist/PropFuelConnector.js.map

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

package/dist/index.d.ts

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@memberjunction/connector-propfuel",
+  "version": "1.0.0",
+  "description": "MemberJunction PropFuel 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": {
+    "zod": "~3.24.4"
+  },
+  "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"
+  }
+}