@skedulo/integration-sdk 0.1.0

package/dist/services/sync.service.js

@@ -0,0 +1,166 @@
+"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.SyncService = void 0;
+const mapping_service_1 = require("./mapping.service");
+// SyncService runs one DataFlow using a source and target adapter.
+//
+// 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.
+//
+//   handleEvent({ event, flow }, ctx)
+//     Event-driven: payload already mapped by caller (e.g. Paragon Workflow).
+//     Skips fetch/normalize/resolveLookups/enrich — maps payload then writes.
+//
+// Constructor:
+//   source — adapter that fetches from the source system (null for event-driven)
+//   target — adapter that writes to the destination system
+class SyncService {
+    constructor(source, target) {
+        this.source = source;
+        this.target = target;
+    }
+    async run(args, ctx) {
+        var _a, e_1, _b, _c;
+        var _d, _e;
+        if (!((_d = this.source) === null || _d === void 0 ? void 0 : _d.fetch)) {
+            throw new Error('SyncService.run requires a source adapter with fetch()');
+        }
+        const { flow, since } = args;
+        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;
+                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);
+                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 (!_f && !_a && (_b = _g.return)) await _b.call(_g);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return totals;
+    }
+    async handleEvent(args, ctx) {
+        var _a, _b;
+        const { event, flow } = args;
+        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 };
+        }
+        const outcomes = await this.target.upsert(ctx, flow, [mapped]);
+        const outcome = outcomes[0];
+        if (outcome.status === 'ok') {
+            return { status: 'synced', recordsProcessed: 1 };
+        }
+        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 };
+    }
+    // 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;
+        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 (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;
+    }
+}
+exports.SyncService = SyncService;
+//# sourceMappingURL=sync.service.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export type { LookupRule } from './interfaces/lookup-rule.interface';
+export type { FieldMapping, MappingConfigDto } from './interfaces/field-mapping.interface';
+export type { FilterOperator, FilterOperatorOption, FilterRule, FilterSpec, } from './interfaces/filter.interface';
+export { FILTER_OPERATORS } from './interfaces/filter.interface';
+export type { DataFlow } from './interfaces/data-flow-spec.interface';
+export type { MappedEvent } from './interfaces/mapped-event.interface';
+export type { SyncResult, BatchResult, PreviewResult } from './interfaces/sync-result.interface';
+export type { SampleFetcher } from './interfaces/sample-fetcher.interface';
+export type { Adapter, EnrichmentPair, UpsertOutcome, ObjectInfo, FieldInfo, SampleRecord, } from './interfaces/adapter.interface';
+export type { IntegrationCapabilities } from './interfaces/integration-capabilities.interface';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC3F,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,UAAU,GACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,YAAY,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILTER_OPERATORS = void 0;
+var filter_interface_1 = require("./interfaces/filter.interface");
+Object.defineProperty(exports, "FILTER_OPERATORS", { enumerable: true, get: function () { return filter_interface_1.FILTER_OPERATORS; } });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAQA,kEAAiE;AAAxD,oHAAA,gBAAgB,OAAA"}

package/dist/utils/compileFilter.d.ts

@@ -0,0 +1,3 @@
+import type { FilterSpec } from '../interfaces/filter.interface';
+export declare function compileFilter(filter: FilterSpec): string;
+//# sourceMappingURL=compileFilter.d.ts.map

package/dist/utils/compileFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileFilter.d.ts","sourceRoot":"","sources":["../../src/utils/compileFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAmE7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIxD"}

package/dist/utils/compileFilter.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileFilter = compileFilter;
+function renderValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return '[' + value.map((item) => renderValue(item)).join(', ') + ']';
+    if (typeof value === 'object' && value.type === 'expr')
+        return value.value;
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    return String(value);
+}
+function compileRule(rule) {
+    const { field, op, value } = rule;
+    switch (op) {
+        case 'eq':
+            return `\`${field}\` = ${renderValue(value)}`;
+        case 'neq':
+            return `\`${field}\` != ${renderValue(value)}`;
+        case 'in':
+            return `\`${field}\` in ${renderValue(value)}`;
+        case 'nin':
+            return `$not(\`${field}\` in ${renderValue(value)})`;
+        case 'contains':
+            return `$contains(\`${field}\`, ${renderValue(value)})`;
+        case 'startsWith': {
+            if (typeof value === 'object' &&
+                value !== null &&
+                !Array.isArray(value) &&
+                value.type === 'expr')
+                throw new Error('startsWith/endsWith does not support expr values');
+            return `$contains(\`${field}\`, /^${String(value).replace(/[.*+?^${}()|[\]\/\\]/g, '\\$&')}/)`;
+        }
+        case 'endsWith': {
+            if (typeof value === 'object' &&
+                value !== null &&
+                !Array.isArray(value) &&
+                value.type === 'expr')
+                throw new Error('startsWith/endsWith does not support expr values');
+            return `$contains(\`${field}\`, /${String(value).replace(/[.*+?^${}()|[\]\/\\]/g, '\\$&')}$/)`;
+        }
+        case 'gt':
+            return `\`${field}\` > ${renderValue(value)}`;
+        case 'lt':
+            return `\`${field}\` < ${renderValue(value)}`;
+        case 'gte':
+            return `\`${field}\` >= ${renderValue(value)}`;
+        case 'lte':
+            return `\`${field}\` <= ${renderValue(value)}`;
+        case 'between': {
+            if (!Array.isArray(value) || value.length !== 2)
+                throw new Error(`'between' requires a 2-element array, got: ${JSON.stringify(value)}`);
+            return `\`${field}\` >= ${renderValue(value[0])} and \`${field}\` <= ${renderValue(value[1])}`;
+        }
+        case 'notExists':
+            return `($not($exists(\`${field}\`)) or \`${field}\` = null)`;
+        case 'exists':
+            return `($exists(\`${field}\`) and \`${field}\` != null)`;
+        default: {
+            const _exhaustive = op;
+            throw new Error(`Unknown filter operator: ${_exhaustive}`);
+        }
+    }
+}
+function compileFilter(filter) {
+    if (filter.rules.length === 0)
+        return 'true';
+    const joiner = filter.combinator === 'AND' ? ' and ' : ' or ';
+    return `(${filter.rules.map(compileRule).join(joiner)})`;
+}
+//# sourceMappingURL=compileFilter.js.map

