@skedulo/integration-sdk 0.2.3 → 0.3.0

package/dist/services/sync-runner.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SyncRunner = exports.AdapterNotRegisteredError = void 0;
+exports.SyncRunner = exports.AdapterNotRegisteredError = exports.AdapterRoleError = void 0;
+const constants_1 = require("../constants");
+const adapter_registry_1 = require("../adapters/adapter-registry");
 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");
@@ -29,6 +31,13 @@ const sync_service_1 = require("./sync.service");
 //
 //   // Event-driven:
 //   await runner.handleEvent({ event, options: { lookupStrategy: 'idMapping' } }, ctx)
+class AdapterRoleError extends Error {
+    constructor(systemName, requiredRole) {
+        super(`adapter "${systemName}" does not support role: "${requiredRole}"`);
+        this.name = 'AdapterRoleError';
+    }
+}
+exports.AdapterRoleError = AdapterRoleError;
 class AdapterNotRegisteredError extends Error {
     constructor(systemName) {
         super(`adapter not registered for system: "${systemName}"`);
@@ -37,11 +46,13 @@ class AdapterNotRegisteredError extends Error {
 }
 exports.AdapterNotRegisteredError = AdapterNotRegisteredError;
 class SyncRunner {
-    constructor() {
-        this.registry = new Map();
+    // Accept either an existing AdapterRegistry (shared with the consumer's
+    // metadata handler — single source of truth) or none (built up via register()).
+    constructor(registry) {
+        this.registry = registry !== null && registry !== void 0 ? registry : new adapter_registry_1.AdapterRegistry({});
     }
     register(systemName, adapter) {
-        this.registry.set(systemName, adapter);
+        this.registry.register(systemName, adapter);
     }
     // Run a full batch sync for a known flow.
     // Fetches the flow by ID, resolves adapters, delegates to SyncService.run().
@@ -55,8 +66,8 @@ class SyncRunner {
                 ctx.logger.warn(`sync_runner_run: flow ${args.flowId} not found`);
                 return { succeeded: 0, filtered: 0, skipped: 0, failed: 0, dlqWrites: 0 };
             }
-            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);
+            const source = this._resolve((_b = (_a = flow.sourceSystem) !== null && _a !== void 0 ? _a : args.sourceSystem) !== null && _b !== void 0 ? _b : null, constants_1.AdapterRole.SOURCE);
+            const target = this._resolve((_d = (_c = flow.targetSystem) !== null && _c !== void 0 ? _c : args.targetSystem) !== null && _d !== void 0 ? _d : null, constants_1.AdapterRole.TARGET);
             const strategy = createSyncStrategy((_e = args.options) !== null && _e !== void 0 ? _e : {}, ctx);
             // Cursor computation: prefer flow.lastRunAt over caller-supplied since.
             // When lastRunAt is set, args.since is ignored entirely.
@@ -65,19 +76,25 @@ class SyncRunner {
             const overlapMs = (_h = (_g = args.options) === null || _g === void 0 ? void 0 : _g.cursorOverlapMs) !== null && _h !== void 0 ? _h : 60000;
             const effectiveCursor = lastRunAt ? new Date(lastRunAt.getTime() - overlapMs) : null; // null = full sync (no prior run)
             const result = await new sync_service_1.SyncService(source, target, strategy).run({ flow, since: effectiveCursor }, ctx);
-            // Cursor persistence: always advance, even when result has zero succeeded/skipped/filtered.
-            // An empty run means "nothing in this window changed" — the window is still fully accounted for.
-            // Swallow failures — sync succeeded, next run retries the same window.
-            try {
-                await ctx.dataFlowService.updateCursor(args.flowId, runStartedAt);
+            // Cursor persistence: only advance when no records failed in this run.
+            // Advancing on partial failure would skip the failed records on the next run,
+            // since the new cursor would be past their LastModifiedDate.
+            // Zero failures with zero succeeded is still success — the window had no changes.
+            if (result.failed === 0) {
+                try {
+                    await ctx.dataFlowService.updateCursor(args.flowId, runStartedAt);
+                }
+                catch (err) {
+                    ctx.logger.error(`update_cursor_failed: flowId=${args.flowId} error="${err instanceof Error ? err.message : String(err)}" — next run will re-process same window`);
+                }
             }
-            catch (err) {
-                ctx.logger.error(`update_cursor_failed: flowId=${args.flowId} error="${err instanceof Error ? err.message : String(err)}" — next run will re-process same window`);
+            else {
+                ctx.logger.warn(`cursor_not_advanced: flowId=${args.flowId} failed=${result.failed} — next run will re-process same window so failed records can retry`);
             }
             return result;
         }
         catch (err) {
-            if (err instanceof AdapterNotRegisteredError) {
+            if (err instanceof AdapterNotRegisteredError || err instanceof AdapterRoleError) {
                 ctx.logger.error(`sync_runner_run: ${err.message} flowId=${args.flowId}`);
                 return { succeeded: 0, filtered: 0, skipped: 0, failed: 1, dlqWrites: 0 };
             }
@@ -103,13 +120,13 @@ class SyncRunner {
         const results = [];
         for (const flow of sorted) {
             try {
-                const target = this._resolve((_a = flow.targetSystem) !== null && _a !== void 0 ? _a : null);
+                const target = this._resolve((_a = flow.targetSystem) !== null && _a !== void 0 ? _a : null, constants_1.AdapterRole.TARGET);
                 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) {
-                if (err instanceof AdapterNotRegisteredError) {
+                if (err instanceof AdapterNotRegisteredError || err instanceof AdapterRoleError) {
                     ctx.logger.error(`sync_runner_event: ${err.message} flowId=${flow.id}`);
                     results.push({ status: 'failed', recordsProcessed: 0, error: err.message });
                 }
@@ -122,18 +139,27 @@ class SyncRunner {
         }
         return results;
     }
-    _resolve(systemName) {
+    _resolve(systemName, role) {
+        var _a, _b;
         if (!systemName)
             throw new AdapterNotRegisteredError(String(systemName));
-        const adapter = this.registry.get(systemName);
-        if (!adapter)
+        let adapter;
+        try {
+            adapter = this.registry.resolve(systemName);
+        }
+        catch (_c) {
             throw new AdapterNotRegisteredError(systemName);
+        }
+        const roles = (_b = (_a = adapter.capabilities) === null || _a === void 0 ? void 0 : _a.roles) !== null && _b !== void 0 ? _b : [constants_1.AdapterRole.SOURCE, constants_1.AdapterRole.TARGET];
+        if (!roles.includes(role)) {
+            throw new AdapterRoleError(systemName, role);
+        }
         return adapter;
     }
 }
 exports.SyncRunner = SyncRunner;
 function createSyncStrategy(options, _ctx) {
-    if (options.lookupStrategy === 'idMapping') {
+    if (options.lookupStrategy === constants_1.LookupStrategy.IdMapping) {
         return new id_mapping_sync_strategy_1.IdMappingSyncStrategy(new id_mapping_service_1.IdMappingService());
     }
     return new external_id_sync_strategy_1.ExternalIdSyncStrategy();

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/testing/adapter-contract.d.ts

@@ -0,0 +1,24 @@
+import type { Adapter } from '../interfaces/adapter.interface';
+import type { ProxyResult } from '../clients/proxy.client';
+export interface AdapterContractConfig {
+    /** Factory producing a fresh adapter instance for each test. */
+    createAdapter: () => Adapter;
+    /**
+     * Override the expected default record ID field if your adapter
+     * customizes `getRecordIdField()`. Defaults to `'id'` — matches
+     * BaseAdapter's default.
+     */
+    expectedRecordIdField?: string;
+}
+export declare function runAdapterContractTests(config: AdapterContractConfig): void;
+/**
+ * Build a `ProxyResult` envelope for use in test mocks. Every test ends up
+ * writing `{ status: 200, headers: {}, output: ... }` by hand; this helper
+ * makes the intent obvious and lets you override status/headers when
+ * exercising stale-mapping or 503-retry paths.
+ */
+export declare function mockProxyResult<T>(output: T, overrides?: {
+    status?: number;
+    headers?: Record<string, string>;
+}): ProxyResult<T>;
+//# sourceMappingURL=adapter-contract.d.ts.map

package/dist/testing/adapter-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-contract.d.ts","sourceRoot":"","sources":["../../src/testing/adapter-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAsB3D,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAoE3E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,EACT,SAAS,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GACpE,WAAW,CAAC,CAAC,CAAC,CAMhB"}

package/dist/testing/adapter-contract.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAdapterContractTests = runAdapterContractTests;
+exports.mockProxyResult = mockProxyResult;
+const constants_1 = require("../constants");
+function runAdapterContractTests(config) {
+    const { createAdapter, expectedRecordIdField = 'id' } = config;
+    describe('Adapter SDK contract', () => {
+        it('declares a non-empty integrationType', () => {
+            const adapter = createAdapter();
+            expect(typeof adapter.integrationType).toBe('string');
+            expect(adapter.integrationType.length).toBeGreaterThan(0);
+        });
+        it('declares capabilities.roles with at least one valid role', () => {
+            var _a;
+            const adapter = createAdapter();
+            const roles = (_a = adapter.capabilities) === null || _a === void 0 ? void 0 : _a.roles;
+            expect(Array.isArray(roles)).toBe(true);
+            expect(roles.length).toBeGreaterThan(0);
+            for (const role of roles) {
+                expect(Object.values(constants_1.AdapterRole)).toContain(role);
+            }
+        });
+        it('declares a valid lookupStrategy when capabilities.lookupStrategy is set', () => {
+            var _a;
+            const adapter = createAdapter();
+            const ls = (_a = adapter.capabilities) === null || _a === void 0 ? void 0 : _a.lookupStrategy;
+            if (ls !== undefined) {
+                expect(Object.values(constants_1.LookupStrategy)).toContain(ls);
+            }
+        });
+        it('getRecordIdField returns the expected field', () => {
+            var _a;
+            const adapter = createAdapter();
+            expect((_a = adapter.getRecordIdField) === null || _a === void 0 ? void 0 : _a.call(adapter)).toBe(expectedRecordIdField);
+        });
+        describe('buildMappingEntries default behaviour', () => {
+            it('returns [] for empty inputs', () => {
+                var _a;
+                const adapter = createAdapter();
+                expect((_a = adapter.buildMappingEntries) === null || _a === void 0 ? void 0 : _a.call(adapter, [], [])).toEqual([]);
+            });
+            it('zips sourceIds with outcome results in order', () => {
+                var _a;
+                const adapter = createAdapter();
+                const result = (_a = adapter.buildMappingEntries) === null || _a === void 0 ? void 0 : _a.call(adapter, ['s1', 's2'], [
+                    { status: 'ok', result: 't1' },
+                    { status: 'ok', result: 't2' },
+                ]);
+                expect(result).toEqual([
+                    { sourceId: 's1', targetId: 't1' },
+                    { sourceId: 's2', targetId: 't2' },
+                ]);
+            });
+            it('drops entries whose target result is empty or missing', () => {
+                var _a;
+                const adapter = createAdapter();
+                const result = (_a = adapter.buildMappingEntries) === null || _a === void 0 ? void 0 : _a.call(adapter, ['s1', 's2', 's3'], [
+                    { status: 'ok', result: 't1' },
+                    { status: 'ok', result: '' },
+                    { status: 'permanent', error: 'x' },
+                ]);
+                expect(result).toEqual([{ sourceId: 's1', targetId: 't1' }]);
+            });
+        });
+    });
+}
+/**
+ * Build a `ProxyResult` envelope for use in test mocks. Every test ends up
+ * writing `{ status: 200, headers: {}, output: ... }` by hand; this helper
+ * makes the intent obvious and lets you override status/headers when
+ * exercising stale-mapping or 503-retry paths.
+ */
+function mockProxyResult(output, overrides = {}) {
+    var _a, _b;
+    return {
+        status: (_a = overrides.status) !== null && _a !== void 0 ? _a : 200,
+        headers: (_b = overrides.headers) !== null && _b !== void 0 ? _b : {},
+        output,
+    };
+}
+//# sourceMappingURL=adapter-contract.js.map

package/dist/testing/adapter-contract.js.map

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

package/dist/utils/auth.d.ts

@@ -0,0 +1,6 @@
+import type { SkedResponse } from './http-response';
+export declare function isAdminRequest(skedContext: unknown): boolean;
+export declare function requireAdmin(skedContext: unknown, operation: string): SkedResponse<{
+    message: string;
+}> | null;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,wBAAgB,cAAc,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,GAChB,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAM1C"}

package/dist/utils/auth.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAdminRequest = isAdminRequest;
+exports.requireAdmin = requireAdmin;
+function isAdminRequest(skedContext) {
+    var _a, _b;
+    const ctx = skedContext;
+    return ((_b = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.userContext) === null || _a === void 0 ? void 0 : _a.userRoles) === null || _b === void 0 ? void 0 : _b.includes('administrator')) === true;
+}
+function requireAdmin(skedContext, operation) {
+    if (isAdminRequest(skedContext))
+        return null;
+    return {
+        status: 403,
+        body: { message: `${operation} requires admin privileges` },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":";;AAEA,wCAGC;AAED,oCASC;AAdD,SAAgB,cAAc,CAAC,WAAoB;;IACjD,MAAM,GAAG,GAAG,WAA4E,CAAC;IACzF,OAAO,CAAA,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,WAAW,0CAAE,SAAS,0CAAE,QAAQ,CAAC,eAAe,CAAC,MAAK,IAAI,CAAC;AACzE,CAAC;AAED,SAAgB,YAAY,CAC1B,WAAoB,EACpB,SAAiB;IAEjB,IAAI,cAAc,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,SAAS,4BAA4B,EAAE;KAC5D,CAAC;AACJ,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,23 @@
+import type { DataFlow } from '../interfaces/data-flow-spec.interface';
+export declare function escapeEqlString(value: string): string;
+export declare function unwrapProxy<T = unknown>(raw: unknown): T;
+export declare function getQueryParam(querystring: string | Record<string, string> | null | undefined, key: string): string | undefined;
+export declare function humanizeFieldName(name: string): string;
+export interface SkedResponse<T = unknown> {
+    status: number;
+    body: T;
+}
+export declare function okResponse<T extends object = Record<string, unknown>>(message: string, data?: T): SkedResponse<{
+    message: string;
+} & T>;
+export declare function errorResponse(error: unknown): SkedResponse<{
+    requestId: string;
+    status: number;
+    message: string;
+}>;
+export declare function isAdminRequest(skedContext: unknown): boolean;
+export declare function requireAdmin(skedContext: unknown, operation: string): SkedResponse<{
+    message: string;
+}> | null;
+export declare function normalizeDataFlow(flow: DataFlow): DataFlow;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAMvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAID,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAKxD;AAED,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/D,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAMpB;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,CAAC,GACP,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,CAAC,CAKvC;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAuBD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,GAChB,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAM1C;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAW1D"}

package/dist/utils/helpers.js

@@ -0,0 +1,118 @@
+"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.escapeEqlString = escapeEqlString;
+exports.unwrapProxy = unwrapProxy;
+exports.getQueryParam = getQueryParam;
+exports.humanizeFieldName = humanizeFieldName;
+exports.okResponse = okResponse;
+exports.errorResponse = errorResponse;
+exports.isAdminRequest = isAdminRequest;
+exports.requireAdmin = requireAdmin;
+exports.normalizeDataFlow = normalizeDataFlow;
+const crypto_1 = require("crypto");
+// 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, "\\'");
+}
+// The Skedulo integration proxy wraps responses in { status, headers, output }.
+// Returns .output when present, otherwise the raw value.
+function unwrapProxy(raw) {
+    if (raw != null && typeof raw === 'object' && 'output' in raw) {
+        return raw.output;
+    }
+    return raw;
+}
+function getQueryParam(querystring, key) {
+    var _a;
+    if (!querystring)
+        return undefined;
+    if (typeof querystring === 'string') {
+        return (_a = new URLSearchParams(querystring).get(key)) !== null && _a !== void 0 ? _a : undefined;
+    }
+    return querystring[key];
+}
+// Convert camelCase / PascalCase identifier to a human-readable Title Case label.
+// "firstName" -> "First Name", "AccountId" -> "Account Id", "email" -> "Email".
+function humanizeFieldName(name) {
+    if (!name)
+        return '';
+    return name
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/^./, (c) => c.toUpperCase())
+        .trim();
+}
+function okResponse(message, data) {
+    return {
+        status: 200,
+        body: Object.assign({ message }, (data !== null && data !== void 0 ? data : {})),
+    };
+}
+// Build the Skedulo-integration-convention error envelope from any thrown value.
+// Status precedence: Axios-style err.response.status → top-level err.status (if 4xx/5xx) → 500.
+// Generates a requestId UUID and logs via console.error so support can correlate.
+function errorResponse(error) {
+    var _a, _b, _c, _d;
+    const requestId = (0, crypto_1.randomUUID)();
+    const err = error;
+    const upstreamStatus = (_a = err === null || err === void 0 ? void 0 : err.response) === null || _a === void 0 ? void 0 : _a.status;
+    const carriedStatus = typeof (err === null || err === void 0 ? void 0 : err.status) === 'number' && err.status >= 400 && err.status <= 599
+        ? err.status
+        : undefined;
+    const status = (_b = upstreamStatus !== null && upstreamStatus !== void 0 ? upstreamStatus : carriedStatus) !== null && _b !== void 0 ? _b : 500;
+    const message = (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : String(error);
+    console.error(`[${requestId}] Error details:`, {
+        message,
+        status,
+        hasData: ((_d = err === null || err === void 0 ? void 0 : err.response) === null || _d === void 0 ? void 0 : _d.data) != null,
+    });
+    return { status, body: { requestId, status, message } };
+}
+function isAdminRequest(skedContext) {
+    var _a, _b;
+    const ctx = skedContext;
+    return ((_b = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.userContext) === null || _a === void 0 ? void 0 : _a.userRoles) === null || _b === void 0 ? void 0 : _b.includes('administrator')) === true;
+}
+function requireAdmin(skedContext, operation) {
+    if (isAdminRequest(skedContext))
+        return null;
+    return {
+        status: 403,
+        body: { message: `${operation} requires admin privileges` },
+    };
+}
+// 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), lastRunAt: (() => {
+            if (!flow.lastRunAt)
+                return null;
+            if (flow.lastRunAt instanceof Date)
+                return flow.lastRunAt;
+            const d = new Date(flow.lastRunAt);
+            return isNaN(d.getTime()) ? null : d;
+        })() });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/http-response.d.ts

@@ -0,0 +1,16 @@
+export interface SkedResponse<T = unknown> {
+    status: number;
+    body: T;
+}
+export declare function createSuccessResponse<T extends object = Record<string, unknown>>(message: string, data?: T): SkedResponse<{
+    message: string;
+} & T>;
+export declare function handleError(error: unknown): SkedResponse<{
+    requestId: string;
+    status: number | null;
+    message: string;
+}>;
+export declare function handleMetadataError(err: unknown): SkedResponse<{
+    message: string;
+} | unknown>;
+//# sourceMappingURL=http-response.d.ts.map

package/dist/utils/http-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-response.d.ts","sourceRoot":"","sources":["../../src/utils/http-response.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9E,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,CAAC,GACP,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,CAAC,CAKvC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAgBD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,CAK7F"}

package/dist/utils/http-response.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSuccessResponse = createSuccessResponse;
+exports.handleError = handleError;
+exports.handleMetadataError = handleMetadataError;
+const crypto_1 = require("crypto");
+const metadata_handler_1 = require("../handlers/metadata.handler");
+function createSuccessResponse(message, data) {
+    return {
+        status: 200,
+        body: Object.assign({ message }, (data !== null && data !== void 0 ? data : {})),
+    };
+}
+function handleError(error) {
+    var _a, _b, _c;
+    const requestId = (0, crypto_1.randomUUID)();
+    const err = error;
+    const upstreamStatus = (_a = err === null || err === void 0 ? void 0 : err.response) === null || _a === void 0 ? void 0 : _a.status;
+    const message = (_b = err === null || err === void 0 ? void 0 : err.message) !== null && _b !== void 0 ? _b : String(error);
+    console.error(`[${requestId}] Error details:`, {
+        message,
+        status: upstreamStatus,
+        data: (_c = err === null || err === void 0 ? void 0 : err.response) === null || _c === void 0 ? void 0 : _c.data,
+    });
+    return {
+        status: upstreamStatus !== null && upstreamStatus !== void 0 ? upstreamStatus : 500,
+        body: { requestId, status: upstreamStatus !== null && upstreamStatus !== void 0 ? upstreamStatus : null, message },
+    };
+}
+function handleMetadataError(err) {
+    if (err instanceof metadata_handler_1.MetadataHandlerError) {
+        return { status: err.status, body: { message: err.message } };
+    }
+    return handleError(err);
+}
+//# sourceMappingURL=http-response.js.map

package/dist/utils/http-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-response.js","sourceRoot":"","sources":["../../src/utils/http-response.ts"],"names":[],"mappings":";;AAQA,sDAQC;AAED,kCAoBC;AAED,kDAKC;AA7CD,mCAAoC;AACpC,mEAAoE;AAOpE,SAAgB,qBAAqB,CACnC,OAAe,EACf,IAAQ;IAER,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,gBAAE,OAAO,IAAK,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAK,EAAQ,CAAC,CAA6B;KACrE,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAC,KAAc;;IAKxC,MAAM,SAAS,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,KAAoF,CAAC;IACjG,MAAM,cAAc,GAAG,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ,0CAAE,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,mCAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,kBAAkB,EAAE;QAC7C,OAAO;QACP,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ,0CAAE,IAAI;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,GAAG;QAC7B,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,IAAI,EAAE,OAAO,EAAE;KAC7D,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,YAAY,uCAAoB,EAAE,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/query-string.d.ts

@@ -0,0 +1,2 @@
+export declare function getQueryParam(querystring: string | Record<string, string> | null | undefined, key: string): string | undefined;
+//# sourceMappingURL=query-string.d.ts.map

package/dist/utils/query-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-string.d.ts","sourceRoot":"","sources":["../../src/utils/query-string.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/D,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAMpB"}

package/dist/utils/query-string.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQueryParam = getQueryParam;
+function getQueryParam(querystring, key) {
+    var _a;
+    if (!querystring)
+        return undefined;
+    if (typeof querystring === 'string') {
+        return (_a = new URLSearchParams(querystring).get(key)) !== null && _a !== void 0 ? _a : undefined;
+    }
+    return querystring[key];
+}
+//# sourceMappingURL=query-string.js.map

package/dist/utils/query-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-string.js","sourceRoot":"","sources":["../../src/utils/query-string.ts"],"names":[],"mappings":";;AAAA,sCASC;AATD,SAAgB,aAAa,CAC3B,WAA+D,EAC/D,GAAW;;IAEX,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,MAAA,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,SAAS,CAAC;IAChE,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/sked-handler.d.ts

@@ -0,0 +1,22 @@
+export type HttpVerb = 'get' | 'post' | 'put' | 'patch' | 'delete';
+export interface SkedRoute {
+    method: HttpVerb;
+    path: string;
+    handler: (body: Record<string, unknown>, headers: Record<string, string>, method: string, path: string, skedContext: unknown, querystring?: string | Record<string, string> | null) => Promise<{
+        status: number;
+        body?: unknown;
+    }>;
+}
+export interface SkedHandlerPayload {
+    method: string;
+    path: string;
+    headers: Record<string, string>;
+    body: Record<string, unknown>;
+    querystring?: string | Record<string, string> | null;
+}
+export interface SkedHandlerResponse {
+    status: number;
+    body?: unknown;
+}
+export declare function createSkedHandler(routes: SkedRoute[]): (payload: SkedHandlerPayload) => Promise<SkedHandlerResponse>;
+//# sourceMappingURL=sked-handler.d.ts.map

package/dist/utils/sked-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sked-handler.d.ts","sourceRoot":"","sources":["../../src/utils/sked-handler.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,KACjD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClD;AAQD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EAAE,GAClB,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CA+B/D"}