@microsoft/terraform-cdk-constructs 0.0.3-pre.7 → 1.2.0

package/docs/versioning-and-migrations-user-guide.md

@@ -0,0 +1,409 @@
+# API Versioning and Migrations: User Guide
+
+This guide explains how Azure API versioning and automatic migrations work in the terraform-cdk-constructs library. No technical knowledge of the internal framework is required—just follow these patterns to benefit from automatic version management.
+
+---
+
+## Table of Contents
+
+1. [Quick Start](#quick-start)
+2. [Understanding API Versions](#understanding-api-versions)
+3. [How Automatic Version Resolution Works](#how-automatic-version-resolution-works)
+4. [Version Pinning for Stability](#version-pinning-for-stability)
+5. [Understanding Deprecation Warnings](#understanding-deprecation-warnings)
+6. [Migration Guidance](#migration-guidance)
+7. [Frequently Asked Questions](#frequently-asked-questions)
+
+---
+
+## Quick Start
+
+### Simple Example (Recommended for Most Users)
+
+```typescript
+import { ResourceGroup } from '@microsoft/terraform-cdk-constructs';
+import { App, TerraformStack } from 'cdktf';
+
+class MyStack extends TerraformStack {
+  constructor(scope: App, name: string) {
+    super(scope, name);
+    
+    // Just create your resource - version is handled automatically!
+    const resourceGroup = new ResourceGroup(this, 'MyResourceGroup', {
+      name: 'my-resource-group',
+      location: 'eastus',
+      tags: { environment: 'production' }
+    });
+  }
+}
+```
+
+**That's it!** The framework automatically:
+- ✅ Uses the latest stable Azure API version
+- ✅ Validates your properties
+- ✅ Warns you about upcoming changes
+- ✅ Provides migration guidance when needed
+
+---
+
+## Understanding API Versions
+
+### What Are API Versions?
+
+Azure resources use versioned APIs (e.g., `2024-01-01`, `2024-11-01`). Each version may have:
+- New features and properties
+- Bug fixes and improvements
+- Deprecated properties (to be removed)
+- Breaking changes (incompatible changes)
+
+### Version Lifecycle Phases
+
+Every API version goes through these phases:
+
+| Phase | What It Means | Should You Use It? |
+|-------|---------------|-------------------|
+| **ACTIVE** ✅ | Fully supported, receives new features | ✅ **Yes - Recommended** |
+| **MAINTENANCE** ⚙️ | Bug fixes only, no new features | ✅ Yes, but consider upgrading soon |
+| **DEPRECATED** ⚠️ | Migration recommended, limited support | ⚠️ Start planning migration |
+| **SUNSET** 🚨 | End of life, will be removed | 🚨 **Migrate immediately** |
+
+---
+
+## How Automatic Version Resolution Works
+
+### Default Behavior: Always Use Latest
+
+When you **don't specify** an API version, the framework automatically uses the **latest ACTIVE version**:
+
+```typescript
+// No apiVersion specified → uses latest automatically
+const storage = new StorageAccount(this, 'storage', {
+  name: 'mystorageaccount',
+  location: 'eastus',
+  sku: { name: 'Standard_LRS' }
+  // Framework will use 2024-01-01 (or whatever is latest)
+});
+```
+
+**Benefits:**
+- ✅ Always get the latest features
+- ✅ Always get bug fixes
+- ✅ No manual version updates needed
+- ✅ Your code stays current as Azure evolves
+
+### When Versions Change
+
+When Azure releases a new API version (e.g., monthly updates):
+
+1. **Next time you run `cdktf synth`**, your resources automatically use the new version
+2. **You see console output** confirming the version being used
+3. **No code changes required** unless there are breaking changes (see [Migration Guidance](#migration-guidance))
+
+**Example Console Output:**
+```
+Registered 3 API versions for Microsoft.Storage/storageAccounts
+✓ Using API version 2024-01-01 for mystorageaccount
+```
+
+---
+
+## Version Pinning for Stability
+
+### When to Pin Versions
+
+Pin to a specific API version when you need:
+- **Stability**: Production systems that should not change unexpectedly
+- **Compliance**: Audit requirements for consistent infrastructure
+- **Testing**: Ensuring test environments match production exactly
+- **Controlled Upgrades**: Planning migrations during maintenance windows
+
+### How to Pin a Version
+
+Simply add the `apiVersion` property:
+
+```typescript
+const storage = new StorageAccount(this, 'storage', {
+  apiVersion: '2023-05-01',  // Pinned to specific version
+  name: 'mystorageaccount',
+  location: 'eastus',
+  sku: { name: 'Standard_LRS' }
+});
+```
+
+**What Happens:**
+- ✅ Your resource will **always** use `2023-05-01`
+- ✅ New library versions won't change your API version
+- ⚠️ You'll get warnings if the version becomes deprecated
+- ℹ️ You control when to upgrade by changing the `apiVersion` value
+
+---
+
+## Understanding Deprecation Warnings
+
+### What You'll See
+
+When using an older API version, you'll see warnings during `cdktf synth`:
+
+#### Warning: Deprecated Version
+
+```
+⚠️  API version 2023-05-01 for Microsoft.Storage/storageAccounts is deprecated.
+    Consider upgrading to the latest version: 2024-01-01
+    Support ends: 2024-12-31
+    Migration guide: /docs/migration-guides/storage-2024-01-01.md
+```
+
+**What This Means:**
+- ✅ Your code still works perfectly
+- ⚠️ The version will eventually be removed
+- ℹ️ You have time to plan your migration
+- 📚 Documentation is available to help
+
+#### Error: Sunset Version
+
+```
+🚨 API version 2023-01-01 for Microsoft.Storage/storageAccounts has reached sunset.
+   Immediate migration to 2024-01-01 is required.
+   This version will be removed in the next library update.
+   Migration guide: /docs/migration-guides/storage-2024-01-01.md
+```
+
+**What This Means:**
+- 🚨 Your code still works, but not for long
+- 🚨 Update your code as soon as possible
+- 🚨 The next library update may remove this version
+- 📚 Follow the migration guide immediately
+
+### Automatic Migration Analysis
+
+When you use a deprecated or sunset version, the framework automatically:
+
+1. **Analyzes the migration** from your current version to the latest
+2. **Counts breaking changes** that will affect your code
+3. **Estimates effort** required to migrate
+4. **Provides guidance** on what needs to change
+
+**Example Output:**
+```
+Migration from 2023-05-01 to 2024-01-01 analysis:
+  • Breaking changes: 2
+  • Estimated effort: Medium (4-8 hours)
+  • Automatic upgrade: Partially possible
+  
+Breaking changes:
+  1. Property 'accountType' renamed to 'sku.name'
+  2. Property 'enableHttpsTrafficOnly' now required (was optional)
+
+See migration guide for details: /docs/migration-guides/storage-2024-01-01.md
+```
+
+**You don't need to run any commands** - this happens automatically whenever you create a resource with an outdated version!
+
+---
+
+## Migration Guidance
+
+### Step-by-Step Migration Process
+
+#### 1. Review the Warning
+
+When you see a deprecation warning, note:
+- Current version you're using
+- Target version recommended
+- Support end date
+- Link to migration guide
+
+#### 2. Check the Migration Guide
+
+Follow the link provided in the warning to see:
+- Detailed list of changes
+- Code examples showing before/after
+- Properties that were renamed
+- New required properties
+- Recommended migration approach
+
+#### 3. Test in Development
+
+Before updating production:
+
+```typescript
+// Create a test stack with the new version
+const testStorage = new StorageAccount(this, 'test-storage', {
+  apiVersion: '2024-01-01',  // New version
+  name: 'teststorageaccount',
+  location: 'eastus',
+  sku: { name: 'Standard_LRS' }  // Updated property name
+});
+```
+
+#### 4. Update Your Code
+
+Make the necessary changes identified in the migration guide:
+
+```typescript
+// Before (2023-05-01)
+const storage = new StorageAccount(this, 'storage', {
+  apiVersion: '2023-05-01',
+  name: 'mystorageaccount',
+  location: 'eastus',
+  accountType: 'Standard_LRS',  // Old property name
+  enableHttpsTrafficOnly: true
+});
+
+// After (2024-01-01)
+const storage = new StorageAccount(this, 'storage', {
+  apiVersion: '2024-01-01',
+  name: 'mystorageaccount',
+  location: 'eastus',
+  sku: { name: 'Standard_LRS' },  // New property structure
+  enableHttpsTrafficOnly: true  // Still supported
+});
+```
+
+#### 5. Deploy and Verify
+
+1. Run `cdktf synth` - confirm no warnings
+2. Run `cdktf diff` - review planned changes
+3. Deploy to test environment first
+4. Verify everything works as expected
+5. Deploy to production
+
+### Migration Effort Levels
+
+The framework estimates how long migration will take:
+
+| Effort Level | Estimated Time | What It Means |
+|--------------|----------------|---------------|
+| **Low** | < 1 hour | Mostly automatic, minimal changes |
+| **Medium** | 1-8 hours | Some property renames, minor updates |
+| **High** | 1-3 days | Significant changes, testing needed |
+| **Breaking** | > 3 days | Major refactoring required |
+
+---
+
+## Frequently Asked Questions
+
+### Q: Do I need to specify an API version?
+
+**A: No, not usually.** For most use cases, automatic version resolution is recommended. Only pin versions when you specifically need stability.
+
+### Q: Will my code break when new API versions are released?
+
+**A: No.** The framework only uses new versions that are marked as ACTIVE (stable). Breaking changes are clearly documented, and you get warnings with migration guidance.
+
+### Q: How do I find out what API version I'm using?
+
+**A: Check the console output** during `cdktf synth`. You can also access it in code:
+
+```typescript
+const storage = new StorageAccount(this, 'storage', { /* ... */ });
+console.log(`Using API version: ${storage.resolvedApiVersion}`);
+```
+
+### Q: Can I turn off migration warnings?
+
+**A: Yes**, but it's not recommended. Add `enableMigrationAnalysis: false`:
+
+```typescript
+const storage = new StorageAccount(this, 'storage', {
+  apiVersion: '2023-05-01',
+  enableMigrationAnalysis: false,  // Turns off warnings
+  // ... other properties
+});
+```
+
+### Q: What happens if I use an unsupported API version?
+
+**A: You'll get a clear error** listing all supported versions:
+
+```
+Error: Unsupported API version '2022-01-01' for Microsoft.Storage/storageAccounts
+Supported versions: 2023-05-01, 2024-01-01, 2024-11-01
+```
+
+### Q: How often do API versions change?
+
+**A: It varies by service:**
+- Some services: Monthly updates
+- Most services: Quarterly updates
+- Stable services: Yearly updates
+
+The framework handles this automatically, so you don't need to track it manually.
+
+### Q: What if a property I'm using gets removed?
+
+**A: You'll get warnings well in advance:**
+
+1. Property is marked deprecated (still works)
+2. Warnings appear in console output
+3. Migration guide explains alternatives
+4. You have months to update before removal
+
+### Q: Can I see all supported versions for a resource?
+
+**A: Yes**, use the `supportedVersions()` method:
+
+```typescript
+const storage = new StorageAccount(this, 'storage', { /* ... */ });
+console.log(`Supported versions: ${storage.supportedVersions().join(', ')}`);
+// Output: Supported versions: 2023-05-01, 2024-01-01, 2024-11-01
+```
+
+### Q: How do I know if migration is automatic or manual?
+
+**A: Check the migration analysis output:**
+
+```
+Automatic upgrade: Yes  ← Properties will be transformed automatically
+Automatic upgrade: Partial  ← Some changes automatic, some manual
+Automatic upgrade: No  ← Manual code changes required
+```
+
+---
+
+## Best Practices
+
+### ✅ DO:
+- Use automatic version resolution for development and test environments
+- Pin versions for production environments
+- Read deprecation warnings and plan migrations
+- Test migrations in non-production environments first
+- Follow migration guides when updating versions
+
+### ❌ DON'T:
+- Ignore sunset warnings in production code
+- Disable migration analysis without good reason
+- Skip testing when migrating API versions
+- Use deprecated versions for new projects
+- Pin to old versions indefinitely
+
+---
+
+## Getting Help
+
+### Resources
+
+- **Migration Guides**: `/docs/migration-guides/` directory
+- **API Coverage**: `/docs/api-coverage.md`
+- **GitHub Issues**: Report problems or ask questions
+- **Examples**: `/examples/` directory with version-specific examples
+
+### Support Channels
+
+1. **Check the migration guide** linked in warning messages
+2. **Search existing GitHub issues** for similar problems
+3. **Create a new issue** with your specific question
+4. **Include console output** showing warnings/errors
+
+---
+
+## Summary
+
+The versioning system is designed to **just work** with minimal effort from you:
+
+1. **By default**, you get the latest stable API version automatically
+2. **Warnings appear** when you need to update, with clear guidance
+3. **Migration is guided** with effort estimates and documentation
+4. **You control the timing** by pinning versions when needed
+
+Focus on building your infrastructure—let the framework handle API version complexity!

package/go.mod

@@ -1,11 +1,11 @@
 module github.com/microsoft/azure-terraform-cdk-modules
 
-go 1.19
+go 1.23
 
 require (
-	github.com/Azure/azure-sdk-for-go v51.0.0+incompatible
-	github.com/gruntwork-io/terratest v0.43.2
-	github.com/stretchr/testify v1.8.4
+	github.com/Azure/azure-sdk-for-go v58.3.0+incompatible
+	github.com/gruntwork-io/terratest v0.47.0
+	github.com/stretchr/testify v1.9.0
 )
 
 require (
@@ -31,6 +31,7 @@ require (
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/dimchansky/utfbom v1.1.1 // indirect
 	github.com/form3tech-oss/jwt-go v3.2.2+incompatible // indirect
+	github.com/gofrs/uuid v4.4.0+incompatible // indirect
 	github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect
 	github.com/golang/protobuf v1.5.3 // indirect
 	github.com/google/go-cmp v0.5.9 // indirect
@@ -39,7 +40,7 @@ require (
 	github.com/googleapis/gax-go/v2 v2.7.1 // indirect
 	github.com/hashicorp/errwrap v1.0.0 // indirect
 	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
-	github.com/hashicorp/go-getter v1.7.1 // indirect
+	github.com/hashicorp/go-getter v1.7.5 // indirect
 	github.com/hashicorp/go-multierror v1.1.0 // indirect
 	github.com/hashicorp/go-safetemp v1.0.0 // indirect
 	github.com/hashicorp/go-version v1.6.0 // indirect
@@ -53,21 +54,20 @@ require (
 	github.com/mitchellh/go-testing-interface v1.14.1 // indirect
 	github.com/mitchellh/go-wordwrap v1.0.1 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/satori/go.uuid v1.2.0 // indirect
 	github.com/tmccombs/hcl2json v0.3.3 // indirect
 	github.com/ulikunitz/xz v0.5.10 // indirect
 	github.com/zclconf/go-cty v1.9.1 // indirect
 	go.opencensus.io v0.24.0 // indirect
-	golang.org/x/crypto v0.14.0 // indirect
-	golang.org/x/net v0.17.0 // indirect
-	golang.org/x/oauth2 v0.7.0 // indirect
-	golang.org/x/sys v0.13.0 // indirect
-	golang.org/x/text v0.13.0 // indirect
+	golang.org/x/crypto v0.21.0 // indirect
+	golang.org/x/net v0.23.0 // indirect
+	golang.org/x/oauth2 v0.8.0 // indirect
+	golang.org/x/sys v0.18.0 // indirect
+	golang.org/x/text v0.14.0 // indirect
 	golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 // indirect
 	google.golang.org/api v0.114.0 // indirect
 	google.golang.org/appengine v1.6.7 // indirect
 	google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1 // indirect
 	google.golang.org/grpc v1.56.3 // indirect
-	google.golang.org/protobuf v1.31.0 // indirect
+	google.golang.org/protobuf v1.33.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

package/go.sum

@@ -116,6 +116,7 @@ cloud.google.com/go/language v1.6.0/go.mod h1:6dJ8t3B+lUYfStgls25GusK04NLh3eDLQn
 cloud.google.com/go/lifesciences v0.5.0/go.mod h1:3oIKy8ycWGPUyZDR/8RNnTOYevhaMLqh5vLUXs9zvT8=
 cloud.google.com/go/lifesciences v0.6.0/go.mod h1:ddj6tSX/7BOnhxCSd3ZcETvtNr8NZ6t/iPhY2Tyfu08=
 cloud.google.com/go/longrunning v0.4.1 h1:v+yFJOfKC3yZdY6ZUI933pIYdhyhV8S3NpWrXWmg7jM=
+cloud.google.com/go/longrunning v0.4.1/go.mod h1:4iWDqhBZ70CvZ6BfETbvam3T8FMvLK+eFj0E6AaRQTo=
 cloud.google.com/go/mediatranslation v0.5.0/go.mod h1:jGPUhGTybqsPQn91pNXw0xVHfuJ3leR1wj37oU3y1f4=
 cloud.google.com/go/mediatranslation v0.6.0/go.mod h1:hHdBCTYNigsBxshbznuIMFNe5QXEowAuNmmC7h8pu5w=
 cloud.google.com/go/memcache v1.4.0/go.mod h1:rTOfiGZtJX1AaFUrOgsMHX5kAzaTQ8azHiuDoTPzNsE=
@@ -186,8 +187,8 @@ cloud.google.com/go/webrisk v1.5.0/go.mod h1:iPG6fr52Tv7sGk0H6qUFzmL3HHZev1htXuW
 cloud.google.com/go/workflows v1.6.0/go.mod h1:6t9F5h/unJz41YqfBmqSASJSXccBLtD1Vwf+KmJENM0=
 cloud.google.com/go/workflows v1.7.0/go.mod h1:JhSrZuVZWuiDfKEFxU0/F1PQjmpnpcoISEXH2bcHC3M=
 dmitri.shuralyov.com/gpu/mtl v0.0.0-20190408044501-666a987793e9/go.mod h1:H6x//7gZCb22OMCxBHrMx7a5I7Hp++hsVxbQ4BYO7hU=
-github.com/Azure/azure-sdk-for-go v51.0.0+incompatible h1:p7blnyJSjJqf5jflHbSGhIhEpXIgIFmYZNg5uwqweso=
-github.com/Azure/azure-sdk-for-go v51.0.0+incompatible/go.mod h1:9XXNKU+eRnpl9moKnB4QOLf1HestfXbmab5FXxiDBjc=
+github.com/Azure/azure-sdk-for-go v58.3.0+incompatible h1:lb9OWePNuJMiibdxg9XvdbiOldR0Yifge37L4LoOxIs=
+github.com/Azure/azure-sdk-for-go v58.3.0+incompatible/go.mod h1:9XXNKU+eRnpl9moKnB4QOLf1HestfXbmab5FXxiDBjc=
 github.com/Azure/go-autorest v14.2.0+incompatible h1:V5VMDjClD3GiElqLWO7mz2MxNAK/vTfRHdAubSIPRgs=
 github.com/Azure/go-autorest v14.2.0+incompatible/go.mod h1:r+4oMnoxhatjLLJ6zxSWATqVooLgysK6ZNox3g/xq24=
 github.com/Azure/go-autorest/autorest v0.11.17/go.mod h1:eipySxLmqSyC5s5k1CLupqet0PSENBEDP93LQ9a8QYw=
@@ -273,6 +274,8 @@ github.com/go-gl/glfw/v3.3/glfw v0.0.0-20200222043503-6f7a984d4dc4/go.mod h1:tQ2
 github.com/go-test/deep v1.0.3/go.mod h1:wGDj63lr65AM2AQyKZd/NYHGb0R+1RLqB8NKt3aSFNA=
 github.com/go-test/deep v1.0.7 h1:/VSMRlnY/JSyqxQUzQLKVMAskpY/NZKFA5j2P+0pP2M=
 github.com/go-test/deep v1.0.7/go.mod h1:QV8Hv/iy04NyLBxAdO9njL0iVPN1S4d/A3NVv1V36o8=
+github.com/gofrs/uuid v4.4.0+incompatible h1:3qXRTX8/NbyulANqlc0lchS1gqAVxRgsuW1YrTJupqA=
+github.com/gofrs/uuid v4.4.0+incompatible/go.mod h1:b2aQJv3Z4Fp6yNu3cdSllBxTCLRxnplIgP/c0N/04lM=
 github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q=
 github.com/golang/groupcache v0.0.0-20190702054246-869f871628b6/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
 github.com/golang/groupcache v0.0.0-20191227052852-215e87163ea7/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
@@ -333,6 +336,7 @@ github.com/google/martian/v3 v3.0.0/go.mod h1:y5Zk1BBys9G+gd6Jrk0W3cC1+ELVxBWuIG
 github.com/google/martian/v3 v3.1.0/go.mod h1:y5Zk1BBys9G+gd6Jrk0W3cC1+ELVxBWuIGO+w/tUAp0=
 github.com/google/martian/v3 v3.2.1/go.mod h1:oBOf6HBosgwRXnUGWUB05QECsc6uvmMiJ3+6W4l/CUk=
 github.com/google/martian/v3 v3.3.2 h1:IqNFLAmvJOgVlpdEBiQbDc2EwKW77amAycfTuWKdfvw=
+github.com/google/martian/v3 v3.3.2/go.mod h1:oBOf6HBosgwRXnUGWUB05QECsc6uvmMiJ3+6W4l/CUk=
 github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc=
 github.com/google/pprof v0.0.0-20190515194954-54271f7e092f/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc=
 github.com/google/pprof v0.0.0-20191218002539-d4f498aebedc/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
@@ -369,14 +373,14 @@ github.com/googleapis/gax-go/v2 v2.7.1 h1:gF4c0zjUP2H/s/hEGyLA3I0fA2ZWjzYiONAD6c
 github.com/googleapis/gax-go/v2 v2.7.1/go.mod h1:4orTrqY6hXxxaUL4LHIPl6lGo8vAE38/qKbhSAKP6QI=
 github.com/googleapis/go-type-adapters v1.0.0/go.mod h1:zHW75FOG2aur7gAO2B+MLby+cLsWGBF62rFAi7WjWO4=
 github.com/grpc-ecosystem/grpc-gateway v1.16.0/go.mod h1:BDjrQk3hbvj6Nolgz8mAMFbcEtjT1g+wF4CSlocrBnw=
-github.com/gruntwork-io/terratest v0.43.2 h1:WlopytXFscGobjwQJiyGMVf6VqdKzlO0dObGVnlhEeo=
-github.com/gruntwork-io/terratest v0.43.2/go.mod h1:8dVukVEc2wyV4NUfRO8E/gTRCFMITHuTuBvpNbITmz8=
+github.com/gruntwork-io/terratest v0.47.0 h1:xIy1pT7NbGVlMLDZEHl3+3iSnvffh8tN2pL6idn448c=
+github.com/gruntwork-io/terratest v0.47.0/go.mod h1:oywHw1cFKXSYvKPm27U7quZVzDUlA22H2xUrKCe26xM=
 github.com/hashicorp/errwrap v1.0.0 h1:hLrqtEDnRye3+sgx6z4qVLNuviH3MR5aQ0ykNJa/UYA=
 github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
 github.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ=
 github.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48=
-github.com/hashicorp/go-getter v1.7.1 h1:SWiSWN/42qdpR0MdhaOc/bLR48PLuP1ZQtYLRlM69uY=
-github.com/hashicorp/go-getter v1.7.1/go.mod h1:W7TalhMmbPmsSMdNjD0ZskARur/9GJ17cfHTRtXV744=
+github.com/hashicorp/go-getter v1.7.5 h1:dT58k9hQ/vbxNMwoI5+xFYAJuv6152UNvdHokfI5wE4=
+github.com/hashicorp/go-getter v1.7.5/go.mod h1:W7TalhMmbPmsSMdNjD0ZskARur/9GJ17cfHTRtXV744=
 github.com/hashicorp/go-multierror v1.1.0 h1:B9UzwGQJehnUY1yNrnwREHc3fGbC2xefo8g4TbElacI=
 github.com/hashicorp/go-multierror v1.1.0/go.mod h1:spPvp8C1qA32ftKqdAHm4hHTbPw+vmowP0z+KUhOZdA=
 github.com/hashicorp/go-safetemp v1.0.0 h1:2HR189eFNrjHQyENnQMMpCiBAsRxzbTMIgBhEyExpmo=
@@ -433,8 +437,6 @@ github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZN
 github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
 github.com/rogpeppe/fastuuid v1.2.0/go.mod h1:jVj6XXZzXRy/MSR5jhDC/2q6DgLz+nrA6LYCDYWNEvQ=
 github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4=
-github.com/satori/go.uuid v1.2.0 h1:0uYX9dsZ2yD7q2RtLRtPSdGDWzjeM3TbMJP9utgA0ww=
-github.com/satori/go.uuid v1.2.0/go.mod h1:dA0hQrYB0VpLJoorglMZABFdXlWrHn1NEOzdhQKdks0=
 github.com/sebdah/goldie v1.0.0/go.mod h1:jXP4hmWywNEwZzhMuv2ccnqTSFpuq8iyQhtQdkkZBH4=
 github.com/sergi/go-diff v1.0.0/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo=
 github.com/spaolacci/murmur3 v0.0.0-20180118202830-f09979ecbc72/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA=
@@ -451,8 +453,8 @@ github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
-github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
+github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
 github.com/tmccombs/hcl2json v0.3.3 h1:+DLNYqpWE0CsOQiEZu+OZm5ZBImake3wtITYxQ8uLFQ=
 github.com/tmccombs/hcl2json v0.3.3/go.mod h1:Y2chtz2x9bAeRTvSibVRVgbLJhLJXKlUeIvjeVdnm4w=
 github.com/ulikunitz/xz v0.5.10 h1:t92gobL9l3HE202wg3rlk19F6X+JOxl9BBrCCMYEYd8=
@@ -491,8 +493,8 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh
 golang.org/x/crypto v0.0.0-20201002170205-7f63de1d35b0/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
 golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.14.0 h1:wBqGXzWJW6m1XrIKlAH0Hs1JJ7+9KBwnIO8v66Q9cHc=
-golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4=
+golang.org/x/crypto v0.21.0 h1:X31++rzVUdKhX5sWmSOFZxx8UW/ldWx55cbf08iNAMA=
+golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs=
 golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20190306152737-a1d7652674e8/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
 golang.org/x/exp v0.0.0-20190510132918-efd6b22b2522/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8=
@@ -577,8 +579,8 @@ golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug
 golang.org/x/net v0.0.0-20220909164309-bea034e7d591/go.mod h1:YDH+HFinaLZZlnHAfSS6ZXJJ9M9t4Dl22yv3iI2vPwk=
 golang.org/x/net v0.0.0-20221014081412-f15817d10f9b/go.mod h1:YDH+HFinaLZZlnHAfSS6ZXJJ9M9t4Dl22yv3iI2vPwk=
 golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco=
-golang.org/x/net v0.17.0 h1:pVaXccu2ozPjCXewfr1S7xza/zcXTity9cCdXQYSjIM=
-golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE=
+golang.org/x/net v0.23.0 h1:7EYJ93RZ9vYSZAIb2x3lnuvqO5zneoD6IvWjuhfxjTs=
+golang.org/x/net v0.23.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg=
 golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
 golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
 golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
@@ -604,8 +606,8 @@ golang.org/x/oauth2 v0.0.0-20220822191816-0ebed06d0094/go.mod h1:h4gKUeWbJ4rQPri
 golang.org/x/oauth2 v0.0.0-20220909003341-f21342109be1/go.mod h1:h4gKUeWbJ4rQPri7E0u6Gs4e9Ri2zaLxzw5DI5XGrYg=
 golang.org/x/oauth2 v0.0.0-20221014153046-6fdb5e3db783/go.mod h1:h4gKUeWbJ4rQPri7E0u6Gs4e9Ri2zaLxzw5DI5XGrYg=
 golang.org/x/oauth2 v0.1.0/go.mod h1:G9FE4dLTsbXUu90h/Pf85g4w1D+SSAgR+q46nJZ8M4A=
-golang.org/x/oauth2 v0.7.0 h1:qe6s0zUXlPX80/dITx3440hWZ7GwMwgDDyrSGTPJG/g=
-golang.org/x/oauth2 v0.7.0/go.mod h1:hPLQkd9LyjfXTiRohC/41GhcFqxisoUQ99sCUOHO9x4=
+golang.org/x/oauth2 v0.8.0 h1:6dkIjl3j3LtZ/O3sTgZTMsLKSftL/B8Zgq4huOIIUu8=
+golang.org/x/oauth2 v0.8.0/go.mod h1:yr7u4HXZRm1R1kBWqr/xKNqewf0plRYoB7sla+BCIXE=
 golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
@@ -684,12 +686,13 @@ golang.org/x/sys v0.0.0-20220624220833-87e55d714810/go.mod h1:oPkhp1MJrh7nUepCBc
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220728004956-3c1f35247d10/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.13.0 h1:Af8nKPmuFypiUBjVoU9V20FiaFXOcuZI21p0ycVYYGE=
-golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.18.0 h1:DBdB3niSjOA/O0blCZBqDefyWNYveAYMNF1Wum0DYQ4=
+golang.org/x/sys v0.18.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
-golang.org/x/term v0.13.0 h1:bb+I9cTfFazGW51MZqBVmZy7+JEJMouUHTUSKVQLBek=
+golang.org/x/term v0.18.0 h1:FcHjZXDMxI8mM3nwhX9HlKop4C0YQvCVCdwYl2wOtE8=
+golang.org/x/term v0.18.0/go.mod h1:ILwASektA3OnRv7amZ1xhE/KTR+u50pbXfZ03+6Nx58=
 golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
@@ -700,8 +703,8 @@ golang.org/x/text v0.3.5/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
-golang.org/x/text v0.13.0 h1:ablQoSUd0tRdKxZewP80B+BaqeKJuVhuRxj/dkrun3k=
-golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE=
+golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ=
+golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
 golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
 golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
@@ -980,8 +983,8 @@ google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQ
 google.golang.org/protobuf v1.27.1/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc=
 google.golang.org/protobuf v1.28.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
 google.golang.org/protobuf v1.28.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
-google.golang.org/protobuf v1.31.0 h1:g0LDEJHgrBl9N9r17Ru3sqWhkIx2NB67okBHPwC7hs8=
-google.golang.org/protobuf v1.31.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
+google.golang.org/protobuf v1.33.0 h1:uNO2rsAINq/JlFpSdYEKIZ0uKD/R9cpdv0T+yoGwGmI=
+google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127 h1:qIbj1fsPNlZgppZ+VLlY7N33q108Sa+fhmuc+sWQYwY=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
@@ -991,6 +994,7 @@ gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.3/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
+gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package/lib/azure-actiongroup/index.d.ts

@@ -1 +1,11 @@
+/**
+ * Azure Action Group construct
+ *
+ * This module provides the Action Group construct for Azure Monitor alerts.
+ * Action Groups serve as the central notification hub, supporting multiple
+ * receiver types including email, SMS, webhook, Azure Functions, Logic Apps,
+ * and voice calls.
+ *
+ * @packageDocumentation
+ */
 export * from "./lib";

package/lib/azure-actiongroup/index.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Azure Action Group construct
+ *
+ * This module provides the Action Group construct for Azure Monitor alerts.
+ * Action Groups serve as the central notification hub, supporting multiple
+ * receiver types including email, SMS, webhook, Azure Functions, Logic Apps,
+ * and voice calls.
+ *
+ * @packageDocumentation
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -15,4 +25,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXp1cmUtYWN0aW9uZ3JvdXAvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHdDQUFzQiIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gXCIuL2xpYlwiO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXp1cmUtYWN0aW9uZ3JvdXAvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7R0FTRzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILHdDQUFzQiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQXp1cmUgQWN0aW9uIEdyb3VwIGNvbnN0cnVjdFxuICpcbiAqIFRoaXMgbW9kdWxlIHByb3ZpZGVzIHRoZSBBY3Rpb24gR3JvdXAgY29uc3RydWN0IGZvciBBenVyZSBNb25pdG9yIGFsZXJ0cy5cbiAqIEFjdGlvbiBHcm91cHMgc2VydmUgYXMgdGhlIGNlbnRyYWwgbm90aWZpY2F0aW9uIGh1Yiwgc3VwcG9ydGluZyBtdWx0aXBsZVxuICogcmVjZWl2ZXIgdHlwZXMgaW5jbHVkaW5nIGVtYWlsLCBTTVMsIHdlYmhvb2ssIEF6dXJlIEZ1bmN0aW9ucywgTG9naWMgQXBwcyxcbiAqIGFuZCB2b2ljZSBjYWxscy5cbiAqXG4gKiBAcGFja2FnZURvY3VtZW50YXRpb25cbiAqL1xuXG5leHBvcnQgKiBmcm9tIFwiLi9saWJcIjtcbiJdfQ==