@skedulo/integration-sdk 0.9.1 → 0.10.0

package/dist/actions/sync/retry-failed.action.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRetryFailedAction = makeRetryFailedAction;
+const sync_runner_1 = require("../../services/sync-runner");
+const action_names_1 = require("../utils/action-names");
+const helpers_1 = require("../utils/helpers");
+const errors_1 = require("../utils/errors");
+const define_action_1 = require("../utils/define-action");
+/**
+ * Retry specific failed records for a flow. Admin-only. Takes the source-system ids the
+ * caller already holds (from the failed-records list), re-fetches those records via the
+ * adapter's `fetchByIds` — current state, so a source-side fix takes effect — re-runs the
+ * pipeline, then reconciles: resolve the ones that now pass, re-record the ones that still fail.
+ */
+function makeRetryFailedAction(deps) {
+    return (0, define_action_1.defineAction)({
+        name: action_names_1.ACTIONS.sync.retryFailed,
+        requireAdmin: true,
+        parseInput(raw) {
+            const obj = (raw !== null && raw !== void 0 ? raw : {});
+            if (!Number.isInteger(obj.flowId) || obj.flowId <= 0) {
+                throw new errors_1.InvalidInputError('flowId must be a positive integer');
+            }
+            // `recordIds` is a transitional alias: the pre-rename UI sends source ids under that key.
+            const ids = Array.isArray(obj.sourceIds) ? obj.sourceIds : obj.recordIds;
+            if (!Array.isArray(ids) || ids.length === 0) {
+                throw new errors_1.InvalidInputError('sourceIds must be a non-empty array');
+            }
+            // Dedupe: the reconcile upserts one failed-record row per source id, and the store
+            // rejects two conflicting (flow, source_id) rows in a single statement.
+            return { flowId: obj.flowId, sourceIds: [...new Set(ids.map((id) => String(id)))] };
+        },
+        async handler(input, ctx) {
+            var _a;
+            const flow = await ctx.dataFlowService.getFlowById(input.flowId);
+            if (!flow) {
+                throw new errors_1.NotFoundError('FLOW_NOT_FOUND', `Flow ${input.flowId} not found`);
+            }
+            // Retry re-fetches each record's current state from the flow's SOURCE, so that adapter must
+            // implement fetchByIds — the vendor for inbound flows, Skedulo for outbound. Reject with a
+            // typed 501 when the source can't re-fetch (rather than a bare AdapterRoleError → 500).
+            let source;
+            try {
+                source = flow.sourceSystem ? deps.registry.resolve(flow.sourceSystem) : undefined;
+            }
+            catch (_b) {
+                source = undefined;
+            }
+            if (typeof (source === null || source === void 0 ? void 0 : source.fetchByIds) !== 'function') {
+                throw new errors_1.NotImplementedError(`Retry is not supported for flow ${input.flowId}: its source (${(_a = flow.sourceSystem) !== null && _a !== void 0 ? _a : 'unknown'}) can't re-fetch records`);
+            }
+            const summary = await new sync_runner_1.SyncRunner(deps.registry).retryRecords({
+                flowId: input.flowId,
+                sourceIds: input.sourceIds,
+                options: { lookupStrategy: (0, helpers_1.resolveLookupStrategy)(deps.adapter) },
+            }, ctx);
+            return Object.assign({ flowId: input.flowId }, summary);
+        },
+    });
+}
+//# sourceMappingURL=retry-failed.action.js.map

