SWA test stability (#697)

* Fixes #677

Update project references and improve app setup

- Added project reference for `CommunityToolkit.Aspire.Hosting.NodeJS.Extensions.csproj` in `CommunityToolkit.Aspire.StaticWebApps.AppHost.csproj`.
- Changed web app setup in `Program.cs` from `.AddNpmApp` to `.AddViteApp` with `.WithNpmPackageInstallation()`.
- Modified `Port` property in `SwaResourceOptions.cs` to use a random port between 4280 and 5280.
- Updated tests in `SwaHostingComponentTests.cs` to utilize `CancellationToken` for better control over async operations.

Related Work Items: #6, #677

* reverting port change and disabling tests

* Deprecating the SWA emulator integration

Contributes to #698

* Updating readmie

* forcing the dev certs install for SWA

* Revert "forcing the dev certs install for SWA"

This reverts commit 15475a6.

* Commenting out the tests completely

This precents the test app host from actually starting up

Author: aaronpowell

docs/diagnostics.md

@@ -13,3 +13,7 @@ Once a release of .NET Aspire with that API is available, the API in the .NET As
 ## CTASPIRE002
 
 Support for loading extensions into SQLite requires either a NuGet package or folder path to the library to be provided, and as a result there is some custom logic to load the extension based on the path or NuGet package. This logic will require some experimenting to figure out edge cases, so the feature for extension loading will be kept as experimental until it is proven to be stable.
+
+## CTASPIRE003
+
+The API is marked for deprecation and will be removed in a future release.

examples/swa/CommunityToolkit.Aspire.StaticWebApps.AppHost/CommunityToolkit.Aspire.StaticWebApps.AppHost.csproj

@@ -1,5 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk">
-  <Sdk Name="Aspire.AppHost.Sdk" Version="$(AspireAppHostSdkVersion)"/>
+  <Sdk Name="Aspire.AppHost.Sdk" Version="$(AspireAppHostSdkVersion)" />
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -13,6 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
+    <ProjectReference Include="..\..\..\src\CommunityToolkit.Aspire.Hosting.NodeJS.Extensions\CommunityToolkit.Aspire.Hosting.NodeJS.Extensions.csproj" IsAspireProjectResource="false" />
     <ProjectReference Include="..\CommunityToolkit.Aspire.StaticWebApps.ApiApp\CommunityToolkit.Aspire.StaticWebApps.ApiApp.csproj" />
     <ProjectReference Include="..\..\..\src\CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps\CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps.csproj" IsAspireProjectResource="false" />
   </ItemGroup>

examples/swa/CommunityToolkit.Aspire.StaticWebApps.AppHost/Program.cs

@@ -4,13 +4,15 @@
     .WithHttpHealthCheck("/health");
 
 var web = builder
-    .AddNpmApp("web", Path.Combine(builder.AppHostDirectory, "..", "CommunityToolkit.Aspire.StaticWebApps.WebApp"), "dev")
-    .WithHttpEndpoint(env: "PORT")
+    .AddViteApp("web", Path.Combine(builder.AppHostDirectory, "..", "CommunityToolkit.Aspire.StaticWebApps.WebApp"))
+    .WithNpmPackageInstallation()
     .WithHttpHealthCheck("/");
 
+#pragma warning disable CTASPIRE003 // Type or member is obsolete
 _ = builder
     .AddSwaEmulator("swa")
     .WithAppResource(web)
     .WithApiResource(api);
+#pragma warning restore CTASPIRE003 // Type or member is obsolete
 
 builder.Build().Run();

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/README.md

@@ -1,5 +1,7 @@
 # CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps library
 
+**Deprecation warning**: This library is deprecated and will be removed in a future release, refer to https://github.com/CommunityToolkit/Aspire/issues/698 for more information.
+
 Provides extensions methods and resource definitions for the .NET Aspire AppHost to support running Azure Static Web Apps locally using the emulator using the [Azure Static Web App CLI](https://learn.microsoft.com/azure/static-web-apps/local-development).
 
 ## Getting Started

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/SwaApiEndpointAnnotation.cs

@@ -4,6 +4,11 @@ namespace Aspire.Hosting.ApplicationModel;
 /// Represents an annotation for an API endpoint in a Static Web App.
 /// </summary>
 /// <param name="resource">The resource builder for resources with endpoints.</param>
+[Obsolete(
+    message: "The SWA emulator integration is going to be removed in a future release.",
+    error: false,
+    DiagnosticId = "CTASPIRE003",
+    UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
 public class SwaApiEndpointAnnotation(IResourceBuilder<IResourceWithEndpoints> resource) : IResourceAnnotation
 {
     /// <summary>

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/SwaAppEndpointAnnotation.cs

@@ -7,6 +7,11 @@ namespace Aspire.Hosting.ApplicationModel;
 /// Initializes a new instance of the <see cref="SwaAppEndpointAnnotation"/> class.
 /// </remarks>
 /// <param name="resource">The resource builder for the endpoint.</param>
+[Obsolete(
+    message: "The SWA emulator integration is going to be removed in a future release.",
+    error: false,
+    DiagnosticId = "CTASPIRE003",
+    UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
 public class SwaAppEndpointAnnotation(IResourceBuilder<IResourceWithEndpoints> resource) : IResourceAnnotation
 {
     /// <summary>

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/SwaAppHostingExtension.cs

@@ -5,6 +5,11 @@ namespace Aspire.Hosting;
 /// <summary>
 /// Provides extension methods for adding and configuring Static Web Apps emulator.
 /// </summary>
+[Obsolete(
+    message: "The SWA emulator integration is going to be removed in a future release.",
+    error: false,
+    DiagnosticId = "CTASPIRE003",
+    UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
 public static class SwaAppHostingExtension
 {
     /// <summary>
@@ -14,6 +19,11 @@ public static class SwaAppHostingExtension
     /// <param name="name">The name of the resource.</param>
     /// <returns>A reference to the <see cref="IResourceBuilder{T}"/>.</returns>
     /// <remarks>This resource will not be included in the published manifest.</remarks>
+    [Obsolete(
+        message: "The SWA emulator integration is going to be removed in a future release.",
+        error: false,
+        DiagnosticId = "CTASPIRE003",
+        UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
     public static IResourceBuilder<SwaResource> AddSwaEmulator(this IDistributedApplicationBuilder builder, [ResourceName] string name) =>
         builder.AddSwaEmulator(name, new SwaResourceOptions());
 
@@ -25,6 +35,11 @@ public static IResourceBuilder<SwaResource> AddSwaEmulator(this IDistributedAppl
     /// <param name="options">The <see cref="SwaResourceOptions"/> to configure the SWA CLI.</param>"
     /// <returns>A reference to the <see cref="IResourceBuilder{T}"/>.</returns>
     /// <remarks>This resource will not be included in the published manifest.</remarks>
+    [Obsolete(
+        message: "The SWA emulator integration is going to be removed in a future release.",
+        error: false,
+        DiagnosticId = "CTASPIRE003",
+        UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
     public static IResourceBuilder<SwaResource> AddSwaEmulator(this IDistributedApplicationBuilder builder, [ResourceName] string name, SwaResourceOptions options)
     {
         var resource = new SwaResource(name, Environment.CurrentDirectory);
@@ -62,6 +77,11 @@ public static IResourceBuilder<SwaResource> AddSwaEmulator(this IDistributedAppl
     /// <param name="builder">The <see cref="IDistributedApplicationBuilder"/> to add the resource to.</param>
     /// <param name="appResource">The existing <see cref="IResourceBuilder{IResourceWithEndpoint}"/> to use as the <c>--app-devserver-url</c> argument.</param>
     /// <returns>A reference to the <see cref="IResourceBuilder{T}"/>.</returns>
+    [Obsolete(
+        message: "The SWA emulator integration is going to be removed in a future release.",
+        error: false,
+        DiagnosticId = "CTASPIRE003",
+        UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
     public static IResourceBuilder<SwaResource> WithAppResource(this IResourceBuilder<SwaResource> builder, IResourceBuilder<IResourceWithEndpoints> appResource) =>
         builder.WithAnnotation<SwaAppEndpointAnnotation>(new(appResource), ResourceAnnotationMutationBehavior.Replace).WaitFor(appResource);
 
@@ -71,6 +91,11 @@ public static IResourceBuilder<SwaResource> WithAppResource(this IResourceBuilde
     /// <param name="builder">The <see cref="IDistributedApplicationBuilder"/> to add the resource to.</param>
     /// <param name="apiResource">The existing <see cref="IResourceBuilder{IResourceWithEndpoint}"/> to use as the <c>--api-devserver-url</c> argument.</param>
     /// <returns>A reference to the <see cref="IResourceBuilder{T}"/>.</returns>
+    [Obsolete(
+        message: "The SWA emulator integration is going to be removed in a future release.",
+        error: false,
+        DiagnosticId = "CTASPIRE003",
+        UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
     public static IResourceBuilder<SwaResource> WithApiResource(this IResourceBuilder<SwaResource> builder, IResourceBuilder<IResourceWithEndpoints> apiResource) =>
         builder.WithAnnotation<SwaApiEndpointAnnotation>(new(apiResource), ResourceAnnotationMutationBehavior.Replace).WaitFor(apiResource);
 }

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/SwaResource.cs

@@ -8,6 +8,11 @@ namespace Aspire.Hosting.ApplicationModel;
 /// </remarks>
 /// <param name="name">The name of the resource.</param>
 /// <param name="workingDirectory">The working directory for the resource.</param>
+[Obsolete(
+    message: "The SWA emulator integration is going to be removed in a future release.",
+    error: false,
+    DiagnosticId = "CTASPIRE003",
+    UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
 public class SwaResource(string name, string workingDirectory) : ExecutableResource(name, "swa", workingDirectory)
 {
 }

src/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps/SwaResourceOptions.cs

@@ -3,6 +3,11 @@ namespace Aspire.Hosting;
 /// <summary>
 /// Represents the configuration options for a Static Web App resource.
 /// </summary>
+[Obsolete(
+    message: "The SWA emulator integration is going to be removed in a future release.",
+    error: false,
+    DiagnosticId = "CTASPIRE003",
+    UrlFormat = "https://github.com/CommunityToolit/aspire/issues/698")]
 public class SwaResourceOptions
 {
     /// <summary>

tests/CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps.Tests/ResourceCreationTests.cs

@@ -1,3 +1,4 @@
+#pragma warning disable CTASPIRE003
 using Aspire.Hosting;
 
 namespace CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps.Tests;