using DocumentOperator.Application.Common.DTOs; using DocumentOperator.Application.SwissQrCode.Queries; using DocumentOperator.Domain.Common.Exceptions; using MediatR; using Microsoft.AspNetCore.Mvc; namespace DocumentOperator.API.Controllers; /// /// Swiss QR Code extraction operations /// [ApiController] [Route("api/pdf/qr-code")] [Produces("application/json")] public class SwissQrCodeController(IMediator Mediator) : ControllerBase { /// /// Extracts Swiss QR Code from the last page of a PDF document (multipart/form-data) /// /// PDF file containing Swiss QR Code /// If true, returns raw QR text lines instead of parsed Bill object /// Cancellation token /// Swiss QR Code data (IBAN, amount, creditor, debtor, reference, etc.) /// Swiss QR Code extracted successfully /// Invalid PDF or file format /// No Swiss QR Code found on the last page /// Internal server error during extraction [HttpPost("extract-swiss")] [Consumes("multipart/form-data")] [ProducesResponseType(typeof(SwissQrCodeExtractionResult), StatusCodes.Status200OK)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)] public async Task ExtractFromFile( IFormFile file, [FromQuery] bool raw = false, CancellationToken cancellationToken = default) { if (file.Length == 0) return BadRequest(new ProblemDetails { Title = "Invalid file", Detail = "File is required and cannot be empty", Status = StatusCodes.Status400BadRequest }); // Use IFormFile stream directly (no intermediate byte[] conversion) using var pdfStream = file.OpenReadStream(); // Direct pass-through to MediatR var query = new ExtractSwissQrCodeQuery { PdfStream = pdfStream }; var result = await Mediator.Send(query, cancellationToken); return Ok(raw ? result.RawLines : result.Bill); } /// /// Extracts Swiss QR Code from the last page of a PDF document (Base64 JSON) /// /// Request containing Base64-encoded PDF /// If true, returns raw QR text lines instead of parsed Bill object /// Cancellation token /// Swiss QR Code data (IBAN, amount, creditor, debtor, reference, etc.) /// Swiss QR Code extracted successfully /// Invalid PDF or Base64 format /// No Swiss QR Code found on the last page /// Internal server error during extraction [HttpPost("extract-swiss")] [Consumes("application/json")] [ProducesResponseType(typeof(SwissQrCodeExtractionResult), StatusCodes.Status200OK)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)] public async Task ExtractFromBase64( [FromBody] ExtractSwissQrCodeBase64Request request, [FromQuery] bool raw = false, CancellationToken cancellationToken = default) { // Convert Base64 to stream (wrap in try-catch to throw BadRequestException) byte[] pdfBytes; try { pdfBytes = Convert.FromBase64String(request.Base64Pdf); } catch (FormatException ex) { throw new BadRequestException("Invalid Base64 format: " + ex.Message); } using var pdfStream = new MemoryStream(pdfBytes); // Direct pass-through to MediatR var query = new ExtractSwissQrCodeQuery { PdfStream = pdfStream }; var result = await Mediator.Send(query, cancellationToken); return Ok(raw ? result.RawLines : result.Bill); } } /// /// Request DTO for Base64-encoded Swiss QR Code extraction /// public record ExtractSwissQrCodeBase64Request { /// /// PDF document encoded as Base64 string /// /// JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2c... public required string Base64Pdf { get; init; } }