projen-pipelines 0.2.11 → 0.2.13

package/README.md

@@ -16,6 +16,7 @@ specifically designed to work with the projen project configuration engine.
 * Allows easy switching between different CI/CD platforms without rewriting pipeline configurations
 * Handles complex deployment scenarios with less code
 * Manages AWS infrastructure more efficiently and straightforwardly
+* Automatic versioning with flexible strategies and multiple output targets
 
 ### Benefits
 
@@ -23,6 +24,7 @@ specifically designed to work with the projen project configuration engine.
 * Ensures consistency across projects by using proven defaults
 * Simplifies compliance management by integrating it directly into pipeline definitions
 * Facilitates platform migrations (e.g., from GitHub to GitLab) by abstracting pipeline definitions
+* Provides automatic version tracking and exposure through CloudFormation and SSM Parameter Store
 
 ## Beyond AWS CDK: A Vision for Universal CI/CD Pipeline Generation
 
@@ -203,6 +205,274 @@ Here's a brief description of each one:
 
 Remember that these tasks are created and managed automatically by the `CDKPipeline` class. You can run these tasks using the `npx projen TASK_NAME` command.
 
+## Versioning
+
+Projen Pipelines includes a comprehensive versioning system that automatically tracks and exposes deployment versions through various AWS services. This feature enables deployment traceability, automated rollback decisions, and comprehensive audit trails.
+
+### Basic Versioning Configuration
+
+To enable versioning in your pipeline, add the `versioning` configuration:
+
+```typescript
+import { awscdk } from 'projen';
+import { GithubCDKPipeline, VersioningStrategy, VersioningOutputs } from 'projen-pipelines';
+
+const app = new awscdk.AwsCdkTypeScriptApp({
+  // ... other config
+});
+
+new GithubCDKPipeline(app, {
+  // ... other pipeline config
+  
+  versioning: {
+    enabled: true,
+    strategy: VersioningStrategy.commitCount(),
+    outputs: VersioningOutputs.standard()
+  }
+});
+```
+
+### Versioning Strategies
+
+Projen Pipelines provides several built-in versioning strategies:
+
+#### Git Tag Strategy
+Uses git tags as the version source, with optional prefix stripping:
+
+```typescript
+// Basic git tag strategy
+const strategy = VersioningStrategy.gitTag();
+
+// With custom configuration
+const strategy = VersioningStrategy.gitTag({
+  stripPrefix: 'v',           // Strip 'v' from tags (v1.2.3 → 1.2.3)
+  annotatedOnly: true,        // Only use annotated tags
+  includeSinceTag: true       // Include commits since tag
+});
+```
+
+#### Package.json Strategy
+Uses the version from your package.json file:
+
+```typescript
+// Basic package.json strategy
+const strategy = VersioningStrategy.packageJson();
+
+// With custom configuration
+const strategy = VersioningStrategy.packageJson({
+  path: './package.json',
+  includePrerelease: true,
+  appendCommitInfo: true
+});
+```
+
+#### Commit Count Strategy
+Uses the number of commits as the version:
+
+```typescript
+// Basic commit count strategy
+const strategy = VersioningStrategy.commitCount();
+
+// With custom configuration
+const strategy = VersioningStrategy.commitCount({
+  countFrom: 'all',           // 'all' | 'since-tag' 
+  includeBranch: true,        // Include branch name
+  padding: 5                  // Zero-pad count (00001)
+});
+```
+
+#### Build Number Strategy
+Creates a version from build metadata:
+
+```typescript
+// Basic build number strategy
+const strategy = VersioningStrategy.buildNumber();
+
+// With custom configuration
+const strategy = VersioningStrategy.buildNumber({
+  prefix: 'release',
+  commitCount: { countFrom: 'all', padding: 5 }
+});
+// Output: release-01234-3a4b5c6d
+```
+
+#### Custom Composite Strategy
+Create your own version format using template variables:
+
+```typescript
+const strategy = VersioningStrategy.create(
+  '{git-tag}+{commit-count}-{commit-hash:8}',
+  {
+    gitTag: { stripPrefix: 'v' },
+    commitCount: { countFrom: 'since-tag' }
+  }
+);
+// Output: 1.2.3+45-3a4b5c6d
+```
+
+### Version Output Configurations
+
+Control how and where version information is exposed:
+
+#### CloudFormation Outputs
+Export version information as CloudFormation stack outputs:
+
+```typescript
+// Basic CloudFormation output
+const outputs = VersioningOutputs.cloudFormationOnly();
+
+// With custom configuration
+const outputs = VersioningOutputs.cloudFormationOnly({
+  exportName: 'MyApp-{stage}-Version'
+});
+```
+
+#### SSM Parameter Store
+Store version information in AWS Systems Manager Parameter Store:
+
+```typescript
+// Basic parameter store
+const outputs = VersioningOutputs.parameterStoreOnly('/myapp/{stage}/version');
+
+// Hierarchical parameters
+const outputs = VersioningOutputs.hierarchicalParameters('/myapp/{stage}/version', {
+  includeCloudFormation: true
+});
+```
+
+This creates parameters like:
+- `/myapp/prod/version` → Full version JSON
+- `/myapp/prod/version/commit` → Commit hash
+- `/myapp/prod/version/tag` → Git tag
+- `/myapp/prod/version/count` → Commit count
+
+#### Standard Configuration
+The recommended configuration that uses CloudFormation outputs with optional Parameter Store:
+
+```typescript
+const outputs = VersioningOutputs.standard({
+  parameterName: '/myapp/{stage}/version',
+});
+```
+
+### Output Formats
+
+Version information can be output in two formats:
+
+**Plain Format:** Simple string values in CloudFormation
+```yaml
+Outputs:
+  AppVersion:
+    Value: "1.2.3+45-3a4b5c6d"
+    Description: "Application version"
+  AppCommitHash:
+    Value: "3a4b5c6def1234567890"
+    Description: "Git commit hash"
+```
+
+**Structured Format:** JSON object with comprehensive metadata in SSM
+```json
+{
+  "version": "1.2.3",
+  "commitHash": "3a4b5c6def1234567890",
+  "commitCount": 1234,
+  "commitsSinceTag": 45,
+  "branch": "main",
+  "tag": "v1.2.3",
+  "deployedAt": "2024-01-15T10:30:00Z",
+  "deployedBy": "github-actions",
+  "buildNumber": "456",
+  "environment": "production"
+}
+```
+
+### Stage-Specific Overrides
+
+Configure different versioning strategies for different stages:
+
+```typescript
+new GithubCDKPipeline(app, {
+  versioning: {
+    enabled: true,
+    strategy: VersioningStrategy.gitTag(),
+    outputs: VersioningOutputs.standard(),
+    stageOverrides: {
+      dev: {
+        strategy: VersioningStrategy.commitCount(),
+        outputs: VersioningOutputs.minimal()
+      },
+      prod: {
+        validation: {
+          requireTag: true,
+          tagPattern: /^v\d+\.\d+\.\d+$/
+        }
+      }
+    }
+  }
+});
+```
+
+### Template Variables
+
+All strategies support these template variables:
+- `{git-tag}` - Git tag (with optional prefix stripping)
+- `{package-version}` - Version from package.json
+- `{commit-count}` - Number of commits
+- `{commit-hash}` - Full commit hash
+- `{commit-hash:8}` - Short commit hash (8 characters)
+- `{branch}` - Git branch name
+- `{build-number}` - CI/CD build number
+
+### Benefits of Versioning
+
+1. **Deployment Traceability**: Always know exactly which code version is deployed
+2. **Automated Rollback**: Use version information for automated rollback decisions
+3. **Audit Trail**: Comprehensive deployment history with metadata
+4. **Multi-Stage Support**: Different versioning strategies per environment
+5. **Zero Configuration**: Works out-of-the-box with sensible defaults
+6. **CI/CD Integration**: Automatically detects version info from CI/CD environments
+
+### Feature Branch Deployments
+
+Projen Pipelines supports automated feature branch deployments for GitHub Actions. This allows you to deploy and test your changes in isolated environments before merging to the main branch. Gitlab support is currently missing.
+
+#### Configuration
+
+To enable feature branch deployments, add the `featureStages` configuration to your pipeline:
+
+```typescript
+new GithubCDKPipeline(app, {
+  stackPrefix: 'MyApp',
+  iamRoleArns: {
+    default: 'arn:aws:iam::123456789012:role/GithubDeploymentRole',
+  },
+  featureStages: {
+    env: { account: '123456789013', region: 'eu-central-1' },
+  },
+  stages: [
+    // ... your regular stages
+  ],
+});
+```
+
+#### How It Works
+
+When feature stages are configured, two GitHub workflows are created:
+
+1. **deploy-feature** - Automatically deploys your feature branch when a pull request is labeled with `feature-deployment`
+2. **destroy-feature** - Automatically destroys the feature deployment when:
+   - The pull request is closed
+   - The `feature-deployment` label is removed from the pull request
+
+#### Using Feature Deployments
+
+1. Create a pull request with your changes
+2. Add the `feature-deployment` label to trigger deployment
+3. The feature environment will be deployed with a stack name including your branch name
+4. Remove the label or close the PR to destroy the feature environment
+
+The feature deployment uses the `--force` flag when destroying to ensure cleanup without manual confirmation.
+
 ## Current Status
 
 Projen-Pipelines is currently in version 0.x, awaiting Projen's 1.0 release. Despite its pre-1.0 status, it's being used in several production environments.

