terraconstructs 0.0.8

package/lib/aws/aws-construct.d.ts

@@ -0,0 +1,76 @@
+import { Construct } from "constructs";
+import { AwsStack } from "./aws-stack";
+import { TerraConstructBase, TerraConstructProps, ITerraConstruct } from "../construct-base";
+/**
+ * Represents the environment a given AwsConstruct lives in.
+ * Used as the return value for the `IResource.env` property.
+ */
+export interface AwsEnvironment {
+    /**
+     * The AWS partition that this resource belongs to.
+     */
+    readonly partition: string;
+    /**
+     * The AWS account ID that this resource belongs to.
+     */
+    readonly account: string;
+    /**
+     * The AWS region that this resource belongs to.
+     */
+    readonly region: string;
+}
+/**
+ * Represents an AWS resource similar to the AWS CDK `Resource` class but backed by CDKTF.
+ */
+export interface IAwsConstruct extends ITerraConstruct {
+    /**
+     * The stack into which this resource is contructed by the TerraConstruct.
+     */
+    readonly stack: AwsStack;
+    /**
+     * The environment this resource belongs to.
+     * For resources that are created and managed by the CDKTF
+     * (generally, those created by creating new class instances like Environment, EcsDeployment, etc.),
+     * this is always the same as the environment of the stack they belong to;
+     * however, for imported resources
+     * (those obtained from static methods like fromRoleArn, fromBucketName, etc.),
+     * that might be different than the stack they were imported into.
+     */
+    readonly env: AwsEnvironment;
+}
+/**
+ * Construction properties for `Resource`.
+ */
+export interface AwsConstructProps extends TerraConstructProps {
+    /**
+     * The AWS account ID this resource belongs to.
+     *
+     * @default - the resource is in the same account as the stack it belongs to
+     */
+    readonly account?: string;
+    /**
+     * The AWS region this resource belongs to.
+     *
+     * @default - the resource is in the same region as the stack it belongs to
+     */
+    readonly region?: string;
+    /**
+     * ARN to deduce region and account from
+     *
+     * The ARN is parsed and the account and region are taken from the ARN.
+     * This should be used for imported resources.
+     *
+     * Cannot be supplied together with either `account` or `region`.
+     *
+     * @default - take environment from `account`, `region` parameters, or use Stack environment.
+     */
+    readonly environmentFromArn?: string;
+}
+/**
+ * Represents an AWS resource similar to the AWS CDK `Resource` class but backed by CDKTF.
+ */
+export declare abstract class AwsConstructBase extends TerraConstructBase implements IAwsConstruct {
+    readonly stack: AwsStack;
+    readonly env: AwsEnvironment;
+    constructor(scope: Construct, id: string, props?: AwsConstructProps);
+}

package/lib/aws/aws-construct.js

