@skedulo/integration-sdk 0.2.3 → 0.3.0

package/dist/services/mapping.service.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.engineCache = void 0;
+exports.applyMapping = applyMapping;
+exports.executeMapping = executeMapping;
+exports.executeMappingDetailed = executeMappingDetailed;
+exports.evaluateFilter = evaluateFilter;
+const jsonata_1 = __importDefault(require("jsonata"));
+const field_mapping_engine_1 = require("@skedulo/field-mapping-engine");
+const compileFilter_1 = require("../utils/compileFilter");
+// Cache compiled engines per mapping signature to avoid re-parsing JSONata per event
+exports.engineCache = new Map();
+// Exported for testing. Not part of the public SDK API (not re-exported from index.ts).
+async function applyMapping(flow, record) {
+    const engine = getEngine(flow);
+    const result = await engine.processRecord(record);
+    return result.status === 'SUCCESS' ? result.data : null;
+}
+async function executeMapping(flow, record) {
+    // Filter first — cheap short-circuit
+    if (flow.filter && !(await evaluateFilter(flow.filter, record)))
+        return null;
+    return applyMapping(flow, record);
+}
+async function executeMappingDetailed(flow, record) {
+    var _a, _b, _c;
+    if (flow.filter && !(await evaluateFilter(flow.filter, record))) {
+        return { status: 'filtered', data: null };
+    }
+    const engine = getEngine(flow);
+    const result = await engine.processRecord(record);
+    if (result.status === 'SUCCESS') {
+        return { status: 'success', data: result.data };
+    }
+    const hasRequiredFieldError = result.errors.some((e) => e.includes('Required field') && e.includes('is missing'));
+    if (hasRequiredFieldError) {
+        const requiredValidations = (_c = (_b = (_a = flow.mappingConfig) === null || _a === void 0 ? void 0 : _a.validations) === null || _b === void 0 ? void 0 : _b.filter((v) => v.action === 'ERROR')) !== null && _c !== void 0 ? _c : [];
+        const missingFields = requiredValidations
+            .filter((v) => v.message && result.errors.some((e) => e === v.message))
+            .map((v) => {
+            var _a, _b;
+            const match = (_a = v.message) === null || _a === void 0 ? void 0 : _a.match(/Required field (.+) is missing/);
+            return match ? match[1] : ((_b = v.label) !== null && _b !== void 0 ? _b : 'unknown');
+        });
+        return {
+            status: 'required_missing',
+            data: null,
+            missingFields: missingFields.length > 0 ? missingFields : undefined,
+        };
+    }
+    return { status: 'error', data: null, errorMessage: result.errors.join('; ') };
+}
+async function evaluateFilter(filter, record) {
+    if (!filter)
+        return true;
+    const exprStr = (0, compileFilter_1.compileFilter)(filter);
+    if (exprStr === 'true')
+        return true;
+    const expr = (0, jsonata_1.default)(exprStr);
+    const result = await expr.evaluate(record);
+    return result === true;
+}
+function getEngine(flow) {
+    var _a, _b, _c;
+    const mc = flow.mappingConfig;
+    if (!mc)
+        throw new Error(`No mappingConfig for flow ${flow.id}`);
+    const key = `${flow.id}:${JSON.stringify(mc)}`;
+    let engine = exports.engineCache.get(key);
+    if (!engine) {
+        engine = new field_mapping_engine_1.MappingEngine({
+            integration_id: `sdk-${flow.id}`,
+            sourceSystem: '',
+            sourceObject: '',
+            destinationSystem: '',
+            destinationObject: '',
+            mappings: mc.mappings.map(({ target, expression, label }) => ({ target, expression, label })),
+            translations: (_a = mc.translations) !== null && _a !== void 0 ? _a : [],
+            validations: ((_b = mc.validations) !== null && _b !== void 0 ? _b : []).map((v) => { var _a; return (Object.assign(Object.assign({}, v), { label: (_a = v.label) !== null && _a !== void 0 ? _a : '' })); }),
+            variables: (_c = mc.variables) !== null && _c !== void 0 ? _c : [],
+        });
+        exports.engineCache.set(key, engine);
+    }
+    return engine;
+}
+//# sourceMappingURL=mapping.service.js.map

