Develop/feature/td 5930 blazor implementation integration lh

.gitignore

@@ -56,3 +56,10 @@ obj
 /AdminUI/LearningHub.Nhs.AdminUI/web.config
 /LearningHub.Nhs.WebUI/web.config
 /WebAPI/LearningHub.Nhs.API/web.config
+/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
+/nuget.config

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
+    {
+
+    }
+}

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

@@ -0,0 +1,22 @@
+namespace LearningHub.Nhs.Shared.Interfaces.Http
+{
+    /// <summary>
+    /// Marker interface for the User API HttpClient.
+    ///
+    /// <para>
+    /// Inherits from <see cref="IAPIHttpClient"/> to enable
+    /// dependency injection of a specific implementation configured with
+    /// a user-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 IUserApiHttpClient : IAPIHttpClient
+    {
+
+    }
+}

LearningHub.Nhs.Shared/LearningHub.Nhs.Shared.csproj

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+	<ItemGroup>
+	  <Folder Include="Models\Contribute\" />
+	  <Folder Include="Models\Paging\" />
+	</ItemGroup>
+
+</Project>
+
+

LearningHub.Nhs.Shared/Models/gitIncludeFolderStructureForFuture.txt

@@ -0,0 +1 @@
+

LearningHub.Nhs.Shared/Services/gitIncludeFolderStructureForFuture.txt

@@ -0,0 +1 @@
+

LearningHub.Nhs.WebUI.BlazorClient/DI/DI.cs

@@ -0,0 +1,30 @@
+using Microsoft.Extensions.Options;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Collections.Generic;
+using LearningHub.Nhs.Shared.Configuration;
+
+
+namespace LearningHub.Nhs.WebUI.BlazorClient.DI
+{
+    public static class DI
+    {
+        public static IHttpClientBuilder AddBffHttpClient<TInterface, TImplementation>(this IServiceCollection services, Func<ExposableSettings, string> getApiUrl)
+        where TInterface : class
+        where TImplementation : class, TInterface
+        {
+            return services.AddHttpClient<TInterface, TImplementation>((serviceProvider, client) =>
+            {
+                var ExposableSettings = serviceProvider.GetRequiredService<IOptions<ExposableSettings>>().Value;
+                var apiUrl = getApiUrl(ExposableSettings);
+                var apiUri = new Uri(apiUrl);
+                var apiHost = apiUri.Host;
+                string forwardSlash = "/";
+                // Using the Uri class for robust path joining
+                client.BaseAddress = new Uri($"{ExposableSettings.LearningHubApiBFFUrl}{apiHost}{forwardSlash}");
+            });
+        }
+    }
+}

LearningHub.Nhs.WebUI.BlazorClient/LearningHub.Nhs.WebUI.BlazorClient.csproj

@@ -0,0 +1,44 @@
+<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
+
+	<PropertyGroup>
+		<TargetFramework>net8.0</TargetFramework>
+		<Nullable>enable</Nullable>
+		<ImplicitUsings>enable</ImplicitUsings>
+	</PropertyGroup>
+	<!-- Debug settings only for development -->
+	<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
+		<BlazorWebAssemblyEnableDebugging>true</BlazorWebAssemblyEnableDebugging>
+		<DebugType>full</DebugType>
+	</PropertyGroup>
+
+	<ItemGroup>
+		<PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="8.0.8" />
+
+		<!--Configuration http -->
+		<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="8.0.0" />
+		<PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="8.0.0" />
+
+		<!-- Logging -->
+		<PackageReference Include="Serilog" Version="4.2.0" />
+		<PackageReference Include="Serilog.Extensions.Logging" Version="8.0.0" />
+		<PackageReference Include="Serilog.Formatting.Compact" Version="3.0.0" />
+		<PackageReference Include="Serilog.Settings.Configuration" Version="8.0.0" />
+		<PackageReference Include="Serilog.Sinks.BrowserConsole" Version="8.0.0" />
+		<PackageReference Include="Serilog.Sinks.Http" Version="8.0.0" />
+
+		<!-- Utilities -->
+		<PackageReference Include="Blazored.LocalStorage" Version="4.5.0" />
+		<PackageReference Include="Microsoft.Extensions.Http" Version="8.0.1" />
+		<PackageReference Include="TELBlazor.Components" Version="1.10.0" />
+	</ItemGroup>
+
+	<ItemGroup>
+		<Folder Include="Properties\" />
+	</ItemGroup>
+
+	<ItemGroup>
+	  <ProjectReference Include="..\LearningHub.Nhs.Shared\LearningHub.Nhs.Shared.csproj" />
+	  <ProjectReference Include="..\LearningHub.Nhs.WebUI.Shared\LearningHub.Nhs.WebUI.Shared.csproj" />
+	</ItemGroup>
+</Project>
+