feat: Enhance response display for file downloads and add file upload functionality

- Updated responseDisplayHandler.js to handle file download responses, including UI updates for download success messages and re-download functionality.
- Added formatFileSize utility function to format file sizes in a human-readable format.
- Modified swagger.json to reflect changes in API structure, including new endpoints for article management and file operations.
- Implemented FileController in C# to handle file uploads and downloads, providing appropriate responses and error handling.

Author: jakubkozera

src/c-sharp/JakubKozera.OpenApiUi.Sample/Controllers/FileController.cs

@@ -0,0 +1,102 @@
+using Microsoft.AspNetCore.Mvc;
+using System.Text;
+
+namespace JakubKozera.OpenApiUi.Sample.Controllers;
+
+/// <summary>
+/// Controller for file operations
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Produces("application/json")]
+public class FileController : ControllerBase
+{
+    /// <summary>
+    /// Uploads a file and returns its name and size
+    /// </summary>
+    /// <param name="file">The file to upload</param>
+    /// <returns>File information including name and size</returns>
+    /// <response code="200">Returns file information</response>
+    /// <response code="400">No file provided or file is empty</response>
+    [HttpPost("upload")]
+    [ProducesResponseType<FileInfoResponse>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status400BadRequest)]
+    [Consumes("multipart/form-data")]
+    public async Task<IActionResult> UploadFile(IFormFile file)
+    {
+        if (file == null || file.Length == 0)
+        {
+            return BadRequest(new ProblemDetails
+            {
+                Title = "Invalid file",
+                Detail = "No file provided or file is empty",
+                Status = StatusCodes.Status400BadRequest
+            });
+        }
+
+        var fileInfo = new FileInfoResponse
+        {
+            FileName = file.FileName,
+            Size = file.Length,
+            ContentType = file.ContentType,
+            UploadedAt = DateTime.UtcNow
+        };
+
+        return Ok(fileInfo);
+    }
+
+    /// <summary>
+    /// Downloads a sample text file
+    /// </summary>
+    /// <param name="fileName">Optional custom filename for the downloaded file</param>
+    /// <returns>A sample text file</returns>
+    /// <response code="200">Returns the text file</response>
+    [HttpGet("download")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [Produces("text/plain", "application/octet-stream")]
+    public IActionResult DownloadFile([FromQuery] string? fileName = null)
+    {
+        // Create sample content in memory
+        var content = $@"Sample Text File
+Generated on: {DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC
+
+This is a sample text file created in memory by the API.
+It contains some basic information and sample data.
+
+Random GUID: {Guid.NewGuid()}
+Server Time: {DateTime.Now:F}
+
+Thank you for using our file download API!";
+
+        var bytes = Encoding.UTF8.GetBytes(content);
+        var defaultFileName = fileName ?? $"sample-file-{DateTime.UtcNow:yyyyMMdd-HHmmss}.txt";
+
+        return File(bytes, "text/plain", defaultFileName);
+    }
+}
+
+/// <summary>
+/// Response model for file upload information
+/// </summary>
+public class FileInfoResponse
+{
+    /// <summary>
+    /// Original filename of the uploaded file
+    /// </summary>
+    public string FileName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Size of the file in bytes
+    /// </summary>
+    public long Size { get; set; }
+
+    /// <summary>
+    /// Content type of the uploaded file
+    /// </summary>
+    public string? ContentType { get; set; }
+
+    /// <summary>
+    /// Timestamp when the file was uploaded
+    /// </summary>
+    public DateTime UploadedAt { get; set; }
+}

src/c-sharp/JakubKozera.OpenApiUi.Sample/JakubKozera.OpenApiUi.Sample.csproj

@@ -6,7 +6,7 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);1591</NoWarn>
   </PropertyGroup>  <ItemGroup>
-    <PackageReference Include="JakubKozera.OpenApiUi" Version="1.0.12" />
+    <PackageReference Include="JakubKozera.OpenApiUi" Version="1.0.14" />
     <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="9.0.5" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="8.1.4" />
     <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.12.0" />

