feat: add SiteDomain property to StaticSiteConstruct and update dependencies (#31)

- Add public SiteDomain property to expose fully qualified domain name
- Update AWS CDK from 2.209.1 to 2.213.0
- Update xUnit dependencies (v3.0.0 -> v3.0.1, runner v3.1.3 -> v3.1.4)
- Version bump to 2.0.1
- Add comprehensive XML documentation for new property
- Update CLAUDE.md and static-site.md documentation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>

Author: ncipollina

CLAUDE.md

@@ -58,6 +58,7 @@ dotnet add test/LayeredCraft.Cdk.Constructs.Tests/ package PackageName
 - Configures Route53 DNS records for primary domain and alternates
 - Supports optional API proxying via CloudFront behaviors for `/api/*` paths
 - Includes automatic asset deployment with cache invalidation
+- Exposes `SiteDomain` property containing the fully qualified domain name
 
 **DynamoDbTableConstruct** (`src/LayeredCraft.Cdk.Constructs/DynamoDbTableConstruct.cs`)
 - Comprehensive CDK construct for DynamoDB table creation and configuration
@@ -88,7 +89,7 @@ dotnet add test/LayeredCraft.Cdk.Constructs.Tests/ package PackageName
 
 ### Target Frameworks
 - .NET 8.0 and .NET 9.0
-- Uses AWS CDK v2 (Amazon.CDK.Lib 2.203.1)
+- Uses AWS CDK v2 (Amazon.CDK.Lib 2.213.0)
 
 ### OpenTelemetry Configuration (v2.0.0+)
 Starting with version 2.0.0, the OpenTelemetry layer configuration has been updated:

Directory.Build.props

@@ -1,6 +1,6 @@
 <Project>
     <PropertyGroup>
-        <VersionPrefix>2.0.0</VersionPrefix>
+        <VersionPrefix>2.0.1</VersionPrefix>
         <!-- SPDX license identifier for MIT -->
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
 

docs/constructs/static-site.md

@@ -51,6 +51,29 @@ public class MyStack : Stack
 | `ApiDomain` | `string?` | `null` | API domain for proxy behavior |
 | `AlternateDomains` | `string[]` | `[]` | Additional domains to include in certificate |
 
+## Construct Properties
+
+The `StaticSiteConstruct` exposes the following properties after instantiation:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `SiteDomain` | `string` | Fully qualified domain name of the site (e.g., "www.example.com") |
+
+### Accessing Site Domain
+
+```csharp
+var site = new StaticSiteConstruct(this, "MySite", new StaticSiteConstructProps
+{
+    SiteBucketName = "my-website-bucket",
+    DomainName = "example.com",
+    SiteSubDomain = "www",
+    AssetPath = "./website-build"
+});
+
+// Access the computed site domain
+var domain = site.SiteDomain; // "www.example.com"
+```
+
 ## Advanced Examples
 
 ### Website with Subdomain

src/LayeredCraft.Cdk.Constructs/LayeredCraft.Cdk.Constructs.csproj

@@ -15,7 +15,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-      <PackageReference Include="Amazon.CDK.Lib" Version="2.209.1" />
+      <PackageReference Include="Amazon.CDK.Lib" Version="2.213.0" />
     </ItemGroup>
     <ItemGroup>
         <None Include="..\..\docs\assets\icon.png" Pack="true" PackagePath="" Visible="False" />

src/LayeredCraft.Cdk.Constructs/StaticSiteConstruct.cs

@@ -19,6 +19,11 @@ namespace LayeredCraft.Cdk.Constructs;
 /// </summary>
 public class StaticSiteConstruct : Construct
 {
+    /// <summary>
+    /// Gets the fully qualified domain name of the static site (e.g., "www.example.com").
+    /// This property is set during construct initialization and combines the site subdomain with the domain name.
+    /// </summary>
+    public string SiteDomain { get; private set; }
     /// <summary>
     /// Initializes a new instance of the StaticSiteConstruct class.
     /// </summary>
@@ -33,12 +38,12 @@ public StaticSiteConstruct(Construct scope, string id, IStaticSiteConstructProps
             DomainName = props.DomainName
         });
 
-        var siteDomain = $"{props.SiteSubDomain}.{props.DomainName}";
+        SiteDomain = $"{props.SiteSubDomain}.{props.DomainName}";
 
         // Create S3 bucket for static website hosting
         var siteBucket = new Bucket(this, $"{id}-bucket", new BucketProps
         {
-            BucketName = siteDomain,
+            BucketName = SiteDomain,
             WebsiteIndexDocument = "index.html",
             WebsiteErrorDocument = "index.html",
             PublicReadAccess = true,
@@ -62,15 +67,15 @@ public StaticSiteConstruct(Construct scope, string id, IStaticSiteConstructProps
         // Create SSL certificate for HTTPS with DNS validation
         var certificate = new Certificate(this, $"{id}-certificate", new CertificateProps
         {
-            DomainName = siteDomain,
+            DomainName = SiteDomain,
             Validation = CertificateValidation.FromDns(zone),
             SubjectAlternativeNames = props.AlternateDomains,
         });
 
         // Create CloudFront distribution for global content delivery
         var distribution = new Distribution(this, $"{id}-cdn", new DistributionProps
         {
-            DomainNames = [siteDomain, ..props.AlternateDomains],
+            DomainNames = [SiteDomain, ..props.AlternateDomains],
             DefaultBehavior = new BehaviorOptions
             {
                 Origin = new S3StaticWebsiteOrigin(siteBucket, new S3StaticWebsiteOriginProps
@@ -112,7 +117,7 @@ public StaticSiteConstruct(Construct scope, string id, IStaticSiteConstructProps
         _ = new ARecord(this, $"{id}-alias-record", new ARecordProps
         {
             Zone = zone,
-            RecordName = siteDomain,
+            RecordName = SiteDomain,
             Target = RecordTarget.FromAlias(new CloudFrontTarget(distribution)),
         });
 

test/LayeredCraft.Cdk.Constructs.Tests/LayeredCraft.Cdk.Constructs.Tests.csproj

@@ -36,8 +36,8 @@
         <PackageReference Include="AwesomeAssertions" Version="9.1.0" />
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1"/>
         <PackageReference Include="NSubstitute" Version="5.3.0"/>
-        <PackageReference Include="xunit.v3" Version="3.0.0" />
-        <PackageReference Include="xunit.runner.visualstudio" Version="3.1.3">
+        <PackageReference Include="xunit.v3" Version="3.0.1" />
+        <PackageReference Include="xunit.runner.visualstudio" Version="3.1.4">
           <PrivateAssets>all</PrivateAssets>
           <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>