package/dist/actions/sync/retry-failed.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-failed.action.js","sourceRoot":"","sources":["../../../src/actions/sync/retry-failed.action.ts"],"names":[],"mappings":";;AAcA,sDAiDC;AA/DD,4DAAwD;AACxD,wDAAgD;AAChD,8CAAyD;AACzD,4CAAwF;AACxF,0DAAsD;AAItD;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,IAAc;IAClD,OAAO,IAAA,4BAAY,EAAsC;QACvD,IAAI,EAAE,sBAAO,CAAC,IAAI,CAAC,WAAW;QAC9B,YAAY,EAAE,IAAI;QAClB,UAAU,CAAC,GAAG;YACZ,MAAM,GAAG,GAAG,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,CAA4B,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAK,GAAG,CAAC,MAAiB,IAAI,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,0BAAiB,CAAC,mCAAmC,CAAC,CAAC;YACnE,CAAC;YACD,0FAA0F;YAC1F,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;YACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,0BAAiB,CAAC,qCAAqC,CAAC,CAAC;YACrE,CAAC;YACD,mFAAmF;YACnF,wEAAwE;YACxE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAgB,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;;YACtB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,sBAAa,CAAC,gBAAgB,EAAE,QAAQ,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;YAC9E,CAAC;YACD,4FAA4F;YAC5F,2FAA2F;YAC3F,wFAAwF;YACxF,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACpF,CAAC;YAAC,WAAM,CAAC;gBACP,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YACD,IAAI,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;gBAC7C,MAAM,IAAI,4BAAmB,CAC3B,mCAAmC,KAAK,CAAC,MAAM,iBAAiB,MAAA,IAAI,CAAC,YAAY,mCAAI,SAAS,0BAA0B,CACzH,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAI,wBAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,YAAY,CAC9D;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,EAAE,cAAc,EAAE,IAAA,+BAAqB,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE;aACjE,EACD,GAAG,CACJ,CAAC;YACF,uBAAS,MAAM,EAAE,KAAK,CAAC,MAAM,IAAK,OAAO,EAAG;QAC9C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/actions/sync/types.d.ts

@@ -17,6 +17,17 @@ export type RunFlowOutput = {
     runId: string;
     flowId: number;
 } & RunCounts;
+export interface RetryFailedInput {
+    flowId: number;
+    /** Source-system record ids to retry — re-fetched via the adapter's fetchByIds. */
+    sourceIds: string[];
+}
+export interface RetryFailedOutput {
+    flowId: number;
+    requested: number;
+    succeeded: number;
+    failed: number;
+}
 export interface RunJobInput {
     webhookName: string;
 }

package/dist/actions/sync/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,MAAM,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC;AAIvE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,SAAS,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAEjG,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,MAAM,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC;AAIvE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AACD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,SAAS,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAEjG,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B"}

package/dist/actions/sync.action.d.ts

@@ -0,0 +1,26 @@
+import type { Adapter } from '../interfaces/adapter.interface';
+import type { AdapterRegistry } from '../adapters/adapter-registry';
+import type { BatchResult } from '../interfaces/sync-result.interface';
+import type { Action } from './utils/types';
+type SyncDeps = {
+    adapter: Adapter;
+    registry: AdapterRegistry;
+};
+export interface RunFlowInput {
+    flowId: number;
+    /** Manual backfill: sync from this time, overriding the persisted cursor. */
+    since?: Date;
+    /** Manual full resync: ignore the persisted cursor and pull everything. */
+    fullResync?: boolean;
+}
+export type RunFlowOutput = {
+    runId: string;
+    flowId: number;
+} & BatchResult;
+/**
+ * Manually run a single flow. Admin-only. Supports a one-off backfill (`since`)
+ * or full resync (`fullResync`) that overrides the persisted cursor.
+ */
+export declare function makeRunFlowAction(deps: SyncDeps): Action<RunFlowInput, RunFlowOutput>;
+export {};
+//# sourceMappingURL=sync.action.d.ts.map

package/dist/actions/sync.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.action.d.ts","sourceRoot":"","sources":["../../src/actions/sync.action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAOvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,KAAK,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC;AAahE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC;AAa5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAoDrF"}