package/dist/services/mapping.service.js.map

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

package/dist/services/outbound-service.d.ts

@@ -0,0 +1,14 @@
+import type { IntegrationContext } from '../context';
+import type { SyncResult } from '../types';
+export interface OutboundPayload {
+    skeduloObject: string;
+    recordId: string;
+    operation: 'INSERT' | 'UPDATE' | 'DELETE';
+    integrationType: string;
+}
+export declare class OutboundService {
+    run(payload: OutboundPayload, ctx: IntegrationContext): Promise<SyncResult>;
+    private _fetchRecord;
+    private _handleDelete;
+}
+//# sourceMappingURL=outbound-service.d.ts.map

package/dist/services/outbound-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-service.d.ts","sourceRoot":"","sources":["../../src/services/outbound-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAC;AAMzD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;IACpB,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;YAyCnE,YAAY;YAqBZ,aAAa;CAK5B"}

package/dist/services/outbound-service.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboundService = void 0;
+const mapping_service_1 = require("./mapping-service");
+function escapeEqlString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+class OutboundService {
+    async run(payload, ctx) {
+        try {
+            const spec = await ctx.dataFlowService.getSpecByFilter({
+                integrationType: payload.integrationType,
+                sourceObject: payload.skeduloObject,
+                strategy: 'OUTBOUND_TRIGGERED',
+            });
+            if (!spec) {
+                ctx.logger.warn(`orphan_outbound: no DataFlow for ${payload.integrationType}.${payload.skeduloObject} (OUTBOUND_TRIGGERED)`);
+                return { status: 'skipped', recordsProcessed: 0, reason: 'no_data_flow' };
+            }
+            if (payload.operation === 'DELETE') {
+                return this._handleDelete(payload, spec, ctx);
+            }
+            const record = await this._fetchRecord(payload.skeduloObject, payload.recordId, spec, ctx);
+            if (!record) {
+                return { status: 'skipped', recordsProcessed: 0, reason: 'not_found' };
+            }
+            const mapped = await (0, mapping_service_1.executeMapping)(spec, record);
+            if (!mapped) {
+                return { status: 'filtered', recordsProcessed: 0 };
+            }
+            const method = payload.operation === 'INSERT' ? 'POST' : 'PATCH';
+            const path = payload.operation === 'INSERT'
+                ? spec.targetObject
+                : `${spec.targetObject}/${encodeURIComponent(payload.recordId)}`;
+            await ctx.proxyClient.request(method, path, { body: mapped });
+            return { status: 'synced', recordsProcessed: 1 };
+        }
+        catch (err) {
+            ctx.logger.error(`handler_error: ${err instanceof Error ? err.message : String(err)}`);
+            return { status: 'failed', recordsProcessed: 0, error: String(err) };
+        }
+    }
+    async _fetchRecord(objectName, recordId, spec, ctx) {
+        var _a, _b, _c;
+        const sourceFields = (_c = (_a = spec.sourceFields) !== null && _a !== void 0 ? _a : (_b = spec.mappingConfig) === null || _b === void 0 ? void 0 : _b.mappings.map(m => m.expression)) !== null && _c !== void 0 ? _c : [];
+        const filterFields = spec.filter ? spec.filter.rules.map((r) => r.field) : [];
+        const fields = [...new Set(['UID', ...sourceFields, ...filterFields])];
+        const builder = ctx.newQueryBuilder({ objectName, operationName: 'outboundFetch', readOnly: true });
+        const result = await builder
+            .withFields(fields)
+            .withFilter(`UID == "${escapeEqlString(recordId)}"`)
+            .withLimit(1)
+            .execute();
+        if (!result.records || result.records.length === 0)
+            return null;
+        return result.records[0];
+    }
+    async _handleDelete(payload, spec, ctx) {
+        const path = `${spec.targetObject}/${encodeURIComponent(payload.recordId)}`;
+        await ctx.proxyClient.request('DELETE', path);
+        return { status: 'synced', recordsProcessed: 1 };
+    }
+}
+exports.OutboundService = OutboundService;
+//# sourceMappingURL=outbound-service.js.map