src/c-sharp/JakubKozera.OpenApiUi.Sample/Program.cs

@@ -85,7 +85,7 @@
 {
     options.AddPolicy("GitHubPages", policy =>
     {
-        policy.WithOrigins("https://jakubkozera.github.io")
+        policy.WithOrigins("https://jakubkozera.github.io", "http://localhost:5501")
               .AllowAnyMethod()
               .AllowAnyHeader()
               .AllowCredentials();

src/c-sharp/JakubKozera.OpenApiUi.Sample/sample-requests.http

@@ -114,3 +114,23 @@ Content-Type: application/json
   "tags": ["fail"],
   "isPublished": true
 }
+
+### File Operations
+
+### 17. Upload a file
+POST {{baseUrl}}/api/file/upload
+Content-Type: multipart/form-data; boundary=boundary
+
+--boundary
+Content-Disposition: form-data; name="file"; filename="test.txt"
+Content-Type: text/plain
+
+This is a test file content.
+You can replace this with any file content.
+--boundary--
+
+### 18. Download a sample text file
+GET {{baseUrl}}/api/file/download
+
+### 19. Download a sample text file with custom filename
+GET {{baseUrl}}/api/file/download?fileName=my-custom-file.txt

src/c-sharp/JakubKozera.OpenApiUi/JakubKozera.OpenApiUi.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <TargetFrameworks>net6.0;net8.0;net9.0</TargetFrameworks>
     <PackageId>JakubKozera.OpenApiUi</PackageId>
-    <Version>1.0.12</Version>
+    <Version>1.0.14</Version>
     <Authors>Jakub Kozera</Authors>
     <Description>A .NET library serving OpenAPI UI with HTML/CSS</Description>
     <PackageTags>openapi;ui;html;css;dotnet</PackageTags>

src/c-sharp/JakubKozera.OpenApiUi/scripts/local-pack.ps1

@@ -5,10 +5,35 @@ $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $projectDir = Split-Path -Parent $scriptDir
 $distDir = Join-Path (Split-Path -Parent (Split-Path -Parent $projectDir)) "core\dist"
 $contentDir = Join-Path $projectDir "Content"
+$buildScriptPath = Join-Path (Split-Path -Parent (Split-Path -Parent $projectDir)) "core\build.js"
 
 Write-Host "Project directory: $projectDir" -ForegroundColor Green
 Write-Host "Dist directory: $distDir" -ForegroundColor Green
 Write-Host "Content directory: $contentDir" -ForegroundColor Green
+Write-Host "Build script path: $buildScriptPath" -ForegroundColor Green
+
+# First, run the build script to generate the dist files
+Write-Host "`nRunning build script..." -ForegroundColor Yellow
+if (-not (Test-Path $buildScriptPath)) {
+    Write-Error "Build script not found: $buildScriptPath"
+    exit 1
+}
+
+try {
+    Set-Location (Split-Path -Parent $buildScriptPath)
+    node build.js
+    
+    if ($LASTEXITCODE -ne 0) {
+        throw "Build script failed"
+    }
+    
+    Write-Host "Build script completed successfully!" -ForegroundColor Green
+    Set-Location $scriptDir
+}
+catch {
+    Write-Error "Error running build script: $($_.Exception.Message)"
+    exit 1
+}
 
 # Check if dist directory exists
 if (-not (Test-Path $distDir)) {
@@ -93,7 +118,8 @@ try {
         }
     }
 
-} catch {
+}
+catch {
     Write-Error "Error during build/pack process: $($_.Exception.Message)"
     exit 1
 }

src/core/demo-dist/bundle.css

@@ -10,6 +10,10 @@
 html {
   scroll-behavior: smooth;
 }
+body {
+  padding: 0 !important;
+}
+
 
 /* Make code samples scrollable horizontally */
 pre {