feat(url-shortener): add Lambda-based URL shortener with QR support

* Add ShortenFunction + RedirectFunction (AWS Lambda emulators)
* Generate 6-char slugs with SlugGenerator and store in DynamoDB
* Optional QR-code generation via Net.Codecrete.QrCodeGenerator ans SkiaSharp; PNGs saved to S3
* Provision Urls table and qr-bucket through CDK stack outputs
* Wire POST /shorten and GET /{slug} routes in API Gateway emulator

Author: Blind-Striker

Directory.Packages.props

@@ -43,6 +43,10 @@
     <PackageVersion Include="OpenTelemetry.Instrumentation.AWSLambda" Version="1.12.0"/>
     <PackageVersion Include="OpenTelemetry.Instrumentation.Http" Version="1.12.0"/>
     <PackageVersion Include="OpenTelemetry.Instrumentation.Runtime" Version="1.12.0"/>
+    <!-- third-party packages -->
+    <PackageVersion Include="Net.Codecrete.QrCodeGenerator" Version="2.0.7" />
+    <PackageVersion Include="SkiaSharp" Version="3.119.0" />
+    <PackageVersion Include="SkiaSharp.NativeAssets.Linux" Version="3.119.0" />
     <!-- test packages -->
     <PackageVersion Include="Aspire.Hosting.Testing" Version="9.4.0"/>
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1"/>

playground/LocalStack.Playground.ServiceDefaults/ActivitySources/UrlShortenerActivitySource.cs

@@ -0,0 +1,9 @@
+using System.Diagnostics;
+
+namespace LocalStack.Playground.ServiceDefaults.ActivitySources;
+
+public static class UrlShortenerActivitySource
+{
+    public const string ActivitySourceName = "LocalStack.Lambda.UrlShortener";
+    public static readonly ActivitySource ActivitySource = new(ActivitySourceName);
+}

playground/LocalStack.Playground.ServiceDefaults/LocalStackPlaygroundExtensions.cs

@@ -2,6 +2,7 @@
 // ReSharper disable CheckNamespace
 
 using AWS.Messaging.Telemetry.OpenTelemetry;
+using LocalStack.Playground.ServiceDefaults.ActivitySources;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Diagnostics.HealthChecks;
 using Microsoft.Extensions.DependencyInjection;
@@ -60,7 +61,8 @@ public static TBuilder ConfigureOpenTelemetry<TBuilder>(this TBuilder builder) w
                     // Add instrumentation for the AWS .NET SDK.
                     .AddAWSInstrumentation()
                     .AddAWSLambdaConfigurations(options => options.DisableAwsXRayContextExtraction = true)
-                    .AddAWSMessagingInstrumentation();
+                    .AddAWSMessagingInstrumentation()
+                    .AddSource(UrlShortenerActivitySource.ActivitySourceName);
             });
 
         builder.AddOpenTelemetryExporters();

playground/lambda/LocalStack.Lambda.AppHost/.aws-lambda-testtool/SavedRequests/UrlShortenerLambda/UrlShortenerRequest.json

@@ -0,0 +1,30 @@
+{
+  "version": "2.0",
+  "routeKey": "POST /shorten",
+  "rawPath": "/shorten",
+  "rawQueryString": "",
+  "headers": {
+    "content-type": "application/json",
+    "user-agent": "curl/7.81.0"
+  },
+  "requestContext": {
+    "accountId": "123456789012",
+    "apiId": "local",
+    "domainName": "localhost",
+    "domainPrefix": "",
+    "http": {
+      "method": "POST",
+      "path": "/shorten",
+      "protocol": "HTTP/1.1",
+      "sourceIp": "127.0.0.1",
+      "userAgent": "curl/7.81.0"
+    },
+    "requestId": "offline-request",
+    "routeKey": "POST /shorten",
+    "stage": "$default",
+    "time": "01/Aug/2025:12:00:00 +0000",
+    "timeEpoch": 1690891200000
+  },
+  "body": "{ \"Url\": \"https://aws.amazon.com\", \"Format\": \"qr\" }",
+  "isBase64Encoded": false
+}

playground/lambda/LocalStack.Lambda.AppHost/CustomStack.cs

@@ -3,6 +3,7 @@
 using Amazon;
 using Aspire.Hosting.AWS.Lambda;
 using Aspire.Hosting.LocalStack.Container;
