terraconstructs 0.0.8

package/lib/aws/compute/states/custom-state.d.ts

@@ -0,0 +1,55 @@
+import { Construct } from "constructs";
+import { Chain } from "..";
+import { State } from "./state";
+import { CatchProps, IChainable, INextable, RetryProps } from "../types";
+/**
+ * Properties for defining a custom state definition
+ */
+export interface CustomStateProps {
+    /**
+     * Amazon States Language (JSON-based) definition of the state
+     *
+     * @see https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html
+     */
+    readonly stateJson: {
+        [key: string]: any;
+    };
+}
+/**
+ * State defined by supplying Amazon States Language (ASL) in the state machine.
+ *
+ */
+export declare class CustomState extends State implements IChainable, INextable {
+    readonly endStates: INextable[];
+    /**
+     * Amazon States Language (JSON-based) definition of the state
+     */
+    private readonly stateJson;
+    constructor(scope: Construct, id: string, props: CustomStateProps);
+    /**
+     * Add retry configuration for this state
+     *
+     * This controls if and how the execution will be retried if a particular
+     * error occurs.
+     */
+    addRetry(props?: RetryProps): CustomState;
+    /**
+     * Add a recovery handler for this state
+     *
+     * When a particular error occurs, execution will continue at the error
+     * handler instead of failing the state machine execution.
+     */
+    addCatch(handler: IChainable, props?: CatchProps): CustomState;
+    /**
+     * Continue normal execution with the given state
+     */
+    next(next: IChainable): Chain;
+    /**
+     * Returns the Amazon States Language object for this state
+     */
+    toStateJson(): object;
+    private hasMultipleRetrySources;
+    private hasMultipleCatchSources;
+    private addMultipleRetrySourcesWarning;
+    private addMultipleCatchSourcesWarning;
+}

package/lib/aws/compute/states/custom-state.js

