Merge branch 'Develop/Feature/TD-5930-Blazor-Implementation-Integration-LH' into Develop/Feature/TD-6114-Nuget-CICD

Author: Phil-NHS

.gitignore

@@ -61,4 +61,11 @@ obj
 /LearningHub.Nhs.WebUI.BlazorClient/LearningHub.Nhs.WebUI.BlazorClient.csproj.user
 /LearningHub.Nhs.WebUI.BlazorClient/wwwroot/appsettings.Development.json
 /LearningHub.Nhs.WebUI.BlazorClient/Properties/launchSettings.json
+/LearningHub.Nhs.WebUI/nuget.config
+/LearningHub.Nhs.WebUI.BlazorClient/Properties/launchSettings.json
+/LearningHub.Nhs.WebUI.BlazorClient/wwwroot/appsettings.json
+/LearningHub.Nhs.WebUI.BlazorClient/wwwroot/appsettings.Development.json
+/LearningHub.Nhs.WebUI.BlazorClient/nuget.config
+/LearningHub.Nhs.WebUI.BlazorClient/LearningHub.Nhs.WebUI.BlazorClient.csproj.user
+/LearningHub.Nhs.WebUI.slnLaunch.user
 /.github/workflows/test.yml

AdminUI/LearningHub.Nhs.AdminUI/LearningHub.Nhs.AdminUI.csproj

@@ -83,7 +83,7 @@
 		<PackageReference Include="Azure.Storage.Blobs" Version="12.23.0" />
 		<PackageReference Include="Azure.Storage.Files.Shares" Version="12.8.0" />
 		<PackageReference Include="BuildWebCompiler" Version="1.12.405" />
-		<PackageReference Include="elfhHub.Nhs.Models" Version="3.0.9" />
+		<PackageReference Include="elfhHub.Nhs.Models" Version="3.0.8" />
 		<PackageReference Include="FluentValidation" Version="11.11.0" />
 		<PackageReference Include="FluentValidation.AspNetCore" Version="11.3.0" />
 		<PackageReference Include="HtmlSanitizer" Version="6.0.453" />

LearningHub.Nhs.Shared/Configuration/ExposableFindwiseSettings.cs

