@skedulo/integration-sdk 0.3.3 → 0.4.0

package/dist/actions/utils/errors.d.ts

@@ -1,18 +1,64 @@
 /**
- * Throw from `parseInput` when validation fails. Becomes a 400 in the envelope.
+ * Coarse-grained error category. Drives HTTP status mapping at the dispatcher
+ * and the `retryable` signal echoed in the failure envelope so callers (PSS,
+ * IS, UI) know whether to back off and retry.
  */
-export declare class InvalidInputError extends Error {
-    readonly details?: unknown | undefined;
-    readonly code = "INVALID_INPUT";
-    constructor(message: string, details?: unknown | undefined);
+export type ErrorCategory = 'invalid_input' | 'forbidden' | 'not_found' | 'conflict' | 'precondition_failed' | 'upstream_transient' | 'upstream_permanent' | 'not_implemented' | 'internal';
+/** Default HTTP status per category. */
+export declare function categoryToStatus(c: ErrorCategory): number;
+/** Default retryability per category. Only transient upstream failures retry. */
+export declare function categoryRetryable(c: ErrorCategory): boolean;
+interface ActionErrorOpts {
+    category?: ErrorCategory;
+    retryable?: boolean;
+    cause?: unknown;
 }
 /**
- * Throw from a handler to produce a structured failure envelope.
- * Use for known business errors (FLOW_NOT_FOUND, DIRECTION_IS_IMMUTABLE, etc.).
+ * Base class for all structured action failures. Throw a typed subclass
+ * (`InvalidInputError`, `ForbiddenError`, `NotFoundError`, …) — they pre-set
+ * `category` so HTTP status and retry signaling are automatic.
  */
 export declare class ActionError extends Error {
     readonly code: string;
     readonly details?: unknown | undefined;
-    constructor(code: string, message: string, details?: unknown | undefined);
+    /** Coarse category — drives HTTP status and `retryable`. */
+    readonly category: ErrorCategory;
+    /** Whether a retry could succeed. Defaults from `category`. */
+    readonly retryable: boolean;
+    constructor(code: string, message: string, details?: unknown | undefined, opts?: ActionErrorOpts);
+}
+/** Throw from `parseInput` (or a handler) when the input is malformed. */
+export declare class InvalidInputError extends ActionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ForbiddenError extends ActionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class NotFoundError extends ActionError {
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare class ConflictError extends ActionError {
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare class PreconditionFailedError extends ActionError {
+    constructor(code: string, message: string, details?: unknown);
+}
+/** Vendor/IS responded with a transient failure (5xx, network, timeout). Safe to retry. */
+export declare class UpstreamTransientError extends ActionError {
+    constructor(message: string, opts?: {
+        cause?: unknown;
+        details?: unknown;
+    });
+}
+/** Vendor/IS rejected the request permanently (4xx semantics). Don't retry. */
+export declare class UpstreamPermanentError extends ActionError {
+    constructor(message: string, opts?: {
+        cause?: unknown;
+        details?: unknown;
+    });
+}
+export declare class NotImplementedError extends ActionError {
+    constructor(message: string, details?: unknown);
 }
+export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/actions/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aAIxB,OAAO,CAAC,EAAE,OAAO;IAHnC,QAAQ,CAAC,IAAI,mBAAmB;gBAE9B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;gBAFjB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,WAAW,GACX,WAAW,GACX,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,CAAC;AAEf,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAqBzD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAE3D;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAOlB,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;IARnC,4DAA4D;IAC5D,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,+DAA+D;IAC/D,SAAgB,SAAS,EAAE,OAAO,CAAC;gBAGjB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA,EACjC,IAAI,GAAE,eAAoB;CAW7B;AAED,0EAA0E;AAC1E,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,2FAA2F;AAC3F,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;CAO/E;AAED,+EAA+E;AAC/E,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;CAO/E;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C"}

package/dist/actions/utils/errors.js

@@ -1,29 +1,119 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionError = exports.InvalidInputError = void 0;
-/**
- * Throw from `parseInput` when validation fails. Becomes a 400 in the envelope.
- */
-class InvalidInputError extends Error {
-    constructor(message, details) {
-        super(message);
-        this.details = details;
-        this.code = 'INVALID_INPUT';
-        this.name = 'InvalidInputError';
+exports.NotImplementedError = exports.UpstreamPermanentError = exports.UpstreamTransientError = exports.PreconditionFailedError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.InvalidInputError = exports.ActionError = void 0;
+exports.categoryToStatus = categoryToStatus;
+exports.categoryRetryable = categoryRetryable;
+/** Default HTTP status per category. */
+function categoryToStatus(c) {
+    switch (c) {
+        case 'invalid_input':
+            return 422;
+        case 'forbidden':
+            return 403;
+        case 'not_found':
+            return 404;
+        case 'conflict':
+            return 409;
+        case 'precondition_failed':
+            return 412;
+        case 'upstream_transient':
+            return 503;
+        case 'upstream_permanent':
+            return 502;
+        case 'not_implemented':
+            return 501;
+        case 'internal':
+            return 500;
     }
 }
-exports.InvalidInputError = InvalidInputError;
+/** Default retryability per category. Only transient upstream failures retry. */
+function categoryRetryable(c) {
+    return c === 'upstream_transient';
+}
 /**
- * Throw from a handler to produce a structured failure envelope.
- * Use for known business errors (FLOW_NOT_FOUND, DIRECTION_IS_IMMUTABLE, etc.).
+ * Base class for all structured action failures. Throw a typed subclass
+ * (`InvalidInputError`, `ForbiddenError`, `NotFoundError`, …) — they pre-set
+ * `category` so HTTP status and retry signaling are automatic.
  */
 class ActionError extends Error {
-    constructor(code, message, details) {
+    constructor(code, message, details, opts = {}) {
+        var _a, _b;
         super(message);
         this.code = code;
         this.details = details;
         this.name = 'ActionError';
+        this.category = (_a = opts.category) !== null && _a !== void 0 ? _a : 'internal';
+        this.retryable = (_b = opts.retryable) !== null && _b !== void 0 ? _b : categoryRetryable(this.category);
+        if (opts.cause !== undefined) {
+            // Use ES2022 Error.cause — preserves the underlying stack across rewraps.
+            this.cause = opts.cause;
+        }
     }
 }
 exports.ActionError = ActionError;
+/** Throw from `parseInput` (or a handler) when the input is malformed. */
+class InvalidInputError extends ActionError {
+    constructor(message, details) {
+        super('INVALID_INPUT', message, details, { category: 'invalid_input' });
+        this.name = 'InvalidInputError';
+    }
+}
+exports.InvalidInputError = InvalidInputError;
+class ForbiddenError extends ActionError {
+    constructor(message, details) {
+        super('FORBIDDEN', message, details, { category: 'forbidden' });
+        this.name = 'ForbiddenError';
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+class NotFoundError extends ActionError {
+    constructor(code, message, details) {
+        super(code, message, details, { category: 'not_found' });
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ConflictError extends ActionError {
+    constructor(code, message, details) {
+        super(code, message, details, { category: 'conflict' });
+        this.name = 'ConflictError';
+    }
+}
+exports.ConflictError = ConflictError;
+class PreconditionFailedError extends ActionError {
+    constructor(code, message, details) {
+        super(code, message, details, { category: 'precondition_failed' });
+        this.name = 'PreconditionFailedError';
+    }
+}
+exports.PreconditionFailedError = PreconditionFailedError;
+/** Vendor/IS responded with a transient failure (5xx, network, timeout). Safe to retry. */
+class UpstreamTransientError extends ActionError {
+    constructor(message, opts = {}) {
+        super('UPSTREAM_TRANSIENT', message, opts.details, {
+            category: 'upstream_transient',
+            cause: opts.cause,
+        });
+        this.name = 'UpstreamTransientError';
+    }
+}
+exports.UpstreamTransientError = UpstreamTransientError;
+/** Vendor/IS rejected the request permanently (4xx semantics). Don't retry. */
+class UpstreamPermanentError extends ActionError {
+    constructor(message, opts = {}) {
+        super('UPSTREAM_PERMANENT', message, opts.details, {
+            category: 'upstream_permanent',
+            cause: opts.cause,
+        });
+        this.name = 'UpstreamPermanentError';
+    }
+}
+exports.UpstreamPermanentError = UpstreamPermanentError;
+class NotImplementedError extends ActionError {
+    constructor(message, details) {
+        super('NOT_IMPLEMENTED', message, details, { category: 'not_implemented' });
+        this.name = 'NotImplementedError';
+    }
+}
+exports.NotImplementedError = NotImplementedError;
 //# sourceMappingURL=errors.js.map

package/dist/actions/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/actions/utils/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAE1C,YACE,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAU;QAH1B,SAAI,GAAG,eAAe,CAAC;QAM9B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AATD,8CASC;AAED;;;GAGG;AACH,MAAa,WAAY,SAAQ,KAAK;IACpC,YACkB,IAAY,EAC5B,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AATD,kCASC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/actions/utils/errors.ts"],"names":[],"mappings":";;;AAiBA,4CAqBC;AAGD,8CAEC;AA3BD,wCAAwC;AACxC,SAAgB,gBAAgB,CAAC,CAAgB;IAC/C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,eAAe;YAClB,OAAO,GAAG,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;QACb,KAAK,qBAAqB;YACxB,OAAO,GAAG,CAAC;QACb,KAAK,oBAAoB;YACvB,OAAO,GAAG,CAAC;QACb,KAAK,oBAAoB;YACvB,OAAO,GAAG,CAAC;QACb,KAAK,iBAAiB;YACpB,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,SAAgB,iBAAiB,CAAC,CAAgB;IAChD,OAAO,CAAC,KAAK,oBAAoB,CAAC;AACpC,CAAC;AAQD;;;;GAIG;AACH,MAAa,WAAY,SAAQ,KAAK;IAMpC,YACkB,IAAY,EAC5B,OAAe,EACC,OAAiB,EACjC,OAAwB,EAAE;;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAU;QAIjC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAA,IAAI,CAAC,QAAQ,mCAAI,UAAU,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,MAAA,IAAI,CAAC,SAAS,mCAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,0EAA0E;YACzE,IAA4B,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AArBD,kCAqBC;AAED,0EAA0E;AAC1E,MAAa,iBAAkB,SAAQ,WAAW;IAChD,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAED,MAAa,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,MAAa,aAAc,SAAQ,WAAW;IAC5C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,aAAc,SAAQ,WAAW;IAC5C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,uBAAwB,SAAQ,WAAW;IACtD,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAED,2FAA2F;AAC3F,MAAa,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAA+C,EAAE;QAC5E,KAAK,CAAC,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACjD,QAAQ,EAAE,oBAAoB;YAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AARD,wDAQC;AAED,+EAA+E;AAC/E,MAAa,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAA+C,EAAE;QAC5E,KAAK,CAAC,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACjD,QAAQ,EAAE,oBAAoB;YAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AARD,wDAQC;AAED,MAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAKtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAEtE"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AAGjE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAKtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAEtE"}

package/dist/actions/utils/helpers.js

@@ -4,6 +4,7 @@ exports.resolveSystem = resolveSystem;
 exports.resolveLookupStrategy = resolveLookupStrategy;
 const skedulo_adapter_1 = require("../../adapters/skedulo.adapter");
 const constants_1 = require("../../constants");
+const errors_1 = require("./errors");
 /**
  * Resolve the adapter for the system named in an action's input. Falls back
  * to the action's own integrationType when `system` is omitted.
@@ -17,7 +18,7 @@ function resolveSystem(adapter, inputSystem) {
         return { system, adapter: skedulo_adapter_1.skeduloAdapter };
     if (system === adapter.integrationType)
         return { system, adapter };
-    throw new Error(`Unknown system: ${system}`);
+    throw new errors_1.InvalidInputError(`Unknown system: ${system}`);
 }
 /**
  * Resolve the configured lookup strategy on an adapter, defaulting to ExternalId.

package/dist/actions/utils/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/actions/utils/helpers.ts"],"names":[],"mappings":";;AAWA,sCAQC;AAKD,sDAEC;AAzBD,oEAAgE;AAChE,+CAAiE;AAEjE;;;;;;GAMG;AACH,SAAgB,aAAa,CAC3B,OAAgB,EAChB,WAA+B;IAE/B,MAAM,MAAM,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,OAAO,CAAC,eAAe,CAAC;IACtD,IAAI,MAAM,KAAK,0BAAc;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAc,EAAE,CAAC;IAC1E,IAAI,MAAM,KAAK,OAAO,CAAC,eAAe;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAgB;;IACpD,OAAO,MAAA,MAAA,OAAO,CAAC,YAAY,0CAAE,cAAc,mCAAI,0BAAc,CAAC,UAAU,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/actions/utils/helpers.ts"],"names":[],"mappings":";;AAYA,sCAQC;AAKD,sDAEC;AA1BD,oEAAgE;AAChE,+CAAiE;AACjE,qCAA6C;AAE7C;;;;;;GAMG;AACH,SAAgB,aAAa,CAC3B,OAAgB,EAChB,WAA+B;IAE/B,MAAM,MAAM,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,OAAO,CAAC,eAAe,CAAC;IACtD,IAAI,MAAM,KAAK,0BAAc;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAc,EAAE,CAAC;IAC1E,IAAI,MAAM,KAAK,OAAO,CAAC,eAAe;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnE,MAAM,IAAI,0BAAiB,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAgB;;IACpD,OAAO,MAAA,MAAA,OAAO,CAAC,YAAY,0CAAE,cAAc,mCAAI,0BAAc,CAAC,UAAU,CAAC;AAC3E,CAAC"}

package/dist/actions/utils/metrics.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal metrics surface so actions can emit counters/histograms without
+ * coupling to a specific backend (StatsD, OTel, Datadog). Tenant functions
+ * inject a real impl via `BaseAdapterHandlerConfig.metrics`; the SDK defaults
+ * to a no-op.
+ */
+export interface Metrics {
+    counter(name: string, value: number, tags?: Record<string, string>): void;
+    histogram(name: string, value: number, tags?: Record<string, string>): void;
+}
+export declare const noopMetrics: Metrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/actions/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC7E;AAED,eAAO,MAAM,WAAW,EAAE,OAOzB,CAAC"}

package/dist/actions/utils/metrics.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopMetrics = void 0;
+exports.noopMetrics = {
+    counter() {
+        /* no-op */
+    },
+    histogram() {
+        /* no-op */
+    },
+};
+//# sourceMappingURL=metrics.js.map

package/dist/actions/utils/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/actions/utils/metrics.ts"],"names":[],"mappings":";;;AAWa,QAAA,WAAW,GAAY;IAClC,OAAO;QACL,WAAW;IACb,CAAC;IACD,SAAS;QACP,WAAW;IACb,CAAC;CACF,CAAC"}

package/dist/actions/utils/middleware.d.ts

@@ -0,0 +1,39 @@
+import type { IntegrationContext } from '../../context';
+/** The (input, ctx) → result function that middleware wraps. */
+export type ActionHandler<I, O> = (input: I, ctx: IntegrationContext) => Promise<O>;
+/** Metadata available to every middleware. Set once at definition time. */
+export interface MiddlewareMeta {
+    actionName: string;
+    /** Safe to retry without side effects. */
+    idempotent: boolean;
+    /** Emit an audit log line on success. */
+    audit: boolean;
+}
+/**
+ * A middleware wraps `next` and returns a new handler. Order is outer-to-inner:
+ * `compose([A, B], handler)` runs A → B → handler.
+ */
+export type Middleware = <I, O>(next: ActionHandler<I, O>, meta: MiddlewareMeta) => ActionHandler<I, O>;
+export declare function compose<I, O>(middlewares: ReadonlyArray<Middleware>, handler: ActionHandler<I, O>, meta: MiddlewareMeta): ActionHandler<I, O>;
+/**
+ * Log structured start/end lines for every action. Failure lines include the
+ * error code and message; the requestId threads through to downstream services.
+ */
+export declare const withLogging: Middleware;
+/**
+ * Emit a counter per (action, status[, code]) and a duration histogram. Tags
+ * stay low-cardinality — `code` is bounded by the error taxonomy.
+ */
+export declare const withMetrics: Middleware;
+/**
+ * Emit a single audit line on success when `meta.audit` is true. Mutating
+ * actions opt in via `defineAction({ audit: true })`. Failures are not audited
+ * (a rejected mutation didn't happen) — they show up in the standard logs.
+ */
+export declare const withAudit: Middleware;
+/**
+ * Gate the handler on admin privileges. Failure raises `ForbiddenError` so the
+ * dispatcher returns 403 and the error envelope is consistent across actions.
+ */
+export declare const requireAdmin: Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/actions/utils/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,gEAAgE;AAChE,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAC5B,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EACzB,IAAI,EAAE,cAAc,KACjB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,EACtC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,IAAI,EAAE,cAAc,GACnB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAErB;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UAsBzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UAezB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,UAUvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,UAK1B,CAAC"}

package/dist/actions/utils/middleware.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireAdmin = exports.withAudit = exports.withMetrics = exports.withLogging = void 0;
+exports.compose = compose;
+const helpers_1 = require("../../utils/helpers");
+const errors_1 = require("./errors");
+function compose(middlewares, handler, meta) {
+    return middlewares.reduceRight((next, mw) => mw(next, meta), handler);
+}
+// ── stock middlewares ────────────────────────────────────────────────────────
+/**
+ * Log structured start/end lines for every action. Failure lines include the
+ * error code and message; the requestId threads through to downstream services.
+ */
+const withLogging = (next, meta) => async (input, ctx) => {
+    var _a, _b;
+    const startedAt = Date.now();
+    ctx.logger.info(`[action.start] name=${meta.actionName} requestId=${ctx.requestId} ` +
+        `idempotent=${meta.idempotent}`);
+    try {
+        const result = await next(input, ctx);
+        ctx.logger.info(`[action.end] name=${meta.actionName} requestId=${ctx.requestId} ` +
+            `status=ok duration_ms=${Date.now() - startedAt}`);
+        return result;
+    }
+    catch (err) {
+        const e = err;
+        ctx.logger.warn(`[action.end] name=${meta.actionName} requestId=${ctx.requestId} ` +
+            `status=error duration_ms=${Date.now() - startedAt} ` +
+            `code=${(_a = e.code) !== null && _a !== void 0 ? _a : 'INTERNAL'} message=${(_b = e.message) !== null && _b !== void 0 ? _b : String(err)}`);
+        throw err;
+    }
+};
+exports.withLogging = withLogging;
+/**
+ * Emit a counter per (action, status[, code]) and a duration histogram. Tags
+ * stay low-cardinality — `code` is bounded by the error taxonomy.
+ */
+const withMetrics = (next, meta) => async (input, ctx) => {
+    var _a;
+    const startedAt = Date.now();
+    try {
+        const result = await next(input, ctx);
+        const dur = Date.now() - startedAt;
+        ctx.metrics.counter('action.calls', 1, { name: meta.actionName, status: 'ok' });
+        ctx.metrics.histogram('action.duration_ms', dur, { name: meta.actionName, status: 'ok' });
+        return result;
+    }
+    catch (err) {
+        const dur = Date.now() - startedAt;
+        const code = (_a = err.code) !== null && _a !== void 0 ? _a : 'INTERNAL';
+        ctx.metrics.counter('action.calls', 1, { name: meta.actionName, status: 'error', code });
+        ctx.metrics.histogram('action.duration_ms', dur, { name: meta.actionName, status: 'error' });
+        throw err;
+    }
+};
+exports.withMetrics = withMetrics;
+/**
+ * Emit a single audit line on success when `meta.audit` is true. Mutating
+ * actions opt in via `defineAction({ audit: true })`. Failures are not audited
+ * (a rejected mutation didn't happen) — they show up in the standard logs.
+ */
+const withAudit = (next, meta) => async (input, ctx) => {
+    var _a, _b, _c;
+    if (!meta.audit)
+        return next(input, ctx);
+    const result = await next(input, ctx);
+    const tenantId = (_c = (_b = (_a = ctx.skedContext) === null || _a === void 0 ? void 0 : _a.tenant) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : 'unknown';
+    ctx.logger.info(`[audit] action=${meta.actionName} tenant=${tenantId} ` +
+        `requestId=${ctx.requestId} integration=${ctx.integrationType}`);
+    return result;
+};
+exports.withAudit = withAudit;
+/**
+ * Gate the handler on admin privileges. Failure raises `ForbiddenError` so the
+ * dispatcher returns 403 and the error envelope is consistent across actions.
+ */
+const requireAdmin = (next, meta) => async (input, ctx) => {
+    if (!(0, helpers_1.isAdminRequest)(ctx.skedContext)) {
+        throw new errors_1.ForbiddenError(`${meta.actionName} requires admin privileges`);
+    }
+    return next(input, ctx);
+};
+exports.requireAdmin = requireAdmin;
+//# sourceMappingURL=middleware.js.map

package/dist/actions/utils/middleware.js.map

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

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

@@ -17,9 +17,23 @@ export interface ActionFailure {
         code: string;
         message: string;
         details?: unknown;
+        /** Whether the caller may retry. Set when the thrown error carries a category. */
+        retryable?: boolean;
     };
 }
 export type ActionResult<T> = ActionSuccess<T> | ActionFailure;
+/**
+ * Out-of-band values the dispatcher lifts off request headers and hands to
+ * `parseInput` alongside the raw body, so per-flow actions can read them
+ * without the body having to carry them (ES scheduled webhooks post an empty
+ * body, and triggered actions post a bare array).
+ */
+export interface ParseMeta {
+    /** From the `sked-data-flow-id` header. */
+    dataFlowId?: number;
+    /** From the `sked-scheduled-job-name` header (a job's `webhook_name`). */
+    scheduledJobName?: string;
+}
 /**
  * One registered action. The registry holds a map of name → Action.
  * `parseInput` validates the raw HTTP body and returns the typed input,
@@ -31,18 +45,16 @@ export interface Action<TInput, TOutput> {
     /**
      * Validate the raw incoming body. Throw InvalidInputError for malformed
      * input; return the typed input on success. Returning a value here is
-     * how the dispatcher knows to invoke the handler.
+     * how the dispatcher knows to invoke the handler. `meta` carries values the
+     * dispatcher lifted off request headers (e.g. `dataFlowId`).
      */
-    parseInput: (raw: unknown) => TInput;
+    parseInput: (raw: unknown, meta?: ParseMeta) => TInput;
     /**
      * Run the action. Returns the result (will be wrapped in ActionSuccess
      * by the dispatcher). Throw an `ActionError` to produce a failure envelope.
      */
     handler: (input: TInput, ctx: IntegrationContext) => Promise<TOutput>;
 }
-/**
- * The registry is keyed by action name. Action types are erased here —
- * the typed dispatch client (Task 10) re-introduces type-level inference.
- */
+/** Registry keyed by action name; action input/output types are erased here. */
 export type ActionRegistry = Map<string, Action<any, any>>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO;IACrC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACrC;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kFAAkF;QAClF,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO;IACrC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,MAAM,CAAC;IACvD;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}

package/dist/adapters/base-adapter-handler.d.ts

@@ -1,6 +1,10 @@
+import { type ErrorCategory } from '../actions/utils/errors';
+import type { Metrics } from '../actions/utils/metrics';
 import type { ActionRegistry } from '../actions/utils/types';
 import type { Adapter } from '../interfaces/adapter.interface';
 import { AdapterRegistry } from './adapter-registry';
+/** Header carrying the upstream request id, threaded into ctx.requestId. */
+export declare const REQUEST_ID_HEADER = "sked-request-id";
 export type RouteHandler = (body: any, headers: any, method: string, path: string, skedContext: any, querystring?: string | Record<string, string> | null) => Promise<{
     status: number;
     body?: unknown;
@@ -20,6 +24,11 @@ export interface BaseAdapterHandlerConfig {
      * the wire layer (header parsing, error mapping) with synthetic actions.
      */
     actionRegistry?: ActionRegistry;
+    /**
+     * Optional metrics sink, threaded onto every `IntegrationContext` so action
+     * middleware can emit counters/histograms. Defaults to a no-op.
+     */
+    metrics?: Metrics;
 }
 /**
  * Single-entry handler that dispatches every integration action through the
@@ -39,4 +48,5 @@ export declare class BaseAdapterHandler {
      */
     dispatch: RouteHandler;
 }
+export type { ErrorCategory };
 //# sourceMappingURL=base-adapter-handler.d.ts.map

package/dist/adapters/base-adapter-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/base-adapter-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,GAAG,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,KACjD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAKjB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,wBAAwB;IAJ/D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAC7C,SAAgB,cAAc,EAAE,cAAc,CAAC;gBAEhB,MAAM,EAAE,wBAAwB;IAU/D;;;;OAIG;IACH,QAAQ,EAAE,YAAY,CAmCpB;CACH"}
+{"version":3,"file":"base-adapter-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/base-adapter-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAInD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,GAAG,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,KACjD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAKjB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,wBAAwB;IAJ/D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAC7C,SAAgB,cAAc,EAAE,cAAc,CAAC;gBAEhB,MAAM,EAAE,wBAAwB;IAU/D;;;;OAIG;IACH,QAAQ,EAAE,YAAY,CAkDpB;CACH;AA8CD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/adapters/base-adapter-handler.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseAdapterHandler = void 0;
+exports.BaseAdapterHandler = exports.REQUEST_ID_HEADER = void 0;
+const crypto_1 = require("crypto");
 const context_1 = require("../context");
 const action_names_1 = require("../actions/utils/action-names");
 const errors_1 = require("../actions/utils/errors");
 const action_registry_1 = require("../actions/action-registry");
 const adapter_registry_1 = require("./adapter-registry");
 const skedulo_adapter_1 = require("./skedulo.adapter");
+/** Header carrying the upstream request id, threaded into ctx.requestId. */
+exports.REQUEST_ID_HEADER = 'sked-request-id';
 /**
  * Single-entry handler that dispatches every integration action through the
  * action registry. Tenant functions wire one HTTP route to `dispatch` and
@@ -22,6 +25,8 @@ class BaseAdapterHandler {
          * action input. Returns an `ActionResult` wrapped in an HTTP status.
          */
         this.dispatch = async (body, headers, _method, _path, skedContext) => {
+            var _a;
+            const requestId = (_a = readHeader(headers, exports.REQUEST_ID_HEADER)) !== null && _a !== void 0 ? _a : (0, crypto_1.randomUUID)();
             const actionName = readHeader(headers, action_names_1.ACTION_HEADER);
             if (!actionName) {
                 return failure(400, 'MISSING_ACTION_HEADER', `Missing required header: ${action_names_1.ACTION_HEADER}`);
@@ -32,7 +37,10 @@ class BaseAdapterHandler {
             }
             let input;
             try {
-                input = action.parseInput(body);
+                input = action.parseInput(body, {
+                    dataFlowId: readDataFlowId(headers),
+                    scheduledJobName: readHeader(headers, action_names_1.SCHEDULED_JOB_NAME_HEADER),
+                });
             }
             catch (err) {
                 if (err instanceof errors_1.InvalidInputError) {
@@ -43,14 +51,14 @@ class BaseAdapterHandler {
             const integrationContext = (0, context_1.createIntegrationContext)(skedContext, this.integrationType, {
                 requestSource: `${this.integrationType}-${actionName}`,
                 userAgent: `${this.integrationType}-function`,
-            });
+            }, { requestId, metrics: this.config.metrics });
             try {
                 const result = await action.handler(input, integrationContext);
                 return { status: 200, body: { ok: true, result } };
             }
             catch (err) {
                 if (err instanceof errors_1.ActionError) {
-                    return failure(actionErrorStatus(err.code), err.code, err.message, err.details);
+                    return failure((0, errors_1.categoryToStatus)(err.category), err.code, err.message, err.details, err.retryable);
                 }
                 return failure(500, 'INTERNAL_ERROR', err instanceof Error ? err.message : String(err));
             }
@@ -78,36 +86,25 @@ function readHeader(headers, name) {
     }
     return undefined;
 }
-function failure(status, code, message, details) {
-    const error = details !== undefined ? { code, message, details } : { code, message };
-    return { status, body: { ok: false, error } };
-}
 /**
- * Map well-known action error codes to HTTP statuses. Default to 400
- * (caller error).
+ * ElasticServer scheduled webhooks post an empty body and triggered actions
+ * post a bare array; both carry the flow id on the `sked-data-flow-id` header.
+ * Lift it off so the dispatcher can hand it to `parseInput` as `meta` without
+ * mutating the body.
  */
-function actionErrorStatus(code) {
-    switch (code) {
-        case 'FORBIDDEN':
-            return 403;
-        case 'FLOW_NOT_FOUND':
-            return 404;
-        case 'PRECONDITION_FAILED':
-            return 412;
-        case 'NOT_IMPLEMENTED':
-            return 501;
-        case 'NO_ACTIVE_FLOWS':
-            return 503;
-        case 'PROCESSING_FAILED':
-            return 502;
-        case 'DIRECTION_IS_IMMUTABLE':
-        case 'DEACTIVATE_BEFORE_STRATEGY_CHANGE':
-            return 409;
-        case 'UNSUPPORTED_STRATEGY':
-        case 'MISSING_SYNC_STRATEGY':
-            return 422;
-        default:
-            return 400;
-    }
+function readDataFlowId(headers) {
+    const raw = readHeader(headers, action_names_1.DATA_FLOW_ID_HEADER);
+    if (raw === undefined)
+        return undefined;
+    const id = Number(raw);
+    return Number.isInteger(id) ? id : undefined;
+}
+function failure(status, code, message, details, retryable) {
+    const error = { code, message };
+    if (details !== undefined)
+        error.details = details;
+    if (retryable !== undefined)
+        error.retryable = retryable;
+    return { status, body: { ok: false, error } };
 }
 //# sourceMappingURL=base-adapter-handler.js.map