package/lib/assign-approver/base.js

@@ -12,5 +12,5 @@ class AssignApprover extends projen_1.Component {
 }
 exports.AssignApprover = AssignApprover;
 _a = JSII_RTTI_SYMBOL_1;
-AssignApprover[_a] = { fqn: "projen-pipelines.AssignApprover", version: "0.2.11" };
+AssignApprover[_a] = { fqn: "projen-pipelines.AssignApprover", version: "0.2.13" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hc3NpZ24tYXBwcm92ZXIvYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLG1DQUE0QztBQXVCNUMsTUFBc0IsY0FBZSxTQUFRLGtCQUFTO0lBR3BELFlBQVksS0FBYyxFQUFxQixXQUFrQztRQUMvRSxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7UUFEZ0MsZ0JBQVcsR0FBWCxXQUFXLENBQXVCO0lBRWpGLENBQUM7O0FBTEgsd0NBT0MiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBDb21wb25lbnQsIFByb2plY3QgfSBmcm9tICdwcm9qZW4nO1xuXG5leHBvcnQgaW50ZXJmYWNlIEFwcHJvdmVyTWFwcGluZyB7XG5cbiAgcmVhZG9ubHkgYXV0aG9yOiBzdHJpbmc7XG4gIHJlYWRvbmx5IGFwcHJvdmVyczogc3RyaW5nW107XG5cbn1cblxuZXhwb3J0IGludGVyZmFjZSBBc3NpZ25BcHByb3Zlck9wdGlvbnMge1xuXG4gIC8qKlxuICAgKiBUaGUgbWFwcGluZyBvZiBhdXRob3JzIHRvIGFwcHJvdmVycy5cbiAgICovXG4gIHJlYWRvbmx5IGFwcHJvdmVyTWFwcGluZzogQXBwcm92ZXJNYXBwaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBHaXRIdWIgdG9rZW4gdG8gdXNlIGZvciB0aGUgQVBJIGNhbGxzLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVmYXVsdEFwcHJvdmVyczogc3RyaW5nW107XG5cbn1cblxuZXhwb3J0IGFic3RyYWN0IGNsYXNzIEFzc2lnbkFwcHJvdmVyIGV4dGVuZHMgQ29tcG9uZW50IHtcblxuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBQcm9qZWN0LCBwcm90ZWN0ZWQgcmVhZG9ubHkgYmFzZU9wdGlvbnM6IEFzc2lnbkFwcHJvdmVyT3B0aW9ucykge1xuICAgIHN1cGVyKHNjb3BlKTtcbiAgfVxuXG59Il19

package/lib/assign-approver/github.js

@@ -81,5 +81,5 @@ if (filteredApprovers.length > 0) {
 }
 exports.GitHubAssignApprover = GitHubAssignApprover;
 _a = JSII_RTTI_SYMBOL_1;
-GitHubAssignApprover[_a] = { fqn: "projen-pipelines.GitHubAssignApprover", version: "0.2.11" };
+GitHubAssignApprover[_a] = { fqn: "projen-pipelines.GitHubAssignApprover", version: "0.2.13" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0aHViLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Fzc2lnbi1hcHByb3Zlci9naXRodWIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFDQSx1RUFBa0Y7QUFDbEYsaUNBQStEO0FBYS9ELE1BQWEsb0JBQXFCLFNBQVEscUJBQWM7SUFJdEQsWUFBWSxLQUFvQixFQUFFLE9BQW9DO1FBQ3BFLEtBQUssQ0FBQyxLQUFLLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDdEIsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFFdkIsZ0RBQWdEO1FBQ2hELElBQUksQ0FBQyxRQUFRLEdBQUcsS0FBSyxDQUFDLE1BQU8sQ0FBQyxXQUFXLENBQUMsaUJBQWlCLENBQUMsQ0FBQztRQUM3RCxJQUFJLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQztZQUNmLGlCQUFpQixFQUFFO2dCQUNqQixLQUFLLEVBQUUsQ0FBQyxRQUFRLEVBQUUsa0JBQWtCLENBQUM7YUFDdEM7U0FDRixDQUFDLENBQUM7UUFFSCxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7SUFDdkIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksaUJBQWlCO1FBQ3RCLE9BQU87WUFDTCxZQUFZLEVBQUUsK0JBQWEsQ0FBQyxLQUFLO1NBQ2xDLENBQUM7SUFDSixDQUFDO0lBRVMsYUFBYTtRQUNyQixNQUFNLFVBQVUsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFDO1FBRWhFLE1BQU0scUJBQXFCLEdBQUcsSUFBSSxDQUFDLDZCQUE2QixFQUFFLENBQUM7UUFFbkUsSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsaUJBQWlCLEVBQUU7WUFDdEMsTUFBTSxFQUFFLFVBQVU7WUFDbEIsV0FBVyxFQUFFLElBQUksQ0FBQyxpQkFBaUIsRUFBRTtZQUNyQyxLQUFLLEVBQUU7Z0JBQ0w7b0JBQ0UsSUFBSSxFQUFFLGlDQUFpQztvQkFDdkMsSUFBSSxFQUFFLDBCQUEwQjtvQkFDaEMsSUFBSSxFQUFFO3dCQUNKLE1BQU0sRUFBRSxxQkFBcUI7cUJBQzlCO2lCQUNGO2FBQ0Y7U0FDRixDQUFDLENBQUM7SUFDTCxDQUFDO0lBRVMsNkJBQTZCO1FBQ3JDLE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsZUFBZTthQUNwRCxHQUFHLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxNQUFNLE9BQU8sQ0FBQyxNQUFNLE9BQU8sT0FBTyxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUM7YUFDN0YsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBRWYsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFDLGdCQUFnQjthQUN2RCxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDO2FBQ2xCLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUVkLE9BQU87Ozs7RUFJVCxjQUFjLEdBQUcsY0FBYyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRTtnQkFDdkMsZ0JBQWdCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFxQjlCLENBQUM7SUFDRCxDQUFDOztBQXBGSCxvREFxRkMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBHaXRIdWJQcm9qZWN0LCBHaXRodWJXb3JrZmxvdyB9IGZyb20gJ3Byb2plbi9saWIvZ2l0aHViJztcbmltcG9ydCB7IEpvYlBlcm1pc3Npb24sIEpvYlBlcm1pc3Npb25zIH0gZnJvbSAncHJvamVuL2xpYi9naXRodWIvd29ya2Zsb3dzLW1vZGVsJztcbmltcG9ydCB7IEFzc2lnbkFwcHJvdmVyLCBBc3NpZ25BcHByb3Zlck9wdGlvbnMgfSBmcm9tICcuL2Jhc2UnO1xuXG5leHBvcnQgaW50ZXJmYWNlIEdpdEh1YkFzc2lnbkFwcHJvdmVyT3B0aW9ucyBleHRlbmRzIEFzc2lnbkFwcHJvdmVyT3B0aW9ucyB7XG5cbiAgLyoqXG4gICAqIHJ1bm5lciB0YWdzIHRvIHVzZSB0byBzZWxlY3QgcnVubmVyc1xuICAgKlxuICAgKiBAZGVmYXVsdCBbJ3VidW50dS1sYXRlc3QnXVxuICAgKi9cbiAgcmVhZG9ubHkgcnVubmVyVGFncz86IHN0cmluZ1tdO1xuXG59XG5cbmV4cG9ydCBjbGFzcyBHaXRIdWJBc3NpZ25BcHByb3ZlciBleHRlbmRzIEFzc2lnbkFwcHJvdmVyIHtcbiAgcHJpdmF0ZSByZWFkb25seSB3b3JrZmxvdzogR2l0aHViV29ya2Zsb3c7XG4gIHByaXZhdGUgcmVhZG9ubHkgb3B0aW9uczogR2l0SHViQXNzaWduQXBwcm92ZXJPcHRpb25zO1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBHaXRIdWJQcm9qZWN0LCBvcHRpb25zOiBHaXRIdWJBc3NpZ25BcHByb3Zlck9wdGlvbnMpIHtcbiAgICBzdXBlcihzY29wZSwgb3B0aW9ucyk7XG4gICAgdGhpcy5vcHRpb25zID0gb3B0aW9ucztcblxuICAgIC8vIEluaXRpYWxpemUgdGhlIGRlcGxveW1lbnQgd29ya2Zsb3cgb24gR2l0SHViLlxuICAgIHRoaXMud29ya2Zsb3cgPSBzY29wZS5naXRodWIhLmFkZFdvcmtmbG93KCdhc3NpZ24tYXBwcm92ZXInKTtcbiAgICB0aGlzLndvcmtmbG93Lm9uKHtcbiAgICAgIHB1bGxSZXF1ZXN0VGFyZ2V0OiB7XG4gICAgICAgIHR5cGVzOiBbJ29wZW5lZCcsICdyZWFkeV9mb3JfcmV2aWV3J10sXG4gICAgICB9LFxuICAgIH0pO1xuXG4gICAgdGhpcy5zZXR1cFdvcmtmbG93KCk7XG4gIH1cblxuICAvKipcbiAgICogR2V0IHRoZSByZXF1aXJlZCBwZXJtaXNzaW9ucyBmb3IgdGhlIEdpdEh1YiB3b3JrZmxvd1xuICAgKi9cbiAgcHVibGljIHJlbmRlclBlcm1pc3Npb25zKCk6IEpvYlBlcm1pc3Npb25zIHtcbiAgICByZXR1cm4ge1xuICAgICAgcHVsbFJlcXVlc3RzOiBKb2JQZXJtaXNzaW9uLldSSVRFLFxuICAgIH07XG4gIH1cblxuICBwcm90ZWN0ZWQgc2V0dXBXb3JrZmxvdygpOiB2b2lkIHtcbiAgICBjb25zdCBydW5uZXJUYWdzID0gdGhpcy5vcHRpb25zLnJ1bm5lclRhZ3MgPz8gWyd1YnVudHUtbGF0ZXN0J107XG5cbiAgICBjb25zdCBhcHByb3Zlck1hcHBpbmdTY3JpcHQgPSB0aGlzLmdlbmVyYXRlQXBwcm92ZXJNYXBwaW5nU2NyaXB0KCk7XG5cbiAgICB0aGlzLndvcmtmbG93LmFkZEpvYignYXNzaWduLWFwcHJvdmVyJywge1xuICAgICAgcnVuc09uOiBydW5uZXJUYWdzLFxuICAgICAgcGVybWlzc2lvbnM6IHRoaXMucmVuZGVyUGVybWlzc2lvbnMoKSxcbiAgICAgIHN0ZXBzOiBbXG4gICAgICAgIHtcbiAgICAgICAgICBuYW1lOiAnQXNzaWduIGFwcHJvdmVyIGJhc2VkIG9uIGF1dGhvcicsXG4gICAgICAgICAgdXNlczogJ2FjdGlvbnMvZ2l0aHViLXNjcmlwdEB2NycsXG4gICAgICAgICAgd2l0aDoge1xuICAgICAgICAgICAgc2NyaXB0OiBhcHByb3Zlck1hcHBpbmdTY3JpcHQsXG4gICAgICAgICAgfSxcbiAgICAgICAgfSxcbiAgICAgIF0sXG4gICAgfSk7XG4gIH1cblxuICBwcm90ZWN0ZWQgZ2VuZXJhdGVBcHByb3Zlck1hcHBpbmdTY3JpcHQoKTogc3RyaW5nIHtcbiAgICBjb25zdCBtYXBwaW5nRW50cmllcyA9IHRoaXMuYmFzZU9wdGlvbnMuYXBwcm92ZXJNYXBwaW5nXG4gICAgICAubWFwKG1hcHBpbmcgPT4gYCAgJyR7bWFwcGluZy5hdXRob3J9JzogWyR7bWFwcGluZy5hcHByb3ZlcnMubWFwKGEgPT4gYCcke2F9J2ApLmpvaW4oJywgJyl9XWApXG4gICAgICAuam9pbignLFxcbicpO1xuXG4gICAgY29uc3QgZGVmYXVsdEFwcHJvdmVycyA9IHRoaXMuYmFzZU9wdGlvbnMuZGVmYXVsdEFwcHJvdmVyc1xuICAgICAgLm1hcChhID0+IGAnJHthfSdgKVxuICAgICAgLmpvaW4oJywgJyk7XG5cbiAgICByZXR1cm4gYGNvbnN0IGF1dGhvciA9IGNvbnRleHQucGF5bG9hZC5wdWxsX3JlcXVlc3QudXNlci5sb2dpbjtcblxuLy8gRGVmaW5lIGFwcHJvdmVyIG1hcHBpbmdcbmNvbnN0IGFwcHJvdmVyTWFwcGluZyA9IHtcbiR7bWFwcGluZ0VudHJpZXN9JHttYXBwaW5nRW50cmllcy5sZW5ndGggPiAwID8gJywnIDogJyd9XG4gICdkZWZhdWx0JzogWyR7ZGVmYXVsdEFwcHJvdmVyc31dIC8vIERlZmF1bHQgYXBwcm92ZXIocykgaWYgYXV0aG9yIG5vdCBpbiBtYXBwaW5nXG59O1xuXG4vLyBHZXQgYXBwcm92ZXJzIGZvciB0aGUgUFIgYXV0aG9yXG5jb25zdCBhcHByb3ZlcnMgPSBhcHByb3Zlck1hcHBpbmdbYXV0aG9yXSB8fCBhcHByb3Zlck1hcHBpbmdbJ2RlZmF1bHQnXTtcblxuLy8gRmlsdGVyIG91dCB0aGUgYXV0aG9yIGZyb20gYXBwcm92ZXJzIGxpc3QgKGNhbid0IGFwcHJvdmUgb3duIFBSKVxuY29uc3QgZmlsdGVyZWRBcHByb3ZlcnMgPSBhcHByb3ZlcnMuZmlsdGVyKGFwcHJvdmVyID0+IGFwcHJvdmVyICE9PSBhdXRob3IpO1xuXG5pZiAoZmlsdGVyZWRBcHByb3ZlcnMubGVuZ3RoID4gMCkge1xuICAvLyBSZXF1ZXN0IHJldmlld3MgZnJvbSB0aGUgYXBwcm92ZXJzXG4gIGF3YWl0IGdpdGh1Yi5yZXN0LnB1bGxzLnJlcXVlc3RSZXZpZXdlcnMoe1xuICAgIG93bmVyOiBjb250ZXh0LnJlcG8ub3duZXIsXG4gICAgcmVwbzogY29udGV4dC5yZXBvLnJlcG8sXG4gICAgcHVsbF9udW1iZXI6IGNvbnRleHQuaXNzdWUubnVtYmVyLFxuICAgIHJldmlld2VyczogZmlsdGVyZWRBcHByb3ZlcnNcbiAgfSk7XG4gIFxuICBjb25zb2xlLmxvZyhcXGBBc3NpZ25lZCByZXZpZXdlcnM6IFxcJHtmaWx0ZXJlZEFwcHJvdmVycy5qb2luKCcsICcpfVxcYCk7XG59IGVsc2Uge1xuICBjb25zb2xlLmxvZygnTm8gZWxpZ2libGUgcmV2aWV3ZXJzIGZvdW5kIGZvciB0aGlzIFBSIGF1dGhvcicpO1xufWA7XG4gIH1cbn1cbiJdfQ==

package/lib/awscdk/base.d.ts

@@ -1,6 +1,7 @@
 import { Component, awscdk } from 'projen';
 import { PipelineEngine } from '../engine';
 import { PipelineStep } from '../steps';
+import { VersioningConfig } from '../versioning';
 /**
  * The Environment interface is designed to hold AWS related information
  * for a specific deployment environment within your infrastructure.
@@ -138,6 +139,10 @@ export interface CDKPipelineOptions {
     readonly preInstallSteps?: PipelineStep[];
     readonly preSynthSteps?: PipelineStep[];
     readonly postSynthSteps?: PipelineStep[];
+    /**
+     * Versioning configuration
+     */
+    readonly versioning?: VersioningConfig;
 }
 /**
  * The CDKPipeline class extends the Component class and sets up the necessary configuration for deploying AWS CDK (Cloud Development Kit) applications across multiple stages.
@@ -189,4 +194,20 @@ export declare abstract class CDKPipeline extends Component {
      */
     protected createIndependentStage(stage: IndependentStage): void;
     protected getCliStackPattern(stage: string): string;
+    /**
+     * Create version:fetch:<stage> task to fetch version data from deployed stack
+     */
+    protected createVersionFetchTask(stage: NamedStageOptions): void;
+    /**
+     * Generate CDK application code for versioning
+     */
+    generateVersioningAppCode(config: VersioningConfig): string;
+    /**
+     * Generate versioning imports for CDK application
+     */
+    generateVersioningImports(): string;
+    /**
+     * Generate versioning utility functions for CDK application
+     */
+    generateVersioningUtilities(): string;
 }