@skedulo/integration-sdk 0.1.2 → 0.2.0

package/dist/services/id-mapping.service.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdMappingService = void 0;
+const pulse_solution_services_1 = require("@skedulo/pulse-solution-services");
+const constants_1 = require("../constants");
+const utils_1 = require("../utils");
+const MAPPING_OBJECT_NAME = 'IntegrationIdMapping';
+const MAPPING_FIELDS = [
+    { name: 'SourceSystem', label: 'Source System', maxLength: 64 },
+    { name: 'TargetSystem', label: 'Target System', maxLength: 64 },
+    { name: 'ObjectType', label: 'Object Type', maxLength: 128 },
+    { name: 'SourceId', label: 'Source ID', maxLength: 512 },
+    { name: 'TargetId', label: 'Target ID', maxLength: 512 },
+    { name: 'UniqueKey', label: 'Unique Key', maxLength: 768, unique: true },
+    { name: 'DataFlowId', label: 'Data Flow ID', maxLength: 64 },
+];
+function buildFieldPayload(spec) {
+    var _a;
+    return {
+        metadata: { type: 'CustomField' },
+        objectName: MAPPING_OBJECT_NAME,
+        name: spec.name,
+        field: {
+            type: 'String',
+            description: spec.label,
+            display: {
+                label: spec.label,
+                order: 0,
+                isAlert: false,
+                showIf: null,
+                showOnDesktop: true,
+                showOnMobile: false,
+                editableOnMobile: false,
+                requiredOnMobile: false,
+            },
+            constraints: {
+                required: false,
+                unique: (_a = spec.unique) !== null && _a !== void 0 ? _a : false,
+                accessMode: 'ReadWrite',
+                maxLength: spec.maxLength,
+            },
+        },
+    };
+}
+class IdMappingService {
+    /**
+     * Batch query: resolve source IDs to target IDs across multiple object types.
+     * Returns a map keyed by 'ObjectType:sourceId'.
+     */
+    async resolve(ctx, queries) {
+        var _a, _b, _c;
+        const result = new Map();
+        for (const query of queries) {
+            const { sourceSystem, targetSystem, objectType, sourceIds } = query;
+            if (sourceIds.length === 0)
+                continue;
+            for (const chunkIds of chunkArray(sourceIds, constants_1.LOOKUP_CHUNK_SIZE)) {
+                const list = chunkIds.map((id) => `'${(0, utils_1.escapeEqlString)(id)}'`).join(', ');
+                const filter = [
+                    `SourceSystem == '${(0, utils_1.escapeEqlString)(sourceSystem)}'`,
+                    `TargetSystem == '${(0, utils_1.escapeEqlString)(targetSystem)}'`,
+                    `ObjectType == '${(0, utils_1.escapeEqlString)(objectType)}'`,
+                    `SourceId IN [${list}]`,
+                ].join(' AND ');
+                const builder = ctx.newQueryBuilder({
+                    objectName: MAPPING_OBJECT_NAME,
+                    operationName: constants_1.OperationName.MAPPING_RESOLVE,
+                    readOnly: true,
+                });
+                const queryResult = await builder
+                    .withFields(['SourceId', 'TargetId'])
+                    .withFilter(filter)
+                    .withLimit(chunkIds.length)
+                    .execute();
+                for (const record of (_a = queryResult.records) !== null && _a !== void 0 ? _a : []) {
+                    const r = record;
+                    const sourceId = String((_b = r['SourceId']) !== null && _b !== void 0 ? _b : '');
+                    const targetId = String((_c = r['TargetId']) !== null && _c !== void 0 ? _c : '');
+                    if (sourceId && targetId) {
+                        result.set(`${objectType}:${sourceId}`, targetId);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /** Idempotent write — upserts on UniqueKey. */
+    async upsertMappings(ctx, entries) {
+        if (entries.length === 0)
+            return;
+        const records = entries.map((e) => (Object.assign({ SourceSystem: e.sourceSystem, TargetSystem: e.targetSystem, ObjectType: e.objectType, SourceId: e.sourceId, TargetId: e.targetId, UniqueKey: buildUniqueKey(e) }, (e.dataFlowId ? { DataFlowId: e.dataFlowId } : {}))));
+        await ctx.graphqlService.upsert({
+            objectName: MAPPING_OBJECT_NAME,
+            operationName: constants_1.OperationName.MAPPING_UPSERT,
+            records,
+            keyField: 'UniqueKey',
+            bulkOperation: true,
+        });
+    }
+    /** Delete mapping entries for a given set of source IDs. Called after a successful target delete. */
+    async deleteMappings(ctx, params) {
+        var _a;
+        const { sourceSystem, targetSystem, objectType, sourceIds } = params;
+        if (sourceIds.length === 0)
+            return;
+        for (const chunkIds of chunkArray(sourceIds, constants_1.LOOKUP_CHUNK_SIZE)) {
+            const list = chunkIds.map((id) => `'${(0, utils_1.escapeEqlString)(id)}'`).join(', ');
+            const filter = [
+                `SourceSystem == '${(0, utils_1.escapeEqlString)(sourceSystem)}'`,
+                `TargetSystem == '${(0, utils_1.escapeEqlString)(targetSystem)}'`,
+                `ObjectType == '${(0, utils_1.escapeEqlString)(objectType)}'`,
+                `SourceId IN [${list}]`,
+            ].join(' AND ');
+            const builder = ctx.newQueryBuilder({
+                objectName: MAPPING_OBJECT_NAME,
+                operationName: constants_1.OperationName.MAPPING_DELETE_LOOKUP,
+                readOnly: true,
+            });
+            const result = await builder
+                .withFields(['UID'])
+                .withFilter(filter)
+                .withLimit(chunkIds.length)
+                .execute();
+            const uids = ((_a = result.records) !== null && _a !== void 0 ? _a : []).map((r) => ({ UID: r.UID })).filter((r) => r.UID);
+            if (uids.length === 0)
+                continue;
+            await ctx.graphqlService.delete({
+                objectName: MAPPING_OBJECT_NAME,
+                operationName: constants_1.OperationName.MAPPING_DELETE,
+                records: uids,
+            });
+        }
+    }
+    /** Bulk cleanup when a flow is deleted. Paginated so large mapping tables don't OOM. */
+    async deleteByDataFlowId(ctx, dataFlowId) {
+        var _a, _b;
+        let lastUID = null;
+        while (true) {
+            const clauses = [`DataFlowId == '${(0, utils_1.escapeEqlString)(dataFlowId)}'`];
+            if (lastUID)
+                clauses.push(`UID > '${(0, utils_1.escapeEqlString)(lastUID)}'`);
+            const builder = ctx.newQueryBuilder({
+                objectName: MAPPING_OBJECT_NAME,
+                operationName: constants_1.OperationName.MAPPING_FLOW_DELETE,
+            });
+            const result = await builder
+                .withFields(['UID'])
+                .withFilter(clauses.join(' AND '))
+                .withLimit(constants_1.LOOKUP_CHUNK_SIZE)
+                .withOrderBy('UID ASC')
+                .execute();
+            const records = ((_a = result.records) !== null && _a !== void 0 ? _a : []);
+            if (records.length === 0)
+                break;
+            await ctx.graphqlService.delete({
+                objectName: MAPPING_OBJECT_NAME,
+                operationName: constants_1.OperationName.MAPPING_DELETE,
+                records: records.map((r) => ({ UID: r.UID })),
+            });
+            if (records.length < constants_1.LOOKUP_CHUNK_SIZE)
+                break;
+            lastUID = String((_b = records[records.length - 1].UID) !== null && _b !== void 0 ? _b : '');
+            if (!lastUID)
+                break;
+        }
+    }
+    /**
+     * Idempotent schema bootstrap. Checks before creating — safe to call on every /setup request.
+     * Must be called from the integration's /setup endpoint before any idMapping flows run.
+     */
+    static async ensureSchema(ctx) {
+        const objectClient = ctx.newArtifactClient(pulse_solution_services_1.ArtifactType.CUSTOM_OBJECT);
+        const existing = await objectClient
+            .get({ name: MAPPING_OBJECT_NAME })
+            .catch(() => null);
+        if (!existing) {
+            await objectClient.upsert({}, {
+                metadata: { type: 'CustomObject' },
+                name: MAPPING_OBJECT_NAME,
+                label: 'Integration ID Mapping',
+                description: 'Cross-system record ID store for integration flows',
+            });
+        }
+        const fieldClient = ctx.newArtifactClient(pulse_solution_services_1.ArtifactType.CUSTOM_FIELD);
+        for (const fieldSpec of MAPPING_FIELDS) {
+            const existingField = await fieldClient
+                .get({ objectName: MAPPING_OBJECT_NAME, name: fieldSpec.name })
+                .catch(() => null);
+            if (!existingField) {
+                // No path params — the objectName is in the body payload.
+                // POST to artifacts/custom-field (not /custom-field/IntegrationIdMapping).
+                await fieldClient.upsert({}, buildFieldPayload(fieldSpec));
+            }
+        }
+    }
+}
+exports.IdMappingService = IdMappingService;
+function buildUniqueKey(e) {
+    return `${e.sourceSystem}_${e.targetSystem}_${e.objectType}_${e.sourceId}`;
+}
+function chunkArray(arr, size) {
+    const out = [];
+    for (let i = 0; i < arr.length; i += size)
+        out.push(arr.slice(i, i + size));
+    return out;
+}
+//# sourceMappingURL=id-mapping.service.js.map

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

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

package/dist/services/preview.service.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PreviewService = void 0;
-const mapping_service_1 = require("./mapping.service");
+const field_mapping_service_1 = require("./field-mapping.service");
 const constants_1 = require("../constants");
 class PreviewService {
     async run(args, ctx) {
@@ -15,7 +15,7 @@ class PreviewService {
         const results = [];
         for (const record of samples) {
             try {
-                const result = await (0, mapping_service_1.executeMappingDetailed)(flow, record);
+                const result = await (0, field_mapping_service_1.executeMappingDetailed)(flow, record);
                 switch (result.status) {
                     case 'filtered':
                         results.push({ sourceRecord: record, targetRecord: null, status: 'filtered_out' });

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

@@ -1 +1 @@
-{"version":3,"file":"preview.service.js","sourceRoot":"","sources":["../../src/services/preview.service.ts"],"names":[],"mappings":";;;AACA,uDAA2D;AAE3D,4CAA6C;AAE7C,MAAa,cAAc;IACzB,KAAK,CAAC,GAAG,CACP,IAKC,EACD,GAAuB;;QAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,YAAY,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,aAAa,mCAAI,oBAAoB,CAAC;QAC3D,MAAM,YAAY,GAAG,MAAA,IAAI,CAAC,YAAY,mCAAI,IAAI,CAAC,YAAY,CAAC;QAC5D,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAE1F,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAA,wCAAsB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC1D,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;oBACtB,KAAK,UAAU;wBACb,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;wBACnF,MAAM;oBACR,KAAK,kBAAkB;wBACrB,OAAO,CAAC,IAAI,CAAC;4BACX,YAAY,EAAE,MAAM;4BACpB,YAAY,EAAE,IAAI;4BAClB,MAAM,EAAE,wBAAwB;4BAChC,MAAM,EAAE,qBAAqB,CAAC,MAAA,MAAM,CAAC,aAAa,mCAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;yBACvE,CAAC,CAAC;wBACH,MAAM;oBACR,KAAK,OAAO;wBACV,OAAO,CAAC,IAAI,CAAC;4BACX,YAAY,EAAE,MAAM;4BACpB,YAAY,EAAE,IAAI;4BAClB,MAAM,EAAE,iBAAiB;4BACzB,MAAM,EAAE,MAAA,MAAM,CAAC,YAAY,mCAAI,eAAe;yBAC/C,CAAC,CAAC;wBACH,MAAM;oBACR,KAAK,SAAS;wBACZ,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,IAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;wBACxF,MAAM;gBACV,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY,EAAE,MAAM;oBACpB,YAAY,EAAE,IAAI;oBAClB,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAxDD,wCAwDC;AAED,KAAK,UAAU,oBAAoB,CACjC,IAAc,EACd,IAAY,EACZ,GAAuB;IAEvB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG;SACrB,eAAe,CAAC;QACf,UAAU,EAAE,IAAI,CAAC,YAAY;QAC7B,aAAa,EAAE,yBAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,QAAQ,EAAE,IAAI;KACf,CAAC;SACD,SAAS,CAAC,IAAI,CAAC;SACf,OAAO,EAAE,CAAC;IACb,OAAO,MAAM,CAAC,OAAoC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"preview.service.js","sourceRoot":"","sources":["../../src/services/preview.service.ts"],"names":[],"mappings":"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"}

package/dist/services/sync-runner.d.ts

@@ -2,6 +2,7 @@ import type { IntegrationContext } from '../context';
 import type { Adapter } from '../interfaces/adapter.interface';
 import type { MappedEvent } from '../interfaces/mapped-event.interface';
 import type { BatchResult, SyncResult } from '../interfaces/sync-result.interface';
+import type { SyncRunOptions } from '../interfaces/sync-flow-strategy.interface';
 export declare class AdapterNotRegisteredError extends Error {
     constructor(systemName: string);
 }
@@ -13,9 +14,11 @@ export declare class SyncRunner {
         since: Date | null;
         sourceSystem?: string;
         targetSystem?: string;
+        options?: SyncRunOptions;
     }, ctx: IntegrationContext): Promise<BatchResult>;
     handleEvent(args: {
         event: MappedEvent;
+        options?: SyncRunOptions;
     }, ctx: IntegrationContext): Promise<SyncResult[]>;
     private _resolve;
 }

package/dist/services/sync-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-runner.d.ts","sourceRoot":"","sources":["../../src/services/sync-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAwBnF,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ9C,GAAG,CACP,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1F,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;IAwBjB,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsC/F,OAAO,CAAC,QAAQ;CAMjB"}
+{"version":3,"file":"sync-runner.d.ts","sourceRoot":"","sources":["../../src/services/sync-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,4CAA4C,CAAC;AA+BnG,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ9C,GAAG,CACP,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,cAAc,CAAC;KAC1B,EACD,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;IAyBjB,WAAW,CACf,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE,EACtD,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC;IA0CxB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/services/sync-runner.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncRunner = exports.AdapterNotRegisteredError = void 0;
+const external_id_sync_strategy_1 = require("./external-id-sync.strategy");
+const id_mapping_sync_strategy_1 = require("./id-mapping-sync.strategy");
+const id_mapping_service_1 = require("./id-mapping.service");
 const sync_service_1 = require("./sync.service");
 // SyncRunner is the high-level entry point for integration packages.
 //
@@ -8,6 +11,7 @@ const sync_service_1 = require("./sync.service");
 //   - Adapter registration (keyed by system name, e.g. 'hubspot', 'skedulo')
 //   - Flow fetch by ID or by filter (for event-driven paths)
 //   - Adapter resolution from flow.sourceSystem / flow.targetSystem
+//   - Strategy creation based on SyncRunOptions.lookupStrategy
 //   - Delegation to SyncService for the actual pipeline
 //
 // Integration packages register their adapters at startup, then call
@@ -17,11 +21,14 @@ const sync_service_1 = require("./sync.service");
 //   runner.register('hubspot', new HubSpotAdapter())
 //   runner.register('skedulo', new SkeduloAdapter())
 //
-//   // Scheduled / Run Now:
+//   // Scheduled / Run Now (ExternalId strategy — default):
 //   await runner.run({ flowId, since }, ctx)
 //
-//   // Paragon Workflow / inbound event:
-//   await runner.handleEvent({ event }, ctx)
+//   // Scheduled / Run Now (IdMapping strategy):
+//   await runner.run({ flowId, since, options: { lookupStrategy: 'idMapping' } }, ctx)
+//
+//   // Event-driven:
+//   await runner.handleEvent({ event, options: { lookupStrategy: 'idMapping' } }, ctx)
 class AdapterNotRegisteredError extends Error {
     constructor(systemName) {
         super(`adapter not registered for system: "${systemName}"`);
@@ -41,7 +48,7 @@ class SyncRunner {
     // sourceSystem / targetSystem fallbacks are used when the flow's own values are null
     // (e.g. flows created before these columns were added to the schema).
     async run(args, ctx) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         try {
             const flow = await ctx.dataFlowService.getFlowById(args.flowId);
             if (!flow) {
@@ -50,7 +57,8 @@ class SyncRunner {
             }
             const source = this._resolve((_b = (_a = flow.sourceSystem) !== null && _a !== void 0 ? _a : args.sourceSystem) !== null && _b !== void 0 ? _b : null);
             const target = this._resolve((_d = (_c = flow.targetSystem) !== null && _c !== void 0 ? _c : args.targetSystem) !== null && _d !== void 0 ? _d : null);
-            return new sync_service_1.SyncService(source, target).run({ flow, since: args.since }, ctx);
+            const strategy = createSyncStrategy((_e = args.options) !== null && _e !== void 0 ? _e : {}, ctx);
+            return new sync_service_1.SyncService(source, target, strategy).run({ flow, since: args.since }, ctx);
         }
         catch (err) {
             if (err instanceof AdapterNotRegisteredError) {
@@ -65,7 +73,7 @@ class SyncRunner {
     // executionOrder (nulls last), and processes each sequentially so that a failure
     // in one flow doesn't prevent the others from running.
     async handleEvent(args, ctx) {
-        var _a;
+        var _a, _b;
         const { event } = args;
         const flows = await ctx.dataFlowService.getFlowsByFilter({
             integrationType: event.integrationType,
@@ -80,7 +88,8 @@ class SyncRunner {
         for (const flow of sorted) {
             try {
                 const target = this._resolve((_a = flow.targetSystem) !== null && _a !== void 0 ? _a : null);
-                const result = await new sync_service_1.SyncService(null, target).handleEvent({ event, flow }, ctx);
+                const strategy = createSyncStrategy((_b = args.options) !== null && _b !== void 0 ? _b : {}, ctx);
+                const result = await new sync_service_1.SyncService(null, target, strategy).handleEvent({ event, flow }, ctx);
                 results.push(result);
             }
             catch (err) {
@@ -107,4 +116,10 @@ class SyncRunner {
     }
 }
 exports.SyncRunner = SyncRunner;
+function createSyncStrategy(options, _ctx) {
+    if (options.lookupStrategy === 'idMapping') {
+        return new id_mapping_sync_strategy_1.IdMappingSyncStrategy(new id_mapping_service_1.IdMappingService());
+    }
+    return new external_id_sync_strategy_1.ExternalIdSyncStrategy();
+}
 //# sourceMappingURL=sync-runner.js.map

package/dist/services/sync-runner.js.map

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

package/dist/services/sync.service.d.ts

@@ -3,10 +3,12 @@ import type { Adapter } from '../interfaces/adapter.interface';
 import type { DataFlow } from '../interfaces/data-flow-spec.interface';
 import type { MappedEvent } from '../interfaces/mapped-event.interface';
 import type { BatchResult, SyncResult } from '../interfaces/sync-result.interface';
+import type { SyncFlowStrategy } from '../interfaces/sync-flow-strategy.interface';
 export declare class SyncService {
     private readonly source;
     private readonly target;
-    constructor(source: Adapter | null, target: Adapter);
+    private readonly strategy;
+    constructor(source: Adapter | null, target: Adapter, strategy?: SyncFlowStrategy);
     run(args: {
         flow: DataFlow;
         since: Date | null;
@@ -16,6 +18,5 @@ export declare class SyncService {
         flow: DataFlow;
     }, ctx: IntegrationContext): Promise<SyncResult>;
     processBatch(flow: DataFlow, records: Record<string, unknown>[], ctx: IntegrationContext): Promise<BatchResult>;
-    private _processBatch;
 }
 //# sourceMappingURL=sync.service.d.ts.map

package/dist/services/sync.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.service.d.ts","sourceRoot":"","sources":["../../src/services/sync.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAoBnF,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,MAAM,EAAE,OAAO;IAG5B,GAAG,CACP,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,EAC5C,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;IA0BjB,WAAW,CACf,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAC5C,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,UAAU,CAAC;IA4BhB,YAAY,CAChB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;YAIT,aAAa;CAsF5B"}
+{"version":3,"file":"sync.service.d.ts","sourceRoot":"","sources":["../../src/services/sync.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAuBnF,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAGzB,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,MAAM,EAAE,OAAO,EAChC,QAAQ,CAAC,EAAE,gBAAgB;IAOvB,GAAG,CACP,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,EAC5C,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;IA2CjB,WAAW,CACf,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAC5C,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,UAAU,CAAC;IAiBhB,YAAY,CAChB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC;CAaxB"}

package/dist/services/sync.service.js

@@ -8,32 +8,39 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncService = void 0;
-const mapping_service_1 = require("./mapping.service");
-const compileFilter_1 = require("../utils/compileFilter");
-// SyncService runs one DataFlow using a source and target adapter.
+const constants_1 = require("../constants");
+const base_adapter_1 = require("../adapters/base.adapter");
+const external_id_sync_strategy_1 = require("./external-id-sync.strategy");
+// SyncService runs one DataFlow using a source adapter, target adapter, and an injected strategy.
 //
 // Two entrypoints:
 //
 //   run({ flow, since }, ctx)
-//     Scheduled/batch: source.fetch → normalize? → local filter → mapping
-//     → target.resolveLookups? → source.enrich? → target.upsert
-//     source may be null when the caller provides records directly.
+//     Scheduled/batch: source.fetch → strategy.processBatch
 //
 //   handleEvent({ event, flow }, ctx)
-//     Event-driven: payload already mapped by caller (e.g. Paragon Workflow).
-//     Skips fetch/normalize/resolveLookups/enrich — maps payload then writes.
+//     Event-driven: strategy.handleDeleteEvent or strategy.handleUpsertEvent
+//
+// The fetch loop lives here (same for all strategies).
+// All batch logic, lookup resolution, and write-back are delegated to the strategy.
 //
 // Constructor:
-//   source — adapter that fetches from the source system (null for event-driven)
-//   target — adapter that writes to the destination system
+//   source   — adapter that fetches from the source system (null for event-driven)
+//   target   — adapter that writes to the destination system
+//   strategy — injected by SyncRunner; selects ExternalId or IdMapping behaviour
 class SyncService {
-    constructor(source, target) {
+    constructor(source, target, strategy) {
         this.source = source;
         this.target = target;
+        this.strategy = strategy !== null && strategy !== void 0 ? strategy : new external_id_sync_strategy_1.ExternalIdSyncStrategy();
+        if (source instanceof base_adapter_1.BaseAdapter)
+            source._initRole(constants_1.AdapterRole.SOURCE);
+        if (target instanceof base_adapter_1.BaseAdapter)
+            target._initRole(constants_1.AdapterRole.TARGET);
     }
     async run(args, ctx) {
         var _a, e_1, _b, _c;
-        var _d, _e;
+        var _d, _e, _f, _g;
         if (!((_d = this.source) === null || _d === void 0 ? void 0 : _d.fetch)) {
             throw new Error('SyncService.run requires a source adapter with fetch()');
         }
@@ -41,131 +48,70 @@ class SyncService {
         const totals = { succeeded: 0, filtered: 0, failed: 0, dlqWrites: 0 };
         const localFilter = (_e = flow.filter) !== null && _e !== void 0 ? _e : null;
         try {
-            for (var _f = true, _g = __asyncValues(this.source.fetch(ctx, flow, since, localFilter)), _h; _h = await _g.next(), _a = _h.done, !_a; _f = true) {
-                _c = _h.value;
-                _f = false;
+            for (var _h = true, _j = __asyncValues(this.source.fetch(ctx, flow, since, localFilter)), _k; _k = await _j.next(), _a = _k.done, !_a; _h = true) {
+                _c = _k.value;
+                _h = false;
                 const batch = _c;
                 if (!batch || batch.length === 0)
                     continue;
-                const normalizedBatch = this.source.normalize
-                    ? await this.source.normalize(ctx, flow, batch)
-                    : batch;
-                const stats = await this._processBatch(flow, normalizedBatch, localFilter, ctx);
+                // Initialize pipeline state for this batch. Strategies and hooks update it in place.
+                ctx.pipeline = _initPipeline(flow, localFilter, batch, constants_1.SyncMode.BATCH, since);
+                // Step 2: beforeMap — adapter transforms raw records and adds synthetic/computed fields.
+                await ((_g = (_f = this.source).beforeMap) === null || _g === void 0 ? void 0 : _g.call(_f, ctx));
+                const stats = await this.strategy.processBatch(ctx, flow, this.source, this.target, ctx.pipeline.data.map((p) => p.raw), localFilter);
                 totals.succeeded += stats.succeeded;
                 totals.filtered += stats.filtered;
                 totals.failed += stats.failed;
                 totals.dlqWrites += stats.dlqWrites;
+                ctx.pipeline = undefined;
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (!_f && !_a && (_b = _g.return)) await _b.call(_g);
+                if (!_h && !_a && (_b = _j.return)) await _b.call(_j);
             }
             finally { if (e_1) throw e_1.error; }
         }
         return totals;
     }
     async handleEvent(args, ctx) {
-        var _a, _b;
+        var _a;
         const { event, flow } = args;
+        ctx.pipeline = _initPipeline(flow, (_a = flow.filter) !== null && _a !== void 0 ? _a : null, [event.payload], constants_1.SyncMode.EVENT, null);
+        let result;
         if (event.operation === 'DELETE') {
-            await this.target.delete(ctx, flow, [event.recordId]);
-            return { status: 'synced', recordsProcessed: 1 };
-        }
-        const mapped = await (0, mapping_service_1.executeMapping)(flow, event.payload);
-        if (!mapped) {
-            return { status: 'filtered', recordsProcessed: 0 };
+            result = await this.strategy.handleDeleteEvent(ctx, flow, this.target, event.recordId);
         }
-        const outcomes = await this.target.upsert(ctx, flow, [mapped]);
-        const outcome = outcomes[0];
-        if (outcome.status === 'ok') {
-            return { status: 'synced', recordsProcessed: 1 };
+        else {
+            result = await this.strategy.handleUpsertEvent(ctx, flow, this.source, this.target, event);
         }
-        ctx.logger.error(`push_failed: dataFlowId=${flow.id} recordId=${event.recordId} ` +
-            `class=${outcome.status} error=${(_a = outcome.error) !== null && _a !== void 0 ? _a : 'unknown'}`);
-        return { status: 'failed', recordsProcessed: 0, error: (_b = outcome.error) !== null && _b !== void 0 ? _b : outcome.status };
+        ctx.pipeline = undefined;
+        return result;
     }
     // Exposed for tests / direct batch processing.
     async processBatch(flow, records, ctx) {
-        var _a;
-        return this._processBatch(flow, records, (_a = flow.filter) !== null && _a !== void 0 ? _a : null, ctx);
-    }
-    async _processBatch(flow, records, localFilter, ctx) {
         var _a, _b;
-        // Fail fast if the filter spec is invalid — compileFilter throws are intentional and
-        // should not be silently swallowed per-record; propagate before touching any records.
-        if (localFilter)
-            (0, compileFilter_1.compileFilter)(localFilter);
-        const stats = { succeeded: 0, filtered: 0, failed: 0, dlqWrites: 0 };
-        const pairs = [];
-        for (const record of records) {
-            if (localFilter && !(await (0, mapping_service_1.evaluateFilter)(localFilter, record))) {
-                stats.filtered++;
-                continue;
-            }
-            try {
-                const mapped = await (0, mapping_service_1.applyMapping)(flow, record);
-                if (!mapped) {
-                    stats.filtered++;
-                    continue;
-                }
-                pairs.push({ raw: record, mapped });
-                stats.succeeded++;
-            }
-            catch (err) {
-                stats.failed++;
-                ctx.logger.error(`dlq_write: dataFlowId=${flow.id} error=${err instanceof Error ? err.message : String(err)}`);
-                stats.dlqWrites++;
-            }
+        if (!ctx.pipeline) {
+            ctx.pipeline = _initPipeline(flow, (_a = flow.filter) !== null && _a !== void 0 ? _a : null, records, constants_1.SyncMode.BATCH, null);
         }
-        if (pairs.length === 0)
-            return stats;
-        // Resolve lookups via target adapter (e.g. Skedulo ExternalId → UID)
-        if (this.target.resolveLookups) {
-            try {
-                await this.target.resolveLookups(ctx, flow, pairs);
-            }
-            catch (err) {
-                ctx.logger.error(`lookup_failed: ${err instanceof Error ? err.message : String(err)}`);
-                stats.failed += stats.succeeded;
-                stats.succeeded = 0;
-                return stats;
-            }
-        }
-        // Optional enrich from source adapter after lookups resolved
-        let toUpsert;
-        if ((_a = this.source) === null || _a === void 0 ? void 0 : _a.enrich) {
-            try {
-                toUpsert = await this.source.enrich(ctx, flow, 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);
-        }
-        try {
-            const outcomes = await this.target.upsert(ctx, flow, toUpsert);
-            for (let i = 0; i < outcomes.length; i++) {
-                if (outcomes[i].status !== 'ok') {
-                    ctx.logger.error(`upsert_failed: dataFlowId=${flow.id} class=${outcomes[i].status} error=${(_b = outcomes[i].error) !== null && _b !== void 0 ? _b : 'unknown'}`);
-                    stats.succeeded--;
-                    stats.failed++;
-                }
-            }
-        }
-        catch (err) {
-            ctx.logger.error(`batch_upsert_failed: dataFlowId=${flow.id} error=${err instanceof Error ? err.message : String(err)}`);
-            stats.failed += stats.succeeded;
-            stats.succeeded = 0;
-        }
-        return stats;
+        return this.strategy.processBatch(ctx, flow, this.source, this.target, records, (_b = flow.filter) !== null && _b !== void 0 ? _b : null);
     }
 }
 exports.SyncService = SyncService;
+function _initPipeline(flow, filter, records, syncMode, since) {
+    return {
+        flow,
+        filter: filter !== null && filter !== void 0 ? filter : null,
+        syncMode,
+        since,
+        data: records.map((raw) => ({ raw, mapped: {} })),
+        outcomes: [],
+        deleteIds: [],
+        stats: { succeeded: 0, filtered: 0, failed: 0, dlqWrites: 0 },
+        errors: [],
+        failedAtStage: null,
+        meta: {},
+    };
+}
 //# sourceMappingURL=sync.service.js.map