package/dist/services/outbound-service.js.map

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

package/dist/services/paragon-workflow-service.d.ts

@@ -0,0 +1,7 @@
+import type { IntegrationContext } from '../context';
+import type { MappedEvent, SyncResult } from '../types';
+export declare class ParagonWorkflowService {
+    handle(event: MappedEvent, ctx: IntegrationContext): Promise<SyncResult>;
+    private _handleDelete;
+}
+//# sourceMappingURL=paragon-workflow-service.d.ts.map

package/dist/services/paragon-workflow-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragon-workflow-service.d.ts","sourceRoot":"","sources":["../../src/services/paragon-workflow-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAC;AAMtE,qBAAa,sBAAsB;IAC3B,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;YA0ChE,aAAa;CAwB5B"}

package/dist/services/paragon-workflow-service.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParagonWorkflowService = void 0;
+const mapping_service_1 = require("./mapping-service");
+const provenance_1 = require("../provenance");
+function escapeEqlString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+class ParagonWorkflowService {
+    async handle(event, ctx) {
+        try {
+            const spec = await ctx.dataFlowService.getSpecByFilter({
+                integrationType: event.integrationType,
+                sourceObject: event.objectType,
+                strategy: 'PARAGON_WORKFLOW',
+            });
+            if (!spec) {
+                ctx.logger.warn(`orphan_event: no PARAGON_WORKFLOW DataFlow for ${event.integrationType}.${event.objectType}`);
+                return { status: 'skipped', recordsProcessed: 0, reason: 'no_data_flow' };
+            }
+            if ((0, provenance_1.hasOwnProvenance)(event.payload, spec.provenanceMarker)) {
+                return { status: 'skipped', recordsProcessed: 0, reason: 'own_provenance' };
+            }
+            if (event.operation === 'DELETE') {
+                return this._handleDelete(event, spec, ctx);
+            }
+            const mapped = await (0, mapping_service_1.executeMapping)(spec, event.payload);
+            if (!mapped) {
+                return { status: 'filtered', recordsProcessed: 0 };
+            }
+            await ctx.graphqlService.upsert({
+                objectName: spec.targetObject,
+                operationName: `paragon_sync_${spec.id}`,
+                records: [(0, provenance_1.applyProvenance)(mapped, spec.provenanceMarker)],
+                keyField: spec.matchKeyField,
+                bulkOperation: true,
+                suppressChangeEvents: true,
+            });
+            return { status: 'synced', recordsProcessed: 1 };
+        }
+        catch (err) {
+            ctx.logger.error(`handler_error: ${err instanceof Error ? err.message : String(err)}`);
+            return { status: 'failed', recordsProcessed: 0, error: String(err) };
+        }
+    }
+    async _handleDelete(event, spec, ctx) {
+        const builder = ctx.newQueryBuilder({
+            objectName: spec.targetObject,
+            operationName: 'paragonWorkflowDeleteLookup',
+        });
+        const result = await builder
+            .withFields(['UID'])
+            .withFilter(`${spec.matchKeyField} == "${escapeEqlString(event.recordId)}"`)
+            .withLimit(1)
+            .execute();
+        if (!result.records || result.records.length === 0) {
+            return { status: 'skipped', recordsProcessed: 0, reason: 'not_found' };
+        }
+        await ctx.graphqlService.delete({
+            objectName: spec.targetObject,
+            operationName: 'paragonWorkflowDelete',
+            records: [{ UID: result.records[0].UID }],
+        });
+        return { status: 'synced', recordsProcessed: 1 };
+    }
+}
+exports.ParagonWorkflowService = ParagonWorkflowService;
+//# sourceMappingURL=paragon-workflow-service.js.map