package/dist/actions/sync.action.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRunFlowAction = makeRunFlowAction;
+const crypto_1 = require("crypto");
+const constants_1 = require("../constants");
+const sync_runner_1 = require("../services/sync-runner");
+const helpers_1 = require("../utils/helpers");
+const action_names_1 = require("./utils/action-names");
+const helpers_2 = require("./utils/helpers");
+const errors_1 = require("./utils/errors");
+function parsePositiveInt(raw, field) {
+    const obj = (raw !== null && raw !== void 0 ? raw : {});
+    const v = obj[field];
+    if (!Number.isInteger(v) || v <= 0) {
+        throw new errors_1.InvalidInputError(`${field} must be a positive integer`);
+    }
+    return v;
+}
+function parseSinceDate(value) {
+    if (typeof value !== 'string') {
+        throw new errors_1.InvalidInputError('since must be an ISO date-time string');
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new errors_1.InvalidInputError(`since is not a valid date-time: "${value}"`);
+    }
+    return date;
+}
+/**
+ * Manually run a single flow. Admin-only. Supports a one-off backfill (`since`)
+ * or full resync (`fullResync`) that overrides the persisted cursor.
+ */
+function makeRunFlowAction(deps) {
+    return {
+        name: action_names_1.ACTIONS.sync.runFlow,
+        parseInput(raw) {
+            const obj = (raw !== null && raw !== void 0 ? raw : {});
+            const input = { flowId: parsePositiveInt(raw, 'flowId') };
+            // fullResync takes precedence over since when both are supplied.
+            if (obj.fullResync === true) {
+                input.fullResync = true;
+            }
+            else if (obj.since !== undefined) {
+                input.since = parseSinceDate(obj.since);
+            }
+            return input;
+        },
+        async handler(input, ctx) {
+            var _a, _b;
+            if (!(0, helpers_1.isAdminRequest)(ctx.skedContext)) {
+                throw new errors_1.ActionError('FORBIDDEN', 'runFlow requires admin privileges');
+            }
+            const integrationType = deps.adapter.integrationType;
+            const lookupStrategy = (0, helpers_2.resolveLookupStrategy)(deps.adapter);
+            const runId = (0, crypto_1.randomUUID)();
+            const flow = await ctx.dataFlowService.getFlowById(input.flowId);
+            if (!flow) {
+                throw new errors_1.ActionError('FLOW_NOT_FOUND', `Flow ${input.flowId} not found`);
+            }
+            // overrideSince: undefined = normal resume, null = full resync, Date = backfill from time.
+            const overrideSince = input.fullResync ? null : input.since;
+            ctx.logger.info(`[run-flow] flowId=${input.flowId} runId=${runId} starting` +
+                (overrideSince === null
+                    ? ' (full resync)'
+                    : overrideSince
+                        ? ` (backfill since ${overrideSince.toISOString()})`
+                        : ''));
+            const stats = await new sync_runner_1.SyncRunner(deps.registry).run({
+                flowId: input.flowId,
+                since: null,
+                overrideSince,
+                sourceSystem: (_a = flow.sourceSystem) !== null && _a !== void 0 ? _a : integrationType,
+                targetSystem: (_b = flow.targetSystem) !== null && _b !== void 0 ? _b : constants_1.SKEDULO_SYSTEM,
+                options: { lookupStrategy },
+            }, ctx);
+            ctx.logger.info(`[run-flow] done: ${JSON.stringify(stats)}`);
+            return Object.assign({ runId, flowId: input.flowId }, stats);
+        },
+    };
+}
+//# sourceMappingURL=sync.action.js.map

package/dist/actions/sync.action.js.map

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

package/dist/actions/utils/action-names.d.ts