package/dist/utils/compileFilter.js.map

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

package/dist/utils/normalizeDataFlow.d.ts

@@ -0,0 +1,3 @@
+import type { DataFlow } from '../interfaces/data-flow-spec.interface';
+export declare function normalizeDataFlow(flow: DataFlow): DataFlow;
+//# sourceMappingURL=normalizeDataFlow.d.ts.map

package/dist/utils/normalizeDataFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDataFlow.d.ts","sourceRoot":"","sources":["../../src/utils/normalizeDataFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAqBvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAE1D"}

package/dist/utils/normalizeDataFlow.js

@@ -0,0 +1,30 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDataFlow = normalizeDataFlow;
+// Older stored flows may have `property` instead of `field` in filter rules.
+// Normalize to `field` so the integration service API accepts them on re-save.
+function normalizeFilterRule(rule) {
+    var _a;
+    const _b = rule, { property, field } = _b, rest = __rest(_b, ["property", "field"]);
+    return Object.assign({ field: (_a = field !== null && field !== void 0 ? field : property) !== null && _a !== void 0 ? _a : '' }, rest);
+}
+function normalizeFilter(filter) {
+    if (!filter)
+        return filter;
+    return Object.assign(Object.assign({}, filter), { rules: filter.rules.map((r) => normalizeFilterRule(r)) });
+}
+function normalizeDataFlow(flow) {
+    return Object.assign(Object.assign({}, flow), { filter: normalizeFilter(flow.filter) });
+}
+//# sourceMappingURL=normalizeDataFlow.js.map

package/dist/utils/normalizeDataFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDataFlow.js","sourceRoot":"","sources":["../../src/utils/normalizeDataFlow.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAqBA,8CAEC;AApBD,6EAA6E;AAC7E,+EAA+E;AAC/E,SAAS,mBAAmB,CAAC,IAA6B;;IACxD,MAAM,KAA+B,IAGpC,EAHK,EAAE,QAAQ,EAAE,KAAK,OAGtB,EAH2B,IAAI,cAA1B,qBAA4B,CAGjC,CAAC;IACF,OAAO,gBAAE,KAAK,EAAE,MAAA,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,QAAQ,mCAAI,EAAE,IAAK,IAAI,CAAgB,CAAC;AACnE,CAAC;AAED,SAAS,eAAe,CAAC,MAA8B;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,uCACK,MAAM,KACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAuC,CAAC,CAAC,IAC5F;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAc;IAC9C,uCAAY,IAAI,KAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,IAAG;AAC3D,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeEqlString(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/utils.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeEqlString = escapeEqlString;
+// EQL string literals use single quotes; the resulting filter is embedded in a
+// GraphQL string literal that uses double quotes. Escape backslashes and single
+// quotes only.
+function escapeEqlString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAGA,0CAEC;AALD,+EAA+E;AAC/E,gFAAgF;AAChF,eAAe;AACf,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/jest.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  collectCoverageFrom: [
+    'src/**/*.ts'
+  ],
+  coverageDirectory: 'coverage',
+  testMatch: [
+    '**/test/**/*.test.ts'
+  ],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node']
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@skedulo/integration-sdk",
+  "version": "0.1.0",
+  "description": "Runtime SDK for Skedulo integration data flows",
+  "license": "ISC",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "require": "./dist/browser.js",
+      "types": "./dist/browser.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "yarn.lock"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:integration": "jest --testPathPatterns=integration",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "docs": "typedoc",
+    "release-package": "yarn build && yarn publish --non-interactive --new-version $npm_package_version"
+  },
+  "dependencies": {
+    "@skedulo/field-mapping-engine": "^1.1.0",
+    "@skedulo/pulse-solution-services": "^0.0.23",
+    "jsonata": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.0",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-missing-exports": "^4.1.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
+}