@@ -0,0 +1,38 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsConstructBase = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const arn_1 = require("./arn");
+const aws_stack_1 = require("./aws-stack");
+const construct_base_1 = require("../construct-base");
+// ref: https://github.com/aws/aws-cdk/blob/v2.150.0/packages/aws-cdk-lib/core/lib/resource.ts#L15
+const RESOURCE_SYMBOL = Symbol.for("terraconstructs/lib/aws.AwsConstruct");
+// ref: https://github.com/aws/aws-cdk/blob/v2.150.0/packages/aws-cdk-lib/core/lib/resource.ts#L122
+/**
+ * Represents an AWS resource similar to the AWS CDK `Resource` class but backed by CDKTF.
+ */
+class AwsConstructBase extends construct_base_1.TerraConstructBase {
+    constructor(scope, id, props = {}) {
+        super(scope, id, props);
+        if ((props.account !== undefined || props.region !== undefined) &&
+            props.environmentFromArn !== undefined) {
+            throw new Error(`Supply at most one of 'account'/'region' (${props.account}/${props.region}) and 'environmentFromArn' (${props.environmentFromArn})`);
+        }
+        Object.defineProperty(this, RESOURCE_SYMBOL, { value: true });
+        this.stack = aws_stack_1.AwsStack.ofAwsConstruct(this);
+        const parsedArn = props.environmentFromArn
+            ? // Since we only want the region and account, NO_RESOURCE_NAME is good enough
+                this.stack.splitArn(props.environmentFromArn, arn_1.ArnFormat.NO_RESOURCE_NAME)
+            : undefined;
+        this.env = {
+            partition: parsedArn?.partition ?? this.stack.partition,
+            account: props.account ?? parsedArn?.account ?? this.stack.account,
+            region: props.region ?? parsedArn?.region ?? this.stack.region,
+        };
+    }
+}
+exports.AwsConstructBase = AwsConstructBase;
+_a = JSII_RTTI_SYMBOL_1;
+AwsConstructBase[_a] = { fqn: "terraconstructs.aws.AwsConstructBase", version: "0.0.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXdzLWNvbnN0cnVjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hd3MvYXdzLWNvbnN0cnVjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUNBLCtCQUFrQztBQUNsQywyQ0FBdUM7QUFDdkMsc0RBSTJCO0FBRTNCLGtHQUFrRztBQUNsRyxNQUFNLGVBQWUsR0FBRyxNQUFNLENBQUMsR0FBRyxDQUFDLHNDQUFzQyxDQUFDLENBQUM7QUFpRjNFLG1HQUFtRztBQUVuRzs7R0FFRztBQUNILE1BQXNCLGdCQUNwQixTQUFRLG1DQUFrQjtJQU0xQixZQUFZLEtBQWdCLEVBQUUsRUFBVSxFQUFFLFFBQTJCLEVBQUU7UUFDckUsS0FBSyxDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFFeEIsSUFDRSxDQUFDLEtBQUssQ0FBQyxPQUFPLEtBQUssU0FBUyxJQUFJLEtBQUssQ0FBQyxNQUFNLEtBQUssU0FBUyxDQUFDO1lBQzNELEtBQUssQ0FBQyxrQkFBa0IsS0FBSyxTQUFTLEVBQ3RDLENBQUM7WUFDRCxNQUFNLElBQUksS0FBSyxDQUNiLDZDQUE2QyxLQUFLLENBQUMsT0FBTyxJQUFJLEtBQUssQ0FBQyxNQUFNLCtCQUErQixLQUFLLENBQUMsa0JBQWtCLEdBQUcsQ0FDckksQ0FBQztRQUNKLENBQUM7UUFFRCxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxlQUFlLEVBQUUsRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUU5RCxJQUFJLENBQUMsS0FBSyxHQUFHLG9CQUFRLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBRTNDLE1BQU0sU0FBUyxHQUFHLEtBQUssQ0FBQyxrQkFBa0I7WUFDeEMsQ0FBQyxDQUFDLDZFQUE2RTtnQkFDN0UsSUFBSSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQ2pCLEtBQUssQ0FBQyxrQkFBa0IsRUFDeEIsZUFBUyxDQUFDLGdCQUFnQixDQUMzQjtZQUNILENBQUMsQ0FBQyxTQUFTLENBQUM7UUFDZCxJQUFJLENBQUMsR0FBRyxHQUFHO1lBQ1QsU0FBUyxFQUFFLFNBQVMsRUFBRSxTQUFTLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxTQUFTO1lBQ3ZELE9BQU8sRUFBRSxLQUFLLENBQUMsT0FBTyxJQUFJLFNBQVMsRUFBRSxPQUFPLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPO1lBQ2xFLE1BQU0sRUFBRSxLQUFLLENBQUMsTUFBTSxJQUFJLFNBQVMsRUFBRSxNQUFNLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNO1NBQy9ELENBQUM7SUFDSixDQUFDOztBQW5DSCw0Q0FvQ0MiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tIFwiY29uc3RydWN0c1wiO1xuaW1wb3J0IHsgQXJuRm9ybWF0IH0gZnJvbSBcIi4vYXJuXCI7XG5pbXBvcnQgeyBBd3NTdGFjayB9IGZyb20gXCIuL2F3cy1zdGFja1wiO1xuaW1wb3J0IHtcbiAgVGVycmFDb25zdHJ1Y3RCYXNlLFxuICBUZXJyYUNvbnN0cnVjdFByb3BzLFxuICBJVGVycmFDb25zdHJ1Y3QsXG59IGZyb20gXCIuLi9jb25zdHJ1Y3QtYmFzZVwiO1xuXG4vLyByZWY6IGh0dHBzOi8vZ2l0aHViLmNvbS9hd3MvYXdzLWNkay9ibG9iL3YyLjE1MC4wL3BhY2thZ2VzL2F3cy1jZGstbGliL2NvcmUvbGliL3Jlc291cmNlLnRzI0wxNVxuY29uc3QgUkVTT1VSQ0VfU1lNQk9MID0gU3ltYm9sLmZvcihcInRlcnJhY29uc3RydWN0cy9saWIvYXdzLkF3c0NvbnN0cnVjdFwiKTtcblxuLy8gcmVmOiBodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi92Mi4xNTAuMC9wYWNrYWdlcy9hd3MtY2RrLWxpYi9jb3JlL2xpYi9yZXNvdXJjZS50cyNMMjFcblxuLyoqXG4gKiBSZXByZXNlbnRzIHRoZSBlbnZpcm9ubWVudCBhIGdpdmVuIEF3c0NvbnN0cnVjdCBsaXZlcyBpbi5cbiAqIFVzZWQgYXMgdGhlIHJldHVybiB2YWx1ZSBmb3IgdGhlIGBJUmVzb3VyY2UuZW52YCBwcm9wZXJ0eS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBBd3NFbnZpcm9ubWVudCB7XG4gIC8qKlxuICAgKiBUaGUgQVdTIHBhcnRpdGlvbiB0aGF0IHRoaXMgcmVzb3VyY2UgYmVsb25ncyB0by5cbiAgICovXG4gIHJlYWRvbmx5IHBhcnRpdGlvbjogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgQVdTIGFjY291bnQgSUQgdGhhdCB0aGlzIHJlc291cmNlIGJlbG9uZ3MgdG8uXG4gICAqL1xuICByZWFkb25seSBhY2NvdW50OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBBV1MgcmVnaW9uIHRoYXQgdGhpcyByZXNvdXJjZSBiZWxvbmdzIHRvLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVnaW9uOiBzdHJpbmc7XG59XG5cbi8vIHJlZjogaHR0cHM6Ly9naXRodWIuY29tL2F3cy9hd3MtY2RrL2Jsb2IvdjIuMTUwLjAvcGFja2FnZXMvYXdzLWNkay1saWIvY29yZS9saWIvcmVzb3VyY2UudHMjTDQ0XG5cbi8qKlxuICogUmVwcmVzZW50cyBhbiBBV1MgcmVzb3VyY2Ugc2ltaWxhciB0byB0aGUgQVdTIENESyBgUmVzb3VyY2VgIGNsYXNzIGJ1dCBiYWNrZWQgYnkgQ0RLVEYuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSUF3c0NvbnN0cnVjdCBleHRlbmRzIElUZXJyYUNvbnN0cnVjdCB7XG4gIC8qKlxuICAgKiBUaGUgc3RhY2sgaW50byB3aGljaCB0aGlzIHJlc291cmNlIGlzIGNvbnRydWN0ZWQgYnkgdGhlIFRlcnJhQ29uc3RydWN0LlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhY2s6IEF3c1N0YWNrO1xuXG4gIC8qKlxuICAgKiBUaGUgZW52aXJvbm1lbnQgdGhpcyByZXNvdXJjZSBiZWxvbmdzIHRvLlxuICAgKiBGb3IgcmVzb3VyY2VzIHRoYXQgYXJlIGNyZWF0ZWQgYW5kIG1hbmFnZWQgYnkgdGhlIENES1RGXG4gICAqIChnZW5lcmFsbHksIHRob3NlIGNyZWF0ZWQgYnkgY3JlYXRpbmcgbmV3IGNsYXNzIGluc3RhbmNlcyBsaWtlIEVudmlyb25tZW50LCBFY3NEZXBsb3ltZW50LCBldGMuKSxcbiAgICogdGhpcyBpcyBhbHdheXMgdGhlIHNhbWUgYXMgdGhlIGVudmlyb25tZW50IG9mIHRoZSBzdGFjayB0aGV5IGJlbG9uZyB0bztcbiAgICogaG93ZXZlciwgZm9yIGltcG9ydGVkIHJlc291cmNlc1xuICAgKiAodGhvc2Ugb2J0YWluZWQgZnJvbSBzdGF0aWMgbWV0aG9kcyBsaWtlIGZyb21Sb2xlQXJuLCBmcm9tQnVja2V0TmFtZSwgZXRjLiksXG4gICAqIHRoYXQgbWlnaHQgYmUgZGlmZmVyZW50IHRoYW4gdGhlIHN0YWNrIHRoZXkgd2VyZSBpbXBvcnRlZCBpbnRvLlxuICAgKi9cbiAgcmVhZG9ubHkgZW52OiBBd3NFbnZpcm9ubWVudDtcbn1cblxuLy8gcmVmOiBodHRwczovL2dpdGh1Yi5jb20vYXdzL2F3cy1jZGsvYmxvYi92Mi4xNTAuMC9wYWNrYWdlcy9hd3MtY2RrLWxpYi9jb3JlL2xpYi9yZXNvdXJjZS50cyNMNzhcblxuLyoqXG4gKiBDb25zdHJ1Y3Rpb24gcHJvcGVydGllcyBmb3IgYFJlc291cmNlYC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBBd3NDb25zdHJ1Y3RQcm9wcyBleHRlbmRzIFRlcnJhQ29uc3RydWN0UHJvcHMge1xuICAvKipcbiAgICogVGhlIEFXUyBhY2NvdW50IElEIHRoaXMgcmVzb3VyY2UgYmVsb25ncyB0by5cbiAgICpcbiAgICogQGRlZmF1bHQgLSB0aGUgcmVzb3VyY2UgaXMgaW4gdGhlIHNhbWUgYWNjb3VudCBhcyB0aGUgc3RhY2sgaXQgYmVsb25ncyB0b1xuICAgKi9cbiAgcmVhZG9ubHkgYWNjb3VudD86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIEFXUyByZWdpb24gdGhpcyByZXNvdXJjZSBiZWxvbmdzIHRvLlxuICAgKlxuICAgKiBAZGVmYXVsdCAtIHRoZSByZXNvdXJjZSBpcyBpbiB0aGUgc2FtZSByZWdpb24gYXMgdGhlIHN0YWNrIGl0IGJlbG9uZ3MgdG9cbiAgICovXG4gIHJlYWRvbmx5IHJlZ2lvbj86IHN0cmluZztcblxuICAvKipcbiAgICogQVJOIHRvIGRlZHVjZSByZWdpb24gYW5kIGFjY291bnQgZnJvbVxuICAgKlxuICAgKiBUaGUgQVJOIGlzIHBhcnNlZCBhbmQgdGhlIGFjY291bnQgYW5kIHJlZ2lvbiBhcmUgdGFrZW4gZnJvbSB0aGUgQVJOLlxuICAgKiBUaGlzIHNob3VsZCBiZSB1c2VkIGZvciBpbXBvcnRlZCByZXNvdXJjZXMuXG4gICAqXG4gICAqIENhbm5vdCBiZSBzdXBwbGllZCB0b2dldGhlciB3aXRoIGVpdGhlciBgYWNjb3VudGAgb3IgYHJlZ2lvbmAuXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gdGFrZSBlbnZpcm9ubWVudCBmcm9tIGBhY2NvdW50YCwgYHJlZ2lvbmAgcGFyYW1ldGVycywgb3IgdXNlIFN0YWNrIGVudmlyb25tZW50LlxuICAgKi9cbiAgcmVhZG9ubHkgZW52aXJvbm1lbnRGcm9tQXJuPzogc3RyaW5nO1xufVxuXG4vLyByZWY6IGh0dHBzOi8vZ2l0aHViLmNvbS9hd3MvYXdzLWNkay9ibG9iL3YyLjE1MC4wL3BhY2thZ2VzL2F3cy1jZGstbGliL2NvcmUvbGliL3Jlc291cmNlLnRzI0wxMjJcblxuLyoqXG4gKiBSZXByZXNlbnRzIGFuIEFXUyByZXNvdXJjZSBzaW1pbGFyIHRvIHRoZSBBV1MgQ0RLIGBSZXNvdXJjZWAgY2xhc3MgYnV0IGJhY2tlZCBieSBDREtURi5cbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIEF3c0NvbnN0cnVjdEJhc2VcbiAgZXh0ZW5kcyBUZXJyYUNvbnN0cnVjdEJhc2VcbiAgaW1wbGVtZW50cyBJQXdzQ29uc3RydWN0XG57XG4gIHB1YmxpYyByZWFkb25seSBzdGFjazogQXdzU3RhY2s7XG4gIHB1YmxpYyByZWFkb25seSBlbnY6IEF3c0Vudmlyb25tZW50O1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBBd3NDb25zdHJ1Y3RQcm9wcyA9IHt9KSB7XG4gICAgc3VwZXIoc2NvcGUsIGlkLCBwcm9wcyk7XG5cbiAgICBpZiAoXG4gICAgICAocHJvcHMuYWNjb3VudCAhPT0gdW5kZWZpbmVkIHx8IHByb3BzLnJlZ2lvbiAhPT0gdW5kZWZpbmVkKSAmJlxuICAgICAgcHJvcHMuZW52aXJvbm1lbnRGcm9tQXJuICE9PSB1bmRlZmluZWRcbiAgICApIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgYFN1cHBseSBhdCBtb3N0IG9uZSBvZiAnYWNjb3VudCcvJ3JlZ2lvbicgKCR7cHJvcHMuYWNjb3VudH0vJHtwcm9wcy5yZWdpb259KSBhbmQgJ2Vudmlyb25tZW50RnJvbUFybicgKCR7cHJvcHMuZW52aXJvbm1lbnRGcm9tQXJufSlgLFxuICAgICAgKTtcbiAgICB9XG5cbiAgICBPYmplY3QuZGVmaW5lUHJvcGVydHkodGhpcywgUkVTT1VSQ0VfU1lNQk9MLCB7IHZhbHVlOiB0cnVlIH0pO1xuXG4gICAgdGhpcy5zdGFjayA9IEF3c1N0YWNrLm9mQXdzQ29uc3RydWN0KHRoaXMpO1xuXG4gICAgY29uc3QgcGFyc2VkQXJuID0gcHJvcHMuZW52aXJvbm1lbnRGcm9tQXJuXG4gICAgICA/IC8vIFNpbmNlIHdlIG9ubHkgd2FudCB0aGUgcmVnaW9uIGFuZCBhY2NvdW50LCBOT19SRVNPVVJDRV9OQU1FIGlzIGdvb2QgZW5vdWdoXG4gICAgICAgIHRoaXMuc3RhY2suc3BsaXRBcm4oXG4gICAgICAgICAgcHJvcHMuZW52aXJvbm1lbnRGcm9tQXJuLFxuICAgICAgICAgIEFybkZvcm1hdC5OT19SRVNPVVJDRV9OQU1FLFxuICAgICAgICApXG4gICAgICA6IHVuZGVmaW5lZDtcbiAgICB0aGlzLmVudiA9IHtcbiAgICAgIHBhcnRpdGlvbjogcGFyc2VkQXJuPy5wYXJ0aXRpb24gPz8gdGhpcy5zdGFjay5wYXJ0aXRpb24sXG4gICAgICBhY2NvdW50OiBwcm9wcy5hY2NvdW50ID8/IHBhcnNlZEFybj8uYWNjb3VudCA/PyB0aGlzLnN0YWNrLmFjY291bnQsXG4gICAgICByZWdpb246IHByb3BzLnJlZ2lvbiA/PyBwYXJzZWRBcm4/LnJlZ2lvbiA/PyB0aGlzLnN0YWNrLnJlZ2lvbixcbiAgICB9O1xuICB9XG59XG4iXX0=

package/lib/aws/aws-stack.d.ts

@@ -0,0 +1,201 @@
+import { provider } from "@cdktf/provider-aws";
+import { ResourceTerraformIterator } from "cdktf";
+import { Construct, IConstruct } from "constructs";
+import { ArnComponents, ArnFormat } from "./arn";
+import { AwsProviderConfig } from "./provider-config.generated";
+import { StackBaseProps, StackBase, IStack } from "../stack-base";
+export interface AwsStackProps extends StackBaseProps {
+    /**
+     * The AWS Provider configuration (without the alias field)
+     */
+    readonly providerConfig: AwsProviderConfig;
+}
+export interface IAwsStack extends IStack {
+    /**
+     * The AWS Region for the TerraConstruct
+     */
+    readonly region: string;
+    /**
+     * The AWS Account for the TerraConstruct
+     */
+    readonly account: string;
+    /**
+     * The AWS Partition for the TerraConstruct
+     */
+    readonly partition: string;
+    /**
+     * The service Principal Id for a specific service
+     *
+     * @param serviceName The service name to get the service principal ID for
+     * @param region The region to get the service principal ID for
+     */
+    servicePrincipalName(serviceName: string, region?: string): string;
+}
+/**
+ * A Terraform stack constrained to a single AWS Account/Region to simulate CFN behavior.
+ */
+export declare class AwsStack extends StackBase implements IAwsStack {
+    /**
+     * Return whether the given object is a Stack.
+     *
+     * attribute detection since as 'instanceof' potentially fails across Library releases.
+     */
+    static isAwsStack(x: any): x is AwsStack;
+    /**
+     * Looks up the first stack scope in which `construct` is defined. Fails if there is no stack up the tree or the stack is not an AwsStack.
+     * @param construct The construct to start the search from.
+     */
+    static ofAwsConstruct(construct: IConstruct): AwsStack;
+    private readonly lookup;
+    private regionalAwsProviders;
+    /**
+     * Cache these tokens for reliable comparisons.
+     *
+     * Every call for the same Token will produce a new unique string, no
+     * attempt is made to deduplicate. Token objects should cache the
+     * value themselves, if required.
+     *
+     * dataSource.getSTringattribute -> Token.asString -> tokenMap.registerString
+     * ref:
+     * - https://github.com/hashicorp/terraform-cdk/blob/v0.20.10/packages/cdktf/lib/terraform-data-source.ts#L68
+     * - https://github.com/hashicorp/terraform-cdk/blob/v0.20.10/packages/cdktf/lib/tokens/private/token-map.ts#L50-L66
+     */
+    private _accountIdToken;
+    private _paritionToken;
+    private _urlSuffixToken;
+    constructor(scope: Construct, id: string, props: AwsStackProps);
+    get provider(): provider.AwsProvider;
+    /**
+     * Get the Region of the AWS Stack
+     */
+    get region(): string;
+    private get dataAwsCallerIdentity();
+    private get dataAwsAvailabilityZones();
+    private get dataAwsPartition();
+    private getRegionalAwsProvider;
+    /**
+     * Get the Account of the AWS Stack
+     */
+    get account(): string;
+    /**
+     * Get the Partition of the AWS Stack
+     */
+    get partition(): string;
+    /**
+     * Base DNS domain name for the current partition (e.g., amazonaws.com in AWS Commercial, amazonaws.com.cn in AWS China).
+     */
+    get urlSuffix(): string;
+    /**
+     * Return the service principal name based on the region it's used in.
+     *
+     * Some service principal names used to be different for different partitions,
+     * and some were not.
+     *
+     * These days all service principal names are standardized, and they are all
+     * of the form `<servicename>.amazonaws.com`.
+     *
+     * To avoid breaking changes, handling is provided for services added with the formats below,
+     * however, no additional handling will be added for new regions or partitions.
+     *   - s3
+     *   - s3.amazonaws.com
+     *   - s3.amazonaws.com.cn
+     *   - s3.c2s.ic.gov
+     *   - s3.sc2s.sgov.gov
+     *
+     * @param service The service name to get the service principal ID for
+     * @param region The region to get the service principal ID for
+     */
+    servicePrincipalName(service: string, region?: string): string;
+    /**
+     * Creates an ARN from components.
+     *
+     * If `partition`, `region` or `account` are not specified, the stack's
+     * partition, region and account will be used.
+     *
+     * If any component is the empty string, an empty string will be inserted
+     * into the generated ARN at the location that component corresponds to.
+     *
+     * The ARN will be formatted as follows:
+     *
+     *   arn:{partition}:{service}:{region}:{account}:{resource}{sep}{resource-name}
+     *
+     * The required ARN pieces that are omitted will be taken from the stack that
+     * the 'scope' is attached to. If all ARN pieces are supplied, the supplied scope
+     * can be 'undefined'.
+     */
+    formatArn(components: ArnComponents): string;
+    /**
+     * Given an ARN, parses it and returns components.
+     *
+     * IF THE ARN IS A CONCRETE STRING...
+     *
+     * ...it will be parsed and validated. The separator (`sep`) will be set to '/'
+     * if the 6th component includes a '/', in which case, `resource` will be set
+     * to the value before the '/' and `resourceName` will be the rest. In case
+     * there is no '/', `resource` will be set to the 6th components and
+     * `resourceName` will be set to the rest of the string.
+     *
+     * IF THE ARN IS A TOKEN...
+     *
+     * ...it cannot be validated, since we don't have the actual value yet at the
+     * time of this function call. You will have to supply `sepIfToken` and
+     * whether or not ARNs of the expected format usually have resource names
+     * in order to parse it properly. The resulting `ArnComponents` object will
+     * contain tokens for the subexpressions of the ARN, not string literals.
+     *
+     * If the resource name could possibly contain the separator char, the actual
+     * resource name cannot be properly parsed. This only occurs if the separator
+     * char is '/', and happens for example for S3 object ARNs, IAM Role ARNs,
+     * IAM OIDC Provider ARNs, etc. To properly extract the resource name from a
+     * Tokenized ARN, you must know the resource type and call
+     * `Arn.extractResourceName`.
+     *
+     * @param arn The ARN string to parse
+     * @param sepIfToken The separator used to separate resource from resourceName
+     * @param hasName Whether there is a name component in the ARN at all. For
+     * example, SNS Topics ARNs have the 'resource' component contain the topic
+     * name, and no 'resourceName' component.
+     *
+     * @returns an ArnComponents object which allows access to the various
+     * components of the ARN.
+     *
+     * @returns an ArnComponents object which allows access to the various
+     *      components of the ARN.
+     *
+     * @deprecated use splitArn instead
+     */
+    parseArn(arn: string, sepIfToken?: string, hasName?: boolean): ArnComponents;
+    /**
+     * Splits the provided ARN into its components.
+     * Works both if 'arn' is a string like 'arn:aws:s3:::bucket',
+     * and a Token representing a dynamic CloudFormation expression
+     * (in which case the returned components will also be dynamic CloudFormation expressions,
+     * encoded as Tokens).
+     *
+     * @param arn the ARN to split into its components
+     * @param arnFormat the expected format of 'arn' - depends on what format the service 'arn' represents uses
+     */
+    splitArn(arn: string, arnFormat: ArnFormat): ArnComponents;
+    /**
+     * Returns iterator for all AZs that are available in the AWS environment
+     * (account/region) associated with this stack (default or aliased provider).
+     *
+     * this will return a cdktf iterator
+     *
+     * https://developer.hashicorp.com/terraform/cdktf/concepts/iterators#define-iterators
+     *
+     * To specify a different strategy for selecting availability zones override this method.
+     */
+    get availabilityZoneIterator(): ResourceTerraformIterator;
+    /**
+     * Returns a Token as List of AZ names that are available in the stack's
+     * AWS environment (account/region).
+     *
+     * The list is slized by `maxCount` which defaults to 2.
+     *
+     * Note: Must use `Fn.element` to access the AZ names.
+     *
+     * @param maxCount the maximum number of AZs to return
+     */
+    availabilityZones(maxCount?: number): string[];
+}