terraconstructs 0.0.25 → 0.1.1

package/lib/aws/compute/cors.js

@@ -0,0 +1,33 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cors = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const apigateway_util_1 = require("./apigateway-util");
+class Cors {
+    // utility class
+    constructor() { }
+}
+exports.Cors = Cors;
+_a = JSII_RTTI_SYMBOL_1;
+Cors[_a] = { fqn: "terraconstructs.aws.compute.Cors", version: "0.1.1" };
+/**
+ * All HTTP methods.
+ */
+Cors.ALL_METHODS = apigateway_util_1.ALL_METHODS;
+/**
+ * All origins.
+ */
+Cors.ALL_ORIGINS = ["*"];
+/**
+ * The set of default headers allowed for CORS and useful for API Gateway.
+ */
+Cors.DEFAULT_HEADERS = [
+    "Content-Type",
+    "X-Amz-Date",
+    "Authorization",
+    "X-Api-Key",
+    "X-Amz-Security-Token",
+    "X-Amz-User-Agent",
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29ycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hd3MvY29tcHV0ZS9jb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsdURBQWdEO0FBaUdoRCxNQUFhLElBQUk7SUF1QmYsZ0JBQWdCO0lBQ2hCLGdCQUF1QixDQUFDOztBQXhCMUIsb0JBeUJDOzs7QUF4QkM7O0dBRUc7QUFDb0IsZ0JBQVcsR0FBRyw2QkFBVyxDQUFDO0FBRWpEOztHQUVHO0FBQ29CLGdCQUFXLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUUzQzs7R0FFRztBQUNvQixvQkFBZSxHQUFHO0lBQ3ZDLGNBQWM7SUFDZCxZQUFZO0lBQ1osZUFBZTtJQUNmLFdBQVc7SUFDWCxzQkFBc0I7SUFDdEIsa0JBQWtCO0NBQ25CLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBBTExfTUVUSE9EUyB9IGZyb20gXCIuL2FwaWdhdGV3YXktdXRpbFwiO1xuaW1wb3J0IHsgRHVyYXRpb24gfSBmcm9tIFwiLi4vLi4vZHVyYXRpb25cIjtcblxuZXhwb3J0IGludGVyZmFjZSBDb3JzT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBTcGVjaWZpZXMgdGhlIHJlc3BvbnNlIHN0YXR1cyBjb2RlIHJldHVybmVkIGZyb20gdGhlIE9QVElPTlMgbWV0aG9kLlxuICAgKlxuICAgKiBAZGVmYXVsdCAyMDRcbiAgICovXG4gIHJlYWRvbmx5IHN0YXR1c0NvZGU/OiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIFNwZWNpZmllcyB0aGUgbGlzdCBvZiBvcmlnaW5zIHRoYXQgYXJlIGFsbG93ZWQgdG8gbWFrZSByZXF1ZXN0cyB0byB0aGlzXG4gICAqIHJlc291cmNlLiBJZiB5b3Ugd2lzaCB0byBhbGxvdyBhbGwgb3JpZ2lucywgc3BlY2lmeSBgQ29ycy5BTExfT1JJR0lOU2Agb3JcbiAgICogYFsgKiBdYC5cbiAgICpcbiAgICogUmVzcG9uc2VzIHdpbGwgaW5jbHVkZSB0aGUgYEFjY2Vzcy1Db250cm9sLUFsbG93LU9yaWdpbmAgcmVzcG9uc2UgaGVhZGVyLlxuICAgKiBJZiBzcGVjaWZpYyBvcmlnaW5zIGFyZSBzcGVjaWZpZWQgKG5vdCBgQ29ycy5BTExfT1JJR0lOU2ApLCB0aGUgYFZhcnk6IE9yaWdpbmBcbiAgICogcmVzcG9uc2UgaGVhZGVyIHdpbGwgYWxzbyBiZSBpbmNsdWRlZC5cbiAgICpcbiAgICogQHNlZSBodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZy9lbi1VUy9kb2NzL1dlYi9IVFRQL0hlYWRlcnMvQWNjZXNzLUNvbnRyb2wtQWxsb3ctT3JpZ2luXG4gICAqL1xuICByZWFkb25seSBhbGxvd09yaWdpbnM6IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgQWNjZXNzLUNvbnRyb2wtQWxsb3ctSGVhZGVycyByZXNwb25zZSBoZWFkZXIgaXMgdXNlZCBpbiByZXNwb25zZSB0byBhXG4gICAqIHByZWZsaWdodCByZXF1ZXN0IHdoaWNoIGluY2x1ZGVzIHRoZSBBY2Nlc3MtQ29udHJvbC1SZXF1ZXN0LUhlYWRlcnMgdG9cbiAgICogaW5kaWNhdGUgd2hpY2ggSFRUUCBoZWFkZXJzIGNhbiBiZSB1c2VkIGR1cmluZyB0aGUgYWN0dWFsIHJlcXVlc3QuXG4gICAqXG4gICAqIEBzZWUgaHR0cHM6Ly9kZXZlbG9wZXIubW96aWxsYS5vcmcvZW4tVVMvZG9jcy9XZWIvSFRUUC9IZWFkZXJzL0FjY2Vzcy1Db250cm9sLUFsbG93LUhlYWRlcnNcbiAgICogQGRlZmF1bHQgQ29ycy5ERUZBVUxUX0hFQURFUlNcbiAgICovXG4gIHJlYWRvbmx5IGFsbG93SGVhZGVycz86IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgQWNjZXNzLUNvbnRyb2wtQWxsb3ctTWV0aG9kcyByZXNwb25zZSBoZWFkZXIgc3BlY2lmaWVzIHRoZSBtZXRob2Qgb3JcbiAgICogbWV0aG9kcyBhbGxvd2VkIHdoZW4gYWNjZXNzaW5nIHRoZSByZXNvdXJjZSBpbiByZXNwb25zZSB0byBhIHByZWZsaWdodCByZXF1ZXN0LlxuICAgKlxuICAgKiBJZiBgQU5ZYCBpcyBzcGVjaWZpZWQsIGl0IHdpbGwgYmUgZXhwYW5kZWQgdG8gYENvcnMuQUxMX01FVEhPRFNgLlxuICAgKlxuICAgKiBAc2VlIGh0dHBzOi8vZGV2ZWxvcGVyLm1vemlsbGEub3JnL2VuLVVTL2RvY3MvV2ViL0hUVFAvSGVhZGVycy9BY2Nlc3MtQ29udHJvbC1BbGxvdy1NZXRob2RzXG4gICAqIEBkZWZhdWx0IENvcnMuQUxMX01FVEhPRFNcbiAgICovXG4gIHJlYWRvbmx5IGFsbG93TWV0aG9kcz86IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgQWNjZXNzLUNvbnRyb2wtQWxsb3ctQ3JlZGVudGlhbHMgcmVzcG9uc2UgaGVhZGVyIHRlbGxzIGJyb3dzZXJzIHdoZXRoZXJcbiAgICogdG8gZXhwb3NlIHRoZSByZXNwb25zZSB0byBmcm9udGVuZCBKYXZhU2NyaXB0IGNvZGUgd2hlbiB0aGUgcmVxdWVzdCdzXG4gICAqIGNyZWRlbnRpYWxzIG1vZGUgKFJlcXVlc3QuY3JlZGVudGlhbHMpIGlzIFwiaW5jbHVkZVwiLlxuICAgKlxuICAgKiBXaGVuIGEgcmVxdWVzdCdzIGNyZWRlbnRpYWxzIG1vZGUgKFJlcXVlc3QuY3JlZGVudGlhbHMpIGlzIFwiaW5jbHVkZVwiLFxuICAgKiBicm93c2VycyB3aWxsIG9ubHkgZXhwb3NlIHRoZSByZXNwb25zZSB0byBmcm9udGVuZCBKYXZhU2NyaXB0IGNvZGUgaWYgdGhlXG4gICAqIEFjY2Vzcy1Db250cm9sLUFsbG93LUNyZWRlbnRpYWxzIHZhbHVlIGlzIHRydWUuXG4gICAqXG4gICAqIENyZWRlbnRpYWxzIGFyZSBjb29raWVzLCBhdXRob3JpemF0aW9uIGhlYWRlcnMgb3IgVExTIGNsaWVudCBjZXJ0aWZpY2F0ZXMuXG4gICAqIEBzZWUgaHR0cHM6Ly9kZXZlbG9wZXIubW96aWxsYS5vcmcvZW4tVVMvZG9jcy9XZWIvSFRUUC9IZWFkZXJzL0FjY2Vzcy1Db250cm9sLUFsbG93LUNyZWRlbnRpYWxzXG4gICAqIEBkZWZhdWx0IGZhbHNlXG4gICAqL1xuICByZWFkb25seSBhbGxvd0NyZWRlbnRpYWxzPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogVGhlIEFjY2Vzcy1Db250cm9sLU1heC1BZ2UgcmVzcG9uc2UgaGVhZGVyIGluZGljYXRlcyBob3cgbG9uZyB0aGUgcmVzdWx0cyBvZlxuICAgKiBhIHByZWZsaWdodCByZXF1ZXN0ICh0aGF0IGlzIHRoZSBpbmZvcm1hdGlvbiBjb250YWluZWQgaW4gdGhlXG4gICAqIEFjY2Vzcy1Db250cm9sLUFsbG93LU1ldGhvZHMgYW5kIEFjY2Vzcy1Db250cm9sLUFsbG93LUhlYWRlcnMgaGVhZGVycylcbiAgICogY2FuIGJlIGNhY2hlZC5cbiAgICpcbiAgICogVG8gZGlzYWJsZSBjYWNoaW5nIGFsdG9nZXRoZXIgdXNlIGBkaXNhYmxlQ2FjaGU6IHRydWVgLlxuICAgKlxuICAgKiBAc2VlIGh0dHBzOi8vZGV2ZWxvcGVyLm1vemlsbGEub3JnL2VuLVVTL2RvY3MvV2ViL0hUVFAvSGVhZGVycy9BY2Nlc3MtQ29udHJvbC1NYXgtQWdlXG4gICAqIEBkZWZhdWx0IC0gYnJvd3Nlci1zcGVjaWZpYyAoc2VlIHJlZmVyZW5jZSlcbiAgICovXG4gIHJlYWRvbmx5IG1heEFnZT86IER1cmF0aW9uO1xuXG4gIC8qKlxuICAgKiBTZXRzIEFjY2Vzcy1Db250cm9sLU1heC1BZ2UgdG8gLTEsIHdoaWNoIG1lYW5zIHRoYXQgY2FjaGluZyBpcyBkaXNhYmxlZC5cbiAgICogVGhpcyBvcHRpb24gY2Fubm90IGJlIHVzZWQgd2l0aCBgbWF4QWdlYC5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBjYWNoZSBpcyBlbmFibGVkXG4gICAqL1xuICByZWFkb25seSBkaXNhYmxlQ2FjaGU/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgQWNjZXNzLUNvbnRyb2wtRXhwb3NlLUhlYWRlcnMgcmVzcG9uc2UgaGVhZGVyIGluZGljYXRlcyB3aGljaCBoZWFkZXJzXG4gICAqIGNhbiBiZSBleHBvc2VkIGFzIHBhcnQgb2YgdGhlIHJlc3BvbnNlIGJ5IGxpc3RpbmcgdGhlaXIgbmFtZXMuXG4gICAqXG4gICAqIElmIHlvdSB3YW50IGNsaWVudHMgdG8gYmUgYWJsZSB0byBhY2Nlc3Mgb3RoZXIgaGVhZGVycywgeW91IGhhdmUgdG8gbGlzdFxuICAgKiB0aGVtIHVzaW5nIHRoZSBBY2Nlc3MtQ29udHJvbC1FeHBvc2UtSGVhZGVycyBoZWFkZXIuXG4gICAqXG4gICAqIEBzZWUgaHR0cHM6Ly9kZXZlbG9wZXIubW96aWxsYS5vcmcvZW4tVVMvZG9jcy9XZWIvSFRUUC9IZWFkZXJzL0FjY2Vzcy1Db250cm9sLUV4cG9zZS1IZWFkZXJzXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gb25seSB0aGUgNiBDT1JTLXNhZmVsaXN0ZWQgcmVzcG9uc2UgaGVhZGVycyBhcmUgZXhwb3NlZDpcbiAgICogQ2FjaGUtQ29udHJvbCwgQ29udGVudC1MYW5ndWFnZSwgQ29udGVudC1UeXBlLCBFeHBpcmVzLCBMYXN0LU1vZGlmaWVkLFxuICAgKiBQcmFnbWFcbiAgICovXG4gIHJlYWRvbmx5IGV4cG9zZUhlYWRlcnM/OiBzdHJpbmdbXTtcbn1cblxuZXhwb3J0IGNsYXNzIENvcnMge1xuICAvKipcbiAgICogQWxsIEhUVFAgbWV0aG9kcy5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgQUxMX01FVEhPRFMgPSBBTExfTUVUSE9EUztcblxuICAvKipcbiAgICogQWxsIG9yaWdpbnMuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIHJlYWRvbmx5IEFMTF9PUklHSU5TID0gW1wiKlwiXTtcblxuICAvKipcbiAgICogVGhlIHNldCBvZiBkZWZhdWx0IGhlYWRlcnMgYWxsb3dlZCBmb3IgQ09SUyBhbmQgdXNlZnVsIGZvciBBUEkgR2F0ZXdheS5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgREVGQVVMVF9IRUFERVJTID0gW1xuICAgIFwiQ29udGVudC1UeXBlXCIsXG4gICAgXCJYLUFtei1EYXRlXCIsXG4gICAgXCJBdXRob3JpemF0aW9uXCIsXG4gICAgXCJYLUFwaS1LZXlcIixcbiAgICBcIlgtQW16LVNlY3VyaXR5LVRva2VuXCIsXG4gICAgXCJYLUFtei1Vc2VyLUFnZW50XCIsXG4gIF07XG5cbiAgLy8gdXRpbGl0eSBjbGFzc1xuICBwcml2YXRlIGNvbnN0cnVjdG9yKCkge31cbn1cbiJdfQ==

package/lib/aws/compute/deployment.d.ts

@@ -0,0 +1,83 @@
+import { Construct } from "constructs";
+import { Method } from "./method";
+import { IRestApi } from "./restapi";
+import { AwsConstructBase, AwsConstructProps } from "../aws-construct";
+export interface DeploymentProps extends AwsConstructProps {
+    /**
+     * The Rest API to deploy.
+     */
+    readonly api: IRestApi;
+    /**
+     * A description of the purpose of the API Gateway deployment.
+     *
+     * @default - No description.
+     */
+    readonly description?: string;
+    /**
+     * The name of the stage the API Gateway deployment deploys to.
+     * If this property is set and a stage with the corresponding name does not exist,
+     * a new stage resource will be created and associated with this deployment.
+     *
+     * @default - No stage is created or associated with this deployment.
+     */
+    readonly stageName?: string;
+}
+/**
+ * A Deployment of a REST API.
+ *
+ * An immutable representation of a RestApi resource that can be called by users
+ * using Stages. A deployment must be associated with a Stage for it to be
+ * callable over the Internet.
+ *
+ * Normally, you don't need to define deployments manually. The RestApi
+ * construct manages a Deployment resource that represents the latest model. It
+ * can be accessed through `restApi.latestDeployment` (unless `deploy: false` is
+ * set when defining the `RestApi`).
+ *
+ * If you manually define this resource, you will need to know that since
+ * deployments are immutable, their properties will not change after creation.
+ * To reflect API model changes, a new deployment must be created. This is typically
+ * achieved by changing the `triggers` property of the `ApiGatewayDeployment` resource.
+ *
+ * The `addToTriggers` method can be used to augment the set of triggers for this
+ * deployment. This ensures that if specific parts of the API model change (e.g., a Method's configuration),
+ * a new deployment is triggered. This is done automatically for the `restApi.latestDeployment` deployment.
+ *
+ * Furthermore, a deployment should depend on all API Gateway resources (Methods, Resources, etc.)
+ * that define the API. Use the `_addMethodDependency` or directly add dependencies to ensure correct
+ * provisioning order. This is also handled for `restApi.latestDeployment`.
+ */
+export declare class Deployment extends AwsConstructBase {
+    readonly deploymentId: string;
+    readonly api: IRestApi;
+    /**
+     * The name of the stage created and associated with this deployment, if `stageName` was provided.
+     */
+    readonly stageName?: string;
+    private readonly deploymentResource;
+    private stageResource?;
+    private readonly triggerComponents;
+    constructor(scope: Construct, id: string, props: DeploymentProps);
+    private calculateTriggers;
+    /**
+     * Adds a component to the set of triggers that determine if a new deployment should be created.
+     *
+     * Triggers should be preferred over Dependencies, since Dependencies can only capture dependency
+     * ordering and will not cause the resource to recreate (redeploy the REST API) with upstream
+     * configuration changes.
+     *
+     * This should be called by constructs of the API Gateway model that want to
+     * invalidate the deployment when their settings change. The component will
+     * be resolved during synthesis so tokens are welcome.
+     */
+    addToTriggers(data: any): void;
+    /**
+     * Adds a dependency from this Deployment to an API Gateway Method.
+     * This ensures that the method is created before the deployment.
+     *
+     * @param method The Method construct to add as a dependency.
+     * @internal
+     */
+    _addMethodDependency(method: Method): void;
+    get outputs(): Record<string, any>;
+}

package/lib/aws/compute/deployment.js

@@ -0,0 +1,158 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deployment = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const provider_aws_1 = require("@cdktf/provider-aws");
+const cdktf_1 = require("cdktf");
+const restapi_1 = require("./restapi");
+// import { Fn } from "../../terra-func";
+const helpers_internal_1 = require("../../helpers-internal");
+const aws_construct_1 = require("../aws-construct");
+/**
+ * A Deployment of a REST API.
+ *
+ * An immutable representation of a RestApi resource that can be called by users
+ * using Stages. A deployment must be associated with a Stage for it to be
+ * callable over the Internet.
+ *
+ * Normally, you don't need to define deployments manually. The RestApi
+ * construct manages a Deployment resource that represents the latest model. It
+ * can be accessed through `restApi.latestDeployment` (unless `deploy: false` is
+ * set when defining the `RestApi`).
+ *
+ * If you manually define this resource, you will need to know that since
+ * deployments are immutable, their properties will not change after creation.
+ * To reflect API model changes, a new deployment must be created. This is typically
+ * achieved by changing the `triggers` property of the `ApiGatewayDeployment` resource.
+ *
+ * The `addToTriggers` method can be used to augment the set of triggers for this
+ * deployment. This ensures that if specific parts of the API model change (e.g., a Method's configuration),
+ * a new deployment is triggered. This is done automatically for the `restApi.latestDeployment` deployment.
+ *
+ * Furthermore, a deployment should depend on all API Gateway resources (Methods, Resources, etc.)
+ * that define the API. Use the `_addMethodDependency` or directly add dependencies to ensure correct
+ * provisioning order. This is also handled for `restApi.latestDeployment`.
+ */
+class Deployment extends aws_construct_1.AwsConstructBase {
+    constructor(scope, id, props) {
+        super(scope, id, props);
+        this.triggerComponents = new Array();
+        this.api = props.api;
+        this.deploymentResource = new provider_aws_1.apiGatewayDeployment.ApiGatewayDeployment(this, "Resource", {
+            restApiId: props.api.restApiId,
+            description: props.description,
+            // ensure lifecycle create before destroy is enabled unless explicitly set to false
+            lifecycle: {
+                createBeforeDestroy: props.lifecycle?.createBeforeDestroy ?? true, // default to true
+                ...props.lifecycle,
+            },
+        });
+        // Add triggers for redployment on checksum changes.
+        this.deploymentResource.addOverride("triggers", cdktf_1.Lazy.anyValue({
+            produce: () => this.calculateTriggers(),
+        }));
+        // TODO: Implement RemovalPolicy.RETAIN through removed block in Terraform.
+        // if (props.retainDeployments) {
+        //   this.deploymentResource.addOverride("lifecycle", {
+        //     prevent_destroy: true,
+        //   });
+        // }
+        this.deploymentId = this.deploymentResource.id;
+        if (props.stageName) {
+            this.stageName = props.stageName;
+            this.stageResource = new provider_aws_1.apiGatewayStage.ApiGatewayStage(this, "Stage", {
+                restApiId: props.api.restApiId,
+                deploymentId: this.deploymentResource.id,
+                stageName: props.stageName,
+                description: props.description
+                    ? `${props.description} Stage`
+                    : undefined,
+            });
+            // Dependencies on methods should be added to the deploymentResource itself.
+            // The stageResource implicitly depends on deploymentResource via deploymentId.
+        }
+        if (props.api instanceof restapi_1.RestApiBase) {
+            // The method _attachDeployment might need to be adapted or might not exist in TerraConstructs RestApiBase
+            // This is specific to how `latestDeployment` is managed by the RestApi construct.
+            props.api._attachDeployment?.(this);
+        }
+    }
+    calculateTriggers() {
+        const triggers = [...this.triggerComponents];
+        // Ignore IRestApi that are imported
+        if (this.api instanceof restapi_1.RestApi || this.api instanceof restapi_1.SpecRestApi) {
+            const apiInternal = this.api.node
+                .defaultChild;
+            // TODO: AWSCDK Triggers redeployment on any changes (not just the body property).
+            const tfRestAPI = apiInternal.toTerraform();
+            triggers.push(tfRestAPI.resource.aws_api_gateway_rest_api);
+        }
+        // NOTE: AWSCDK calculates checksum against function properties.
+        // Terraform allows use to include the entire object, so we use that for clarity.
+        const checksum = (0, helpers_internal_1.md5hash)(triggers
+            .map((x) => this.stack.resolve(x))
+            .map((c) => JSON.stringify(c))
+            .join(""));
+        // triggers has to be Record<string, string> for Terraform to accept it.
+        return { redeployment: checksum };
+        // // NOTE: consider checksum too confusing and use full trigger objects instead?
+        // // TODO: This causes "missing attributer separator" errors
+        // return triggers.length !== 0
+        //   ? { redeployment: Fn.sha1(Fn.jsonencode(this.stack.resolve(triggers))) }
+        //   : // TODO: Wrap each trigger in sha instead? { redeployment: Fn.sha1(Fn.jsonencode()) }
+        //     // triggers.reduce(
+        //     //   (acc, curr) => {
+        //     //     const key = `trigger-${Object.keys(acc).length + 1}`;
+        //     //     acc[key] = this.stack.resolve(curr);
+        //     //     return acc;
+        //     //   },
+        //     //   {} as { [key: string]: string },
+        //     // )
+        //     undefined;
+    }
+    /**
+     * Adds a component to the set of triggers that determine if a new deployment should be created.
+     *
+     * Triggers should be preferred over Dependencies, since Dependencies can only capture dependency
+     * ordering and will not cause the resource to recreate (redeploy the REST API) with upstream
+     * configuration changes.
+     *
+     * This should be called by constructs of the API Gateway model that want to
+     * invalidate the deployment when their settings change. The component will
+     * be resolved during synthesis so tokens are welcome.
+     */
+    addToTriggers(data) {
+        if (this.node.locked) {
+            throw new Error("Cannot modify deployment triggers when the construct is locked.");
+        }
+        this.triggerComponents.push(data);
+    }
+    /**
+     * Adds a dependency from this Deployment to an API Gateway Method.
+     * This ensures that the method is created before the deployment.
+     *
+     * @param method The Method construct to add as a dependency.
+     * @internal
+     */
+    _addMethodDependency(method) {
+        // adding a dependency between the constructs using `node.addDependency()`
+        // will create additional dependencies between `aws_api_gateway_deployment`
+        // and the `aws_lambda_permission` resources (children under Method),
+        // causing cyclic dependency errors. Hence, falling back to declaring
+        // dependencies between the underlying TerraformElements.
+        this.node.addDependency(method.node.defaultChild);
+        // TODO: Triggers are recommended instead of dependencies?
+    }
+    get outputs() {
+        return {
+            deploymentId: this.deploymentId,
+            stageName: this.stageName,
+            stageInvokeUrl: this.stageResource?.invokeUrl,
+        };
+    }
+}
+exports.Deployment = Deployment;
+_a = JSII_RTTI_SYMBOL_1;
+Deployment[_a] = { fqn: "terraconstructs.aws.compute.Deployment", version: "0.1.1" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVwbG95bWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hd3MvY29tcHV0ZS9kZXBsb3ltZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsc0RBSzZCO0FBQzdCLGlDQUE2QjtBQUc3Qix1Q0FBd0U7QUFDeEUseUNBQXlDO0FBQ3pDLDZEQUFpRDtBQUNqRCxvREFBdUU7QUFxQ3ZFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F3Qkc7QUFDSCxNQUFhLFVBQVcsU0FBUSxnQ0FBZ0I7SUFhOUMsWUFBWSxLQUFnQixFQUFFLEVBQVUsRUFBRSxLQUFzQjtRQUM5RCxLQUFLLENBQUMsS0FBSyxFQUFFLEVBQUUsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUhULHNCQUFpQixHQUFHLElBQUksS0FBSyxFQUFPLENBQUM7UUFLcEQsSUFBSSxDQUFDLEdBQUcsR0FBRyxLQUFLLENBQUMsR0FBRyxDQUFDO1FBRXJCLElBQUksQ0FBQyxrQkFBa0IsR0FBRyxJQUFJLG1DQUFvQixDQUFDLG9CQUFvQixDQUNyRSxJQUFJLEVBQ0osVUFBVSxFQUNWO1lBQ0UsU0FBUyxFQUFFLEtBQUssQ0FBQyxHQUFHLENBQUMsU0FBUztZQUM5QixXQUFXLEVBQUUsS0FBSyxDQUFDLFdBQVc7WUFDOUIsbUZBQW1GO1lBQ25GLFNBQVMsRUFBRTtnQkFDVCxtQkFBbUIsRUFBRSxLQUFLLENBQUMsU0FBUyxFQUFFLG1CQUFtQixJQUFJLElBQUksRUFBRSxrQkFBa0I7Z0JBQ3JGLEdBQUcsS0FBSyxDQUFDLFNBQVM7YUFDbkI7U0FDRixDQUNGLENBQUM7UUFFRixvREFBb0Q7UUFDcEQsSUFBSSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsQ0FDakMsVUFBVSxFQUNWLFlBQUksQ0FBQyxRQUFRLENBQUM7WUFDWixPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLGlCQUFpQixFQUFFO1NBQ3hDLENBQUMsQ0FDSCxDQUFDO1FBRUYsMkVB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RUFBMEU7UUFDMUUsMkVBQTJFO1FBQzNFLHFFQUFxRTtRQUNyRSxxRUFBcUU7UUFDckUseURBQXlEO1FBQ3pELElBQUksQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUNyQixNQUFNLENBQUMsSUFBSSxDQUFDLFlBQWlELENBQzlELENBQUM7UUFFRiwwREFBMEQ7SUFDNUQsQ0FBQztJQUVELElBQVcsT0FBTztRQUNoQixPQUFPO1lBQ0wsWUFBWSxFQUFFLElBQUksQ0FBQyxZQUFZO1lBQy9CLFNBQVMsRUFBRSxJQUFJLENBQUMsU0FBUztZQUN6QixjQUFjLEVBQUUsSUFBSSxDQUFDLGFBQWEsRUFBRSxTQUFTO1NBQzlDLENBQUM7SUFDSixDQUFDOztBQTNKSCxnQ0E0SkMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuICBhcGlHYXRld2F5RGVwbG95bWVudCxcbiAgYXBpR2F0ZXdheU1ldGhvZCxcbiAgYXBpR2F0ZXdheVJlc3RBcGksXG4gIGFwaUdhdGV3YXlTdGFnZSxcbn0gZnJvbSBcIkBjZGt0Zi9wcm92aWRlci1hd3NcIjtcbmltcG9ydCB7IExhenkgfSBmcm9tIFwiY2RrdGZcIjtcbmltcG9ydCB7IENvbnN0cnVjdCB9IGZyb20gXCJjb25zdHJ1Y3RzXCI7XG5pbXBvcnQgeyBNZXRob2QgfSBmcm9tIFwiLi9tZXRob2RcIjtcbmltcG9ydCB7IElSZXN0QXBpLCBSZXN0QXBpLCBSZXN0QXBpQmFzZSwgU3BlY1Jlc3RBcGkgfSBmcm9tIFwiLi9yZXN0YXBpXCI7XG4vLyBpbXBvcnQgeyBGbiB9IGZyb20gXCIuLi8uLi90ZXJyYS1mdW5jXCI7XG5pbXBvcnQgeyBtZDVoYXNoIH0gZnJvbSBcIi4uLy4uL2hlbHBlcnMtaW50ZXJuYWxcIjtcbmltcG9ydCB7IEF3c0NvbnN0cnVjdEJhc2UsIEF3c0NvbnN0cnVjdFByb3BzIH0gZnJvbSBcIi4uL2F3cy1jb25zdHJ1Y3RcIjtcblxuZXhwb3J0IGludGVyZmFjZSBEZXBsb3ltZW50UHJvcHMgZXh0ZW5kcyBBd3NDb25zdHJ1Y3RQcm9wcyB7XG4gIC8qKlxuICAgKiBUaGUgUmVzdCBBUEkgdG8gZGVwbG95LlxuICAgKi9cbiAgcmVhZG9ubHkgYXBpOiBJUmVzdEFwaTtcblxuICAvKipcbiAgICogQSBkZXNjcmlwdGlvbiBvZiB0aGUgcHVycG9zZSBvZiB0aGUgQVBJIEdhdGV3YXkgZGVwbG95bWVudC5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBObyBkZXNjcmlwdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IGRlc2NyaXB0aW9uPzogc3RyaW5nO1xuXG4gIC8vIC8vIFRPRE86IEltcGxlbWVudCBSZW1vdmFsUG9saWN5LlJFVEFJTiB0aHJvdWdoIHJlbW92ZWQgYmxvY2sgaW4gVGVycmFmb3JtLlxuICAvLyAvLyByZWY6IGh0dHBzOi8vZ2l0aHViLmNvbS9oYXNoaWNvcnAvdGVycmFmb3JtL2lzc3Vlcy8yNzAzNSNpc3N1ZWNvbW1lbnQtMjM0MDM0ODgwMVxuICAvLyAvLyByZWY6IGh0dHBzOi8vZGV2ZWxvcGVyLmhhc2hpY29ycC5jb20vdGVycmFmb3JtL2xhbmd1YWdlL3Jlc291cmNlcy9zeW50YXgjcmVtb3ZpbmctcmVzb3VyY2VzXG4gIC8vIC8qKlxuICAvLyAgKiBXaGVuIGFuIEFQSSBHYXRld2F5IG1vZGVsIGlzIHVwZGF0ZWQsIGEgbmV3IGRlcGxveW1lbnQgd2lsbCBhdXRvbWF0aWNhbGx5IGJlIGNyZWF0ZWQuXG4gIC8vICAqIElmIHRoaXMgaXMgdHJ1ZSwgdGhlIG9sZCBBUEkgR2F0ZXdheSBEZXBsb3ltZW50IHJlc291cmNlIHdpbGwgbm90IGJlIGRlbGV0ZWQuXG4gIC8vICAqIFRoaXMgd2lsbCBhbGxvdyBtYW51YWxseSByZXZlcnRpbmcgYmFjayB0byBhIHByZXZpb3VzIGRlcGxveW1lbnQgaW4gY2FzZSBmb3IgZXhhbXBsZVxuICAvLyAgKlxuICAvLyAgKiBAZGVmYXVsdCBmYWxzZVxuICAvLyAgKi9cbiAgLy8gcmVhZG9ubHkgcmV0YWluRGVwbG95bWVudHM/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgc3RhZ2UgdGhlIEFQSSBHYXRld2F5IGRlcGxveW1lbnQgZGVwbG95cyB0by5cbiAgICogSWYgdGhpcyBwcm9wZXJ0eSBpcyBzZXQgYW5kIGEgc3RhZ2Ugd2l0aCB0aGUgY29ycmVzcG9uZGluZyBuYW1lIGRvZXMgbm90IGV4aXN0LFxuICAgKiBhIG5ldyBzdGFnZSByZXNvdXJjZSB3aWxsIGJlIGNyZWF0ZWQgYW5kIGFzc29jaWF0ZWQgd2l0aCB0aGlzIGRlcGxveW1lbnQuXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gTm8gc3RhZ2UgaXMgY3JlYXRlZCBvciBhc3NvY2lhdGVkIHdpdGggdGhpcyBkZXBsb3ltZW50LlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhZ2VOYW1lPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgRGVwbG95bWVudCBvZiBhIFJFU1QgQVBJLlxuICpcbiAqIEFuIGltbXV0YWJsZSByZXByZXNlbnRhdGlvbiBvZiBhIFJlc3RBcGkgcmVzb3VyY2UgdGhhdCBjYW4gYmUgY2FsbGVkIGJ5IHVzZXJzXG4gKiB1c2luZyBTdGFnZXMuIEEgZGVwbG95bWVudCBtdXN0IGJlIGFzc29jaWF0ZWQgd2l0aCBhIFN0YWdlIGZvciBpdCB0byBiZVxuICogY2FsbGFibGUgb3ZlciB0aGUgSW50ZXJuZXQuXG4gKlxuICogTm9ybWFsbHksIHlvdSBkb24ndCBuZWVkIHRvIGRlZmluZSBkZXBsb3ltZW50cyBtYW51YWxseS4gVGhlIFJlc3RBcGlcbiAqIGNvbnN0cnVjdCBtYW5hZ2VzIGEgRGVwbG95bWVudCByZXNvdXJjZSB0aGF0IHJlcHJlc2VudHMgdGhlIGxhdGVzdCBtb2RlbC4gSXRcbiAqIGNhbiBiZSBhY2Nlc3NlZCB0aHJvdWdoIGByZXN0QXBpLmxhdGVzdERlcGxveW1lbnRgICh1bmxlc3MgYGRlcGxveTogZmFsc2VgIGlzXG4gKiBzZXQgd2hlbiBkZWZpbmluZyB0aGUgYFJlc3RBcGlgKS5cbiAqXG4gKiBJZiB5b3UgbWFudWFsbHkgZGVmaW5lIHRoaXMgcmVzb3VyY2UsIHlvdSB3aWxsIG5lZWQgdG8ga25vdyB0aGF0IHNpbmNlXG4gKiBkZXBsb3ltZW50cyBhcmUgaW1tdXRhYmxlLCB0aGVpciBwcm9wZXJ0aWVzIHdpbGwgbm90IGNoYW5nZSBhZnRlciBjcmVhdGlvbi5cbiAqIFRvIHJlZmxlY3QgQVBJIG1vZGVsIGNoYW5nZXMsIGEgbmV3IGRlcGxveW1lbnQgbXVzdCBiZSBjcmVhdGVkLiBUaGlzIGlzIHR5cGljYWxseVxuICogYWNoaWV2ZWQgYnkgY2hhbmdpbmcgdGhlIGB0cmlnZ2Vyc2AgcHJvcGVydHkgb2YgdGhlIGBBcGlHYXRld2F5RGVwbG95bWVudGAgcmVzb3VyY2UuXG4gKlxuICogVGhlIGBhZGRUb1RyaWdnZXJzYCBtZXRob2QgY2FuIGJlIHVzZWQgdG8gYXVnbWVudCB0aGUgc2V0IG9mIHRyaWdnZXJzIGZvciB0aGlzXG4gKiBkZXBsb3ltZW50LiBUaGlzIGVuc3VyZXMgdGhhdCBpZiBzcGVjaWZpYyBwYXJ0cyBvZiB0aGUgQVBJIG1vZGVsIGNoYW5nZSAoZS5nLiwgYSBNZXRob2QncyBjb25maWd1cmF0aW9uKSxcbiAqIGEgbmV3IGRlcGxveW1lbnQgaXMgdHJpZ2dlcmVkLiBUaGlzIGlzIGRvbmUgYXV0b21hdGljYWxseSBmb3IgdGhlIGByZXN0QXBpLmxhdGVzdERlcGxveW1lbnRgIGRlcGxveW1lbnQuXG4gKlxuICogRnVydGhlcm1vcmUsIGEgZGVwbG95bWVudCBzaG91bGQgZGVwZW5kIG9uIGFsbCBBUEkgR2F0ZXdheSByZXNvdXJjZXMgKE1ldGhvZHMsIFJlc291cmNlcywgZXRjLilcbiAqIHRoYXQgZGVmaW5lIHRoZSBBUEkuIFVzZSB0aGUgYF9hZGRNZXRob2REZXBlbmRlbmN5YCBvciBkaXJlY3RseSBhZGQgZGVwZW5kZW5jaWVzIHRvIGVuc3VyZSBjb3JyZWN0XG4gKiBwcm92aXNpb25pbmcgb3JkZXIuIFRoaXMgaXMgYWxzbyBoYW5kbGVkIGZvciBgcmVzdEFwaS5sYXRlc3REZXBsb3ltZW50YC5cbiAqL1xuZXhwb3J0IGNsYXNzIERlcGxveW1lbnQgZXh0ZW5kcyBBd3NDb25zdHJ1Y3RCYXNlIHtcbiAgcHVibGljIHJlYWRvbmx5IGRlcGxveW1lbnRJZDogc3RyaW5nO1xuICBwdWJsaWMgcmVhZG9ubHkgYXBpOiBJUmVzdEFwaTtcbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoZSBzdGFnZSBjcmVhdGVkIGFuZCBhc3NvY2lhdGVkIHdpdGggdGhpcyBkZXBsb3ltZW50LCBpZiBgc3RhZ2VOYW1lYCB3YXMgcHJvdmlkZWQuXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgc3RhZ2VOYW1lPzogc3RyaW5nO1xuXG4gIHByaXZhdGUgcmVhZG9ubHkgZGVwbG95bWVudFJlc291cmNlOiBhcGlHYXRld2F5RGVwbG95bWVudC5BcGlHYXRld2F5RGVwbG95bWVudDtcbiAgcHJpdmF0ZSBzdGFnZVJlc291cmNlPzogYXBpR2F0ZXdheVN0YWdlLkFwaUdhdGV3YXlTdGFnZTtcblxuICBwcml2YXRlIHJlYWRvbmx5IHRyaWdnZXJDb21wb25lbnRzID0gbmV3IEFycmF5PGFueT4oKTtcblxuICBjb25zdHJ1Y3RvcihzY29wZTogQ29uc3RydWN0LCBpZDogc3RyaW5nLCBwcm9wczogRGVwbG95bWVudFByb3BzKSB7XG4gICAgc3VwZXIoc2NvcGUsIGlkLCBwcm9wcyk7XG5cbiAgICB0aGlzLmFwaSA9IHByb3BzLmFwaTtcblxuICAgIHRoaXMuZGVwbG95bWVudFJlc291cmNlID0gbmV3IGFwaUdhdGV3YXlEZXBsb3ltZW50LkFwaUdhdGV3YXlEZXBsb3ltZW50KFxuICAgICAgdGhpcyxcbiAgICAgIFwiUmVzb3VyY2VcIixcbiAgICAgIHtcbiAgICAgICAgcmVzdEFwaUlkOiBwcm9wcy5hcGkucmVzdEFwaUlkLFxuICAgICAgICBkZXNjcmlwdGlvbjogcHJvcHMuZGVzY3JpcHRpb24sXG4gICAgICAgIC8vIGVuc3VyZSBsaWZlY3ljbGUgY3JlYXRlIGJlZm9yZSBkZXN0cm95IGlzIGVuYWJsZWQgdW5sZXNzIGV4cGxpY2l0bHkgc2V0IHRvIGZhbHNlXG4gICAgICAgIGxpZmVjeWNsZToge1xuICAgICAgICAgIGNyZWF0ZUJlZm9yZURlc3Ryb3k6IHByb3BzLmxpZmVjeWNsZT8uY3JlYXRlQmVmb3JlRGVzdHJveSA/PyB0cnVlLCAvLyBkZWZhdWx0IHRvIHRydWVcbiAgICAgICAgICAuLi5wcm9wcy5saWZlY3ljbGUsXG4gICAgICAgIH0sXG4gICAgICB9LFxuICAgICk7XG5cbiAgICAvLyBBZGQgdHJpZ2dlcnMgZm9yIHJlZHBsb3ltZW50IG9uIGNoZWNrc3VtIGNoYW5nZXMuXG4gICAgdGhpcy5kZXBsb3ltZW50UmVzb3VyY2UuYWRkT3ZlcnJpZGUoXG4gICAgICBcInRyaWdnZXJzXCIsXG4gICAgICBMYXp5LmFueVZhbHVlKHtcbiAgICAgICAgcHJvZHVjZTogKCkgPT4gdGhpcy5jYWxjdWxhdGVUcmlnZ2VycygpLFxuICAgICAgfSksXG4gICAgKTtcblxuICAgIC8vIFRPRE86IEltcGxlbWVudCBSZW1vdmFsUG9saWN5LlJFVEFJTiB0aHJvdWdoIHJlbW92ZWQgYmxvY2sgaW4gVGVycmFmb3JtLlxuICAgIC8vIGlmIChwcm9wcy5yZXRhaW5EZXBsb3ltZW50cykge1xuICAgIC8vICAgdGhpcy5kZXBsb3ltZW50UmVzb3VyY2UuYWRkT3ZlcnJpZGUoXCJsaWZlY3ljbGVcIiwge1xuICAgIC8vICAgICBwcmV2ZW50X2Rlc3Ryb3k6IHRydWUsXG4gICAgLy8gICB9KTtcbiAgICAvLyB9XG5cbiAgICB0aGlzLmRlcGxveW1lbnRJZCA9IHRoaXMuZGVwbG95bWVudFJlc291cmNlLmlkO1xuXG4gICAgaWYgKHByb3BzLnN0YWdlTmFtZSkge1xuICAgICAgdGhpcy5zdGFnZU5hbWUgPSBwcm9wcy5zdGFnZU5hbWU7XG4gICAgICB0aGlzLnN0YWdlUmVzb3VyY2UgPSBuZXcgYXBpR2F0ZXdheVN0YWdlLkFwaUdhdGV3YXlTdGFnZSh0aGlzLCBcIlN0YWdlXCIsIHtcbiAgICAgICAgcmVzdEFwaUlkOiBwcm9wcy5hcGkucmVzdEFwaUlkLFxuICAgICAgICBkZXBsb3ltZW50SWQ6IHRoaXMuZGVwbG95bWVudFJlc291cmNlLmlkLFxuICAgICAgICBzdGFnZU5hbWU6IHByb3BzLnN0YWdlTmFtZSxcbiAgICAgICAgZGVzY3JpcHRpb246IHByb3BzLmRlc2NyaXB0aW9uXG4gICAgICAgICAgPyBgJHtwcm9wcy5kZXNjcmlwdGlvbn0gU3RhZ2VgXG4gICAgICAgICAgOiB1bmRlZmluZWQsXG4gICAgICB9KTtcbiAgICAgIC8vIERlcGVuZGVuY2llcyBvbiBtZXRob2RzIHNob3VsZCBiZSBhZGRlZCB0byB0aGUgZGVwbG95bWVudFJlc291cmNlIGl0c2VsZi5cbiAgICAgIC8vIFRoZSBzdGFnZVJlc291cmNlIGltcGxpY2l0bHkgZGVwZW5kcyBvbiBkZXBsb3ltZW50UmVzb3VyY2UgdmlhIGRlcGxveW1lbnRJZC5cbiAgICB9XG5cbiAgICBpZiAocHJvcHMuYXBpIGluc3RhbmNlb2YgUmVzdEFwaUJhc2UpIHtcbiAgICAgIC8vIFRoZSBtZXRob2QgX2F0dGFjaERlcGxveW1lbnQgbWlnaHQgbmVlZCB0byBiZSBhZGFwdGVkIG9yIG1pZ2h0IG5vdCBleGlzdCBpbiBUZXJyYUNvbnN0cnVjdHMgUmVzdEFwaUJhc2VcbiAgICAgIC8vIFRoaXMgaXMgc3BlY2lmaWMgdG8gaG93IGBsYXRlc3REZXBsb3ltZW50YCBpcyBtYW5hZ2VkIGJ5IHRoZSBSZXN0QXBpIGNvbnN0cnVjdC5cbiAgICAgIChwcm9wcy5hcGkgYXMgYW55KS5fYXR0YWNoRGVwbG95bWVudD8uKHRoaXMpO1xuICAgIH1cbiAgfVxuXG4gIHByaXZhdGUgY2FsY3VsYXRlVHJpZ2dlcnMoKTogeyBba2V5OiBzdHJpbmddOiBzdHJpbmcgfSB8IHVuZGVmaW5lZCB7XG4gICAgY29uc3QgdHJpZ2dlcnMgPSBbLi4udGhpcy50cmlnZ2VyQ29tcG9uZW50c107XG5cbiAgICAvLyBJZ25vcmUgSVJlc3RBcGkgdGhhdCBhcmUgaW1wb3J0ZWRcbiAgICBpZiAodGhpcy5hcGkgaW5zdGFuY2VvZiBSZXN0QXBpIHx8IHRoaXMuYXBpIGluc3RhbmNlb2YgU3BlY1Jlc3RBcGkpIHtcbiAgICAgIGNvbnN0IGFwaUludGVybmFsID0gdGhpcy5hcGkubm9kZVxuICAgICAgICAuZGVmYXVsdENoaWxkIGFzIGFwaUdhdGV3YXlSZXN0QXBpLkFwaUdhdGV3YXlSZXN0QXBpO1xuICAgICAgLy8gVE9ETzogQVdTQ0RLIFRyaWdnZXJzIHJlZGVwbG95bWVudCBvbiBhbnkgY2hhbmdlcyAobm90IGp1c3QgdGhlIGJvZHkgcHJvcGVydHkpLlxuICAgICAgY29uc3QgdGZSZXN0QVBJID0gYXBpSW50ZXJuYWwudG9UZXJyYWZvcm0oKTtcbiAgICAgIHRyaWdnZXJzLnB1c2godGZSZXN0QVBJLnJlc291cmNlLmF3c19hcGlfZ2F0ZXdheV9yZXN0X2FwaSk7XG4gICAgfVxuXG4gICAgLy8gTk9URTogQVdTQ0RLIGNhbGN1bGF0ZXMgY2hlY2tzdW0gYWdhaW5zdCBmdW5jdGlvbiBwcm9wZXJ0aWVzLlxuICAgIC8vIFRlcnJhZm9ybSBhbGxvd3MgdXNlIHRvIGluY2x1ZGUgdGhlIGVudGlyZSBvYmplY3QsIHNvIHdlIHVzZSB0aGF0IGZvciBjbGFyaXR5LlxuICAgIGNvbnN0IGNoZWNrc3VtID0gbWQ1aGFzaChcbiAgICAgIHRyaWdnZXJzXG4gICAgICAgIC5tYXAoKHgpID0+IHRoaXMuc3RhY2sucmVzb2x2ZSh4KSlcbiAgICAgICAgLm1hcCgoYykgPT4gSlNPTi5zdHJpbmdpZnkoYykpXG4gICAgICAgIC5qb2luKFwiXCIpLFxuICAgICk7XG4gICAgLy8gdHJpZ2dlcnMgaGFzIHRvIGJlIFJlY29yZDxzdHJpbmcsIHN0cmluZz4gZm9yIFRlcnJhZm9ybSB0byBhY2NlcHQgaXQuXG4gICAgcmV0dXJuIHsgcmVkZXBsb3ltZW50OiBjaGVja3N1bSB9O1xuXG4gICAgLy8gLy8gTk9URTogY29uc2lkZXIgY2hlY2tzdW0gdG9vIGNvbmZ1c2luZyBhbmQgdXNlIGZ1bGwgdHJpZ2dlciBvYmplY3RzIGluc3RlYWQ/XG4gICAgLy8gLy8gVE9ETzogVGhpcyBjYXVzZXMgXCJtaXNzaW5nIGF0dHJpYnV0ZXIgc2VwYXJhdG9yXCIgZXJyb3JzXG4gICAgLy8gcmV0dXJuIHRyaWdnZXJzLmxlbmd0aCAhPT0gMFxuICAgIC8vICAgPyB7IHJlZGVwbG95bWVudDogRm4uc2hhMShGbi5qc29uZW5jb2RlKHRoaXMuc3RhY2sucmVzb2x2ZSh0cmlnZ2VycykpKSB9XG4gICAgLy8gICA6IC8vIFRPRE86IFdyYXAgZWFjaCB0cmlnZ2VyIGluIHNoYSBpbnN0ZWFkPyB7IHJlZGVwbG95bWVudDogRm4uc2hhMShGbi5qc29uZW5jb2RlKCkpIH1cbiAgICAvLyAgICAgLy8gdHJpZ2dlcnMucmVkdWNlKFxuICAgIC8vICAgICAvLyAgIChhY2MsIGN1cnIpID0+IHtcbiAgICAvLyAgICAgLy8gICAgIGNvbnN0IGtleSA9IGB0cmlnZ2VyLSR7T2JqZWN0LmtleXMoYWNjKS5sZW5ndGggKyAxfWA7XG4gICAgLy8gICAgIC8vICAgICBhY2Nba2V5XSA9IHRoaXMuc3RhY2sucmVzb2x2ZShjdXJyKTtcbiAgICAvLyAgICAgLy8gICAgIHJldHVybiBhY2M7XG4gICAgLy8gICAgIC8vICAgfSxcbiAgICAvLyAgICAgLy8gICB7fSBhcyB7IFtrZXk6IHN0cmluZ106IHN0cmluZyB9LFxuICAgIC8vICAgICAvLyApXG4gICAgLy8gICAgIHVuZGVmaW5lZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBBZGRzIGEgY29tcG9uZW50IHRvIHRoZSBzZXQgb2YgdHJpZ2dlcnMgdGhhdCBkZXRlcm1pbmUgaWYgYSBuZXcgZGVwbG95bWVudCBzaG91bGQgYmUgY3JlYXRlZC5cbiAgICpcbiAgICogVHJpZ2dlcnMgc2hvdWxkIGJlIHByZWZlcnJlZCBvdmVyIERlcGVuZGVuY2llcywgc2luY2UgRGVwZW5kZW5jaWVzIGNhbiBvbmx5IGNhcHR1cmUgZGVwZW5kZW5jeVxuICAgKiBvcmRlcmluZyBhbmQgd2lsbCBub3QgY2F1c2UgdGhlIHJlc291cmNlIHRvIHJlY3JlYXRlIChyZWRlcGxveSB0aGUgUkVTVCBBUEkpIHdpdGggdXBzdHJlYW1cbiAgICogY29uZmlndXJhdGlvbiBjaGFuZ2VzLlxuICAgKlxuICAgKiBUaGlzIHNob3VsZCBiZSBjYWxsZWQgYnkgY29uc3RydWN0cyBvZiB0aGUgQVBJIEdhdGV3YXkgbW9kZWwgdGhhdCB3YW50IHRvXG4gICAqIGludmFsaWRhdGUgdGhlIGRlcGxveW1lbnQgd2hlbiB0aGVpciBzZXR0aW5ncyBjaGFuZ2UuIFRoZSBjb21wb25lbnQgd2lsbFxuICAgKiBiZSByZXNvbHZlZCBkdXJpbmcgc3ludGhlc2lzIHNvIHRva2VucyBhcmUgd2VsY29tZS5cbiAgICovXG4gIHB1YmxpYyBhZGRUb1RyaWdnZXJzKGRhdGE6IGFueSkge1xuICAgIGlmICh0aGlzLm5vZGUubG9ja2VkKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIFwiQ2Fubm90IG1vZGlmeSBkZXBsb3ltZW50IHRyaWdnZXJzIHdoZW4gdGhlIGNvbnN0cnVjdCBpcyBsb2NrZWQuXCIsXG4gICAgICApO1xuICAgIH1cbiAgICB0aGlzLnRyaWdnZXJDb21wb25lbnRzLnB1c2goZGF0YSk7XG4gIH1cblxuICAvKipcbiAgICogQWRkcyBhIGRlcGVuZGVuY3kgZnJvbSB0aGlzIERlcGxveW1lbnQgdG8gYW4gQVBJIEdhdGV3YXkgTWV0aG9kLlxuICAgKiBUaGlzIGVuc3VyZXMgdGhhdCB0aGUgbWV0aG9kIGlzIGNyZWF0ZWQgYmVmb3JlIHRoZSBkZXBsb3ltZW50LlxuICAgKlxuICAgKiBAcGFyYW0gbWV0aG9kIFRoZSBNZXRob2QgY29uc3RydWN0IHRvIGFkZCBhcyBhIGRlcGVuZGVuY3kuXG4gICAqIEBpbnRlcm5hbFxuICAgKi9cbiAgcHVibGljIF9hZGRNZXRob2REZXBlbmRlbmN5KG1ldGhvZDogTWV0aG9kKSB7XG4gICAgLy8gYWRkaW5nIGEgZGVwZW5kZW5jeSBiZXR3ZWVuIHRoZSBjb25zdHJ1Y3RzIHVzaW5nIGBub2RlLmFkZERlcGVuZGVuY3koKWBcbiAgICAvLyB3aWxsIGNyZWF0ZSBhZGRpdGlvbmFsIGRlcGVuZGVuY2llcyBiZXR3ZWVuIGBhd3NfYXBpX2dhdGV3YXlfZGVwbG95bWVudGBcbiAgICAvLyBhbmQgdGhlIGBhd3NfbGFtYmRhX3Blcm1pc3Npb25gIHJlc291cmNlcyAoY2hpbGRyZW4gdW5kZXIgTWV0aG9kKSxcbiAgICAvLyBjYXVzaW5nIGN5Y2xpYyBkZXBlbmRlbmN5IGVycm9ycy4gSGVuY2UsIGZhbGxpbmcgYmFjayB0byBkZWNsYXJpbmdcbiAgICAvLyBkZXBlbmRlbmNpZXMgYmV0d2VlbiB0aGUgdW5kZXJseWluZyBUZXJyYWZvcm1FbGVtZW50cy5cbiAgICB0aGlzLm5vZGUuYWRkRGVwZW5kZW5jeShcbiAgICAgIG1ldGhvZC5ub2RlLmRlZmF1bHRDaGlsZCBhcyBhcGlHYXRld2F5TWV0aG9kLkFwaUdhdGV3YXlNZXRob2QsXG4gICAgKTtcblxuICAgIC8vIFRPRE86IFRyaWdnZXJzIGFyZSByZWNvbW1lbmRlZCBpbnN0ZWFkIG9mIGRlcGVuZGVuY2llcz9cbiAgfVxuXG4gIHB1YmxpYyBnZXQgb3V0cHV0cygpOiBSZWNvcmQ8c3RyaW5nLCBhbnk+IHtcbiAgICByZXR1cm4ge1xuICAgICAgZGVwbG95bWVudElkOiB0aGlzLmRlcGxveW1lbnRJZCxcbiAgICAgIHN0YWdlTmFtZTogdGhpcy5zdGFnZU5hbWUsXG4gICAgICBzdGFnZUludm9rZVVybDogdGhpcy5zdGFnZVJlc291cmNlPy5pbnZva2VVcmwsXG4gICAgfTtcbiAgfVxufVxuIl19

package/lib/aws/compute/domain-name.d.ts

@@ -0,0 +1,153 @@
+import { Construct } from "constructs";
+import { BasePathMapping, BasePathMappingOptions } from "./base-path-mapping";
+import { EndpointType, IRestApi } from "./restapi";
+import { IStage } from "./stage";
+import { AwsConstructBase, AwsConstructProps, IAwsConstruct } from "../aws-construct";
+import * as acm from "../edge";
+import { IBucket } from "../storage";
+/**
+ * Options for creating an api mapping
+ */
+export interface ApiMappingOptions {
+    /**
+     * The api path name that callers of the API must provide in the URL after
+     * the domain name (e.g. `example.com/base-path`). If you specify this
+     * property, it can't be an empty string.
+     *
+     * If this is undefined, a mapping will be added for the empty path. Any request
+     * that does not match a mapping will get sent to the API that has been mapped
+     * to the empty path.
+     *
+     * @default - map requests from the domain root (e.g. `example.com`).
+     */
+    readonly basePath?: string;
+}
+/**
+ * The minimum version of the SSL protocol that you want API Gateway to use for HTTPS connections.
+ */
+export declare enum SecurityPolicy {
+    /** Cipher suite TLS 1.0 */
+    TLS_1_0 = "TLS_1_0",
+    /** Cipher suite TLS 1.2 */
+    TLS_1_2 = "TLS_1_2"
+}
+export interface DomainNameOptions {
+    /**
+     * The custom domain name for your API. Uppercase letters are not supported.
+     */
+    readonly domainName: string;
+    /**
+     * The reference to an AWS-managed certificate for use by the edge-optimized
+     * endpoint for the domain name. For "EDGE" domain names, the certificate
+     * needs to be in the US East (N. Virginia) region.
+     */
+    readonly certificate: acm.ICertificate;
+    /**
+     * The type of endpoint for this DomainName.
+     * @default REGIONAL
+     */
+    readonly endpointType?: EndpointType;
+    /**
+     * The Transport Layer Security (TLS) version + cipher suite for this domain name.
+     * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html
+     * @default SecurityPolicy.TLS_1_2
+     */
+    readonly securityPolicy?: SecurityPolicy;
+    /**
+     * The mutual TLS authentication configuration for a custom domain name.
+     * @default - mTLS is not configured.
+     */
+    readonly mtls?: MTLSConfig;
+    /**
+     * The base path name that callers of the API must provide in the URL after
+     * the domain name (e.g. `example.com/base-path`). If you specify this
+     * property, it can't be an empty string.
+     *
+     * @default - map requests from the domain root (e.g. `example.com`).
+     */
+    readonly basePath?: string;
+}
+export interface DomainNameProps extends DomainNameOptions, AwsConstructProps {
+    /**
+     * If specified, all requests to this domain will be mapped to the production
+     * deployment of this API. If you wish to map this domain to multiple APIs
+     * with different base paths, use `addBasePathMapping` or `addApiMapping`.
+     *
+     * @default - you will have to call `addBasePathMapping` to map this domain to
+     * API endpoints.
+     */
+    readonly mapping?: IRestApi;
+}
+export interface IDomainName extends IAwsConstruct {
+    /**
+     * The domain name (e.g. `example.com`)
+     *
+     * @attribute DomainName
+     */
+    readonly domainName: string;
+    /**
+     * The Route53 alias target to use in order to connect a record set to this domain through an alias.
+     *
+     * @attribute DistributionDomainName,RegionalDomainName
+     */
+    readonly domainNameAliasDomainName: string;
+    /**
+     * The Route53 hosted zone ID to use in order to connect a record set to this domain through an alias.
+     *
+     * @attribute DistributionHostedZoneId,RegionalHostedZoneId
+     */
+    readonly domainNameAliasHostedZoneId: string;
+}
+export declare class DomainName extends AwsConstructBase implements IDomainName {
+    /**
+     * Imports an existing domain name.
+     */
+    static fromDomainNameAttributes(scope: Construct, id: string, attrs: DomainNameAttributes): IDomainName;
+    readonly domainName: string;
+    readonly domainNameAliasDomainName: string;
+    readonly domainNameAliasHostedZoneId: string;
+    private readonly basePaths;
+    private readonly securityPolicy?;
+    private readonly endpointType;
+    private readonly resource;
+    get outputs(): Record<string, any>;
+    constructor(scope: Construct, id: string, props: DomainNameProps);
+    private validateBasePath;
+    private isMultiLevel;
+    addBasePathMapping(targetApi: IRestApi, options?: BasePathMappingOptions): BasePathMapping;
+    addApiMapping(targetStage: IStage, options?: ApiMappingOptions): void;
+    private configureMTLS;
+}
+export interface DomainNameAttributes {
+    /**
+     * The domain name (e.g. `example.com`)
+     */
+    readonly domainName: string;
+    /**
+     * The Route53 alias target to use in order to connect a record set to this domain through an alias.
+     */
+    readonly domainNameAliasTarget: string;
+    /**
+     * The Route53 hosted zone ID to use in order to connect a record set to this domain through an alias.
+     */
+    readonly domainNameAliasHostedZoneId: string;
+}
+/**
+ * The mTLS authentication configuration for a custom domain name.
+ */
+export interface MTLSConfig {
+    /**
+     * The bucket that the trust store is hosted in.
+     */
+    readonly bucket: IBucket;
+    /**
+     * The key in S3 to look at for the trust store.
+     */
+    readonly key: string;
+    /**
+     *  The version of the S3 object that contains your truststore.
+     *  To specify a version, you must have versioning enabled for the S3 bucket.
+     *  @default - latest version
+     */
+    readonly version?: string;
+}