@jttc/projen-project-types 1.0.0-beta.0 → 1.0.0-beta.10

package/lib/terraform/components/terraform-plan-github-workflow.js

@@ -0,0 +1,155 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerraformPlanGithubWorkflow = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const projen_1 = require("projen");
+const github_1 = require("projen/lib/github");
+const workflows_model_1 = require("projen/lib/github/workflows-model");
+/**
+ * GitHub workflow component for Terraform plan on Pull Requests.
+ * Creates a workflow that validates, plans Terraform changes and comments results on PRs.
+ *
+ * This component is designed for Terraform stack projects to show plan results
+ * in Pull Requests without actually applying changes.
+ */
+class TerraformPlanGithubWorkflow extends projen_1.Component {
+    constructor(project, options = {}) {
+        super(project);
+        // Get or create GitHub component - use root project for subprojects, current project otherwise
+        const targetProject = project.parent ? project.root : project;
+        let github = targetProject.components.find((c) => c.constructor.name === 'GitHub');
+        if (!github) {
+            github = new github_1.GitHub(targetProject);
+        }
+        const workflowName = options.workflowName ?? 'terraform-plan';
+        const terraformVersion = options.terraformVersion ?? '1.6.0';
+        const workingDirectory = options.workingDirectory ?? (project.parent ? project.outdir : '.');
+        const workflow = github.addWorkflow(workflowName);
+        workflow.on({
+            pullRequest: {
+                branches: ['main'],
+                paths: ['**.tf', '**.tfvars'],
+            },
+        });
+        // Add environment variable for working directory
+        workflow.addJob('terraform-plan', {
+            name: 'Terraform Plan',
+            runsOn: ['ubuntu-latest'],
+            env: {
+                tf_actions_working_dir: workingDirectory,
+            },
+            defaults: {
+                run: {
+                    workingDirectory: '${{ env.tf_actions_working_dir }}',
+                },
+            },
+            permissions: {
+                contents: workflows_model_1.JobPermission.READ,
+                pullRequests: workflows_model_1.JobPermission.WRITE,
+            },
+            steps: [
+                {
+                    name: 'Checkout',
+                    uses: 'actions/checkout@v4',
+                },
+                {
+                    name: 'Setup Terraform',
+                    uses: 'hashicorp/setup-terraform@v3',
+                    with: {
+                        terraformVersion: terraformVersion,
+                    },
+                },
+                {
+                    name: 'Terraform Format',
+                    id: 'fmt',
+                    run: 'terraform fmt -check',
+                    continueOnError: true,
+                },
+                {
+                    name: 'Terraform Init',
+                    id: 'init',
+                    run: 'terraform init -input=false',
+                },
+                {
+                    name: 'Terraform Validate',
+                    id: 'validate',
+                    run: 'terraform validate -no-color',
+                },
+                {
+                    name: 'Terraform Plan',
+                    id: 'plan',
+                    run: 'terraform plan -no-color -input=false',
+                    continueOnError: true,
+                },
+                {
+                    name: 'Comment PR',
+                    uses: 'actions/github-script@v7',
+                    if: "github.event_name == 'pull_request'",
+                    env: {
+                        PLAN: 'terraform\\n${{ steps.plan.outputs.stdout }}',
+                    },
+                    with: {
+                        'github-token': '${{ secrets.GITHUB_TOKEN }}',
+                        script: `
+              // 1. Retrieve existing bot comments for the PR
+              const { data: comments } = await github.rest.issues.listComments({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+              })
+              const botComment = comments.find(comment => {
+                return comment.user.type === 'Bot' && comment.body.includes('Terraform Format and Style')
+              })
+
+              // 2. Prepare format of the comment
+              const output = \`#### Terraform Format and Style 🖌\\\`\${{ steps.fmt.outcome }}\\\`
+              #### Terraform Initialization ⚙️\\\`\${{ steps.init.outcome }}\\\`
+              #### Terraform Validation 🤖\\\`\${{ steps.validate.outcome }}\\\`
+              <details><summary>Validation Output</summary>
+
+              \\\`\\\`\\\`
+              \${{ steps.validate.outputs.stdout }}
+              \\\`\\\`\\\`
+
+              </details>
+
+              #### Terraform Plan 📖\\\`\${{ steps.plan.outcome }}\\\`
+
+              <details><summary>Show Plan</summary>
+
+              \\\`\\\`\\\`
+              \${process.env.PLAN}
+              \\\`\\\`\\\`
+
+              </details>
+
+              *Pusher: @\${{ github.actor }}, Action: \\\`\${{ github.event_name }}\\\`, Working Directory: \\\`\${{ env.tf_actions_working_dir }}\\\`, Workflow: \\\`\${{ github.workflow }}\\\`*\`;
+
+              // 3. If we have a comment, update it, otherwise create a new one
+              if (botComment) {
+                github.rest.issues.updateComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  comment_id: botComment.id,
+                  body: output
+                })
+              } else {
+                github.rest.issues.createComment({
+                  issue_number: context.issue.number,
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  body: output
+                })
+              }
+            `,
+                    },
+                },
+            ],
+        });
+    }
+}
+exports.TerraformPlanGithubWorkflow = TerraformPlanGithubWorkflow;
+_a = JSII_RTTI_SYMBOL_1;
+TerraformPlanGithubWorkflow[_a] = { fqn: "@jttc/projen-project-types.TerraformPlanGithubWorkflow", version: "1.0.0-beta.10" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVycmFmb3JtLXBsYW4tZ2l0aHViLXdvcmtmbG93LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3RlcnJhZm9ybS9jb21wb25lbnRzL3RlcnJhZm9ybS1wbGFuLWdpdGh1Yi13b3JrZmxvdy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLG1DQUE0QztBQUM1Qyw4Q0FBMkM7QUFDM0MsdUVBQWtFO0FBeUJsRTs7Ozs7O0dBTUc7QUFDSCxNQUFhLDJCQUE0QixTQUFRLGtCQUFTO0lBQ3hELFlBQ0UsT0FBZ0IsRUFDaEIsVUFBOEMsRUFBRTtRQUVoRCxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFFZiwrRkFBK0Y7UUFDL0YsTUFBTSxhQUFhLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDO1FBQzlELElBQUksTUFBTSxHQUFHLGFBQWEsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUN4QyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxJQUFJLEtBQUssUUFBUSxDQUM3QixDQUFDO1FBQ1osSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ1osTUFBTSxHQUFHLElBQUksZUFBTSxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQ3JDLENBQUM7UUFFRCxNQUFNLFlBQVksR0FBRyxPQUFPLENBQUMsWUFBWSxJQUFJLGdCQUFnQixDQUFDO1FBQzlELE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixJQUFJLE9BQU8sQ0FBQztRQUM3RCxNQUFNLGdCQUFnQixHQUNwQixPQUFPLENBQUMsZ0JBQWdCLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUV0RSxNQUFNLFFBQVEsR0FBRyxNQUFNLENBQUMsV0FBVyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBRWxELFFBQVEsQ0FBQyxFQUFFLENBQUM7WUFDVixXQUFXLEVBQUU7Z0JBQ1gsUUFBUSxFQUFFLENBQUMsTUFBTSxDQUFDO2dCQUNsQixLQUFLLEVBQUUsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDO2FBQzlCO1NBQ0YsQ0FBQyxDQUFDO1FBRUgsaURBQWlEO1FBQ2pELFFBQVEsQ0FBQyxNQUFNLENBQUMsZ0JBQWdCLEVBQUU7WUFDaEMsSUFBSSxFQUFFLGdCQUFnQjtZQUN0QixNQUFNLEVBQUUsQ0FBQyxlQUFlLENBQUM7WUFDekIsR0FBRyxFQUFFO2dCQUNILHNCQUFzQixFQUFFLGdCQUFnQjthQUN6QztZQUNELFFBQVEsRUFBRTtnQkFDUixHQUFHLEVBQUU7b0JBQ0gsZ0JBQWdCLEVBQUUsbUNBQW1DO2lCQUN0RDthQUNGO1lBQ0QsV0FBVyxFQUFFO2dCQUNYLFFBQVEsRUFBRSwrQkFBYSxDQUFDLElBQUk7Z0JBQzVCLFlBQVksRUFBRSwrQkFBYSxDQUFDLEtBQUs7YUFDbEM7WUFDRCxLQUFLLEVBQUU7Z0JBQ0w7b0JBQ0UsSUFBSSxFQUFFLFVBQVU7b0JBQ2hCLElBQUksRUFBRSxxQkFBcUI7aUJBQzVCO2dCQUNEO29CQUNFLElBQUksRUFBRSxpQkFBaUI7b0JBQ3ZCLElBQUksRUFBRSw4QkFBOEI7b0JBQ3BDLElBQUksRUFBRTt3QkFDSixnQkFBZ0IsRUFBRSxnQkFBZ0I7cUJBQ25DO2lCQUNGO2dCQUNEO29CQUNFLElBQUksRUFBRSxrQkFBa0I7b0JBQ3hCLEVBQUUsRUFBRSxLQUFLO29CQUNULEdBQUcsRUFBRSxzQkFBc0I7b0JBQzNCLGVBQWUsRUFBRSxJQUFJO2lCQUN0QjtnQkFDRDtvQkFDRSxJQUFJLEVBQUUsZ0JBQWdCO29CQUN0QixFQUFFLEVBQUUsTUFBTTtvQkFDVixHQUFHLEVBQUUsNkJBQTZCO2lCQUNuQztnQkFDRDtvQkFDRSxJQUFJLEVBQUUsb0JBQW9CO29CQUMxQixFQUFFLEVBQUUsVUFBVTtvQkFDZCxHQUFHLEVBQUUsOEJBQThCO2lCQUNwQztnQkFDRDtvQkFDRSxJQUFJLEVBQUUsZ0JBQWdCO29CQUN0QixFQUFFLEVBQUUsTUFBTTtvQkFDVixHQUFHLEVBQUUsdUNBQXVDO29CQUM1QyxlQUFlLEVBQUUsSUFBSTtpQkFDdEI7Z0JBQ0Q7b0JBQ0UsSUFBSSxFQUFFLFlBQVk7b0JBQ2xCLElBQUksRUFBRSwwQkFBMEI7b0JBQ2hDLEVBQUUsRUFBRSxxQ0FBcUM7b0JBQ3pDLEdBQUcsRUFBRTt3QkFDSCxJQUFJLEVBQUUsOENBQThDO3FCQUNyRDtvQkFDRCxJQUFJLEVBQUU7d0JBQ0osY0FBYyxFQUFFLDZCQUE2Qjt3QkFDN0MsTUFBTSxFQUFFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7YUFtRFA7cUJBQ0Y7aUJBQ0Y7YUFDRjtTQUNGLENBQUMsQ0FBQztJQUNMLENBQUM7O0FBakpILGtFQWtKQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IENvbXBvbmVudCwgUHJvamVjdCB9IGZyb20gJ3Byb2plbic7XG5pbXBvcnQgeyBHaXRIdWIgfSBmcm9tICdwcm9qZW4vbGliL2dpdGh1Yic7XG5pbXBvcnQgeyBKb2JQZXJtaXNzaW9uIH0gZnJvbSAncHJvamVuL2xpYi9naXRodWIvd29ya2Zsb3dzLW1vZGVsJztcblxuLyoqXG4gKiBPcHRpb25zIGZvciBUZXJyYWZvcm1QbGFuR2l0aHViV29ya2Zsb3cgY29tcG9uZW50LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRlcnJhZm9ybVBsYW5HaXRodWJXb3JrZmxvd09wdGlvbnMge1xuICAvKipcbiAgICogVGVycmFmb3JtIHZlcnNpb24gdG8gdXNlIGluIHRoZSB3b3JrZmxvdy5cbiAgICogQGRlZmF1bHQgXCIxLjYuMFwiXG4gICAqL1xuICByZWFkb25seSB0ZXJyYWZvcm1WZXJzaW9uPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBOYW1lIG9mIHRoZSB3b3JrZmxvdy5cbiAgICogQGRlZmF1bHQgXCJ0ZXJyYWZvcm0tcGxhblwiXG4gICAqL1xuICByZWFkb25seSB3b3JrZmxvd05hbWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFdvcmtpbmcgZGlyZWN0b3J5IGZvciBUZXJyYWZvcm0gY29tbWFuZHMuXG4gICAqIEBkZWZhdWx0IFwiLlwiXG4gICAqL1xuICByZWFkb25seSB3b3JraW5nRGlyZWN0b3J5Pzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEdpdEh1YiB3b3JrZmxvdyBjb21wb25lbnQgZm9yIFRlcnJhZm9ybSBwbGFuIG9uIFB1bGwgUmVxdWVzdHMuXG4gKiBDcmVhdGVzIGEgd29ya2Zsb3cgdGhhdCB2YWxpZGF0ZXMsIHBsYW5zIFRlcnJhZm9ybSBjaGFuZ2VzIGFuZCBjb21tZW50cyByZXN1bHRzIG9uIFBScy5cbiAqXG4gKiBUaGlzIGNvbXBvbmVudCBpcyBkZXNpZ25lZCBmb3IgVGVycmFmb3JtIHN0YWNrIHByb2plY3RzIHRvIHNob3cgcGxhbiByZXN1bHRzXG4gKiBpbiBQdWxsIFJlcXVlc3RzIHdpdGhvdXQgYWN0dWFsbHkgYXBwbHlpbmcgY2hhbmdlcy5cbiAqL1xuZXhwb3J0IGNsYXNzIFRlcnJhZm9ybVBsYW5HaXRodWJXb3JrZmxvdyBleHRlbmRzIENvbXBvbmVudCB7XG4gIGNvbnN0cnVjdG9yKFxuICAgIHByb2plY3Q6IFByb2plY3QsXG4gICAgb3B0aW9uczogVGVycmFmb3JtUGxhbkdpdGh1YldvcmtmbG93T3B0aW9ucyA9IHt9LFxuICApIHtcbiAgICBzdXBlcihwcm9qZWN0KTtcblxuICAgIC8vIEdldCBvciBjcmVhdGUgR2l0SHViIGNvbXBvbmVudCAtIHVzZSByb290IHByb2plY3QgZm9yIHN1YnByb2plY3RzLCBjdXJyZW50IHByb2plY3Qgb3RoZXJ3aXNlXG4gICAgY29uc3QgdGFyZ2V0UHJvamVjdCA9IHByb2plY3QucGFyZW50ID8gcHJvamVjdC5yb290IDogcHJvamVjdDtcbiAgICBsZXQgZ2l0aHViID0gdGFyZ2V0UHJvamVjdC5jb21wb25lbnRzLmZpbmQoXG4gICAgICAoYykgPT4gYy5jb25zdHJ1Y3Rvci5uYW1lID09PSAnR2l0SHViJyxcbiAgICApIGFzIEdpdEh1YjtcbiAgICBpZiAoIWdpdGh1Yikge1xuICAgICAgZ2l0aHViID0gbmV3IEdpdEh1Yih0YXJnZXRQcm9qZWN0KTtcbiAgICB9XG5cbiAgICBjb25zdCB3b3JrZmxvd05hbWUgPSBvcHRpb25zLndvcmtmbG93TmFtZSA/PyAndGVycmFmb3JtLXBsYW4nO1xuICAgIGNvbnN0IHRlcnJhZm9ybVZlcnNpb24gPSBvcHRpb25zLnRlcnJhZm9ybVZlcnNpb24gPz8gJzEuNi4wJztcbiAgICBjb25zdCB3b3JraW5nRGlyZWN0b3J5ID1cbiAgICAgIG9wdGlvbnMud29ya2luZ0RpcmVjdG9yeSA/PyAocHJvamVjdC5wYXJlbnQgPyBwcm9qZWN0Lm91dGRpciA6ICcuJyk7XG5cbiAgICBjb25zdCB3b3JrZmxvdyA9IGdpdGh1Yi5hZGRXb3JrZmxvdyh3b3JrZmxvd05hbWUpO1xuXG4gICAgd29ya2Zsb3cub24oe1xuICAgICAgcHVsbFJlcXVlc3Q6IHtcbiAgICAgICAgYnJhbmNoZXM6IFsnbWFpbiddLFxuICAgICAgICBwYXRoczogWycqKi50ZicsICcqKi50ZnZhcnMnXSxcbiAgICAgIH0sXG4gICAgfSk7XG5cbiAgICAvLyBBZGQgZW52aXJvbm1lbnQgdmFyaWFibGUgZm9yIHdvcmtpbmcgZGlyZWN0b3J5XG4gICAgd29ya2Zsb3cuYWRkSm9iKCd0ZXJyYWZvcm0tcGxhbicsIHtcbiAgICAgIG5hbWU6ICdUZXJyYWZvcm0gUGxhbicsXG4gICAgICBydW5zT246IFsndWJ1bnR1LWxhdGVzdCddLFxuICAgICAgZW52OiB7XG4gICAgICAgIHRmX2FjdGlvbnNfd29ya2luZ19kaXI6IHdvcmtpbmdEaXJlY3RvcnksXG4gICAgICB9LFxuICAgICAgZGVmYXVsdHM6IHtcbiAgICAgICAgcnVuOiB7XG4gICAgICAgICAgd29ya2luZ0RpcmVjdG9yeTogJyR7eyBlbnYudGZfYWN0aW9uc193b3JraW5nX2RpciB9fScsXG4gICAgICAgIH0sXG4gICAgICB9LFxuICAgICAgcGVybWlzc2lvbnM6IHtcbiAgICAgICAgY29udGVudHM6IEpvYlBlcm1pc3Npb24uUkVBRCxcbiAgICAgICAgcHVsbFJlcXVlc3RzOiBKb2JQZXJtaXNzaW9uLldSSVRFLFxuICAgICAgfSxcbiAgICAgIHN0ZXBzOiBbXG4gICAgICAgIHtcbiAgICAgICAgICBuYW1lOiAnQ2hlY2tvdXQnLFxuICAgICAgICAgIHVzZXM6ICdhY3Rpb25zL2NoZWNrb3V0QHY0JyxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgIG5hbWU6ICdTZXR1cCBUZXJyYWZvcm0nLFxuICAgICAgICAgIHVzZXM6ICdoYXNoaWNvcnAvc2V0dXAtdGVycmFmb3JtQHYzJyxcbiAgICAgICAgICB3aXRoOiB7XG4gICAgICAgICAgICB0ZXJyYWZvcm1WZXJzaW9uOiB0ZXJyYWZvcm1WZXJzaW9uLFxuICAgICAgICAgIH0sXG4gICAgICAgIH0sXG4gICAgICAgIHtcbiAgICAgICAgICBuYW1lOiAnVGVycmFmb3JtIEZvcm1hdCcsXG4gICAgICAgICAgaWQ6ICdmbXQnLFxuICAgICAgICAgIHJ1bjogJ3RlcnJhZm9ybSBmbXQgLWNoZWNrJyxcbiAgICAgICAgICBjb250aW51ZU9uRXJyb3I6IHRydWUsXG4gICAgICAgIH0sXG4gICAgICAgIHtcbiAgICAgICAgICBuYW1lOiAnVGVycmFmb3JtIEluaXQnLFxuICAgICAgICAgIGlkOiAnaW5pdCcsXG4gICAgICAgICAgcnVuOiAndGVycmFmb3JtIGluaXQgLWlucHV0PWZhbHNlJyxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgIG5hbWU6ICdUZXJyYWZvcm0gVmFsaWRhdGUnLFxuICAgICAgICAgIGlkOiAndmFsaWRhdGUnLFxuICAgICAgICAgIHJ1bjogJ3RlcnJhZm9ybSB2YWxpZGF0ZSAtbm8tY29sb3InLFxuICAgICAgICB9LFxuICAgICAgICB7XG4gICAgICAgICAgbmFtZTogJ1RlcnJhZm9ybSBQbGFuJyxcbiAgICAgICAgICBpZDogJ3BsYW4nLFxuICAgICAgICAgIHJ1bjogJ3RlcnJhZm9ybSBwbGFuIC1uby1jb2xvciAtaW5wdXQ9ZmFsc2UnLFxuICAgICAgICAgIGNvbnRpbnVlT25FcnJvcjogdHJ1ZSxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgIG5hbWU6ICdDb21tZW50IFBSJyxcbiAgICAgICAgICB1c2VzOiAnYWN0aW9ucy9naXRodWItc2NyaXB0QHY3JyxcbiAgICAgICAgICBpZjogXCJnaXRodWIuZXZlbnRfbmFtZSA9PSAncHVsbF9yZXF1ZXN0J1wiLFxuICAgICAgICAgIGVudjoge1xuICAgICAgICAgICAgUExBTjogJ3RlcnJhZm9ybVxcXFxuJHt7IHN0ZXBzLnBsYW4ub3V0cHV0cy5zdGRvdXQgfX0nLFxuICAgICAgICAgIH0sXG4gICAgICAgICAgd2l0aDoge1xuICAgICAgICAgICAgJ2dpdGh1Yi10b2tlbic6ICcke3sgc2VjcmV0cy5HSVRIVUJfVE9LRU4gfX0nLFxuICAgICAgICAgICAgc2NyaXB0OiBgXG4gICAgICAgICAgICAgIC8vIDEuIFJldHJpZXZlIGV4aXN0aW5nIGJvdCBjb21tZW50cyBmb3IgdGhlIFBSXG4gICAgICAgICAgICAgIGNvbnN0IHsgZGF0YTogY29tbWVudHMgfSA9IGF3YWl0IGdpdGh1Yi5yZXN0Lmlzc3Vlcy5saXN0Q29tbWVudHMoe1xuICAgICAgICAgICAgICAgIG93bmVyOiBjb250ZXh0LnJlcG8ub3duZXIsXG4gICAgICAgICAgICAgICAgcmVwbzogY29udGV4dC5yZXBvLnJlcG8sXG4gICAgICAgICAgICAgICAgaXNzdWVfbnVtYmVyOiBjb250ZXh0Lmlzc3VlLm51bWJlcixcbiAgICAgICAgICAgICAgfSlcbiAgICAgICAgICAgICAgY29uc3QgYm90Q29tbWVudCA9IGNvbW1lbnRzLmZpbmQoY29tbWVudCA9PiB7XG4gICAgICAgICAgICAgICAgcmV0dXJuIGNvbW1lbnQudXNlci50eXBlID09PSAnQm90JyAmJiBjb21tZW50LmJvZHkuaW5jbHVkZXMoJ1RlcnJhZm9ybSBGb3JtYXQgYW5kIFN0eWxlJylcbiAgICAgICAgICAgICAgfSlcblxuICAgICAgICAgICAgICAvLyAyLiBQcmVwYXJlIGZvcm1hdCBvZiB0aGUgY29tbWVudFxuICAgICAgICAgICAgICBjb25zdCBvdXRwdXQgPSBcXGAjIyMjIFRlcnJhZm9ybSBGb3JtYXQgYW5kIFN0eWxlIPCfloxcXFxcXFxgXFwke3sgc3RlcHMuZm10Lm91dGNvbWUgfX1cXFxcXFxgXG4gICAgICAgICAgICAgICMjIyMgVGVycmFmb3JtIEluaXRpYWxpemF0aW9uIOKame+4j1xcXFxcXGBcXCR7eyBzdGVwcy5pbml0Lm91dGNvbWUgfX1cXFxcXFxgXG4gICAgICAgICAgICAgICMjIyMgVGVycmFmb3JtIFZhbGlkYXRpb24g8J+kllxcXFxcXGBcXCR7eyBzdGVwcy52YWxpZGF0ZS5vdXRjb21lIH19XFxcXFxcYFxuICAgICAgICAgICAgICA8ZGV0YWlscz48c3VtbWFyeT5WYWxpZGF0aW9uIE91dHB1dDwvc3VtbWFyeT5cblxuICAgICAgICAgICAgICBcXFxcXFxgXFxcXFxcYFxcXFxcXGBcbiAgICAgICAgICAgICAgXFwke3sgc3RlcHMudmFsaWRhdGUub3V0cHV0cy5zdGRvdXQgfX1cbiAgICAgICAgICAgICAgXFxcXFxcYFxcXFxcXGBcXFxcXFxgXG5cbiAgICAgICAgICAgICAgPC9kZXRhaWxzPlxuXG4gICAgICAgICAgICAgICMjIyMgVGVycmFmb3JtIFBsYW4g8J+TllxcXFxcXGBcXCR7eyBzdGVwcy5wbGFuLm91dGNvbWUgfX1cXFxcXFxgXG5cbiAgICAgICAgICAgICAgPGRldGFpbHM+PHN1bW1hcnk+U2hvdyBQbGFuPC9zdW1tYXJ5PlxuXG4gICAgICAgICAgICAgIFxcXFxcXGBcXFxcXFxgXFxcXFxcYFxuICAgICAgICAgICAgICBcXCR7cHJvY2Vzcy5lbnYuUExBTn1cbiAgICAgICAgICAgICAgXFxcXFxcYFxcXFxcXGBcXFxcXFxgXG5cbiAgICAgICAgICAgICAgPC9kZXRhaWxzPlxuXG4gICAgICAgICAgICAgICpQdXNoZXI6IEBcXCR7eyBnaXRodWIuYWN0b3IgfX0sIEFjdGlvbjogXFxcXFxcYFxcJHt7IGdpdGh1Yi5ldmVudF9uYW1lIH19XFxcXFxcYCwgV29ya2luZyBEaXJlY3Rvcnk6IFxcXFxcXGBcXCR7eyBlbnYudGZfYWN0aW9uc193b3JraW5nX2RpciB9fVxcXFxcXGAsIFdvcmtmbG93OiBcXFxcXFxgXFwke3sgZ2l0aHViLndvcmtmbG93IH19XFxcXFxcYCpcXGA7XG5cbiAgICAgICAgICAgICAgLy8gMy4gSWYgd2UgaGF2ZSBhIGNvbW1lbnQsIHVwZGF0ZSBpdCwgb3RoZXJ3aXNlIGNyZWF0ZSBhIG5ldyBvbmVcbiAgICAgICAgICAgICAgaWYgKGJvdENvbW1lbnQpIHtcbiAgICAgICAgICAgICAgICBnaXRodWIucmVzdC5pc3N1ZXMudXBkYXRlQ29tbWVudCh7XG4gICAgICAgICAgICAgICAgICBvd25lcjogY29udGV4dC5yZXBvLm93bmVyLFxuICAgICAgICAgICAgICAgICAgcmVwbzogY29udGV4dC5yZXBvLnJlcG8sXG4gICAgICAgICAgICAgICAgICBjb21tZW50X2lkOiBib3RDb21tZW50LmlkLFxuICAgICAgICAgICAgICAgICAgYm9keTogb3V0cHV0XG4gICAgICAgICAgICAgICAgfSlcbiAgICAgICAgICAgICAgfSBlbHNlIHtcbiAgICAgICAgICAgICAgICBnaXRodWIucmVzdC5pc3N1ZXMuY3JlYXRlQ29tbWVudCh7XG4gICAgICAgICAgICAgICAgICBpc3N1ZV9udW1iZXI6IGNvbnRleHQuaXNzdWUubnVtYmVyLFxuICAgICAgICAgICAgICAgICAgb3duZXI6IGNvbnRleHQucmVwby5vd25lcixcbiAgICAgICAgICAgICAgICAgIHJlcG86IGNvbnRleHQucmVwby5yZXBvLFxuICAgICAgICAgICAgICAgICAgYm9keTogb3V0cHV0XG4gICAgICAgICAgICAgICAgfSlcbiAgICAgICAgICAgICAgfVxuICAgICAgICAgICAgYCxcbiAgICAgICAgICB9LFxuICAgICAgICB9LFxuICAgICAgXSxcbiAgICB9KTtcbiAgfVxufVxuIl19

package/lib/terraform/index.d.ts

@@ -0,0 +1,5 @@
+export * from './components';
+export * from './terraform-base-project';
+export * from './terraform-stack-project';
+export * from './terraform-module-project';
+export * from './providers';

package/lib/terraform/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./components"), exports);
+__exportStar(require("./terraform-base-project"), exports);
+__exportStar(require("./terraform-stack-project"), exports);
+__exportStar(require("./terraform-module-project"), exports);
+__exportStar(require("./providers"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVycmFmb3JtL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwrQ0FBNkI7QUFDN0IsMkRBQXlDO0FBQ3pDLDREQUEwQztBQUMxQyw2REFBMkM7QUFDM0MsOENBQTRCIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSAnLi9jb21wb25lbnRzJztcbmV4cG9ydCAqIGZyb20gJy4vdGVycmFmb3JtLWJhc2UtcHJvamVjdCc7XG5leHBvcnQgKiBmcm9tICcuL3RlcnJhZm9ybS1zdGFjay1wcm9qZWN0JztcbmV4cG9ydCAqIGZyb20gJy4vdGVycmFmb3JtLW1vZHVsZS1wcm9qZWN0JztcbmV4cG9ydCAqIGZyb20gJy4vcHJvdmlkZXJzJztcbiJdfQ==

package/lib/terraform/providers/hetzner-provider.d.ts

@@ -0,0 +1,105 @@
+import { TerraformProvider, TerraformProviderOptions } from './provider-strategy';
+/**
+ * Poll function types for Hetzner Cloud provider.
+ */
+export declare enum HetznerPollFunction {
+    /**
+     * Constant polling interval.
+     */
+    CONSTANT = "constant",
+    /**
+     * Exponential backoff polling.
+     */
+    EXPONENTIAL = "exponential"
+}
+/**
+ * Configuration for a specific Hetzner Cloud provider instance.
+ */
+export interface HetznerProviderConfig {
+    /**
+     * Provider alias for multiple configurations.
+     */
+    readonly alias?: string;
+    /**
+     * Hetzner Cloud API token (can be set via HCLOUD_TOKEN env var).
+     * Required unless useEnvironmentToken is true or set via environment variable.
+     */
+    readonly token?: string;
+    /**
+     * Use HCLOUD_TOKEN environment variable for authentication.
+     * When true, the token will be read from HCLOUD_TOKEN environment variable
+     * and no explicit token configuration will be generated in the provider block.
+     * This is useful for CI/CD pipelines and different environments.
+     * @default true
+     */
+    readonly useEnvironmentToken?: boolean;
+    /**
+     * Hetzner Cloud API endpoint.
+     * @default "https://api.hetzner.cloud/v1"
+     */
+    readonly endpoint?: string;
+    /**
+     * Hetzner API endpoint (for Hetzner services, not Hetzner Cloud).
+     * @default "https://api.hetzner.com/v1"
+     */
+    readonly endpointHetzner?: string;
+    /**
+     * Configures the interval in which actions are polled by the client.
+     * @default "500ms"
+     * @example "1s", "2000ms"
+     */
+    readonly pollInterval?: string;
+    /**
+     * Configures the type of function to be used during polling.
+     * @default "exponential"
+     */
+    readonly pollFunction?: HetznerPollFunction;
+}
+/**
+ * Options for Hetzner Terraform provider.
+ */
+export interface HetznerProviderOptions extends TerraformProviderOptions {
+    /**
+     * Array of provider configurations for multiple instances/projects.
+     * Each configuration can have its own alias, token, and settings.
+     *
+     * If empty or not provided, a default configuration will be created
+     * with useEnvironmentToken: true and no alias.
+     *
+     * @example
+     * // Simple case - uses default configuration with HCLOUD_TOKEN env var
+     * new HetznerProvider({
+     *   version: '~> 1.45'
+     * })
+     *
+     * // Multiple configurations
+     * new HetznerProvider({
+     *   version: '~> 1.45',
+     *   providers: [
+     *     {
+     *       alias: 'dns',
+     *       token: 'dns-project-token',
+     *       useEnvironmentToken: false
+     *     },
+     *     {
+     *       alias: 'staging',
+     *       useEnvironmentToken: true
+     *     }
+     *   ]
+     * })
+     */
+    readonly providers?: HetznerProviderConfig[];
+}
+/**
+ * Hetzner Cloud Terraform provider configuration.
+ */
+export declare class HetznerProvider extends TerraformProvider {
+    private readonly providerConfigs;
+    constructor(options: HetznerProviderOptions);
+    providerSource(): string;
+    generateProviderBlock(): string[];
+    /**
+     * Add a new provider configuration.
+     */
+    addProviderConfig(config: HetznerProviderConfig): void;
+}

package/lib/terraform/providers/hetzner-provider.js

@@ -0,0 +1,83 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HetznerProvider = exports.HetznerPollFunction = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const provider_strategy_1 = require("./provider-strategy");
+/**
+ * Poll function types for Hetzner Cloud provider.
+ */
+var HetznerPollFunction;
+(function (HetznerPollFunction) {
+    /**
+     * Constant polling interval.
+     */
+    HetznerPollFunction["CONSTANT"] = "constant";
+    /**
+     * Exponential backoff polling.
+     */
+    HetznerPollFunction["EXPONENTIAL"] = "exponential";
+})(HetznerPollFunction || (exports.HetznerPollFunction = HetznerPollFunction = {}));
+/**
+ * Hetzner Cloud Terraform provider configuration.
+ */
+class HetznerProvider extends provider_strategy_1.TerraformProvider {
+    constructor(options) {
+        super('hcloud', options);
+        // If no providers are specified, create a default configuration
+        this.providerConfigs =
+            options.providers && options.providers.length > 0
+                ? options.providers
+                : [
+                    {
+                        useEnvironmentToken: true,
+                    },
+                ];
+    }
+    providerSource() {
+        return 'hetznercloud/hcloud';
+    }
+    generateProviderBlock() {
+        const lines = [];
+        // Generate provider block for each configuration
+        this.providerConfigs.forEach((config) => {
+            lines.push('provider "hcloud" {');
+            if (config.alias) {
+                lines.push(`  alias = "${config.alias}"`);
+            }
+            if (config.useEnvironmentToken !== false) {
+                lines.push('  # token will be read from HCLOUD_TOKEN environment variable');
+            }
+            else if (config.token) {
+                lines.push(`  token = "${config.token}"`);
+            }
+            else {
+                lines.push('  # token = var.hcloud_token  # Please set token or use useEnvironmentToken: true');
+            }
+            if (config.endpoint) {
+                lines.push(`  endpoint = "${config.endpoint}"`);
+            }
+            if (config.endpointHetzner) {
+                lines.push(`  endpoint_hetzner = "${config.endpointHetzner}"`);
+            }
+            if (config.pollInterval) {
+                lines.push(`  poll_interval = "${config.pollInterval}"`);
+            }
+            if (config.pollFunction) {
+                lines.push(`  poll_function = "${config.pollFunction}"`);
+            }
+            lines.push('}');
+        });
+        return lines;
+    }
+    /**
+     * Add a new provider configuration.
+     */
+    addProviderConfig(config) {
+        this.providerConfigs.push(config);
+    }
+}
+exports.HetznerProvider = HetznerProvider;
+_a = JSII_RTTI_SYMBOL_1;
+HetznerProvider[_a] = { fqn: "@jttc/projen-project-types.HetznerProvider", version: "1.0.0-beta.10" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGV0em5lci1wcm92aWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90ZXJyYWZvcm0vcHJvdmlkZXJzL2hldHpuZXItcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSwyREFHNkI7QUFFN0I7O0dBRUc7QUFDSCxJQUFZLG1CQVVYO0FBVkQsV0FBWSxtQkFBbUI7SUFDN0I7O09BRUc7SUFDSCw0Q0FBcUIsQ0FBQTtJQUVyQjs7T0FFRztJQUNILGtEQUEyQixDQUFBO0FBQzdCLENBQUMsRUFWVyxtQkFBbUIsbUNBQW5CLG1CQUFtQixRQVU5QjtBQXdGRDs7R0FFRztBQUNILE1BQWEsZUFBZ0IsU0FBUSxxQ0FBaUI7SUFHcEQsWUFBWSxPQUErQjtRQUN6QyxLQUFLLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBRXpCLGdFQUFnRTtRQUNoRSxJQUFJLENBQUMsZUFBZTtZQUNsQixPQUFPLENBQUMsU0FBUyxJQUFJLE9BQU8sQ0FBQyxTQUFTLENBQUMsTUFBTSxHQUFHLENBQUM7Z0JBQy9DLENBQUMsQ0FBQyxPQUFPLENBQUMsU0FBUztnQkFDbkIsQ0FBQyxDQUFDO29CQUNFO3dCQUNFLG1CQUFtQixFQUFFLElBQUk7cUJBQzFCO2lCQUNGLENBQUM7SUFDVixDQUFDO0lBRU0sY0FBYztRQUNuQixPQUFPLHFCQUFxQixDQUFDO0lBQy9CLENBQUM7SUFFTSxxQkFBcUI7UUFDMUIsTUFBTSxLQUFLLEdBQWEsRUFBRSxDQUFDO1FBRTNCLGlEQUFpRDtRQUNqRCxJQUFJLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFO1lBQ3RDLEtBQUssQ0FBQyxJQUFJLENBQUMscUJBQXFCLENBQUMsQ0FBQztZQUVsQyxJQUFJLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQztnQkFDakIsS0FBSyxDQUFDLElBQUksQ0FBQyxjQUFjLE1BQU0sQ0FBQyxLQUFLLEdBQUcsQ0FBQyxDQUFDO1lBQzVDLENBQUM7WUFFRCxJQUFJLE1BQU0sQ0FBQyxtQkFBbUIsS0FBSyxLQUFLLEVBQUUsQ0FBQztnQkFDekMsS0FBSyxDQUFDLElBQUksQ0FDUiwrREFBK0QsQ0FDaEUsQ0FBQztZQUNKLENBQUM7aUJBQU0sSUFBSSxNQUFNLENBQUMsS0FBSyxFQUFFLENBQUM7Z0JBQ3hCLEtBQUssQ0FBQyxJQUFJLENBQUMsY0FBYyxNQUFNLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQztZQUM1QyxDQUFDO2lCQUFNLENBQUM7Z0JBQ04sS0FBSyxDQUFDLElBQUksQ0FDUixtRkFBbUYsQ0FDcEYsQ0FBQztZQUNKLENBQUM7WUFFRCxJQUFJLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQztnQkFDcEIsS0FBSyxDQUFDLElBQUksQ0FBQyxpQkFBaUIsTUFBTSxDQUFDLFFBQVEsR0FBRyxDQUFDLENBQUM7WUFDbEQsQ0FBQztZQUVELElBQUksTUFBTSxDQUFDLGVBQWUsRUFBRSxDQUFDO2dCQUMzQixLQUFLLENBQUMsSUFBSSxDQUFDLHlCQUF5QixNQUFNLENBQUMsZUFBZSxHQUFHLENBQUMsQ0FBQztZQUNqRSxDQUFDO1lBRUQsSUFBSSxNQUFNLENBQUMsWUFBWSxFQUFFLENBQUM7Z0JBQ3hCLEtBQUssQ0FBQyxJQUFJLENBQUMsc0JBQXNCLE1BQU0sQ0FBQyxZQUFZLEdBQUcsQ0FBQyxDQUFDO1lBQzNELENBQUM7WUFFRCxJQUFJLE1BQU0sQ0FBQyxZQUFZLEVBQUUsQ0FBQztnQkFDeEIsS0FBSyxDQUFDLElBQUksQ0FBQyxzQkFBc0IsTUFBTSxDQUFDLFlBQVksR0FBRyxDQUFDLENBQUM7WUFDM0QsQ0FBQztZQUVELEtBQUssQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDbEIsQ0FBQyxDQUFDLENBQUM7UUFFSCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7SUFFRDs7T0FFRztJQUNJLGlCQUFpQixDQUFDLE1BQTZCO1FBQ3BELElBQUksQ0FBQyxlQUFlLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3BDLENBQUM7O0FBdkVILDBDQXdFQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7XG4gIFRlcnJhZm9ybVByb3ZpZGVyLFxuICBUZXJyYWZvcm1Qcm92aWRlck9wdGlvbnMsXG59IGZyb20gJy4vcHJvdmlkZXItc3RyYXRlZ3knO1xuXG4vKipcbiAqIFBvbGwgZnVuY3Rpb24gdHlwZXMgZm9yIEhldHpuZXIgQ2xvdWQgcHJvdmlkZXIuXG4gKi9cbmV4cG9ydCBlbnVtIEhldHpuZXJQb2xsRnVuY3Rpb24ge1xuICAvKipcbiAgICogQ29uc3RhbnQgcG9sbGluZyBpbnRlcnZhbC5cbiAgICovXG4gIENPTlNUQU5UID0gJ2NvbnN0YW50JyxcblxuICAvKipcbiAgICogRXhwb25lbnRpYWwgYmFja29mZiBwb2xsaW5nLlxuICAgKi9cbiAgRVhQT05FTlRJQUwgPSAnZXhwb25lbnRpYWwnLFxufVxuXG4vKipcbiAqIENvbmZpZ3VyYXRpb24gZm9yIGEgc3BlY2lmaWMgSGV0em5lciBDbG91ZCBwcm92aWRlciBpbnN0YW5jZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBIZXR6bmVyUHJvdmlkZXJDb25maWcge1xuICAvKipcbiAgICogUHJvdmlkZXIgYWxpYXMgZm9yIG11bHRpcGxlIGNvbmZpZ3VyYXRpb25zLlxuICAgKi9cbiAgcmVhZG9ubHkgYWxpYXM/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEhldHpuZXIgQ2xvdWQgQVBJIHRva2VuIChjYW4gYmUgc2V0IHZpYSBIQ0xPVURfVE9LRU4gZW52IHZhcikuXG4gICAqIFJlcXVpcmVkIHVubGVzcyB1c2VFbnZpcm9ubWVudFRva2VuIGlzIHRydWUgb3Igc2V0IHZpYSBlbnZpcm9ubWVudCB2YXJpYWJsZS5cbiAgICovXG4gIHJlYWRvbmx5IHRva2VuPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBVc2UgSENMT1VEX1RPS0VOIGVudmlyb25tZW50IHZhcmlhYmxlIGZvciBhdXRoZW50aWNhdGlvbi5cbiAgICogV2hlbiB0cnVlLCB0aGUgdG9rZW4gd2lsbCBiZSByZWFkIGZyb20gSENMT1VEX1RPS0VOIGVudmlyb25tZW50IHZhcmlhYmxlXG4gICAqIGFuZCBubyBleHBsaWNpdCB0b2tlbiBjb25maWd1cmF0aW9uIHdpbGwgYmUgZ2VuZXJhdGVkIGluIHRoZSBwcm92aWRlciBibG9jay5cbiAgICogVGhpcyBpcyB1c2VmdWwgZm9yIENJL0NEIHBpcGVsaW5lcyBhbmQgZGlmZmVyZW50IGVudmlyb25tZW50cy5cbiAgICogQGRlZmF1bHQgdHJ1ZVxuICAgKi9cbiAgcmVhZG9ubHkgdXNlRW52aXJvbm1lbnRUb2tlbj86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIEhldHpuZXIgQ2xvdWQgQVBJIGVuZHBvaW50LlxuICAgKiBAZGVmYXVsdCBcImh0dHBzOi8vYXBpLmhldHpuZXIuY2xvdWQvdjFcIlxuICAgKi9cbiAgcmVhZG9ubHkgZW5kcG9pbnQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEhldHpuZXIgQVBJIGVuZHBvaW50IChmb3IgSGV0em5lciBzZXJ2aWNlcywgbm90IEhldHpuZXIgQ2xvdWQpLlxuICAgKiBAZGVmYXVsdCBcImh0dHBzOi8vYXBpLmhldHpuZXIuY29tL3YxXCJcbiAgICovXG4gIHJlYWRvbmx5IGVuZHBvaW50SGV0em5lcj86IHN0cmluZztcblxuICAvKipcbiAgICogQ29uZmlndXJlcyB0aGUgaW50ZXJ2YWwgaW4gd2hpY2ggYWN0aW9ucyBhcmUgcG9sbGVkIGJ5IHRoZSBjbGllbnQuXG4gICAqIEBkZWZhdWx0IFwiNTAwbXNcIlxuICAgKiBAZXhhbXBsZSBcIjFzXCIsIFwiMjAwMG1zXCJcbiAgICovXG4gIHJlYWRvbmx5IHBvbGxJbnRlcnZhbD86IHN0cmluZztcblxuICAvKipcbiAgICogQ29uZmlndXJlcyB0aGUgdHlwZSBvZiBmdW5jdGlvbiB0byBiZSB1c2VkIGR1cmluZyBwb2xsaW5nLlxuICAgKiBAZGVmYXVsdCBcImV4cG9uZW50aWFsXCJcbiAgICovXG4gIHJlYWRvbmx5IHBvbGxGdW5jdGlvbj86IEhldHpuZXJQb2xsRnVuY3Rpb247XG59XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgSGV0em5lciBUZXJyYWZvcm0gcHJvdmlkZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSGV0em5lclByb3ZpZGVyT3B0aW9ucyBleHRlbmRzIFRlcnJhZm9ybVByb3ZpZGVyT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBBcnJheSBvZiBwcm92aWRlciBjb25maWd1cmF0aW9ucyBmb3IgbXVsdGlwbGUgaW5zdGFuY2VzL3Byb2plY3RzLlxuICAgKiBFYWNoIGNvbmZpZ3VyYXRpb24gY2FuIGhhdmUgaXRzIG93biBhbGlhcywgdG9rZW4sIGFuZCBzZXR0aW5ncy5cbiAgICpcbiAgICogSWYgZW1wdHkgb3Igbm90IHByb3ZpZGVkLCBhIGRlZmF1bHQgY29uZmlndXJhdGlvbiB3aWxsIGJlIGNyZWF0ZWRcbiAgICogd2l0aCB1c2VFbnZpcm9ubWVudFRva2VuOiB0cnVlIGFuZCBubyBhbGlhcy5cbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogLy8gU2ltcGxlIGNhc2UgLSB1c2VzIGRlZmF1bHQgY29uZmlndXJhdGlvbiB3aXRoIEhDTE9VRF9UT0tFTiBlbnYgdmFyXG4gICAqIG5ldyBIZXR6bmVyUHJvdmlkZXIoe1xuICAgKiAgIHZlcnNpb246ICd+PiAxLjQ1J1xuICAgKiB9KVxuICAgKlxuICAgKiAvLyBNdWx0aXBsZSBjb25maWd1cmF0aW9uc1xuICAgKiBuZXcgSGV0em5lclByb3ZpZGVyKHtcbiAgICogICB2ZXJzaW9uOiAnfj4gMS40NScsXG4gICAqICAgcHJvdmlkZXJzOiBbXG4gICAqICAgICB7XG4gICAqICAgICAgIGFsaWFzOiAnZG5zJyxcbiAgICogICAgICAgdG9rZW46ICdkbnMtcHJvamVjdC10b2tlbicsXG4gICAqICAgICAgIHVzZUVudmlyb25tZW50VG9rZW46IGZhbHNlXG4gICAqICAgICB9LFxuICAgKiAgICAge1xuICAgKiAgICAgICBhbGlhczogJ3N0YWdpbmcnLFxuICAgKiAgICAgICB1c2VFbnZpcm9ubWVudFRva2VuOiB0cnVlXG4gICAqICAgICB9XG4gICAqICAgXVxuICAgKiB9KVxuICAgKi9cbiAgcmVhZG9ubHkgcHJvdmlkZXJzPzogSGV0em5lclByb3ZpZGVyQ29uZmlnW107XG59XG5cbi8qKlxuICogSGV0em5lciBDbG91ZCBUZXJyYWZvcm0gcHJvdmlkZXIgY29uZmlndXJhdGlvbi5cbiAqL1xuZXhwb3J0IGNsYXNzIEhldHpuZXJQcm92aWRlciBleHRlbmRzIFRlcnJhZm9ybVByb3ZpZGVyIHtcbiAgcHJpdmF0ZSByZWFkb25seSBwcm92aWRlckNvbmZpZ3M6IEhldHpuZXJQcm92aWRlckNvbmZpZ1tdO1xuXG4gIGNvbnN0cnVjdG9yKG9wdGlvbnM6IEhldHpuZXJQcm92aWRlck9wdGlvbnMpIHtcbiAgICBzdXBlcignaGNsb3VkJywgb3B0aW9ucyk7XG5cbiAgICAvLyBJZiBubyBwcm92aWRlcnMgYXJlIHNwZWNpZmllZCwgY3JlYXRlIGEgZGVmYXVsdCBjb25maWd1cmF0aW9uXG4gICAgdGhpcy5wcm92aWRlckNvbmZpZ3MgPVxuICAgICAgb3B0aW9ucy5wcm92aWRlcnMgJiYgb3B0aW9ucy5wcm92aWRlcnMubGVuZ3RoID4gMFxuICAgICAgICA/IG9wdGlvbnMucHJvdmlkZXJzXG4gICAgICAgIDogW1xuICAgICAgICAgICAge1xuICAgICAgICAgICAgICB1c2VFbnZpcm9ubWVudFRva2VuOiB0cnVlLFxuICAgICAgICAgICAgfSxcbiAgICAgICAgICBdO1xuICB9XG5cbiAgcHVibGljIHByb3ZpZGVyU291cmNlKCk6IHN0cmluZyB7XG4gICAgcmV0dXJuICdoZXR6bmVyY2xvdWQvaGNsb3VkJztcbiAgfVxuXG4gIHB1YmxpYyBnZW5lcmF0ZVByb3ZpZGVyQmxvY2soKTogc3RyaW5nW10ge1xuICAgIGNvbnN0IGxpbmVzOiBzdHJpbmdbXSA9IFtdO1xuXG4gICAgLy8gR2VuZXJhdGUgcHJvdmlkZXIgYmxvY2sgZm9yIGVhY2ggY29uZmlndXJhdGlvblxuICAgIHRoaXMucHJvdmlkZXJDb25maWdzLmZvckVhY2goKGNvbmZpZykgPT4ge1xuICAgICAgbGluZXMucHVzaCgncHJvdmlkZXIgXCJoY2xvdWRcIiB7Jyk7XG5cbiAgICAgIGlmIChjb25maWcuYWxpYXMpIHtcbiAgICAgICAgbGluZXMucHVzaChgICBhbGlhcyA9IFwiJHtjb25maWcuYWxpYXN9XCJgKTtcbiAgICAgIH1cblxuICAgICAgaWYgKGNvbmZpZy51c2VFbnZpcm9ubWVudFRva2VuICE9PSBmYWxzZSkge1xuICAgICAgICBsaW5lcy5wdXNoKFxuICAgICAgICAgICcgICMgdG9rZW4gd2lsbCBiZSByZWFkIGZyb20gSENMT1VEX1RPS0VOIGVudmlyb25tZW50IHZhcmlhYmxlJyxcbiAgICAgICAgKTtcbiAgICAgIH0gZWxzZSBpZiAoY29uZmlnLnRva2VuKSB7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgdG9rZW4gPSBcIiR7Y29uZmlnLnRva2VufVwiYCk7XG4gICAgICB9IGVsc2Uge1xuICAgICAgICBsaW5lcy5wdXNoKFxuICAgICAgICAgICcgICMgdG9rZW4gPSB2YXIuaGNsb3VkX3Rva2VuICAjIFBsZWFzZSBzZXQgdG9rZW4gb3IgdXNlIHVzZUVudmlyb25tZW50VG9rZW46IHRydWUnLFxuICAgICAgICApO1xuICAgICAgfVxuXG4gICAgICBpZiAoY29uZmlnLmVuZHBvaW50KSB7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgZW5kcG9pbnQgPSBcIiR7Y29uZmlnLmVuZHBvaW50fVwiYCk7XG4gICAgICB9XG5cbiAgICAgIGlmIChjb25maWcuZW5kcG9pbnRIZXR6bmVyKSB7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgZW5kcG9pbnRfaGV0em5lciA9IFwiJHtjb25maWcuZW5kcG9pbnRIZXR6bmVyfVwiYCk7XG4gICAgICB9XG5cbiAgICAgIGlmIChjb25maWcucG9sbEludGVydmFsKSB7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgcG9sbF9pbnRlcnZhbCA9IFwiJHtjb25maWcucG9sbEludGVydmFsfVwiYCk7XG4gICAgICB9XG5cbiAgICAgIGlmIChjb25maWcucG9sbEZ1bmN0aW9uKSB7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgcG9sbF9mdW5jdGlvbiA9IFwiJHtjb25maWcucG9sbEZ1bmN0aW9ufVwiYCk7XG4gICAgICB9XG5cbiAgICAgIGxpbmVzLnB1c2goJ30nKTtcbiAgICB9KTtcblxuICAgIHJldHVybiBsaW5lcztcbiAgfVxuXG4gIC8qKlxuICAgKiBBZGQgYSBuZXcgcHJvdmlkZXIgY29uZmlndXJhdGlvbi5cbiAgICovXG4gIHB1YmxpYyBhZGRQcm92aWRlckNvbmZpZyhjb25maWc6IEhldHpuZXJQcm92aWRlckNvbmZpZyk6IHZvaWQge1xuICAgIHRoaXMucHJvdmlkZXJDb25maWdzLnB1c2goY29uZmlnKTtcbiAgfVxufVxuIl19

package/lib/terraform/providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './provider-strategy';
+export * from './hetzner-provider';

package/lib/terraform/providers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./provider-strategy"), exports);
+__exportStar(require("./hetzner-provider"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGVycmFmb3JtL3Byb3ZpZGVycy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsc0RBQW9DO0FBQ3BDLHFEQUFtQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vcHJvdmlkZXItc3RyYXRlZ3knO1xuZXhwb3J0ICogZnJvbSAnLi9oZXR6bmVyLXByb3ZpZGVyJztcbiJdfQ==

package/lib/terraform/providers/provider-strategy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base options for Terraform providers.
+ */
+export interface TerraformProviderOptions {
+    /**
+     * Provider version constraint.
+     * @example "~> 5.0"
+     */
+    readonly version?: string;
+    /**
+     * Provider alias (optional).
+     */
+    readonly alias?: string;
+}
+/**
+ * Base class for Terraform provider configurations.
+ * This is a strategy class that holds configuration, not a Projen component.
+ */
+export declare abstract class TerraformProvider {
+    protected readonly version?: string;
+    protected readonly alias?: string;
+    protected readonly providerName: string;
+    constructor(providerName: string, options?: TerraformProviderOptions);
+    /**
+     * Get the provider alias for the required_providers block.
+     */
+    providerAlias(): string;
+    /**
+     * Get the provider source (e.g., "hashicorp/aws").
+     */
+    abstract providerSource(): string;
+    /**
+     * Generate the provider configuration block.
+     */
+    abstract generateProviderBlock(): string[];
+    /**
+     * Get the version constraint.
+     */
+    versionConstraint(): string | undefined;
+    /**
+     * Get the provider name.
+     */
+    name(): string;
+}

package/lib/terraform/providers/provider-strategy.js

@@ -0,0 +1,38 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerraformProvider = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+/**
+ * Base class for Terraform provider configurations.
+ * This is a strategy class that holds configuration, not a Projen component.
+ */
+class TerraformProvider {
+    constructor(providerName, options) {
+        this.providerName = providerName;
+        this.version = options?.version;
+        this.alias = options?.alias;
+    }
+    /**
+     * Get the provider alias for the required_providers block.
+     */
+    providerAlias() {
+        return this.alias || this.providerName;
+    }
+    /**
+     * Get the version constraint.
+     */
+    versionConstraint() {
+        return this.version;
+    }
+    /**
+     * Get the provider name.
+     */
+    name() {
+        return this.providerName;
+    }
+}
+exports.TerraformProvider = TerraformProvider;
+_a = JSII_RTTI_SYMBOL_1;
+TerraformProvider[_a] = { fqn: "@jttc/projen-project-types.TerraformProvider", version: "1.0.0-beta.10" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdmlkZXItc3RyYXRlZ3kuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGVycmFmb3JtL3Byb3ZpZGVycy9wcm92aWRlci1zdHJhdGVneS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQWdCQTs7O0dBR0c7QUFDSCxNQUFzQixpQkFBaUI7SUFLckMsWUFBWSxZQUFvQixFQUFFLE9BQWtDO1FBQ2xFLElBQUksQ0FBQyxZQUFZLEdBQUcsWUFBWSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxFQUFFLE9BQU8sQ0FBQztRQUNoQyxJQUFJLENBQUMsS0FBSyxHQUFHLE9BQU8sRUFBRSxLQUFLLENBQUM7SUFDOUIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksYUFBYTtRQUNsQixPQUFPLElBQUksQ0FBQyxLQUFLLElBQUksSUFBSSxDQUFDLFlBQVksQ0FBQztJQUN6QyxDQUFDO0lBWUQ7O09BRUc7SUFDSSxpQkFBaUI7UUFDdEIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDO0lBQ3RCLENBQUM7SUFFRDs7T0FFRztJQUNJLElBQUk7UUFDVCxPQUFPLElBQUksQ0FBQyxZQUFZLENBQUM7SUFDM0IsQ0FBQzs7QUF4Q0gsOENBeUNDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBCYXNlIG9wdGlvbnMgZm9yIFRlcnJhZm9ybSBwcm92aWRlcnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGVycmFmb3JtUHJvdmlkZXJPcHRpb25zIHtcbiAgLyoqXG4gICAqIFByb3ZpZGVyIHZlcnNpb24gY29uc3RyYWludC5cbiAgICogQGV4YW1wbGUgXCJ+PiA1LjBcIlxuICAgKi9cbiAgcmVhZG9ubHkgdmVyc2lvbj86IHN0cmluZztcblxuICAvKipcbiAgICogUHJvdmlkZXIgYWxpYXMgKG9wdGlvbmFsKS5cbiAgICovXG4gIHJlYWRvbmx5IGFsaWFzPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEJhc2UgY2xhc3MgZm9yIFRlcnJhZm9ybSBwcm92aWRlciBjb25maWd1cmF0aW9ucy5cbiAqIFRoaXMgaXMgYSBzdHJhdGVneSBjbGFzcyB0aGF0IGhvbGRzIGNvbmZpZ3VyYXRpb24sIG5vdCBhIFByb2plbiBjb21wb25lbnQuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBUZXJyYWZvcm1Qcm92aWRlciB7XG4gIHByb3RlY3RlZCByZWFkb25seSB2ZXJzaW9uPzogc3RyaW5nO1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYWxpYXM/OiBzdHJpbmc7XG4gIHByb3RlY3RlZCByZWFkb25seSBwcm92aWRlck5hbWU6IHN0cmluZztcblxuICBjb25zdHJ1Y3Rvcihwcm92aWRlck5hbWU6IHN0cmluZywgb3B0aW9ucz86IFRlcnJhZm9ybVByb3ZpZGVyT3B0aW9ucykge1xuICAgIHRoaXMucHJvdmlkZXJOYW1lID0gcHJvdmlkZXJOYW1lO1xuICAgIHRoaXMudmVyc2lvbiA9IG9wdGlvbnM/LnZlcnNpb247XG4gICAgdGhpcy5hbGlhcyA9IG9wdGlvbnM/LmFsaWFzO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCB0aGUgcHJvdmlkZXIgYWxpYXMgZm9yIHRoZSByZXF1aXJlZF9wcm92aWRlcnMgYmxvY2suXG4gICAqL1xuICBwdWJsaWMgcHJvdmlkZXJBbGlhcygpOiBzdHJpbmcge1xuICAgIHJldHVybiB0aGlzLmFsaWFzIHx8IHRoaXMucHJvdmlkZXJOYW1lO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCB0aGUgcHJvdmlkZXIgc291cmNlIChlLmcuLCBcImhhc2hpY29ycC9hd3NcIikuXG4gICAqL1xuICBwdWJsaWMgYWJzdHJhY3QgcHJvdmlkZXJTb3VyY2UoKTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBHZW5lcmF0ZSB0aGUgcHJvdmlkZXIgY29uZmlndXJhdGlvbiBibG9jay5cbiAgICovXG4gIHB1YmxpYyBhYnN0cmFjdCBnZW5lcmF0ZVByb3ZpZGVyQmxvY2soKTogc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIEdldCB0aGUgdmVyc2lvbiBjb25zdHJhaW50LlxuICAgKi9cbiAgcHVibGljIHZlcnNpb25Db25zdHJhaW50KCk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gICAgcmV0dXJuIHRoaXMudmVyc2lvbjtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIHByb3ZpZGVyIG5hbWUuXG4gICAqL1xuICBwdWJsaWMgbmFtZSgpOiBzdHJpbmcge1xuICAgIHJldHVybiB0aGlzLnByb3ZpZGVyTmFtZTtcbiAgfVxufVxuIl19

package/lib/terraform/terraform-base-project.d.ts

@@ -0,0 +1,38 @@
+import { Project, ProjectOptions } from 'projen';
+import { TerraformProvider } from './providers';
+/**
+ * Options for Terraform base project.
+ */
+export interface TerraformBaseProjectOptions extends ProjectOptions {
+    /**
+     * Minimum required Terraform version.
+     * @default "1.6.0"
+     */
+    readonly terraformVersion?: string;
+    /**
+     * Terraform provider configuration.
+     */
+    readonly provider?: TerraformProvider;
+}
+/**
+ * Base Terraform project that provides common Terraform configuration.
+ */
+export declare class TerraformBaseProject extends Project {
+    private _provider?;
+    private readonly _terraformVersion;
+    constructor(options: TerraformBaseProjectOptions);
+    /**
+     * Add a provider to this Terraform project.
+     * Only one provider per project is allowed.
+     */
+    addProvider(provider: TerraformProvider): void;
+    /**
+     * Get the current provider.
+     */
+    get provider(): TerraformProvider | undefined;
+    preSynthesize(): void;
+    /**
+     * Generate the provider.tf file if a provider is configured.
+     */
+    private generateProviderFile;
+}