@@ -0,0 +1,29 @@
+namespace LearningHub.Nhs.Shared.Configuration
+{
+    using LearningHub.Nhs.Shared.Interfaces.Configuration;
+    /// <summary>
+    /// Represents a public-facing set of configuration values for Findwise search,
+    /// intended to be safely exposed to client-side applications or public APIs.
+    /// 
+    /// <para>
+    /// Contains only non-sensitive data such as page sizes for various search types.
+    /// </para>
+    /// </summary>
+    public class ExposableFindwiseSettings : IExposableFindwiseSettings
+    {
+        /// <summary>
+        /// Gets or sets the ResourceSearchPageSize.
+        /// </summary>
+        public int ResourceSearchPageSize { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CatalogueSearchPageSize.
+        /// </summary>
+        public int CatalogueSearchPageSize { get; set; }
+
+        /// <summary>
+        /// Gets or sets the AllCatalogueSearchPageSize.
+        /// </summary>
+        public int AllCatalogueSearchPageSize { get; set; }
+    }
+}

LearningHub.Nhs.Shared/Configuration/ExposableSettings.cs

@@ -0,0 +1,36 @@
+namespace LearningHub.Nhs.Shared.Configuration
+{
+    using LearningHub.Nhs.Shared.Interfaces.Configuration;
+    /// <summary>
+    /// Represents configuration values that are safe to expose to clientside frontend applications
+    /// (such as Blazor WebAssembly) or public-facing APIs.
+    /// 
+    /// <para>
+    /// Implements <see cref="IExposableSettings"/> and contains only non-sensitive, non-secret
+    /// values such as public API endpoints and pagination settings. This separation ensures
+    /// that secure or private configuration data is not inadvertently exposed to clients.
+    /// </para>
+    /// </summary>
+    public class ExposableSettings : IExposableSettings
+    {
+        /// <inheritdoc/>
+        public string LearningHubApiUrl { get; set; }
+
+        /// <summary>
+        /// Gets or sets the UserApiUrl.
+        /// </summary>
+        public string UserApiUrl { get; set; }
+
+        /// <summary>
+        /// Gets or sets the OpenApiUrl.
+        /// </summary>
+        public string OpenApiUrl { get; set; }
+        /// <summary>
+        /// Backend for Frontend (BFF) URL for the Learning Hub API accessed by samesite cookie and uses httpclients with bearers to access external apis.
+        /// </summary>
+        public string LearningHubApiBFFUrl { get; set; }
+        /// <inheritdoc/>
+        public IExposableFindwiseSettings FindwiseSettings { get; set; }
+        
+    }
+}

LearningHub.Nhs.Shared/Helpers/gitIncludeFolderStructureForFuture.txt

@@ -0,0 +1 @@
+

LearningHub.Nhs.Shared/Interfaces/Configuration/IExposableFindwiseSettings.cs

@@ -0,0 +1,29 @@
+namespace LearningHub.Nhs.Shared.Interfaces.Configuration
+{
+    /// <summary>
+    /// Represents configuration values related to Findwise search that are safe to expose
+    /// to client-side applications or public-facing APIs.
+    /// 
+    /// <para>
+    /// This includes non-sensitive values such as page sizes for different types of search results.
+    /// It does not contain any secure credentials or internal service configuration.
+    /// </para>
+    /// </summary>
+    public interface IExposableFindwiseSettings
+    {
+        /// <summary>
+        /// Gets or sets the page size for resource search results.
+        /// </summary>
+        public int ResourceSearchPageSize { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CatalogueSearchPageSize.
+        /// </summary>
+        public int CatalogueSearchPageSize { get; set; }
+
+        /// <summary>
+        /// Gets or sets the AllCatalogueSearchPageSize.
+        /// </summary>
+        public int AllCatalogueSearchPageSize { get; set; }
+    }
+}

LearningHub.Nhs.Shared/Interfaces/Configuration/IExposableSettings.cs

@@ -0,0 +1,42 @@
+namespace LearningHub.Nhs.Shared.Interfaces.Configuration
+{
+    /// <summary>
+    /// Defines a contract for configuration data that is non-sensitive and safe to expose publicly
+    ///
+    /// <para>
+    /// This interface exposes only data that is safe to be publicly consumed or shared,
+    /// such as API endpoint URLs or non-sensitive configuration values.
+    /// It explicitly excludes any private or sensitive information (e.g., authentication tokens,
+    /// credentials, or secret keys), which should be handled via separate interfaces or services.
+    /// </para>
+    ///
+    /// <para>
+    /// The data provided by this interface can be safely used in frontend technologies,
+    /// such as Blazor WebAssembly, JavaScript frameworks, or other client-side applications,
+    /// without risking exposure of sensitive information.
+    /// </para>
+    /// </summary>
+    public interface IExposableSettings
+    {
+        /// <summary>
+        /// Gets or sets the LearningHubApiUrl.
+        /// </summary>
+        public string LearningHubApiUrl { get; set; }
+
+        /// <summary>
+        /// Gets or sets the UserApiUrl.
+        /// </summary>
+        public string UserApiUrl { get; set; }
+
+        /// <summary>
+        /// Gets or sets the OpenApiUrl.
+        /// </summary>
+        public string OpenApiUrl { get; set; }
+        /// <summary>
+        /// Gets or sets the LearningHubApiBFFUrl used to proxy via same domain cookie to the BFF LearningHubAPI calls.
+        /// </summary>
+        public string LearningHubApiBFFUrl { get; set; }
+
+        public IExposableFindwiseSettings FindwiseSettings { get; set; }
+    }
+}

LearningHub.Nhs.Shared/Interfaces/Http/IAPIHttpClient.cs

@@ -0,0 +1,18 @@
+namespace LearningHub.Nhs.Shared.Interfaces.Http
+{
+    /// <summary>
+    /// Represents an HTTP client for a specific API.
+    /// </summary>
+    public interface IAPIHttpClient
+    {
+        /// <summary>
+        /// Gets the configured <see cref="HttpClient"/> for the API.
+        /// </summary>
+        Task<HttpClient> GetClientAsync();
+
+        /// <summary>
+        /// Gets the base URL of the API.
+        /// </summary>
+        string ApiUrl { get; }
+    }
+}

LearningHub.Nhs.Shared/Interfaces/Http/ILearningHubHttpClient.cs

@@ -0,0 +1,22 @@
+namespace LearningHub.Nhs.Shared.Interfaces.Http
+{
+    /// <summary>
+    /// Marker interface for the LearningHub API HttpClient.
+    ///
+    /// <para>
+    /// Inherits from <see cref="IAPIHttpClient"/> to enable
+    /// dependency injection of a specific implementation configured with
+    /// different API endpoints or settings specific to LH API.
+    /// </para>
+    ///
+    /// <para>
+    /// Currently, this interface is empty and used solely to differentiate implementations
+    /// that connect to different endpoints via configuration, but it may be extended in the future
+    /// with LearningHub-specific functionality or properties.
+    /// </para>
+    /// </summary>
+    public interface ILearningHubHttpClient : IAPIHttpClient
+    {
+
+    }
+}

LearningHub.Nhs.Shared/Interfaces/Http/IOpenAPIHttpClient.cs

@@ -0,0 +1,28 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace LearningHub.Nhs.Shared.Interfaces.Http
+{
+    /// <summary>
+    /// Marker interface for the IOpenAPIHttpClient API HttpClient.
+    ///
+    /// <para>
+    /// Inherits from <see cref="IAPIHttpClient"/> to enable
+    /// dependency injection of a specific implementation configured with
+    /// a openapi-related API endpoint or settings.
+    /// </para>
+    ///
+    /// <para>
+    /// This interface is currently empty and used solely to differentiate
+    /// implementations that connect to different endpoints via configuration.
+    /// It may be extended in the future with user-specific functionality or properties.
+    /// </para>
+    /// </summary>
+    public interface IOpenApiHttpClient : IAPIHttpClient
+    {
+
+    }
+}