+using AWSCDK.AppHost;
 
 var builder = DistributedApplication.CreateBuilder(args);
 
@@ -18,27 +19,24 @@
         container.LogLevel = LocalStackLogLevel.Debug;
     });
 
-var addFunction = builder
-    .AddAWSLambdaFunction<Projects.LocalStack_Lambda_UrlShortener>(
-        name: "AddFunction",
-        lambdaHandler: "LocalStack.Lambda.UrlShortener::LocalStack.Lambda.UrlShortener.Function::FunctionHandler")
+var urlShortenerStack = builder
+    .AddAWSCDKStack("custom", scope => new UrlShortenerStack(scope, "aspire-url-shortener"))
     .WithReference(awsConfig);
 
-builder.AddAWSAPIGatewayEmulator("APIGatewayEmulator", APIGatewayType.HttpV2)
-    // Add the Web API calculator routes
-    .WithReference(addFunction, Method.Get, "/add/{x}/{y}");
+urlShortenerStack.AddOutput("QrBucketName", stack => stack.QrBucket.BucketName);
+urlShortenerStack.AddOutput("UrlsTableName", stack => stack.UrlsTable.TableName);
 
-// var customStack = builder
-//     .AddAWSCDKStack("custom", scope => new CustomStack(scope, "Aspire-custom"))
-//     .WithReference(awsConfig);
+urlShortenerStack.WithTag("aws-repo", "integrations-on-dotnet-aspire-for-aws");
 
-// Add outputs for all the resources to make them available to the frontend
-// customStack.AddOutput("BucketName", stack => stack.Bucket.BucketName);
-// customStack.AddOutput("ChatTopicArn", stack => stack.ChatTopic.TopicArn);
-// customStack.AddOutput("ChatMessagesQueueUrl", stack => stack.ChatMessagesQueue.QueueUrl);
-// customStack.AddOutput("ChatMessagesTableName", stack => stack.ChatMessagesTable.TableName);
+var urlShortenerLambda = builder
+    .AddAWSLambdaFunction<Projects.LocalStack_Lambda_UrlShortener>(
+        name: "UrlShortenerLambda",
+        lambdaHandler: "LocalStack.Lambda.UrlShortener::LocalStack.Lambda.UrlShortener.Function::FunctionHandler")
+    .WithReference(urlShortenerStack);
 
-// customStack.WithTag("aws-repo", "integrations-on-dotnet-aspire-for-aws");
+builder.AddAWSAPIGatewayEmulator("APIGatewayEmulator", APIGatewayType.HttpV2)
+    // Add the Web API calculator routes
+    .WithReference(urlShortenerLambda, Method.Post, "/shorten");
 
 // Autoconfigures the LocalStack for both AWS Cloudformation and CDK resources adds LocalStack reference to all resources that uses AWS references
 builder.UseLocalStack(localstack);

playground/lambda/LocalStack.Lambda.AppHost/Program.cs

@@ -0,0 +1,35 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// Originally copied from https://github.com/aws/integrations-on-dotnet-aspire-for-aws
+// and adjusted for Aspire.Hosting.LocalStack. All rights reserved.
+
+#pragma warning disable IDE0130
+// ReSharper disable CheckNamespace
+
+using Amazon.CDK;
+using Amazon.CDK.AWS.DynamoDB;
+using Amazon.CDK.AWS.S3;
+using Constructs;
+using Attribute = Amazon.CDK.AWS.DynamoDB.Attribute;
+
+namespace AWSCDK.AppHost;
+
+internal sealed class UrlShortenerStack : Stack
+{
+    public ITable UrlsTable { get; }
+    public IBucket QrBucket { get; }
+
+    public UrlShortenerStack(Construct scope, string id) : base(scope, id)
+    {
+        UrlsTable = new Table(this, "UrlsTable", new TableProps
+        {
+            TableName = "Urls",
+            PartitionKey = new Attribute { Name = "Slug", Type = AttributeType.STRING },
+            BillingMode = BillingMode.PAY_PER_REQUEST,
+        });
+
+        QrBucket = new Bucket(this, "QrBucket", new BucketProps
+        {
+            BucketName = "qr-bucket",
+        });
+    }
+}