@@ -0,0 +1,114 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomState = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+// https://github.com/aws/aws-cdk/blob/v2.160.0/packages/aws-cdk-lib/aws-stepfunctions/lib/states/custom-state.ts
+const cdktf_1 = require("cdktf");
+const __1 = require("..");
+const state_1 = require("./state");
+/**
+ * State defined by supplying Amazon States Language (ASL) in the state machine.
+ *
+ */
+class CustomState extends state_1.State {
+    constructor(scope, id, props) {
+        super(scope, id, {});
+        this.endStates = [this];
+        this.stateJson = props.stateJson;
+    }
+    /**
+     * Add retry configuration for this state
+     *
+     * This controls if and how the execution will be retried if a particular
+     * error occurs.
+     */
+    addRetry(props = {}) {
+        super._addRetry(props);
+        return this;
+    }
+    /**
+     * Add a recovery handler for this state
+     *
+     * When a particular error occurs, execution will continue at the error
+     * handler instead of failing the state machine execution.
+     */
+    addCatch(handler, props = {}) {
+        super._addCatch(handler.startState, props);
+        return this;
+    }
+    /**
+     * Continue normal execution with the given state
+     */
+    next(next) {
+        super.makeNext(next.startState);
+        return __1.Chain.sequence(this, next);
+    }
+    /**
+     * Returns the Amazon States Language object for this state
+     */
+    toStateJson() {
+        const state = {
+            ...this.renderNextEnd(),
+            ...this.stateJson,
+            ...this.renderRetryCatch(),
+        };
+        if (this.hasMultipleRetrySources(state)) {
+            this.addMultipleRetrySourcesWarning();
+        }
+        if (this.hasMultipleCatchSources(state)) {
+            this.addMultipleCatchSourcesWarning();
+        }
+        // Retriers and Catchers can be specified directly in the stateJson or indirectly to the construct with addRetry() and addCatch().
+        // renderRetryCatch() only renders the indirectly supplied Retriers and Catchers, so we need to manually merge in those directly in the stateJson
+        if (Array.isArray(this.stateJson.Retry)) {
+            state.Retry = Array.isArray(state.Retry)
+                ? [...state.Retry, ...this.stateJson.Retry]
+                : [...this.stateJson.Retry];
+        }
+        if (Array.isArray(this.stateJson.Catch)) {
+            state.Catch = Array.isArray(state.Catch)
+                ? [...state.Catch, ...this.stateJson.Catch]
+                : [...this.stateJson.Catch];
+        }
+        return state;
+    }
+    hasMultipleRetrySources(state) {
+        if (!Array.isArray(state.Retry)) {
+            return false;
+        }
+        if (!Array.isArray(this.stateJson.Retry)) {
+            return false;
+        }
+        return state.Retry.length > 0 && this.stateJson.Retry.length > 0;
+    }
+    hasMultipleCatchSources(state) {
+        if (!Array.isArray(state.Catch)) {
+            return false;
+        }
+        if (!Array.isArray(this.stateJson.Catch)) {
+            return false;
+        }
+        return state.Catch.length > 0 && this.stateJson.Catch.length > 0;
+    }
+    addMultipleRetrySourcesWarning() {
+        // "@aws-cdk/aws-stepfunctions:multipleRetrySources", // TODO: CDKTF does not support acknowledgeable warnings
+        cdktf_1.Annotations.of(this).addWarning([
+            "CustomState constructs can configure state retries using the stateJson property or by using the addRetry() function.",
+            "When retries are configured using both of these, the state definition's Retry field is generated ",
+            "by first rendering retries from addRetry(), then rendering retries from the stateJson.",
+        ].join("\n"));
+    }
+    addMultipleCatchSourcesWarning() {
+        // "@aws-cdk/aws-stepfunctions:multipleCatchSources", // TODO: CDKTF does not support acknowledgeable warnings
+        cdktf_1.Annotations.of(this).addWarning([
+            "CustomState constructs can configure state catchers using the stateJson property or by using the addCatch() function.",
+            "When catchers are configured using both of these, the state definition's Catch field is generated ",
+            "by first rendering catchers from addCatch(), then rendering catchers from the stateJson.",
+        ].join("\n"));
+    }
+}
+exports.CustomState = CustomState;
+_a = JSII_RTTI_SYMBOL_1;
+CustomState[_a] = { fqn: "terraconstructs.aws.compute.CustomState", version: "0.0.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VzdG9tLXN0YXRlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2F3cy9jb21wdXRlL3N0YXRlcy9jdXN0b20tc3RhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSxpSEFBaUg7QUFFakgsaUNBQW9DO0FBRXBDLDBCQUEyQjtBQUMzQixtQ0FBZ0M7QUFlaEM7OztHQUdHO0FBQ0gsTUFBYSxXQUFZLFNBQVEsYUFBSztJQVFwQyxZQUFZLEtBQWdCLEVBQUUsRUFBVSxFQUFFLEtBQXVCO1FBQy9ELEtBQUssQ0FBQyxLQUFLLEVBQUUsRUFBRSxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBRXJCLElBQUksQ0FBQyxTQUFTLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN4QixJQUFJLENBQUMsU0FBUyxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQUM7SUFDbkMsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0ksUUFBUSxDQUFDLFFBQW9CLEVBQUU7UUFDcEMsS0FBSyxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN2QixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLFFBQVEsQ0FBQyxPQUFtQixFQUFFLFFBQW9CLEVBQUU7UUFDekQsS0FBSyxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsVUFBVSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzNDLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUVEOztPQUVHO0lBQ0ksSUFBSSxDQUFDLElBQWdCO1FBQzFCLEtBQUssQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ2hDLE9BQU8sU0FBSyxDQUFDLFFBQVEsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDcEMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksV0FBVztRQUNoQixNQUFNLEtBQUssR0FBRztZQUNaLEdBQUcsSUFBSSxDQUFDLGFBQWEs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LENBQUMsQ0FBQyxVQUFVLENBQzdCO1lBQ0UsdUhBQXVIO1lBQ3ZILG9HQUFvRztZQUNwRywwRkFBMEY7U0FDM0YsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQ2IsQ0FBQztJQUNKLENBQUM7O0FBNUhILGtDQTZIQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIGh0dHBzOi8vZ2l0aHViLmNvbS9hd3MvYXdzLWNkay9ibG9iL3YyLjE2MC4wL3BhY2thZ2VzL2F3cy1jZGstbGliL2F3cy1zdGVwZnVuY3Rpb25zL2xpYi9zdGF0ZXMvY3VzdG9tLXN0YXRlLnRzXG5cbmltcG9ydCB7IEFubm90YXRpb25zIH0gZnJvbSBcImNka3RmXCI7XG5pbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tIFwiY29uc3RydWN0c1wiO1xuaW1wb3J0IHsgQ2hhaW4gfSBmcm9tIFwiLi5cIjtcbmltcG9ydCB7IFN0YXRlIH0gZnJvbSBcIi4vc3RhdGVcIjtcbmltcG9ydCB7IENhdGNoUHJvcHMsIElDaGFpbmFibGUsIElOZXh0YWJsZSwgUmV0cnlQcm9wcyB9IGZyb20gXCIuLi90eXBlc1wiO1xuXG4vKipcbiAqIFByb3BlcnRpZXMgZm9yIGRlZmluaW5nIGEgY3VzdG9tIHN0YXRlIGRlZmluaXRpb25cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDdXN0b21TdGF0ZVByb3BzIHtcbiAgLyoqXG4gICAqIEFtYXpvbiBTdGF0ZXMgTGFuZ3VhZ2UgKEpTT04tYmFzZWQpIGRlZmluaXRpb24gb2YgdGhlIHN0YXRlXG4gICAqXG4gICAqIEBzZWUgaHR0cHM6Ly9kb2NzLmF3cy5hbWF6b24uY29tL3N0ZXAtZnVuY3Rpb25zL2xhdGVzdC9kZy9jb25jZXB0cy1hbWF6b24tc3RhdGVzLWxhbmd1YWdlLmh0bWxcbiAgICovXG4gIHJlYWRvbmx5IHN0YXRlSnNvbjogeyBba2V5OiBzdHJpbmddOiBhbnkgfTtcbn1cblxuLyoqXG4gKiBTdGF0ZSBkZWZpbmVkIGJ5IHN1cHBseWluZyBBbWF6b24gU3RhdGVzIExhbmd1YWdlIChBU0wpIGluIHRoZSBzdGF0ZSBtYWNoaW5lLlxuICpcbiAqL1xuZXhwb3J0IGNsYXNzIEN1c3RvbVN0YXRlIGV4dGVuZHMgU3RhdGUgaW1wbGVtZW50cyBJQ2hhaW5hYmxlLCBJTmV4dGFibGUge1xuICBwdWJsaWMgcmVhZG9ubHkgZW5kU3RhdGVzOiBJTmV4dGFibGVbXTtcblxuICAvKipcbiAgICogQW1hem9uIFN0YXRlcyBMYW5ndWFnZSAoSlNPTi1iYXNlZCkgZGVmaW5pdGlvbiBvZiB0aGUgc3RhdGVcbiAgICovXG4gIHByaXZhdGUgcmVhZG9ubHkgc3RhdGVKc29uOiB7IFtrZXk6IHN0cmluZ106IGFueSB9O1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBDdXN0b21TdGF0ZVByb3BzKSB7XG4gICAgc3VwZXIoc2NvcGUsIGlkLCB7fSk7XG5cbiAgICB0aGlzLmVuZFN0YXRlcyA9IFt0aGlzXTtcbiAgICB0aGlzLnN0YXRlSnNvbiA9IHByb3BzLnN0YXRlSnNvbjtcbiAgfVxuXG4gIC8qKlxuICAgKiBBZGQgcmV0cnkgY29uZmlndXJhdGlvbiBmb3IgdGhpcyBzdGF0ZVxuICAgKlxuICAgKiBUaGlzIGNvbnRyb2xzIGlmIGFuZCBob3cgdGhlIGV4ZWN1dGlvbiB3aWxsIGJlIHJldHJpZWQgaWYgYSBwYXJ0aWN1bGFyXG4gICAqIGVycm9yIG9jY3Vycy5cbiAgICovXG4gIHB1YmxpYyBhZGRSZXRyeShwcm9wczogUmV0cnlQcm9wcyA9IHt9KTogQ3VzdG9tU3RhdGUge1xuICAgIHN1cGVyLl9hZGRSZXRyeShwcm9wcyk7XG4gICAgcmV0dXJuIHRoaXM7XG4gIH1cblxuICAvKipcbiAgICogQWRkIGEgcmVjb3ZlcnkgaGFuZGxlciBmb3IgdGhpcyBzdGF0ZVxuICAgKlxuICAgKiBXaGVuIGEgcGFydGljdWxhciBlcnJvciBvY2N1cnMsIGV4ZWN1dGlvbiB3aWxsIGNvbnRpbnVlIGF0IHRoZSBlcnJvclxuICAgKiBoYW5kbGVyIGluc3RlYWQgb2YgZmFpbGluZyB0aGUgc3RhdGUgbWFjaGluZSBleGVjdXRpb24uXG4gICAqL1xuICBwdWJsaWMgYWRkQ2F0Y2goaGFuZGxlcjogSUNoYWluYWJsZSwgcHJvcHM6IENhdGNoUHJvcHMgPSB7fSk6IEN1c3RvbVN0YXRlIHtcbiAgICBzdXBlci5fYWRkQ2F0Y2goaGFuZGxlci5zdGFydFN0YXRlLCBwcm9wcyk7XG4gICAgcmV0dXJuIHRoaXM7XG4gIH1cblxuICAvKipcbiAgICogQ29udGludWUgbm9ybWFsIGV4ZWN1dGlvbiB3aXRoIHRoZSBnaXZlbiBzdGF0ZVxuICAgKi9cbiAgcHVibGljIG5leHQobmV4dDogSUNoYWluYWJsZSk6IENoYWluIHtcbiAgICBzdXBlci5tYWtlTmV4dChuZXh0LnN0YXJ0U3RhdGUpO1xuICAgIHJldHVybiBDaGFpbi5zZXF1ZW5jZSh0aGlzLCBuZXh0KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIHRoZSBBbWF6b24gU3RhdGVzIExhbmd1YWdlIG9iamVjdCBmb3IgdGhpcyBzdGF0ZVxuICAgKi9cbiAgcHVibGljIHRvU3RhdGVKc29uKCk6IG9iamVjdCB7XG4gICAgY29uc3Qgc3RhdGUgPSB7XG4gICAgICAuLi50aGlzLnJlbmRlck5leHRFbmQoKSxcbiAgICAgIC4uLnRoaXMuc3RhdGVKc29uLFxuICAgICAgLi4udGhpcy5yZW5kZXJSZXRyeUNhdGNoKCksXG4gICAgfTtcblxuICAgIGlmICh0aGlzLmhhc011bHRpcGxlUmV0cnlTb3VyY2VzKHN0YXRlKSkge1xuICAgICAgdGhpcy5hZGRNdWx0aXBsZVJldHJ5U291cmNlc1dhcm5pbmcoKTtcbiAgICB9XG5cbiAgICBpZiAodGhpcy5oYXNNdWx0aXBsZUNhdGNoU291cmNlcyhzdGF0ZSkpIHtcbiAgICAgIHRoaXMuYWRkTXVsdGlwbGVDYXRjaFNvdXJjZXNXYXJuaW5nKCk7XG4gICAgfVxuXG4gICAgLy8gUmV0cmllcnMgYW5kIENhdGNoZXJzIGNhbiBiZSBzcGVjaWZpZWQgZGlyZWN0bHkgaW4gdGhlIHN0YXRlSnNvbiBvciBpbmRpcmVjdGx5IHRvIHRoZSBjb25zdHJ1Y3Qgd2l0aCBhZGRSZXRyeSgpIGFuZCBhZGRDYXRjaCgpLlxuICAgIC8vIHJlbmRlclJldHJ5Q2F0Y2goKSBvbmx5IHJlbmRlcnMgdGhlIGluZGlyZWN0bHkgc3VwcGxpZWQgUmV0cmllcnMgYW5kIENhdGNoZXJzLCBzbyB3ZSBuZWVkIHRvIG1hbnVhbGx5IG1lcmdlIGluIHRob3NlIGRpcmVjdGx5IGluIHRoZSBzdGF0ZUpzb25cbiAgICBpZiAoQXJyYXkuaXNBcnJheSh0aGlzLnN0YXRlSnNvbi5SZXRyeSkpIHtcbiAgICAgIHN0YXRlLlJldHJ5ID0gQXJyYXkuaXNBcnJheShzdGF0ZS5SZXRyeSlcbiAgICAgICAgPyBbLi4uc3RhdGUuUmV0cnksIC4uLnRoaXMuc3RhdGVKc29uLlJldHJ5XVxuICAgICAgICA6IFsuLi50aGlzLnN0YXRlSnNvbi5SZXRyeV07XG4gICAgfVxuXG4gICAgaWYgKEFycmF5LmlzQXJyYXkodGhpcy5zdGF0ZUpzb24uQ2F0Y2gpKSB7XG4gICAgICBzdGF0ZS5DYXRjaCA9IEFycmF5LmlzQXJyYXkoc3RhdGUuQ2F0Y2gpXG4gICAgICAgID8gWy4uLnN0YXRlLkNhdGNoLCAuLi50aGlzLnN0YXRlSnNvbi5DYXRjaF1cbiAgICAgICAgOiBbLi4udGhpcy5zdGF0ZUpzb24uQ2F0Y2hdO1xuICAgIH1cblxuICAgIHJldHVybiBzdGF0ZTtcbiAgfVxuXG4gIHByaXZhdGUgaGFzTXVsdGlwbGVSZXRyeVNvdXJjZXMoc3RhdGU6IGFueSk6IGJvb2xlYW4ge1xuICAgIGlmICghQXJyYXkuaXNBcnJheShzdGF0ZS5SZXRyeSkpIHtcbiAgICAgIHJldHVybiBmYWxzZTtcbiAgICB9XG5cbiAgICBpZiAoIUFycmF5LmlzQXJyYXkodGhpcy5zdGF0ZUpzb24uUmV0cnkpKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgcmV0dXJuIHN0YXRlLlJldHJ5Lmxlbmd0aCA+IDAgJiYgdGhpcy5zdGF0ZUpzb24uUmV0cnkubGVuZ3RoID4gMDtcbiAgfVxuXG4gIHByaXZhdGUgaGFzTXVsdGlwbGVDYXRjaFNvdXJjZXMoc3RhdGU6IGFueSk6IGJvb2xlYW4ge1xuICAgIGlmICghQXJyYXkuaXNBcnJheShzdGF0ZS5DYXRjaCkpIHtcbiAgICAgIHJldHVybiBmYWxzZTtcbiAgICB9XG5cbiAgICBpZiAoIUFycmF5LmlzQXJyYXkodGhpcy5zdGF0ZUpzb24uQ2F0Y2gpKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgcmV0dXJuIHN0YXRlLkNhdGNoLmxlbmd0aCA+IDAgJiYgdGhpcy5zdGF0ZUpzb24uQ2F0Y2gubGVuZ3RoID4gMDtcbiAgfVxuXG4gIHByaXZhdGUgYWRkTXVsdGlwbGVSZXRyeVNvdXJjZXNXYXJuaW5nKCk6IHZvaWQge1xuICAgIC8vIFwiQGF3cy1jZGsvYXdzLXN0ZXBmdW5jdGlvbnM6bXVsdGlwbGVSZXRyeVNvdXJjZXNcIiwgLy8gVE9ETzogQ0RLVEYgZG9lcyBub3Qgc3VwcG9ydCBhY2tub3dsZWRnZWFibGUgd2FybmluZ3NcbiAgICBBbm5vdGF0aW9ucy5vZih0aGlzKS5hZGRXYXJuaW5nKFxuICAgICAgW1xuICAgICAgICBcIkN1c3RvbVN0YXRlIGNvbnN0cnVjdHMgY2FuIGNvbmZpZ3VyZSBzdGF0ZSByZXRyaWVzIHVzaW5nIHRoZSBzdGF0ZUpzb24gcHJvcGVydHkgb3IgYnkgdXNpbmcgdGhlIGFkZFJldHJ5KCkgZnVuY3Rpb24uXCIsXG4gICAgICAgIFwiV2hlbiByZXRyaWVzIGFyZSBjb25maWd1cmVkIHVzaW5nIGJvdGggb2YgdGhlc2UsIHRoZSBzdGF0ZSBkZWZpbml0aW9uJ3MgUmV0cnkgZmllbGQgaXMgZ2VuZXJhdGVkIFwiLFxuICAgICAgICBcImJ5IGZpcnN0IHJlbmRlcmluZyByZXRyaWVzIGZyb20gYWRkUmV0cnkoKSwgdGhlbiByZW5kZXJpbmcgcmV0cmllcyBmcm9tIHRoZSBzdGF0ZUpzb24uXCIsXG4gICAgICBdLmpvaW4oXCJcXG5cIiksXG4gICAgKTtcbiAgfVxuXG4gIHByaXZhdGUgYWRkTXVsdGlwbGVDYXRjaFNvdXJjZXNXYXJuaW5nKCk6IHZvaWQge1xuICAgIC8vIFwiQGF3cy1jZGsvYXdzLXN0ZXBmdW5jdGlvbnM6bXVsdGlwbGVDYXRjaFNvdXJjZXNcIiwgLy8gVE9ETzogQ0RLVEYgZG9lcyBub3Qgc3VwcG9ydCBhY2tub3dsZWRnZWFibGUgd2FybmluZ3NcbiAgICBBbm5vdGF0aW9ucy5vZih0aGlzKS5hZGRXYXJuaW5nKFxuICAgICAgW1xuICAgICAgICBcIkN1c3RvbVN0YXRlIGNvbnN0cnVjdHMgY2FuIGNvbmZpZ3VyZSBzdGF0ZSBjYXRjaGVycyB1c2luZyB0aGUgc3RhdGVKc29uIHByb3BlcnR5IG9yIGJ5IHVzaW5nIHRoZSBhZGRDYXRjaCgpIGZ1bmN0aW9uLlwiLFxuICAgICAgICBcIldoZW4gY2F0Y2hlcnMgYXJlIGNvbmZpZ3VyZWQgdXNpbmcgYm90aCBvZiB0aGVzZSwgdGhlIHN0YXRlIGRlZmluaXRpb24ncyBDYXRjaCBmaWVsZCBpcyBnZW5lcmF0ZWQgXCIsXG4gICAgICAgIFwiYnkgZmlyc3QgcmVuZGVyaW5nIGNhdGNoZXJzIGZyb20gYWRkQ2F0Y2goKSwgdGhlbiByZW5kZXJpbmcgY2F0Y2hlcnMgZnJvbSB0aGUgc3RhdGVKc29uLlwiLFxuICAgICAgXS5qb2luKFwiXFxuXCIpLFxuICAgICk7XG4gIH1cbn1cbiJdfQ==

package/lib/aws/compute/states/distributed-map/item-batcher.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Interface for ItemBatcher configuration properties
+ */
+export interface ItemBatcherProps {
+    /**
+     * MaxItemsPerBatch
+     *
+     * Specifies the maximum number of items that each child workflow execution processes, as static number
+     *
+     * @default - uses value of `maxItemsPerBatchPath` as the max items per batch,
+     *   no limits on the number of items in a batch under the 256KB limit if that property was also not provided
+     */
+    readonly maxItemsPerBatch?: number;
+    /**
+     * MaxItemsPerBatchPath
+     *
+     * Specifies the maximum number of items that each child workflow execution processes, as JsonPath
+     *
+     * @default - uses value of `maxItemsPerBatch` as the max items per batch,
+     *   no limits on the number of items in a batch under the 256KB limit if that property was also not provided
+     */
+    readonly maxItemsPerBatchPath?: string;
+    /**
+     * MaxInputBytesPerBatch
+     *
+     * Specifies the maximum number of bytes that each child workflow execution processes, as static number
+     *
+     * @default - uses value of `maxInputBytesPerBatchPath` as the max size per batch,
+     *   no limits on the batch size under the 256KB limit if that property was also not provided
+     */
+    readonly maxInputBytesPerBatch?: number;
+    /**
+     * MaxInputBytesPerBatchPath
+     *
+     * Specifies the maximum number of bytes that each child workflow execution processes, as JsonPath
+     *
+     * @default - uses value of `maxInputBytesPerBatch` as the max size per batch,
+     *   no limits on the batch size under the 256KB limit if that property was also not provided
+     */
+    readonly maxInputBytesPerBatchPath?: string;
+    /**
+     * BatchInput
+     *
+     * Fixed JSON input to include in each batch passed to each child workflow execution
+     *
+     * @default - No batchInput
+     */
+    readonly batchInput?: object;
+}
+/**
+ * Configuration for processing a group of items in a single child workflow execution
+ */
+export declare class ItemBatcher {
+    private props;
+    constructor(props: ItemBatcherProps);
+    /**
+     * Render ItemBatcher in ASL JSON format
+     */
+    render(): any;
+    /**
+     * Validate this ItemBatcher
+     */
+    validateItemBatcher(): string[];
+}

package/lib/aws/compute/states/distributed-map/item-batcher.js

@@ -0,0 +1,58 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ItemBatcher = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+/**
+ * Configuration for processing a group of items in a single child workflow execution
+ */
+class ItemBatcher {
+    constructor(props) {
+        this.props = props;
+    }
+    /**
+     * Render ItemBatcher in ASL JSON format
+     */
+    render() {
+        return {
+            ...(this.props.maxItemsPerBatch && {
+                MaxItemsPerBatch: this.props.maxItemsPerBatch,
+            }),
+            ...(this.props.maxItemsPerBatchPath && {
+                MaxItemsPerBatchPath: this.props.maxItemsPerBatchPath,
+            }),
+            ...(this.props.maxInputBytesPerBatch && {
+                MaxInputBytesPerBatch: this.props.maxInputBytesPerBatch,
+            }),
+            ...(this.props.maxInputBytesPerBatchPath && {
+                MaxInputBytesPerBatchPath: this.props.maxInputBytesPerBatchPath,
+            }),
+            ...(this.props.batchInput && { BatchInput: this.props.batchInput }),
+        };
+    }
+    /**
+     * Validate this ItemBatcher
+     */
+    validateItemBatcher() {
+        const errors = [];
+        if (this.props.maxItemsPerBatch && this.props.maxItemsPerBatchPath) {
+            errors.push("Provide either `maxItemsPerBatch` or `maxItemsPerBatchPath`, but not both");
+        }
+        if (this.props.maxInputBytesPerBatch &&
+            this.props.maxInputBytesPerBatchPath) {
+            errors.push("Provide either `maxInputBytesPerBatch` or `maxInputBytesPerBatchPath`, but not both");
+        }
+        if (!this.props.maxItemsPerBatch &&
+            !this.props.maxItemsPerBatchPath &&
+            !this.props.maxInputBytesPerBatch &&
+            !this.props.maxInputBytesPerBatchPath &&
+            !this.props.batchInput) {
+            errors.push("Provide at least one value to the ItemBatcher");
+        }
+        return errors;
+    }
+}
+exports.ItemBatcher = ItemBatcher;
+_a = JSII_RTTI_SYMBOL_1;
+ItemBatcher[_a] = { fqn: "terraconstructs.aws.compute.ItemBatcher", version: "0.0.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXRlbS1iYXRjaGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2F3cy9jb21wdXRlL3N0YXRlcy9kaXN0cmlidXRlZC1tYXAvaXRlbS1iYXRjaGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBd0RBOztHQUVHO0FBQ0gsTUFBYSxXQUFXO0lBR3RCLFlBQVksS0FBdUI7UUFDakMsSUFBSSxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUM7SUFDckIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTTtRQUNYLE9BQU87WUFDTCxHQUFHLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsSUFBSTtnQkFDakMsZ0JBQWdCLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxnQkFBZ0I7YUFDOUMsQ0FBQztZQUNGLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLG9CQUFvQixJQUFJO2dCQUNyQyxvQkFBb0IsRUFBRSxJQUFJLENBQUMsS0FBSyxDQUFDLG9CQUFvQjthQUN0RCxDQUFDO1lBQ0YsR0FBRyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMscUJBQXFCLElBQUk7Z0JBQ3RDLHFCQUFxQixFQUFFLElBQUksQ0FBQyxLQUFLLENBQUMscUJBQXFCO2FBQ3hELENBQUM7WUFDRixHQUFHLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyx5QkFBeUIsSUFBSTtnQkFDMUMseUJBQXlCLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyx5QkFBeUI7YUFDaEUsQ0FBQztZQUNGLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFVBQVUsSUFBSSxFQUFFLFVBQVUsRUFBRSxJQUFJLENBQUMsS0FBSyxDQUFDLFVBQVUsRUFBRSxDQUFDO1NBQ3BFLENBQUM7SUFDSixDQUFDO0lBRUQ7O09BRUc7SUFDSSxtQkFBbUI7UUFDeEIsTUFBTSxNQUFNLEdBQWEsRUFBRSxDQUFDO1FBQzVCLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxnQkFBZ0IsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLG9CQUFvQixFQUFFLENBQUM7WUFDbkUsTUFBTSxDQUFDLElBQUksQ0FDVCwyRUFBMkUsQ0FDNUUsQ0FBQztRQUNKLENBQUM7UUFFRCxJQUNFLElBQUksQ0FBQyxLQUFLLENBQUMscUJBQXFCO1lBQ2hDLElBQUksQ0FBQyxLQUFLLENBQUMseUJBQXlCLEVBQ3BDLENBQUM7WUFDRCxNQUFNLENBQUMsSUFBSSxDQUNULHFGQUFxRixDQUN0RixDQUFDO1FBQ0osQ0FBQztRQUVELElBQ0UsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLGdCQUFnQjtZQUM1QixDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsb0JBQW9CO1lBQ2hDLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxxQkFBcUI7WUFDakMsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLHlCQUF5QjtZQUNyQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsVUFBVSxFQUN0QixDQUFDO1lBQ0QsTUFBTSxDQUFDLElBQUksQ0FBQywrQ0FBK0MsQ0FBQyxDQUFDO1FBQy9ELENBQUM7UUFFRCxPQUFPLE1BQU0sQ0FBQztJQUNoQixDQUFDOztBQTNESCxrQ0E0REMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi92Mi4xNjAuMC9wYWNrYWdlcy9hd3MtY2RrLWxpYi9hd3Mtc3RlcGZ1bmN0aW9ucy9saWIvc3RhdGVzL2l0ZW0tYmF0Y2hlci50c1xuXG4vKipcbiAqIEludGVyZmFjZSBmb3IgSXRlbUJhdGNoZXIgY29uZmlndXJhdGlvbiBwcm9wZXJ0aWVzXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSXRlbUJhdGNoZXJQcm9wcyB7XG4gIC8qKlxuICAgKiBNYXhJdGVtc1BlckJhdGNoXG4gICAqXG4gICAqIFNwZWNpZmllcyB0aGUgbWF4aW11bSBudW1iZXIgb2YgaXRlbXMgdGhhdCBlYWNoIGNoaWxkIHdvcmtmbG93IGV4ZWN1dGlvbiBwcm9jZXNzZXMsIGFzIHN0YXRpYyBudW1iZXJcbiAgICpcbiAgICogQGRlZmF1bHQgLSB1c2VzIHZhbHVlIG9mIGBtYXhJdGVtc1BlckJhdGNoUGF0aGAgYXMgdGhlIG1heCBpdGVtcyBwZXIgYmF0Y2gsXG4gICAqICAgbm8gbGltaXRzIG9uIHRoZSBudW1iZXIgb2YgaXRlbXMgaW4gYSBiYXRjaCB1bmRlciB0aGUgMjU2S0IgbGltaXQgaWYgdGhhdCBwcm9wZXJ0eSB3YXMgYWxzbyBub3QgcHJvdmlkZWRcbiAgICovXG4gIHJlYWRvbmx5IG1heEl0ZW1zUGVyQmF0Y2g/OiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIE1heEl0ZW1zUGVyQmF0Y2hQYXRoXG4gICAqXG4gICAqIFNwZWNpZmllcyB0aGUgbWF4aW11bSBudW1iZXIgb2YgaXRlbXMgdGhhdCBlYWNoIGNoaWxkIHdvcmtmbG93IGV4ZWN1dGlvbiBwcm9jZXNzZXMsIGFzIEpzb25QYXRoXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gdXNlcyB2YWx1ZSBvZiBgbWF4SXRlbXNQZXJCYXRjaGAgYXMgdGhlIG1heCBpdGVtcyBwZXIgYmF0Y2gsXG4gICAqICAgbm8gbGltaXRzIG9uIHRoZSBudW1iZXIgb2YgaXRlbXMgaW4gYSBiYXRjaCB1bmRlciB0aGUgMjU2S0IgbGltaXQgaWYgdGhhdCBwcm9wZXJ0eSB3YXMgYWxzbyBub3QgcHJvdmlkZWRcbiAgICovXG4gIHJlYWRvbmx5IG1heEl0ZW1zUGVyQmF0Y2hQYXRoPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBNYXhJbnB1dEJ5dGVzUGVyQmF0Y2hcbiAgICpcbiAgICogU3BlY2lmaWVzIHRoZSBtYXhpbXVtIG51bWJlciBvZiBieXRlcyB0aGF0IGVhY2ggY2hpbGQgd29ya2Zsb3cgZXhlY3V0aW9uIHByb2Nlc3NlcywgYXMgc3RhdGljIG51bWJlclxuICAgKlxuICAgKiBAZGVmYXVsdCAtIHVzZXMgdmFsdWUgb2YgYG1heElucHV0Qnl0ZXNQZXJCYXRjaFBhdGhgIGFzIHRoZSBtYXggc2l6ZSBwZXIgYmF0Y2gsXG4gICAqICAgbm8gbGltaXRzIG9uIHRoZSBiYXRjaCBzaXplIHVuZGVyIHRoZSAyNTZLQiBsaW1pdCBpZiB0aGF0IHByb3BlcnR5IHdhcyBhbHNvIG5vdCBwcm92aWRlZFxuICAgKi9cbiAgcmVhZG9ubHkgbWF4SW5wdXRCeXRlc1BlckJhdGNoPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBNYXhJbnB1dEJ5dGVzUGVyQmF0Y2hQYXRoXG4gICAqXG4gICAqIFNwZWNpZmllcyB0aGUgbWF4aW11bSBudW1iZXIgb2YgYnl0ZXMgdGhhdCBlYWNoIGNoaWxkIHdvcmtmbG93IGV4ZWN1dGlvbiBwcm9jZXNzZXMsIGFzIEpzb25QYXRoXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gdXNlcyB2YWx1ZSBvZiBgbWF4SW5wdXRCeXRlc1BlckJhdGNoYCBhcyB0aGUgbWF4IHNpemUgcGVyIGJhdGNoLFxuICAgKiAgIG5vIGxpbWl0cyBvbiB0aGUgYmF0Y2ggc2l6ZSB1bmRlciB0aGUgMjU2S0IgbGltaXQgaWYgdGhhdCBwcm9wZXJ0eSB3YXMgYWxzbyBub3QgcHJvdmlkZWRcbiAgICovXG4gIHJlYWRvbmx5IG1heElucHV0Qnl0ZXNQZXJCYXRjaFBhdGg/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEJhdGNoSW5wdXRcbiAgICpcbiAgICogRml4ZWQgSlNPTiBpbnB1dCB0byBpbmNsdWRlIGluIGVhY2ggYmF0Y2ggcGFzc2VkIHRvIGVhY2ggY2hpbGQgd29ya2Zsb3cgZXhlY3V0aW9uXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gTm8gYmF0Y2hJbnB1dFxuICAgKi9cbiAgcmVhZG9ubHkgYmF0Y2hJbnB1dD86IG9iamVjdDtcbn1cblxuLyoqXG4gKiBDb25maWd1cmF0aW9uIGZvciBwcm9jZXNzaW5nIGEgZ3JvdXAgb2YgaXRlbXMgaW4gYSBzaW5nbGUgY2hpbGQgd29ya2Zsb3cgZXhlY3V0aW9uXG4gKi9cbmV4cG9ydCBjbGFzcyBJdGVtQmF0Y2hlciB7XG4gIHByaXZhdGUgcHJvcHM6IEl0ZW1CYXRjaGVyUHJvcHM7XG5cbiAgY29uc3RydWN0b3IocHJvcHM6IEl0ZW1CYXRjaGVyUHJvcHMpIHtcbiAgICB0aGlzLnByb3BzID0gcHJvcHM7XG4gIH1cblxuICAvKipcbiAgICogUmVuZGVyIEl0ZW1CYXRjaGVyIGluIEFTTCBKU09OIGZvcm1hdFxuICAgKi9cbiAgcHVibGljIHJlbmRlcigpOiBhbnkge1xuICAgIHJldHVybiB7XG4gICAgICAuLi4odGhpcy5wcm9wcy5tYXhJdGVtc1BlckJhdGNoICYmIHtcbiAgICAgICAgTWF4SXRlbXNQZXJCYXRjaDogdGhpcy5wcm9wcy5tYXhJdGVtc1BlckJhdGNoLFxuICAgICAgfSksXG4gICAgICAuLi4odGhpcy5wcm9wcy5tYXhJdGVtc1BlckJhdGNoUGF0aCAmJiB7XG4gICAgICAgIE1heEl0ZW1zUGVyQmF0Y2hQYXRoOiB0aGlzLnByb3BzLm1heEl0ZW1zUGVyQmF0Y2hQYXRoLFxuICAgICAgfSksXG4gICAgICAuLi4odGhpcy5wcm9wcy5tYXhJbnB1dEJ5dGVzUGVyQmF0Y2ggJiYge1xuICAgICAgICBNYXhJbnB1dEJ5dGVzUGVyQmF0Y2g6IHRoaXMucHJvcHMubWF4SW5wdXRCeXRlc1BlckJhdGNoLFxuICAgICAgfSksXG4gICAgICAuLi4odGhpcy5wcm9wcy5tYXhJbnB1dEJ5dGVzUGVyQmF0Y2hQYXRoICYmIHtcbiAgICAgICAgTWF4SW5wdXRCeXRlc1BlckJhdGNoUGF0aDogdGhpcy5wcm9wcy5tYXhJbnB1dEJ5dGVzUGVyQmF0Y2hQYXRoLFxuICAgICAgfSksXG4gICAgICAuLi4odGhpcy5wcm9wcy5iYXRjaElucHV0ICYmIHsgQmF0Y2hJbnB1dDogdGhpcy5wcm9wcy5iYXRjaElucHV0IH0pLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogVmFsaWRhdGUgdGhpcyBJdGVtQmF0Y2hlclxuICAgKi9cbiAgcHVibGljIHZhbGlkYXRlSXRlbUJhdGNoZXIoKTogc3RyaW5nW10ge1xuICAgIGNvbnN0IGVycm9yczogc3RyaW5nW10gPSBbXTtcbiAgICBpZiAodGhpcy5wcm9wcy5tYXhJdGVtc1BlckJhdGNoICYmIHRoaXMucHJvcHMubWF4SXRlbXNQZXJCYXRjaFBhdGgpIHtcbiAgICAgIGVycm9ycy5wdXNoKFxuICAgICAgICBcIlByb3ZpZGUgZWl0aGVyIGBtYXhJdGVtc1BlckJhdGNoYCBvciBgbWF4SXRlbXNQZXJCYXRjaFBhdGhgLCBidXQgbm90IGJvdGhcIixcbiAgICAgICk7XG4gICAgfVxuXG4gICAgaWYgKFxuICAgICAgdGhpcy5wcm9wcy5tYXhJbnB1dEJ5dGVzUGVyQmF0Y2ggJiZcbiAgICAgIHRoaXMucHJvcHMubWF4SW5wdXRCeXRlc1BlckJhdGNoUGF0aFxuICAgICkge1xuICAgICAgZXJyb3JzLnB1c2goXG4gICAgICAgIFwiUHJvdmlkZSBlaXRoZXIgYG1heElucHV0Qnl0ZXNQZXJCYXRjaGAgb3IgYG1heElucHV0Qnl0ZXNQZXJCYXRjaFBhdGhgLCBidXQgbm90IGJvdGhcIixcbiAgICAgICk7XG4gICAgfVxuXG4gICAgaWYgKFxuICAgICAgIXRoaXMucHJvcHMubWF4SXRlbXNQZXJCYXRjaCAmJlxuICAgICAgIXRoaXMucHJvcHMubWF4SXRlbXNQZXJCYXRjaFBhdGggJiZcbiAgICAgICF0aGlzLnByb3BzLm1heElucHV0Qnl0ZXNQZXJCYXRjaCAmJlxuICAgICAgIXRoaXMucHJvcHMubWF4SW5wdXRCeXRlc1BlckJhdGNoUGF0aCAmJlxuICAgICAgIXRoaXMucHJvcHMuYmF0Y2hJbnB1dFxuICAgICkge1xuICAgICAgZXJyb3JzLnB1c2goXCJQcm92aWRlIGF0IGxlYXN0IG9uZSB2YWx1ZSB0byB0aGUgSXRlbUJhdGNoZXJcIik7XG4gICAgfVxuXG4gICAgcmV0dXJuIGVycm9ycztcbiAgfVxufVxuIl19

package/lib/aws/compute/states/distributed-map/item-reader.d.ts

@@ -0,0 +1,256 @@
+import { Construct } from "constructs";
+import * as iam from "../../../iam";
+import { IBucket } from "../../../storage";
+/**
+ * Base interface for Item Reader configurations
+ */
+export interface IItemReader {
+    /**
+     * S3 Bucket containing objects to iterate over or a file with a list to iterate over
+     */
+    readonly bucket?: IBucket;
+    /**
+     * S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath
+     */
+    readonly bucketNamePath?: string;
+    /**
+     * The Amazon S3 API action that Step Functions must invoke depending on the specified dataset.
+     */
+    readonly resource: string;
+    /**
+     * Limits the number of items passed to the Distributed Map state
+     *
+     * @default - Distributed Map state will iterate over all items provided by the ItemReader
+     */
+    readonly maxItems?: number;
+    /**
+     * Render the ItemReader as JSON object
+     */
+    render(): any;
+    /**
+     * Compile policy statements to provide relevent permissions to the state machine
+     */
+    providePolicyStatements(): iam.PolicyStatement[];
+    /**
+     * Validate that ItemReader contains exactly either @see bucket or @see bucketNamePath
+     */
+    validateItemReader(): string[];
+}
+/**
+ * Base interface for Item Reader configuration properties
+ */
+export interface ItemReaderProps {
+    /**
+     * S3 Bucket containing objects to iterate over or a file with a list to iterate over
+     *
+     * @default - S3 bucket will be determined from @see bucketNamePath
+     */
+    readonly bucket?: IBucket;
+    /**
+     * S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath
+     *
+     * @default - S3 bucket will be determined from @see bucket
+     */
+    readonly bucketNamePath?: string;
+    /**
+     * S3 bucket name scope, only required if @see bucketNamePath is provided
+     */
+    readonly bucketNameScope?: Construct;
+    /**
+     * Limits the number of items passed to the Distributed Map state
+     *
+     * @default - Distributed Map state will iterate over all items provided by the ItemReader
+     */
+    readonly maxItems?: number;
+}
+/**
+ * Properties for configuring an Item Reader that iterates over objects in an S3 bucket
+ */
+export interface S3ObjectsItemReaderProps extends ItemReaderProps {
+    /**
+     * S3 prefix used to limit objects to iterate over
+     *
+     * @default - No prefix
+     */
+    readonly prefix?: string;
+}
+/**
+ * Item Reader configuration for iterating over objects in an S3 bucket
+ */
+export declare class S3ObjectsItemReader implements IItemReader {
+    /**
+     * S3 Bucket containing objects to iterate over
+     */
+    readonly bucket?: IBucket;
+    /**
+     * S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath
+     */
+    readonly bucketNamePath?: string;
+    /**
+     * ARN for the `listObjectsV2` method of the S3 API
+     * This API method is used to iterate all objects in the S3 bucket/prefix
+     */
+    readonly resource: string;
+    /**
+     * S3 prefix used to limit objects to iterate over
+     *
+     * @default - No prefix
+     */
+    readonly prefix?: string;
+    /**
+     * Limits the number of items passed to the Distributed Map state
+     *
+     * @default - Distributed Map state will iterate over all items provided by the ItemReader
+     */
+    readonly maxItems?: number;
+    /**
+     * S3 bucket name scope
+     */
+    readonly bucketNameScope?: Construct;
+    protected get partition(): string;
+    constructor(props: S3ObjectsItemReaderProps);
+    /**
+     * Renders the ItemReader configuration as JSON object
+     * @returns - JSON object
+     */
+    render(): any;
+    /**
+     * Compile policy statements to provide relevent permissions to the state machine
+     */
+    providePolicyStatements(): iam.PolicyStatement[];
+    /**
+     * Validate that ItemReader contains exactly either @see bucket or @see bucketNamePath
+     */
+    validateItemReader(): string[];
+}
+/**
+ * Base interface for Item Reader configuration properties the iterate over entries in a S3 file
+ */
+export interface S3FileItemReaderProps extends ItemReaderProps {
+    /**
+     * Key of file stored in S3 bucket containing an array to iterate over
+     */
+    readonly key: string;
+}
+/**
+ * Base Item Reader configuration for iterating over entries in a S3 file
+ */
+declare abstract class S3FileItemReader implements IItemReader {
+    /**
+     * S3 Bucket containing a file with a list to iterate over
+     */
+    readonly bucket?: IBucket;
+    /**
+     * S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath
+     */
+    readonly bucketNamePath?: string;
+    /**
+     * S3 key of a file with a list to iterate over
+     */
+    readonly key: string;
+    /**
+     * ARN for the `getObject` method of the S3 API
+     * This API method is used to iterate all objects in the S3 bucket/prefix
+     */
+    readonly resource: string;
+    /**
+     * Limits the number of items passed to the Distributed Map state
+     *
+     * @default - No maxItems
+     */
+    readonly maxItems?: number;
+    /**
+     * S3 bucket name scope
+     */
+    readonly bucketNameScope?: Construct;
+    protected get partition(): string;
+    protected abstract readonly inputType: string;
+    constructor(props: S3FileItemReaderProps);
+    /**
+     * Renders the ItemReader configuration as JSON object
+     * @returns - JSON object
+     */
+    render(): any;
+    /**
+     * Compile policy statements to provide relevent permissions to the state machine
+     */
+    providePolicyStatements(): iam.PolicyStatement[];
+    /**
+     * Validate that ItemReader contains exactly either @see bucket or @see bucketNamePath and @see bucketNameScope
+     */
+    validateItemReader(): string[];
+}
+/**
+ * Item Reader configuration for iterating over items in a JSON array stored in a S3 file
+ */
+export declare class S3JsonItemReader extends S3FileItemReader {
+    protected readonly inputType: string;
+}
+/**
+ * CSV header location options
+ */
+export declare enum CsvHeaderLocation {
+    /**
+     * Headers will be read from first row of CSV file
+     */
+    FIRST_ROW = "FIRST_ROW",
+    /**
+     * Headers are provided in CSVHeaders property
+     */
+    GIVEN = "GIVEN"
+}
+/**
+ * Configuration for CSV header options for a CSV Item Reader
+ */
+export declare class CsvHeaders {
+    /**
+     * Configures S3CsvItemReader to read headers from the first row of the CSV file
+     * @returns - CsvHeaders
+     */
+    static useFirstRow(): CsvHeaders;
+    /**
+     * Configures S3CsvItemReader to use the headers provided in the `headers` parameter
+     * @param headers - List of headers
+     * @returns - CsvHeaders
+     */
+    static use(headers: string[]): CsvHeaders;
+    /**
+     * Location of headers in CSV file
+     */
+    readonly headerLocation: CsvHeaderLocation;
+    /**
+     * List of headers if `headerLocation` is `GIVEN`
+     */
+    readonly headers?: string[];
+    private constructor();
+}
+/**
+ * Properties for configuring an Item Reader that iterates over items in a CSV file in S3
+ */
+export interface S3CsvItemReaderProps extends S3FileItemReaderProps {
+    /**
+     * CSV file header configuration
+     *
+     * @default - CsvHeaders with CsvHeadersLocation.FIRST_ROW
+     */
+    readonly csvHeaders?: CsvHeaders;
+}
+/**
+ * Item Reader configuration for iterating over items in a CSV file stored in S3
+ */
+export declare class S3CsvItemReader extends S3FileItemReader {
+    /**
+     * CSV headers configuration
+     */
+    readonly csvHeaders: CsvHeaders;
+    protected readonly inputType: string;
+    constructor(props: S3CsvItemReaderProps);
+    render(): any;
+}
+/**
+ * Item Reader configuration for iterating over items in a S3 inventory manifest file stored in S3
+ */
+export declare class S3ManifestItemReader extends S3FileItemReader {
+    protected readonly inputType: string;
+}
+export {};