@cdktn/provider-project 0.7.24

package/CLAUDE.md

@@ -0,0 +1,172 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Projen (https://projen.io) project template for creating CDKTF (CDK for Terraform) pre-built provider binding repositories. This is a fork maintained by CDK Terrain (cdktn.io) after HashiCorp's sunset announcement on December 10, 2025.
+
+**Purpose**: This repository generates the structure and workflows for individual provider repositories. Changes made here propagate to all downstream provider repos (managed at cdktn-io/repository-manager).
+
+## Key Concepts
+
+- **Provider Projects**: This template is used to bootstrap provider repos (e.g., `cdktn-provider-aws`, `cdktn-provider-google`) that contain pre-built TypeScript, Python, Java, C#, and Go bindings for Terraform providers
+- **Projen-based**: Everything is code-generated from `.projenrc.ts` - never manually edit generated files
+- **Downstream Impact**: Changes here affect hundreds of provider repositories when they upgrade to newer versions of `@cdktn/provider-project`
+
+## Common Commands
+
+### Development
+```bash
+npx projen                    # Regenerate all project files from .projenrc.ts
+npm run build                 # Compile TypeScript and run all build steps
+npm run compile               # Compile TypeScript only
+npm test                      # Run Jest tests
+npm run eslint                # Lint TypeScript files
+npm run eslint:fix            # Fix auto-fixable linting issues
+npm run validate-workflows    # Validate GitHub Actions workflow YAML files
+```
+
+### Testing Changes
+```bash
+yarn link                     # Create a local link for testing in provider repos
+# In a provider repo:
+yarn link @cdktn/provider-project
+npx projen                    # Apply the linked version
+```
+
+## Architecture
+
+### Core Components
+
+**`src/index.ts` - CdktnProviderProject Class**
+The main export. Creates a Jsii project with:
+- Multi-language package publishing (npm, PyPI, Maven, NuGet, Go)
+- GitHub Actions workflows for build, release, and provider upgrades
+- Automated dependency management and version bumping
+- Provider-specific configuration (namespace, version constraints)
+- Custom runners for memory-intensive builds (configurable via `useCustomGithubRunner`)
+
+**Configuration Files Generated for Provider Repos:**
+
+**NOTE**: For Legacy support these MUST not be renamed
+
+- `cdktf.json` - Tells `cdktf get` which provider to fetch
+- `src/version.json` - Tracks the actual provider version after fetch
+- Custom GitHub workflows for provider upgrades, auto-merge, and releases
+
+### Component Modules
+
+Each file in `src/` adds specific functionality to generated provider projects:
+
+- **`cdktf-config.ts`**: Sets up CDKTF dependencies, creates fetch task (`cdktf get`), configures build scripts
+- **`provider-upgrade.ts`**: Daily cron workflow that checks for new provider versions and creates auto-merge PRs
+- **`readme.ts`**: Generates comprehensive README with package installation instructions for all languages
+- **`auto-approve.ts` / `automerge.ts`**: GitHub workflows for automated PR approval/merging
+- **`copyright-headers.ts`**: Adds HashiCorp copyright headers using the `copywrite` tool
+- **`deprecate-packages.ts`**: Handles deprecation notices when `isDeprecated: true`
+- **`lock-issues.ts`**: Auto-locks resolved issues after 90 days
+- **`github-issues.ts`**: Issue templates and bot configurations
+
+### Scripts (Generated for Provider Repos)
+
+**`src/scripts/check-for-upgrades.ts`**
+Compares current provider version against Terraform Registry to detect new releases.
+
+**`src/scripts/should-release.ts`**
+Determines if a release is needed by comparing `version.json` against the last git tag.
+
+### Key Workflow Patterns
+
+**Provider Update Flow:**
+1. `provider-upgrade` workflow runs daily (randomized cron between 3-4am)
+2. Checks Terraform Registry for new provider version
+3. If available, runs `yarn fetch` (which executes `cdktf get`)
+4. Adds copyright headers back (they get nuked by fetch)
+5. Creates PR with appropriate semantic commit message (`feat:` for minor, `fix:` for patch)
+6. Auto-approve and auto-merge labels trigger automated merge
+
+**Release Flow:**
+1. Build workflow runs on every push
+2. `should-release.js` compares `src/version.json` against git tags
+3. If changes detected, release workflow publishes to all package registries
+4. Custom `unconditional-bump` task sets version in package.json for Go docs
+
+**Memory Management:**
+- Default GitHub runners: 7GB (heap limit ~6.6GB)
+- Custom runners: 32GB (heap limit ~31.7GB)
+- Set via `NODE_OPTIONS` environment variable: `--max-old-space-size`
+
+## Important Configuration Details
+
+### GitHub Actions Pinning
+All GitHub Actions use pinned commit SHAs (not version tags) for security. Update both:
+1. `.projenrc.ts` (this repo)
+2. `src/index.ts` (for generated provider repos)
+
+### JSII and TypeScript Versions
+**CRITICAL**: JSII and TypeScript must use the same major/minor version range.
+- Example: `jsiiVersion: "~5.8.0"` requires `typescriptVersion: "~5.8.0"`
+- This constraint exists in both `.projenrc.ts` and provider project options
+
+### Package Naming Convention
+Generated packages follow this pattern:
+- **npm**: `@{namespace}/provider-{providerName}`
+- **Python**: `{namespace}-provider-{providerName}`
+- **Go**: `github.com/{githubNamespace}/cdktn-provider-{providerName}-go`
+
+### For Future
+
+- **Maven**: `{mavenOrg}.providers.{providerName}`
+- **NuGet**: `{NuGetOrg}.Providers.{ProviderName}`
+
+Special cases: `null` and `random` providers get `_provider` suffix in Maven to avoid keyword conflicts.
+
+## Deprecation Workflow
+
+When `isDeprecated: true`:
+- Disables dependency upgrades
+- Skips provider upgrade workflow
+- Adds deprecation notice to README
+- Release workflow includes deprecation step for package managers
+- Go packages get deprecation comment in generated code
+
+## Testing Strategy
+
+Tests use snapshot testing via `synthSnapshot()` helper:
+- Generates a full Projen project in memory
+- Captures all generated files
+- Compares against committed snapshots
+- Update snapshots: `npm test -- -u`
+
+Key test scenarios:
+- Minimal configuration
+- Custom GitHub runners
+- Deprecated providers
+- Various version range syntaxes
+- Maven/NuGet org overrides
+
+## Making Changes
+
+1. **Modify `.projenrc.ts` or `src/` files** - Never edit generated files directly
+2. **Run `npx projen`** - Regenerates all project files
+3. **Run tests** - `npm test`
+4. **Validate workflows** - Happens automatically in post-compile, checks YAML against schemas
+5. **Test in a provider repo** - Use `yarn link` for local testing
+6. **Commit and release** - Auto-release on main branch (if not paths-ignored)
+
+## Fork-Specific Context
+
+This fork (cdktn.io) continues development after HashiCorp's sunset. With a Phased approach.
+- Uses `cdktf` and `cdktf-cli` packages instead of `cdktf` until the core project rename has completed, the priority is to restart the provider binding generation first.
+- In the near future, will Use `cdktn` and `cdktn-cli` packages instead of `cdktf`
+- Default `githubNamespace` updated to "cdktn-io" due to Hashicorp maintaining copyright over original cdtkf/cdk.tf/terraform-cdk orgs, repositories and package names.
+- Maintain support custom namespaces for organizations wanting to publish their own provider bindings
+
+## Common Gotchas
+
+- **Don't manually edit workflow YAML files** - Modify the Projen components in `src/` instead
+- **Provider repos need secrets** - NPM_TOKEN, TWINE_*, MAVEN_*, GH_TOKEN for publishing (this is managed by a separate project called the "cdkn-repository-manager")
+- **Fetch nukes src/ directory** - Copyright headers must be re-added after `cdktf get`
+- **version.json has exactly one entry** - Multi-provider projects are not supported
+- **Release task is conditional** - Controlled by `should-release.js`, use `unconditional-release` to force

package/LICENSE

@@ -0,0 +1,355 @@
+Copyright (c) 2020 HashiCorp, Inc.
+
+Mozilla Public License, version 2.0
+
+1. Definitions
+
+1.1. “Contributor”
+
+     means each individual or legal entity that creates, contributes to the
+     creation of, or owns Covered Software.
+
+1.2. “Contributor Version”
+
+     means the combination of the Contributions of others (if any) used by a
+     Contributor and that particular Contributor’s Contribution.
+
+1.3. “Contribution”
+
+     means Covered Software of a particular Contributor.
+
+1.4. “Covered Software”
+
+     means Source Code Form to which the initial Contributor has attached the
+     notice in Exhibit A, the Executable Form of such Source Code Form, and
+     Modifications of such Source Code Form, in each case including portions
+     thereof.
+
+1.5. “Incompatible With Secondary Licenses”
+     means
+
+     a. that the initial Contributor has attached the notice described in
+        Exhibit B to the Covered Software; or
+
+     b. that the Covered Software was made available under the terms of version
+        1.1 or earlier of the License, but not also under the terms of a
+        Secondary License.
+
+1.6. “Executable Form”
+
+     means any form of the work other than Source Code Form.
+
+1.7. “Larger Work”
+
+     means a work that combines Covered Software with other material, in a separate
+     file or files, that is not Covered Software.
+
+1.8. “License”
+
+     means this document.
+
+1.9. “Licensable”
+
+     means having the right to grant, to the maximum extent possible, whether at the
+     time of the initial grant or subsequently, any and all of the rights conveyed by
+     this License.
+
+1.10. “Modifications”
+
+     means any of the following:
+
+     a. any file in Source Code Form that results from an addition to, deletion
+        from, or modification of the contents of Covered Software; or
+
+     b. any new file in Source Code Form that contains any Covered Software.
+
+1.11. “Patent Claims” of a Contributor
+
+      means any patent claim(s), including without limitation, method, process,
+      and apparatus claims, in any patent Licensable by such Contributor that
+      would be infringed, but for the grant of the License, by the making,
+      using, selling, offering for sale, having made, import, or transfer of
+      either its Contributions or its Contributor Version.
+
+1.12. “Secondary License”
+
+      means either the GNU General Public License, Version 2.0, the GNU Lesser
+      General Public License, Version 2.1, the GNU Affero General Public
+      License, Version 3.0, or any later versions of those licenses.
+
+1.13. “Source Code Form”
+
+      means the form of the work preferred for making modifications.
+
+1.14. “You” (or “Your”)
+
+      means an individual or a legal entity exercising rights under this
+      License. For legal entities, “You” includes any entity that controls, is
+      controlled by, or is under common control with You. For purposes of this
+      definition, “control” means (a) the power, direct or indirect, to cause
+      the direction or management of such entity, whether by contract or
+      otherwise, or (b) ownership of more than fifty percent (50%) of the
+      outstanding shares or beneficial ownership of such entity.
+
+
+2. License Grants and Conditions
+
+2.1. Grants
+
+     Each Contributor hereby grants You a world-wide, royalty-free,
+     non-exclusive license:
+
+     a. under intellectual property rights (other than patent or trademark)
+        Licensable by such Contributor to use, reproduce, make available,
+        modify, display, perform, distribute, and otherwise exploit its
+        Contributions, either on an unmodified basis, with Modifications, or as
+        part of a Larger Work; and
+
+     b. under Patent Claims of such Contributor to make, use, sell, offer for
+        sale, have made, import, and otherwise transfer either its Contributions
+        or its Contributor Version.
+
+2.2. Effective Date
+
+     The licenses granted in Section 2.1 with respect to any Contribution become
+     effective for each Contribution on the date the Contributor first distributes
+     such Contribution.
+
+2.3. Limitations on Grant Scope
+
+     The licenses granted in this Section 2 are the only rights granted under this
+     License. No additional rights or licenses will be implied from the distribution
+     or licensing of Covered Software under this License. Notwithstanding Section
+     2.1(b) above, no patent license is granted by a Contributor:
+
+     a. for any code that a Contributor has removed from Covered Software; or
+
+     b. for infringements caused by: (i) Your and any other third party’s
+        modifications of Covered Software, or (ii) the combination of its
+        Contributions with other software (except as part of its Contributor
+        Version); or
+
+     c. under Patent Claims infringed by Covered Software in the absence of its
+        Contributions.
+
+     This License does not grant any rights in the trademarks, service marks, or
+     logos of any Contributor (except as may be necessary to comply with the
+     notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+     No Contributor makes additional grants as a result of Your choice to
+     distribute the Covered Software under a subsequent version of this License
+     (see Section 10.2) or under the terms of a Secondary License (if permitted
+     under the terms of Section 3.3).
+
+2.5. Representation
+
+     Each Contributor represents that the Contributor believes its Contributions
+     are its original creation(s) or it has sufficient rights to grant the
+     rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+     This License is not intended to limit any rights You have under applicable
+     copyright doctrines of fair use, fair dealing, or other equivalents.
+
+2.7. Conditions
+
+     Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in
+     Section 2.1.
+
+
+3. Responsibilities
+
+3.1. Distribution of Source Form
+
+     All distribution of Covered Software in Source Code Form, including any
+     Modifications that You create or to which You contribute, must be under the
+     terms of this License. You must inform recipients that the Source Code Form
+     of the Covered Software is governed by the terms of this License, and how
+     they can obtain a copy of this License. You may not attempt to alter or
+     restrict the recipients’ rights in the Source Code Form.
+
+3.2. Distribution of Executable Form
+
+     If You distribute Covered Software in Executable Form then:
+
+     a. such Covered Software must also be made available in Source Code Form,
+        as described in Section 3.1, and You must inform recipients of the
+        Executable Form how they can obtain a copy of such Source Code Form by
+        reasonable means in a timely manner, at a charge no more than the cost
+        of distribution to the recipient; and
+
+     b. You may distribute such Executable Form under the terms of this License,
+        or sublicense it under different terms, provided that the license for
+        the Executable Form does not attempt to limit or alter the recipients’
+        rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+     You may create and distribute a Larger Work under terms of Your choice,
+     provided that You also comply with the requirements of this License for the
+     Covered Software. If the Larger Work is a combination of Covered Software
+     with a work governed by one or more Secondary Licenses, and the Covered
+     Software is not Incompatible With Secondary Licenses, this License permits
+     You to additionally distribute such Covered Software under the terms of
+     such Secondary License(s), so that the recipient of the Larger Work may, at
+     their option, further distribute the Covered Software under the terms of
+     either this License or such Secondary License(s).
+
+3.4. Notices
+
+     You may not remove or alter the substance of any license notices (including
+     copyright notices, patent notices, disclaimers of warranty, or limitations
+     of liability) contained within the Source Code Form of the Covered
+     Software, except that You may alter any license notices to the extent
+     required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+     You may choose to offer, and to charge a fee for, warranty, support,
+     indemnity or liability obligations to one or more recipients of Covered
+     Software. However, You may do so only on Your own behalf, and not on behalf
+     of any Contributor. You must make it absolutely clear that any such
+     warranty, support, indemnity, or liability obligation is offered by You
+     alone, and You hereby agree to indemnify every Contributor for any
+     liability incurred by such Contributor as a result of warranty, support,
+     indemnity or liability terms You offer. You may include additional
+     disclaimers of warranty and limitations of liability specific to any
+     jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+
+   If it is impossible for You to comply with any of the terms of this License
+   with respect to some or all of the Covered Software due to statute, judicial
+   order, or regulation then You must: (a) comply with the terms of this License
+   to the maximum extent possible; and (b) describe the limitations and the code
+   they affect. Such description must be placed in a text file included with all
+   distributions of the Covered Software under this License. Except to the
+   extent prohibited by statute or regulation, such description must be
+   sufficiently detailed for a recipient of ordinary skill to be able to
+   understand it.
+
+5. Termination
+
+5.1. The rights granted under this License will terminate automatically if You
+     fail to comply with any of its terms. However, if You become compliant,
+     then the rights granted under this License from a particular Contributor
+     are reinstated (a) provisionally, unless and until such Contributor
+     explicitly and finally terminates Your grants, and (b) on an ongoing basis,
+     if such Contributor fails to notify You of the non-compliance by some
+     reasonable means prior to 60 days after You have come back into compliance.
+     Moreover, Your grants from a particular Contributor are reinstated on an
+     ongoing basis if such Contributor notifies You of the non-compliance by
+     some reasonable means, this is the first time You have received notice of
+     non-compliance with this License from such Contributor, and You become
+     compliant prior to 30 days after Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+     infringement claim (excluding declaratory judgment actions, counter-claims,
+     and cross-claims) alleging that a Contributor Version directly or
+     indirectly infringes any patent, then the rights granted to You by any and
+     all Contributors for the Covered Software under Section 2.1 of this License
+     shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user
+     license agreements (excluding distributors and resellers) which have been
+     validly granted by You or Your distributors under this License prior to
+     termination shall survive termination.
+
+6. Disclaimer of Warranty
+
+   Covered Software is provided under this License on an “as is” basis, without
+   warranty of any kind, either expressed, implied, or statutory, including,
+   without limitation, warranties that the Covered Software is free of defects,
+   merchantable, fit for a particular purpose or non-infringing. The entire
+   risk as to the quality and performance of the Covered Software is with You.
+   Should any Covered Software prove defective in any respect, You (not any
+   Contributor) assume the cost of any necessary servicing, repair, or
+   correction. This disclaimer of warranty constitutes an essential part of this
+   License. No use of  any Covered Software is authorized under this License
+   except under this disclaimer.
+
+7. Limitation of Liability
+
+   Under no circumstances and under no legal theory, whether tort (including
+   negligence), contract, or otherwise, shall any Contributor, or anyone who
+   distributes Covered Software as permitted above, be liable to You for any
+   direct, indirect, special, incidental, or consequential damages of any
+   character including, without limitation, damages for lost profits, loss of
+   goodwill, work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses, even if such party shall have been
+   informed of the possibility of such damages. This limitation of liability
+   shall not apply to liability for death or personal injury resulting from such
+   party’s negligence to the extent applicable law prohibits such limitation.
+   Some jurisdictions do not allow the exclusion or limitation of incidental or
+   consequential damages, so this exclusion and limitation may not apply to You.
+
+8. Litigation
+
+   Any litigation relating to this License may be brought only in the courts of
+   a jurisdiction where the defendant maintains its principal place of business
+   and such litigation shall be governed by laws of that jurisdiction, without
+   reference to its conflict-of-law provisions. Nothing in this Section shall
+   prevent a party’s ability to bring cross-claims or counter-claims.
+
+9. Miscellaneous
+
+   This License represents the complete agreement concerning the subject matter
+   hereof. If any provision of this License is held to be unenforceable, such
+   provision shall be reformed only to the extent necessary to make it
+   enforceable. Any law or regulation which provides that the language of a
+   contract shall be construed against the drafter shall not be used to construe
+   this License against a Contributor.
+
+
+10. Versions of the License
+
+10.1. New Versions
+
+      Mozilla Foundation is the license steward. Except as provided in Section
+      10.3, no one other than the license steward has the right to modify or
+      publish new versions of this License. Each version will be given a
+      distinguishing version number.
+
+10.2. Effect of New Versions
+
+      You may distribute the Covered Software under the terms of the version of
+      the License under which You originally received the Covered Software, or
+      under the terms of any subsequent version published by the license
+      steward.
+
+10.3. Modified Versions
+
+      If you create software not governed by this License, and you want to
+      create a new license for such software, you may create and use a modified
+      version of this License if you rename the license and remove any
+      references to the name of the license steward (except to note that such
+      modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses
+      If You choose to distribute Source Code Form that is Incompatible With
+      Secondary Licenses under the terms of this version of the License, the
+      notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+
+      This Source Code Form is subject to the
+      terms of the Mozilla Public License, v.
+      2.0. If a copy of the MPL was not
+      distributed with this file, You can
+      obtain one at
+      http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular file, then
+You may include the notice in a location (such as a LICENSE file in a relevant
+directory) where a recipient would be likely to look for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - “Incompatible With Secondary Licenses” Notice
+
+      This Source Code Form is “Incompatible
+      With Secondary Licenses”, as defined by
+      the Mozilla Public License, v. 2.0.

package/README.md

@@ -0,0 +1,82 @@
+# The Future of Terraform CDK
+
+> [!IMPORTANT]
+>
+> [OCF](https://the-ocf.org/) - [github.com/open-constructs](https://github.com/open-constructs) has stepped up to fork under the new name of [CDK Terrain - cdktn.io](https://cdktn.io)
+
+---
+
+# Terraform CDK Provider Project
+
+A project template for [projen](https://projen.io) to create repositories for prebuilt provider packages for [Terraform CDK](https://cdk.tf).
+
+## Usage
+
+The provider repos are entirely auto generated from the configuration contained in this repo here. There's no manual interaction necessary, except for creating the initial repository - using this repo. The `cdktf get` command is executed as part of the build pipeline in Github Actions. These jobs are executed on a schedule. Hence, new provider changes will be picked up automatically.
+
+### Creating a new provider
+
+> [!NOTE] 
+> Only Offical Terraform Providers or Hashicorp partner Terraform Poviders will be accepted for pre-built provider generation.
+
+Add a new repository [over here](https://github.com/cdktn-io/repository-manager).
+
+In the newly created repository, all we need is a `.projenrc.js` file like this:
+
+```js
+const { CdktnProviderProject } = require('@cdktn/provider-project');
+const { Semver } = require('projen');
+
+const project = new CdktnProviderProject({
+  terraformProvider: "aws@~> 2.0"
+});
+
+project.synth();
+```
+
+Adjust the `terraformProvider` attribute as required and run the following commands:
+
+```
+npm install @cdktn/provider-project@latest
+npx projen
+yarn install
+```
+
+This will generate an entire repository ready to be published, including Github Workflows for publishing NPM, Pypi and maven packages. The only thing which is needed to be set manually are the tokens for these registries:
+
+- `NPM_TOKEN`
+- `TWINE_PASSWORD`
+- `TWINE_USERNAME`
+
+<!-- TODO: Re-enable Maven 
+- `MAVEN_GPG_PRIVATE_KEY`
+- `MAVEN_GPG_PRIVATE_KEY_PASSPHRASE`
+- `MAVEN_PASSWORD`
+- `MAVEN_USERNAME`
+- `MAVEN_STAGING_PROFILE_ID`
+-->
+
+### Updating an existing Provider
+
+Commit and push the required changes to this repository here and wait for the auto-release to happen. Once released, you can run the following commands in the target provider repository:
+
+```
+npm install @cdktn/provider-project@latest
+npx projen
+yarn install
+```
+
+Commit, push and check for the auto-released version.
+
+## Development
+
+Whatever needs to be changed in the downstream [provider repositories](https://github.com/cdktn-io/repository-manager) should be done via the [code definitions](./src/index.ts) here.
+
+For local development, [yarn link](https://classic.yarnpkg.com/en/docs/cli/link/) might be quite helpful for testing.
+
+## CAVEATS
+
+1. Maven is disabled
+1. Java package: com.Io.Cdktn - unusual capitalization, typically should be io.cdktn or com.cdktn
+1. Nuget is disabled
+1. .NET namespace: Io.Cdktn.Cdktn.Providers.Random - has "Cdktn" duplicated

package/lib/alert-open-prs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) HashiCorp, Inc.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+import { cdk } from "projen";
+interface AlertOpenPrsOptions {
+    maxHoursOpen?: number;
+    slackWebhookUrl: string;
+    repository: string;
+}
+export declare class AlertOpenPrs {
+    constructor(project: cdk.JsiiProject, options: AlertOpenPrsOptions);
+}
+export {};