From 1d406a91847432da20d6bb4813c50f971fa6efeb Mon Sep 17 00:00:00 2001
From: Hermes Agent <hermes@litecharms.co.za>
Date: Sun, 30 Aug 2026 15:57:50 +0200
Subject: [PATCH] Implemented GetApplicantInviteEndpoint

---
 .../GetApplicantInviteEndpoint.cs             | 33 +++++++++++++++++++
 .../Communications/CommunicationsService.cs   | 18 ++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 PostFundManagement.Api/Endpoints/Communications/GetApplicantInviteEndpoint.cs

diff --git a/PostFundManagement.Api/Endpoints/Communications/GetApplicantInviteEndpoint.cs b/PostFundManagement.Api/Endpoints/Communications/GetApplicantInviteEndpoint.cs
new file mode 100644
index 0000000..132709e
--- /dev/null
+++ b/PostFundManagement.Api/Endpoints/Communications/GetApplicantInviteEndpoint.cs
@@ -0,0 +1,33 @@
+using PostFundManagement.Application.Extensions;
+using PostFundManagement.Application.Services.Communications;
+using PostFundManagement.Domain.Abstractions;
+using PostFundManagement.Domain.Extensions;
+using PostFundManagement.Domain.Models;
+using PostFundManagement.Domain.Security;
+
+namespace PostFundManagement.Api.Endpoints.Communications;
+
+[ApiVersionTarget(1)]
+public sealed class GetApplicantInviteEndpoint : IEndpoint
+{
+    public void Map(IEndpointRouteBuilder builder)
+    {
+        builder.MapGet("api/communications/invites/applicant/{userId:Guid}", async (Guid userId, CommunicationsService service,
+            HttpContext context, CancellationToken cancellationToken = default) =>
+        {
+            var result = await service.GetApplicantInviteAsync(userId, cancellationToken);
+
+            return result.IsSuccess
+                ? Results.Ok(result.Value)
+                : Results.NotFound();
+        })
+        .WithDescription("Gets an applicant's invite")
+        .WithName(typeof(GetApplicantInviteEndpoint).ToEndpointName())
+        .MapToApiVersion(new ApiVersion(1))
+        .Produces<Invite>(StatusCodes.Status200OK)        
+        .Produces(StatusCodes.Status404NotFound)
+        .Produces(StatusCodes.Status401Unauthorized)
+        .WithTags(EndpointTags.Communications)
+        .CacheOutput();
+    }
+}
diff --git a/PostFundManagement.Application/Services/Communications/CommunicationsService.cs b/PostFundManagement.Application/Services/Communications/CommunicationsService.cs
index 960292b..1ab6761 100644
--- a/PostFundManagement.Application/Services/Communications/CommunicationsService.cs
+++ b/PostFundManagement.Application/Services/Communications/CommunicationsService.cs
@@ -67,4 +67,22 @@ public sealed class CommunicationsService(IDbContextFactory<ApplicationDbContext
             return Result.Fail(new Error(ex.Message).CausedBy(ex));
         }
     }
+
+    public async ValueTask<Result<Invite>> GetApplicantInviteAsync(Guid userId, CancellationToken cancellationToken)
+    {
+        try
+        {
+            using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
+
+            var invite = await context.Invites.AsNoTracking().FirstOrDefaultAsync(i => i.Recipient == userId, cancellationToken);
+
+            return invite is not null
+                ? Result.Ok(invite.Map())
+                : Result.Fail("Failed to find specific invite.");
+        }
+        catch (Exception ex)
+        {
+            return Result.Fail(new Error(ex.Message).CausedBy(ex));
+        }
+    }
 }