package/dist/services/paragon-workflow-service.js.map

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

package/dist/services/paragon-workflow.service.d.ts

@@ -0,0 +1,8 @@
+import type { IntegrationContext } from '../context';
+import type { MappedEvent, SyncResult } from '../types';
+export declare class ParagonWorkflowService {
+    private readonly syncService;
+    constructor();
+    handle(event: MappedEvent, ctx: IntegrationContext): Promise<SyncResult>;
+}
+//# sourceMappingURL=paragon-workflow.service.d.ts.map

package/dist/services/paragon-workflow.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragon-workflow.service.d.ts","sourceRoot":"","sources":["../../src/services/paragon-workflow.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKxD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;;IAMpC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAqB/E"}

package/dist/services/paragon-workflow.service.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParagonWorkflowService = void 0;
+const skedulo_adapter_1 = require("../adapters/skedulo.adapter");
+const sync_service_1 = require("./sync.service");
+const constants_1 = require("../constants");
+class ParagonWorkflowService {
+    constructor() {
+        this.syncService = new sync_service_1.SyncService(null, new skedulo_adapter_1.SkeduloAdapter());
+    }
+    async handle(event, ctx) {
+        try {
+            const flow = await ctx.dataFlowService.getFlowByFilter({
+                integrationType: event.integrationType,
+                sourceObject: event.objectType,
+                strategy: constants_1.Strategy.PARAGON_WORKFLOW,
+            });
+            if (!flow) {
+                ctx.logger.warn(`orphan_event: no ${constants_1.Strategy.PARAGON_WORKFLOW} DataFlow for ${event.integrationType}.${event.objectType}`);
+                return { status: 'skipped', recordsProcessed: 0, reason: 'no_data_flow' };
+            }
+            return this.syncService.handleEvent({ event, flow }, ctx);
+        }
+        catch (err) {
+            ctx.logger.error(`handler_error: ${err instanceof Error ? err.message : String(err)}`);
+            return { status: 'failed', recordsProcessed: 0, error: String(err) };
+        }
+    }
+}
+exports.ParagonWorkflowService = ParagonWorkflowService;
+//# sourceMappingURL=paragon-workflow.service.js.map

package/dist/services/paragon-workflow.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragon-workflow.service.js","sourceRoot":"","sources":["../../src/services/paragon-workflow.service.ts"],"names":[],"mappings":";;;AAEA,iEAA6D;AAC7D,iDAA6C;AAC7C,4CAAwC;AAExC,MAAa,sBAAsB;IAGjC;QACE,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,EAAE,IAAI,gCAAc,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB,EAAE,GAAuB;QACtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC;gBACrD,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,YAAY,EAAE,KAAK,CAAC,UAAU;gBAC9B,QAAQ,EAAE,oBAAQ,CAAC,gBAAgB;aACpC,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,oBAAoB,oBAAQ,CAAC,gBAAgB,iBAAiB,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAC1G,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YAC5E,CAAC;YAED,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;CACF;AA5BD,wDA4BC"}

package/dist/services/preview-service.d.ts

@@ -0,0 +1,11 @@
+import type { IntegrationContext } from '../context';
+import type { PreviewResult, SampleFetcher } from '../types';
+export declare class PreviewService {
+    run(args: {
+        dataFlowId: number;
+        sampleSize: number;
+        sampleRecord?: Record<string, unknown>;
+        sampleFetcher?: SampleFetcher;
+    }, ctx: IntegrationContext): Promise<PreviewResult[]>;
+}
+//# sourceMappingURL=preview-service.d.ts.map

