feat!: drop support for node14 and node16

.nvmrc

@@ -1 +1 @@
-v14
+v18

.projenrc.ts

@@ -1,10 +1,17 @@
-import { JsonPatch, awscdk, github, javascript, release, vscode } from 'projen';
+import { awscdk, github, javascript, release, vscode } from 'projen';
 import { SourceFile } from 'ts-morph';
-import { tagOnNpm, TypeScriptSourceFile } from './projenrc';
+import { LockfileVersion, StableReleaseBranches, StableReleases, tagOnNpm, TypeScriptSourceFile, WordmarkReadme } from './projenrc';
 import { IntegrationTests } from './projenrc/IntegrationTests';
-import { WordmarkReadme } from './projenrc/WordmarkReadme';
 import { Esbuild } from './src/private/esbuild-source';
 
+const releaseBranches: StableReleaseBranches = {
+  v3: {
+    majorVersion: 3,
+    npmDistTag: 'old-stable',
+    lockfileVersion: LockfileVersion.V2,
+  },
+};
+
 const project = new awscdk.AwsCdkConstructLibrary({
   packageManager: javascript.NodePackageManager.NPM,
   projenrcTs: true,
@@ -65,12 +72,7 @@ const project = new awscdk.AwsCdkConstructLibrary({
   npmDistTag: 'latest',
   defaultReleaseBranch: 'main',
   majorVersion: 4,
-  releaseBranches: {
-    v3: {
-      majorVersion: 3,
-      npmDistTag: 'old-stable',
-    },
-  },
+  releaseBranches,
   releaseTrigger: release.ReleaseTrigger.scheduled({
     schedule: '0 5 1,15 * *',
   }),
@@ -153,13 +155,7 @@ new IntegrationTests(project, {
   },
 });
 
-// use npm@8 in upgrade workflow
-for (const upgradeWorkflow of project.upgradeWorkflow?.workflows!) {
-  upgradeWorkflow.file?.patch(JsonPatch.add('/jobs/upgrade/steps/2', {
-    name: 'Use npm@8',
-    run: ['npm i -g npm@8', 'npm --version'].join('\n'),
-  }));
-}
+new StableReleases(project, releaseBranches);
 
 
 // test against latest versions

VERSIONS.md

@@ -0,0 +1,22 @@
+# Supported Versions
+
+Only the latest release of each major version is supported.
+
+| Package version | CDK version | Node.js versions | Support                                                        |
+| --------------- | ----------- | ---------------- | -------------------------------------------------------------- |
+| v5              | ^2.12.0     | >=18             | :white_check_mark:                                             |
+| v4              | ^2.12.0     | >=14             | :white_check_mark:                                             |
+| v3              | ^2.0.0      | >=14             | Security updates and critical bug fixes until February 1, 2024 |
+| v2              | ^1.99.0     | >=12             | :x: Support ended on June 1, 2023                              |
+| v1              | ^1.99.0     | >=12             | :x:                                                            |
+
+## Tags on npm
+
+| Tag          | Description                                                                                | Current version | Will the version change?             |
+| ------------ | ------------------------------------------------------------------------------------------ | --------------- | ------------------------------------ |
+| `latest`     | The latest stable release of the package                                                   | `v4`            | Yes, with new major versions         |
+| `old-stable` | The previous major release. This tag will be updated when a new major version is released. | `v3`            | Yes, with new major versions         |
+| `cdk-v2`     | The latest stable release compatible with AWS CDK v2                                       | `v4`            | Yes, with new major versions         |
+| `cdk-v1`     | The latest stable release compatible with AWS CDK v1                                       | `v2`            | Unlikely                             |
+| `next`       | Preview versions, if available `>= latest`                                                 | `v4`            | Yes                                  |
+| `unstable`   | Used for development purposes only. **Do not use!**                                        | undefined       | May change to any version at anytime |