@@ -39,6 +39,7 @@ export declare const ACTIONS: Readonly<{
     readonly sync: Readonly<{
         runFlow: "sync.run-flow";
         runJob: "sync.run-job";
+        retryFailed: "sync.retry-failed";
     }>;
     readonly scheduledJob: Readonly<{
         create: "scheduled-job.create";

package/dist/actions/utils/action-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-names.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/action-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCT,CAAC;AAEZ,MAAM,MAAM,UAAU,GAClB,OAAO,OAAO,CAAC,YAAY,GAC3B,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC,GAClD,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,QAAQ,CAAC,GACxD,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,IAAI,CAAC,GAChD,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,YAAY,CAAC,GAChE,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC,GAClD,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"action-names.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/action-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCT,CAAC;AAEZ,MAAM,MAAM,UAAU,GAClB,OAAO,OAAO,CAAC,YAAY,GAC3B,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC,GAClD,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,QAAQ,CAAC,GACxD,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,IAAI,CAAC,GAChD,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,YAAY,CAAC,GAChE,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC,GAClD,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/actions/utils/action-names.js

@@ -42,6 +42,7 @@ exports.ACTIONS = Object.freeze({
     sync: Object.freeze({
         runFlow: 'sync.run-flow',
         runJob: 'sync.run-job',
+        retryFailed: 'sync.retry-failed',
     }),
     scheduledJob: Object.freeze({
         create: 'scheduled-job.create',

package/dist/actions/utils/action-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-names.js","sourceRoot":"","sources":["../../../src/actions/utils/action-names.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,aAAa,GAAG,yBAAyB,CAAC;AAEvD;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACU,QAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,UAAU,EAAE,sBAAsB;QAClC,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,wBAAwB;QACtC,aAAa,EAAE,0BAA0B;QACzC,gBAAgB,EAAE,6BAA6B;KAChD,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,cAAc;KACvB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,sBAAsB;QAC9B,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,mBAAmB;KACzB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,oBAAoB;QAC9B,UAAU,EAAE,sBAAsB;QAClC,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,mBAAmB;KAC7B,CAAC;CACM,CAAC,CAAC"}
+{"version":3,"file":"action-names.js","sourceRoot":"","sources":["../../../src/actions/utils/action-names.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,aAAa,GAAG,yBAAyB,CAAC;AAEvD;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACU,QAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,UAAU,EAAE,sBAAsB;QAClC,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,wBAAwB;QACtC,aAAa,EAAE,0BAA0B;QACzC,gBAAgB,EAAE,6BAA6B;KAChD,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,cAAc;QACtB,WAAW,EAAE,mBAAmB;KACjC,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,sBAAsB;QAC9B,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,mBAAmB;KACzB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,oBAAoB;QAC9B,UAAU,EAAE,sBAAsB;QAClC,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,mBAAmB;KAC7B,CAAC;CACM,CAAC,CAAC"}

package/dist/adapters/capabilities-defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities-defaults.d.ts","sourceRoot":"","sources":["../../src/adapters/capabilities-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGpF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAsBzE"}
+{"version":3,"file":"capabilities-defaults.d.ts","sourceRoot":"","sources":["../../src/adapters/capabilities-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGpF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CA8BzE"}

package/dist/adapters/capabilities-defaults.js

@@ -30,14 +30,20 @@ function resolveCapabilities(adapter) {
     const isTarget = roles.includes(constants_1.AdapterRole.TARGET);
     const outbound = (_c = (_b = caps === null || caps === void 0 ? void 0 : caps.realtime) === null || _b === void 0 ? void 0 : _b.outbound) !== null && _c !== void 0 ? _c : isTarget;
     const inbound = (_e = (_d = caps === null || caps === void 0 ? void 0 : caps.realtime) === null || _d === void 0 ? void 0 : _d.inbound) !== null && _e !== void 0 ? _e : false;
+    // Reflects the EXTERNAL adapter's re-fetch ability, so it gates INBOUND retry only
+    // (vendor is the source). Derived from method presence, not hand-declared — adding
+    // fetchByIds flips inbound retry on with nothing to keep in sync. Outbound flows
+    // source from Skedulo (always re-fetchable), so the UI treats them as always retryable.
+    const errorHandling = { retryable: typeof adapter.fetchByIds === 'function' };
     if (!caps) {
         return {
             allowNewDataFlows: false,
             hasDataFlows: false,
             roles,
             realtime: { outbound, inbound },
+            errorHandling,
         };
     }
-    return Object.assign(Object.assign({}, caps), { roles, realtime: { outbound, inbound } });
+    return Object.assign(Object.assign({}, caps), { roles, realtime: { outbound, inbound }, errorHandling });
 }
 //# sourceMappingURL=capabilities-defaults.js.map

package/dist/adapters/capabilities-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities-defaults.js","sourceRoot":"","sources":["../../src/adapters/capabilities-defaults.ts"],"names":[],"mappings":";;AAwBA,kDAsBC;AA7CD,4CAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,mBAAmB,CAAC,OAAgB;;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,MAAM,KAAK,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,mCAAI,CAAC,uBAAW,CAAC,MAAM,EAAE,uBAAW,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,uBAAW,CAAC,MAAM,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,0CAAE,QAAQ,mCAAI,QAAQ,CAAC;IACtD,MAAM,OAAO,GAAG,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,0CAAE,OAAO,mCAAI,KAAK,CAAC;IAEjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,KAAK;YACL,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,uCACK,IAAI,KACP,KAAK,EACL,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAC/B;AACJ,CAAC"}
+{"version":3,"file":"capabilities-defaults.js","sourceRoot":"","sources":["../../src/adapters/capabilities-defaults.ts"],"names":[],"mappings":";;AAwBA,kDA8BC;AArDD,4CAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,mBAAmB,CAAC,OAAgB;;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,MAAM,KAAK,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,mCAAI,CAAC,uBAAW,CAAC,MAAM,EAAE,uBAAW,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,uBAAW,CAAC,MAAM,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,0CAAE,QAAQ,mCAAI,QAAQ,CAAC;IACtD,MAAM,OAAO,GAAG,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,0CAAE,OAAO,mCAAI,KAAK,CAAC;IAEjD,mFAAmF;IACnF,mFAAmF;IACnF,iFAAiF;IACjF,wFAAwF;IACxF,MAAM,aAAa,GAAG,EAAE,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;IAE9E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,KAAK;YACL,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;YAC/B,aAAa;SACd,CAAC;IACJ,CAAC;IAED,uCACK,IAAI,KACP,KAAK,EACL,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC/B,aAAa,IACb;AACJ,CAAC"}

package/dist/adapters/skedulo-mutation-result.d.ts

@@ -0,0 +1,18 @@
+import type { UpsertOutcome } from '../interfaces/adapter.interface';
+interface MutationLike {
+    data?: {
+        schema?: Record<string, string | null> | null;
+    } | null;
+    errors?: unknown[];
+}
+export type ParsedMutation = {
+    attributed: true;
+    outcomes: UpsertOutcome[];
+} | {
+    attributed: false;
+    reason: string;
+};
+export declare function parseMutationResult(result: MutationLike, recordCount: number, operation: 'upsert' | 'insert' | 'update'): ParsedMutation;
+export declare function classifySkeduloError(message: string): 'transient' | 'permanent';
+export {};
+//# sourceMappingURL=skedulo-mutation-result.d.ts.map

package/dist/adapters/skedulo-mutation-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skedulo-mutation-result.d.ts","sourceRoot":"","sources":["../../src/adapters/skedulo-mutation-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAerE,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAChE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GAC/C;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA0B1C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GACxC,cAAc,CAoEhB;AA8BD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAE/E"}

package/dist/adapters/skedulo-mutation-result.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMutationResult = parseMutationResult;
+exports.classifySkeduloError = classifySkeduloError;
+const helpers_1 = require("../utils/helpers");
+const ALIAS_RE = /^alias(\d+)$/;
+// GraphQL error `path` for our mutation is ["schema", "alias<N>"]. Return the 1-based N,
+// or null when no alias segment is present (a request/document-level error).
+function aliasIndexOf(err) {
+    const path = err === null || err === void 0 ? void 0 : err.path;
+    if (!Array.isArray(path))
+        return null;
+    for (const seg of path) {
+        if (typeof seg === 'string') {
+            const m = ALIAS_RE.exec(seg);
+            if (m)
+                return Number(m[1]);
+        }
+    }
+    return null;
+}
+function messageOf(err) {
+    var _a;
+    const m = err === null || err === void 0 ? void 0 : err.message;
+    if (typeof m === 'string' && m.length > 0)
+        return m;
+    // JSON.stringify(undefined) and stringifying a function both yield undefined — guard so
+    // callers (truncate, classifySkeduloError) always receive a string.
+    return (_a = JSON.stringify(err)) !== null && _a !== void 0 ? _a : 'unknown error';
+}
+function parseMutationResult(result, recordCount, operation) {
+    var _a, _b;
+    const errors = Array.isArray(result === null || result === void 0 ? void 0 : result.errors) ? result.errors : [];
+    // Split errors into per-record (alias in range) and document-level (no alias, or an alias
+    // outside this batch — a server contract violation we can't tie to a record).
+    const errByIndex = new Map();
+    let docLevelMessage = null;
+    for (const err of errors) {
+        const alias = aliasIndexOf(err);
+        const idx = alias === null ? null : alias - 1; // 1-based alias → 0-based record index
+        if (idx === null || idx < 0 || idx >= recordCount) {
+            if (docLevelMessage === null)
+                docLevelMessage = messageOf(err);
+            continue;
+        }
+        if (!errByIndex.has(idx))
+            errByIndex.set(idx, messageOf(err));
+    }
+    const schema = (_a = result === null || result === void 0 ? void 0 : result.data) === null || _a === void 0 ? void 0 : _a.schema;
+    // No schema at all — we can't read a single UID, so nothing here is a CONFIRMED success.
+    // Re-probe one at a time (also the shape of a thrown/validation failure). Because nothing
+    // is confirmed, re-issuing is safe (the one exception — a commit that then threw client-side
+    // — is inherent at-least-once for a non-idempotent insert; see _mutate).
+    if (schema === undefined || schema === null) {
+        return {
+            attributed: false,
+            reason: docLevelMessage !== null && docLevelMessage !== void 0 ? docLevelMessage : (errors.length > 0 ? 'errors without data.schema' : 'empty response (no data.schema)'),
+        };
+    }
+    // Schema present ⇒ we can read every survivor's UID by key, so we attribute in place and
+    // NEVER fall back. Re-issuing a record that already has a UID would duplicate it.
+    const outcomes = [];
+    for (let i = 0; i < recordCount; i++) {
+        const errMsg = errByIndex.get(i);
+        if (errMsg !== undefined) {
+            outcomes.push({ status: classifySkeduloError(errMsg), error: (0, helpers_1.truncate)(errMsg) });
+            continue;
+        }
+        const uid = (_b = schema[`alias${i + 1}`]) !== null && _b !== void 0 ? _b : null;
+        if (uid !== null) {
+            outcomes.push({ status: 'ok', result: uid }); // confirmed success — never re-issued
+            continue;
+        }
+        // No UID for this record and no per-alias error naming it. Only a DOCUMENT-level error
+        // (unattributable, whole-request) casts doubt here — then don't assume it landed. A
+        // per-alias error on OTHER records says nothing about this one, so we must not mass-fail
+        // no-UID records just because a sibling failed (some successful update/upsert writes may
+        // legitimately return no UID). Falls through to the insert/update defaults otherwise.
+        if (docLevelMessage !== null) {
+            outcomes.push({
+                status: classifySkeduloError(docLevelMessage),
+                error: (0, helpers_1.truncate)(docLevelMessage),
+            });
+            continue;
+        }
+        if (operation === 'insert') {
+            outcomes.push({
+                status: 'precondition',
+                error: 'insert returned no UID — IntegrationIdMapping may not be bootstrapped (run /setup then /on-initial-sync)',
+            });
+            continue;
+        }
+        outcomes.push({ status: 'ok', result: null });
+    }
+    return { attributed: true, outcomes };
+}
+// Fallback classifier for a Skedulo write error message, used only when the adapter didn't
+// supply an errorClass (batch-level throws, mapping write-back). Transient = worth retrying
+// (infra); permanent = won't change on retry (data). Prefer the adapter's own class
+// (`classifyHttpStatus` in base.adapter.ts, from the HTTP status) — this is the last resort.
+// Keyword-only on purpose: bare HTTP-status patterns (5xx / 429) were removed because this
+// fallback only ever sees map/batch-throw text, which carries no genuine status code, so a
+// number in prose would misclassify a permanent failure as transient and (with zero successes)
+// wrongly trip decideCursor's outage hold — re-wedging the flow this feature exists to unwedge.
+const TRANSIENT_ERROR = new RegExp([
+    'deadlock',
+    'lock (wait )?timeout',
+    'timeout',
+    'timed out',
+    'temporarily unavailable',
+    'service unavailable',
+    'too many requests',
+    'rate ?limit',
+    'throttl',
+    'econnreset',
+    'connection reset',
+    'socket hang up',
+    '(token|session|credentials?) expired',
+    'expired (token|session)',
+].join('|'), 'i');
+function classifySkeduloError(message) {
+    return TRANSIENT_ERROR.test(message) ? 'transient' : 'permanent';
+}
+//# sourceMappingURL=skedulo-mutation-result.js.map

package/dist/adapters/skedulo-mutation-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skedulo-mutation-result.js","sourceRoot":"","sources":["../../src/adapters/skedulo-mutation-result.ts"],"names":[],"mappings":";;AAgDA,kDAwEC;AA8BD,oDAEC;AAvJD,8CAA4C;AAuB5C,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,yFAAyF;AACzF,6EAA6E;AAC7E,SAAS,YAAY,CAAC,GAAY;IAChC,MAAM,IAAI,GAAI,GAAiC,aAAjC,GAAG,uBAAH,GAAG,CAAgC,IAAI,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;;IAC7B,MAAM,CAAC,GAAI,GAAoC,aAApC,GAAG,uBAAH,GAAG,CAAmC,OAAO,CAAC;IACzD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpD,wFAAwF;IACxF,oEAAoE;IACpE,OAAO,MAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,mCAAI,eAAe,CAAC;AAChD,CAAC;AAED,SAAgB,mBAAmB,CACjC,MAAoB,EACpB,WAAmB,EACnB,SAAyC;;IAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,0FAA0F;IAC1F,8EAA8E;IAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,uCAAuC;QACtF,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YAClD,IAAI,eAAe,KAAK,IAAI;gBAAE,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,0CAAE,MAAM,CAAC;IACpC,yFAAyF;IACzF,0FAA0F;IAC1F,6FAA6F;IAC7F,yEAAyE;IACzE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,MAAM,EACJ,eAAe,aAAf,eAAe,cAAf,eAAe,GACf,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,iCAAiC,CAAC;SACzF,CAAC;IACJ,CAAC;IAED,yFAAyF;IACzF,kFAAkF;IAClF,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAA,kBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjF,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAA,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,mCAAI,IAAI,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,sCAAsC;YACpF,SAAS;QACX,CAAC;QACD,uFAAuF;QACvF,oFAAoF;QACpF,yFAAyF;QACzF,yFAAyF;QACzF,sFAAsF;QACtF,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,oBAAoB,CAAC,eAAe,CAAC;gBAC7C,KAAK,EAAE,IAAA,kBAAQ,EAAC,eAAe,CAAC;aACjC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,cAAc;gBACtB,KAAK,EACH,0GAA0G;aAC7G,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACxC,CAAC;AAED,2FAA2F;AAC3F,4FAA4F;AAC5F,oFAAoF;AACpF,6FAA6F;AAC7F,2FAA2F;AAC3F,2FAA2F;AAC3F,+FAA+F;AAC/F,gGAAgG;AAChG,MAAM,eAAe,GAAG,IAAI,MAAM,CAChC;IACE,UAAU;IACV,sBAAsB;IACtB,SAAS;IACT,WAAW;IACX,yBAAyB;IACzB,qBAAqB;IACrB,mBAAmB;IACnB,aAAa;IACb,SAAS;IACT,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;IAChB,sCAAsC;IACtC,yBAAyB;CAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,EACX,GAAG,CACJ,CAAC;AAEF,SAAgB,oBAAoB,CAAC,OAAe;IAClD,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;AACnE,CAAC"}

package/dist/adapters/skedulo.adapter.d.ts

@@ -16,10 +16,14 @@ export declare class SkeduloAdapter implements Adapter<Record<string, unknown>>
     checkBootstrap(ctx: IntegrationContext): Promise<BootstrapStatus>;
     bootstrap(ctx: IntegrationContext): Promise<void>;
     fetch(ctx: IntegrationContext, flow: DataFlow, since: Date | null, _filter: FilterSpec | null): AsyncIterable<Record<string, unknown>[]>;
+    fetchByIds(ctx: IntegrationContext, flow: DataFlow, ids: string[]): Promise<Record<string, unknown>[]>;
     resolveLookups(ctx: IntegrationContext, flow: DataFlow, pairs: EnrichmentPair[]): Promise<void>;
     upsert(ctx: IntegrationContext, flow: DataFlow, records: Record<string, unknown>[]): Promise<UpsertOutcome[]>;
     private _attribution;
     private _mutate;
+    private _rawMutate;
+    private _mutateEachSeparately;
+    private _mutateSingle;
     delete(ctx: IntegrationContext, flow: DataFlow, ids: string[]): Promise<void>;
     /** Delete by Skedulo UID directly — used by IdMappingSyncStrategy after mapping table lookup. */
     deleteById(ctx: IntegrationContext, flow: DataFlow, ids: string[]): Promise<void>;

package/dist/adapters/skedulo.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skedulo.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/skedulo.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACd,MAAM,iCAAiC,CAAC;AAezC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD,qBAAa,cAAe,YAAW,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,QAAQ,CAAC,eAAe,aAAkB;IAE1C,QAAQ,CAAC,YAAY;;;;MAIV;IAIX,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAMlE,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIjE,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,KAAK,CACV,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,IAAI,GAAG,IAAI,EAClB,OAAO,EAAE,UAAU,GAAG,IAAI,GACzB,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAoCrC,cAAc,CAClB,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC;IAyCV,MAAM,CACV,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IAqE3B,OAAO,CAAC,YAAY;YAYN,OAAO;IAkDf,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnF,iGAAiG;IAC3F,UAAU,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvF,gBAAgB,IAAI,MAAM;IAI1B,mBAAmB,CACjB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,aAAa,EAAE,GACxB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ1C,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO1D,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAe5E,kBAAkB,CACtB,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC;IAa1B;;;;;OAKG;YACW,mBAAmB;YA4BnB,YAAY;CA+B3B;AASD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}
+{"version":3,"file":"skedulo.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/skedulo.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACd,MAAM,iCAAiC,CAAC;AAsBzC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD,qBAAa,cAAe,YAAW,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,QAAQ,CAAC,eAAe,aAAkB;IAE1C,QAAQ,CAAC,YAAY;;;;MAIV;IAIX,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAMlE,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIjE,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,KAAK,CACV,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,IAAI,GAAG,IAAI,EAClB,OAAO,EAAE,UAAU,GAAG,IAAI,GACzB,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAoCrC,UAAU,CACd,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAuB/B,cAAc,CAClB,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC;IAyCV,MAAM,CACV,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IAqE3B,OAAO,CAAC,YAAY;YAYN,OAAO;YAkCP,UAAU;YAgCV,qBAAqB;YA2DrB,aAAa;IAwBrB,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnF,iGAAiG;IAC3F,UAAU,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvF,gBAAgB,IAAI,MAAM;IAI1B,mBAAmB,CACjB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,aAAa,EAAE,GACxB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ1C,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO1D,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAe5E,kBAAkB,CACtB,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC;IAa1B;;;;;OAKG;YACW,mBAAmB;YA4BnB,YAAY;CA+B3B;AASD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}