package/dist/services/preview-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-service.d.ts","sourceRoot":"","sources":["../../src/services/preview-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAgB,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3E,qBAAa,cAAc;IACnB,GAAG,CACP,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC;CA4C5B"}

package/dist/services/preview-service.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreviewService = void 0;
+const mapping_service_1 = require("./mapping-service");
+class PreviewService {
+    async run(args, ctx) {
+        var _a, _b, _c, _d;
+        const spec = await ctx.dataFlowService.getSpecById(args.dataFlowId);
+        if (!spec)
+            throw new Error(`DataFlow ${args.dataFlowId} not found`);
+        const fetcher = (_a = args.sampleFetcher) !== null && _a !== void 0 ? _a : defaultSampleFetcher;
+        const sampleRecord = (_b = args.sampleRecord) !== null && _b !== void 0 ? _b : spec.sampleRecord;
+        const samples = sampleRecord
+            ? [sampleRecord]
+            : await fetcher(spec, args.sampleSize, ctx);
+        const results = [];
+        for (const record of samples) {
+            try {
+                const result = await (0, mapping_service_1.executeMappingDetailed)(spec, record);
+                switch (result.status) {
+                    case 'filtered':
+                        results.push({ sourceRecord: record, targetRecord: null, status: 'filtered_out' });
+                        break;
+                    case 'required_missing':
+                        results.push({
+                            sourceRecord: record,
+                            targetRecord: null,
+                            status: 'missing_required_field',
+                            reason: `Missing required: ${((_c = result.missingFields) !== null && _c !== void 0 ? _c : []).join(', ')}`,
+                        });
+                        break;
+                    case 'error':
+                        results.push({
+                            sourceRecord: record,
+                            targetRecord: null,
+                            status: 'transform_error',
+                            reason: (_d = result.errorMessage) !== null && _d !== void 0 ? _d : 'unknown error',
+                        });
+                        break;
+                    case 'success':
+                        results.push({ sourceRecord: record, targetRecord: result.data, status: 'will_sync' });
+                        break;
+                }
+            }
+            catch (e) {
+                results.push({ sourceRecord: record, targetRecord: null, status: 'transform_error', reason: sanitizeError(e) });
+            }
+        }
+        return results;
+    }
+}
+exports.PreviewService = PreviewService;
+async function defaultSampleFetcher(spec, size, ctx) {
+    if (spec.direction !== 'OUTBOUND') {
+        throw new Error('INBOUND preview requires a sampleFetcher (integration-specific endpoint)');
+    }
+    const result = await ctx
+        .newQueryBuilder({ objectName: spec.sourceObject, operationName: `preview_${spec.id}`, readOnly: true })
+        .withLimit(size)
+        .execute();
+    return result.records;
+}
+function sanitizeError(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=preview-service.js.map

package/dist/services/preview-service.js.map

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

package/dist/services/pull-service.d.ts

@@ -0,0 +1,9 @@
+import type { IntegrationContext } from '../context';
+import type { BatchResult, DataFlowSpec, FilterSpec, PullAdapter } from '../types';
+export declare class PullService {
+    private readonly adapter;
+    constructor(adapter: PullAdapter);
+    runFlow(spec: DataFlowSpec, since: Date | null, ctx: IntegrationContext): Promise<BatchResult>;
+    processBatch(spec: DataFlowSpec, records: Record<string, unknown>[], localFilter: FilterSpec | null, ctx: IntegrationContext): Promise<BatchResult>;
+}
+//# sourceMappingURL=pull-service.d.ts.map

package/dist/services/pull-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-service.d.ts","sourceRoot":"","sources":["../../src/services/pull-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAmBlB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW;IAE3C,OAAO,CACX,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,IAAI,GAAG,IAAI,EAClB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;IAiBjB,YAAY,CAChB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,WAAW,EAAE,UAAU,GAAG,IAAI,EAC9B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;CAgFxB"}

package/dist/services/pull-service.js

@@ -0,0 +1,207 @@
+"use strict";
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PullService = void 0;
+const mapping_service_1 = require("./mapping-service");
+const split_filter_1 = require("./split-filter");
+const provenance_1 = require("../provenance");
+const eql_1 = require("./eql");
+// PullService drives a PullAdapter for one DataFlow:
+//   1. Split the filter into pushed (vendor-side) + local (JSONata).
+//   2. Iterate adapter.delta(ctx, spec, since, pushed) → batches of raw records.
+//   3. Per batch: drop our own provenance, apply local filter, map, resolve lookups, enrich, upsert.
+//
+// Loop avoidance: we rely on `suppressChangeEvents: true` in the upsert
+// (Skedulo side) and `hasOwnProvenance` on incoming raw vendor records
+// (HubSpot side, when a future OUTBOUND path stamps a vendor-side marker).
+// We do NOT inject `__skedulo_provenance` into the upsert payload —
+// standard Skedulo objects have no such field and the mutation rejects it.
+//
+// Concurrency / last_run_at gating is the caller's responsibility — the
+// integration-service tenant fn does the optimistic UPDATE before invoking.
+class PullService {
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async runFlow(spec, since, ctx) {
+        var _a, e_1, _b, _c;
+        const totals = { succeeded: 0, filtered: 0, failed: 0, dlqWrites: 0 };
+        const { pushed, local } = (0, split_filter_1.splitFilter)(spec.filter, this.adapter.capabilities);
+        try {
+            for (var _d = true, _e = __asyncValues(this.adapter.delta(ctx, spec, since, pushed)), _f; _f = await _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const batch = _c;
+                if (!batch || batch.length === 0)
+                    continue;
+                const stats = await this.processBatch(spec, batch, local, ctx);
+                totals.succeeded += stats.succeeded;
+                totals.filtered += stats.filtered;
+                totals.failed += stats.failed;
+                totals.dlqWrites += stats.dlqWrites;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) await _b.call(_e);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return totals;
+    }
+    // Exposed for tests / direct batch processing (mirrors old ScheduledPullService.processBatch).
+    async processBatch(spec, records, localFilter, ctx) {
+        const stats = { succeeded: 0, filtered: 0, failed: 0, dlqWrites: 0 };
+        const pairs = [];
+        // Step 1: per-record — provenance, local filter, mapping
+        for (const record of records) {
+            if ((0, provenance_1.hasOwnProvenance)(record, spec.provenanceMarker)) {
+                stats.filtered++;
+                continue;
+            }
+            if (localFilter && !(await (0, mapping_service_1.evaluateFilter)(localFilter, record))) {
+                stats.filtered++;
+                continue;
+            }
+            try {
+                const mapped = await (0, mapping_service_1.applyMapping)(spec, record);
+                if (!mapped) {
+                    stats.filtered++;
+                    continue;
+                }
+                pairs.push({ raw: record, mapped });
+                stats.succeeded++;
+            }
+            catch (err) {
+                stats.failed++;
+                ctx.logger.error(`dlq_write: dataFlowId=${spec.id} error=${err instanceof Error ? err.message : String(err)}`);
+                stats.dlqWrites++;
+            }
+        }
+        if (pairs.length === 0)
+            return stats;
+        // Step 2: batch lookup resolution
+        try {
+            await resolveLookups(spec, pairs, ctx);
+        }
+        catch (err) {
+            ctx.logger.error(`lookup_failed: ${err instanceof Error ? err.message : String(err)}`);
+            stats.failed += stats.succeeded;
+            stats.succeeded = 0;
+            return stats;
+        }
+        // Step 3: adapter enrich (optional)
+        let toUpsert;
+        if (this.adapter.enrich) {
+            try {
+                toUpsert = await this.adapter.enrich(ctx, spec, pairs);
+            }
+            catch (err) {
+                ctx.logger.error(`enrich_failed: ${err instanceof Error ? err.message : String(err)}`);
+                stats.failed += stats.succeeded;
+                stats.succeeded = 0;
+                return stats;
+            }
+        }
+        else {
+            toUpsert = pairs.map(p => p.mapped);
+        }
+        // Step 4: upsert
+        try {
+            await ctx.graphqlService.upsert({
+                objectName: spec.targetObject,
+                operationName: `pull_${spec.id}`,
+                records: toUpsert,
+                keyField: spec.matchKeyField,
+                bulkOperation: true,
+                suppressChangeEvents: true,
+            });
+        }
+        catch (err) {
+            ctx.logger.error(`batch_upsert_failed: ${err instanceof Error ? err.message : String(err)}`);
+            stats.failed += stats.succeeded;
+            stats.succeeded = 0;
+        }
+        return stats;
+    }
+}
+exports.PullService = PullService;
+const LOOKUP_CHUNK_SIZE = 100;
+function chunk(arr, size) {
+    const out = [];
+    for (let i = 0; i < arr.length; i += size)
+        out.push(arr.slice(i, i + size));
+    return out;
+}
+async function batchLookup(ctx, objectName, keyField, values) {
+    var _a, _b, _c;
+    const result = new Map();
+    for (const chunkValues of chunk(values, LOOKUP_CHUNK_SIZE)) {
+        const list = chunkValues.map(v => `'${(0, eql_1.escapeEqlString)(v)}'`).join(', ');
+        const builder = ctx.newQueryBuilder({
+            objectName,
+            operationName: `lookupResolve_${objectName}`,
+            readOnly: true,
+        });
+        // withLimit assumes keyField is unique per value (e.g. ExternalId).
+        // Non-unique keyField would silently truncate results.
+        const queryResult = await builder
+            .withFields(['UID', keyField])
+            .withFilter(`${keyField} IN [${list}]`)
+            .withLimit(chunkValues.length)
+            .execute();
+        for (const record of (_a = queryResult.records) !== null && _a !== void 0 ? _a : []) {
+            const key = String((_b = record[keyField]) !== null && _b !== void 0 ? _b : '');
+            const uid = String((_c = record['UID']) !== null && _c !== void 0 ? _c : '');
+            if (key && uid)
+                result.set(key, uid);
+        }
+    }
+    return result;
+}
+async function resolveLookups(spec, pairs, ctx) {
+    var _a, _b;
+    const lookupMappings = ((_b = (_a = spec.mappingConfig) === null || _a === void 0 ? void 0 : _a.mappings) !== null && _b !== void 0 ? _b : []).filter(m => m.lookup);
+    if (lookupMappings.length === 0)
+        return;
+    for (const mapping of lookupMappings) {
+        const rule = mapping.lookup;
+        // Coerce to string — mapping expressions may produce numbers.
+        // null/undefined values are skipped (no query, no warn).
+        const values = [
+            ...new Set(pairs
+                .map(p => {
+                const v = p.mapped[mapping.target];
+                return v != null ? String(v) : '';
+            })
+                .filter(v => v.length > 0)),
+        ];
+        if (values.length === 0)
+            continue;
+        const uidMap = await batchLookup(ctx, rule.object, rule.keyField, values);
+        for (const pair of pairs) {
+            const rawValue = pair.mapped[mapping.target] != null ? String(pair.mapped[mapping.target]) : undefined;
+            if (!rawValue)
+                continue;
+            const uid = uidMap.get(rawValue);
+            if (uid) {
+                pair.mapped[mapping.target] = uid;
+            }
+            else {
+                // All three onMissing variants log + omit for this slice.
+                // 'skip' and 'error' full implementation lands in slice 3.
+                ctx.logger.warn(`lookup_miss: target=${mapping.target} object=${rule.object} ` +
+                    `keyField=${rule.keyField} value=${rawValue} onMissing=${rule.onMissing}`);
+                delete pair.mapped[mapping.target];
+            }
+        }
+    }
+}
+//# sourceMappingURL=pull-service.js.map