mc/messengerapi.Client
1
0
Fork 0
Code Pull Requests Actions Packages Activity

Carried over contracts.
All checks were successful
Pack and Push NuGet Package / publish (push) Successful in 44s
Details

Browse Source
This commit is contained in:
masiton
2025-07-05 01:57:35 +02:00
commit 311b70cbb4
12 changed files with 787 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
code/MessengerApi.Contracts/MessengerApi.Contracts.csproj Normal file
View File

@ -0,0 +1,23 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>disable</Nullable>
<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
<PackageOutputPath>$(OutputPath)</PackageOutputPath>
<AssemblyVersion>$([System.DateTime]::UtcNow.ToString("yyyy.MM.dd.HHmm"))</AssemblyVersion>
<PackageVersion>$([System.DateTime]::UtcNow.ToString("yyyy.MM.dd.HHmm"))</PackageVersion>
<BaseOutputPath>..\out\</BaseOutputPath>
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
<Title>$(AssemblyName)</Title>
<PackageProjectUrl>https://gitea.masita.net/mc/messengerapi-tools</PackageProjectUrl>
<RepositoryUrl>https://gitea.masita.net/mc/messengerapi-tools</RepositoryUrl>
<PackageTags>logging;log;logger</PackageTags>
<PackageLicenseExpression>mit-0</PackageLicenseExpression>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="portaloggy" />
</ItemGroup>
</Project>

186
code/MessengerApi.Contracts/MessengerClient.cs Normal file
View File

@ -0,0 +1,186 @@
using portaloggy;
using System.Text;
using System.Text.Json.Nodes;
namespace MessengerApi.Contracts
{
/// <summary>
/// Exists for mocking reason. This is implemented by <see cref="MessengerClient"/>.
/// </summary>
public interface IMessengerClient
{
/// <summary>
/// Receives pending messages from the messenger API.
/// </summary>
/// <param name="credentials">Credentials to the API.</param>
IEnumerable<InboxMessage> GetMessages();
/// <summary>
/// Acknowledges message reception to the server.
/// </summary>
void AckMessage(InboxMessage message);
/// <summary>
/// Sends a message.
/// </summary>
/// <param name="credentials">Credentials to the API.</param>
void SendMessage(OutboxMessage outboxMessage);
/// <summary>
/// Returns user ids for allowed message recipients.
/// </summary>
Contact[] GetYellowPages();
}
public class MessengerClient : IMessengerClient
{
private readonly HttpClient _httpClient;
private readonly ILogger _logger;
private DateTime _lastReceivedUtc;
private Credentials _credentials;
public MessengerClient(Credentials credentials, HttpClient httpClient = null, ILogger logger = null)
{
_credentials = credentials;
_httpClient = httpClient ?? new HttpClient();
_logger = logger ?? new ConsoleLogger();
_lastReceivedUtc = DateTime.MinValue.ToUniversalTime();
}
public IEnumerable<InboxMessage> GetMessages()
{
var since = Uri.EscapeDataString(this._lastReceivedUtc.ToString("o"));
var url = $"{_credentials.ApiUrl}/receive?sinceUtc={since}";
var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", _credentials.ApiKey);
_logger.Debug($"Sending query to {url} with content {request.ToString()} to obtain messages.");
var response = _httpClient.Send(request);
if (!response.IsSuccessStatusCode)
{
_logger.Error(response.ReasonPhrase);
throw new HttpRequestException("Can't receive.", null, response.StatusCode);
}
var responseContent = response.Content
.ReadAsStringAsync()
.GetAwaiter()
.GetResult();
if (!string.IsNullOrWhiteSpace(responseContent))
{
_logger.Debug($"Received response of {responseContent}.");
}
if (string.IsNullOrWhiteSpace(responseContent))
{
return Enumerable.Empty<InboxMessage>().ToArray();
}
var json = JsonNode.Parse(responseContent);
var messages = new List<InboxMessage>();
foreach (var item in json["messages"].AsArray())
{
if (item["id"].GetValue<int>() == -1)
{
continue;
}
messages.Add(new InboxMessage
{
Id = item["id"].GetValue<Guid>(),
Payload = item["payload"].ToJsonString(),
PayloadType = item["payloadType"].ToJsonString(),
Sender = item["sender"].GetValue<Guid>(),
});
}
_lastReceivedUtc = DateTime.UtcNow.Subtract(TimeSpan.FromSeconds(10));
_logger.Debug($"Received {messages.Count} messages and last check timestamp is set to {_lastReceivedUtc.ToString("s")}.");
return messages.ToArray();
}
public void SendMessage(OutboxMessage outboxMessage)
{
var body = new JsonObject();
if(outboxMessage.ToUserId.HasValue)
{
body.Add("toUserId", JsonValue.Create<Guid>(outboxMessage.ToUserId.Value));
}
if(outboxMessage.Payload != null)
{
body.Add("payload", JsonValue.Create<string>(outboxMessage.Payload));
}
if(outboxMessage.PayloadType != null)
{
body.Add("payloadType", JsonValue.Create<string>(outboxMessage.PayloadType));
}
if(outboxMessage.LifespanInSeconds != null)
{
body.Add("lifespanInSeconds", JsonValue.Create<int>(outboxMessage.LifespanInSeconds.Value));
}
var content = new StringContent(body.ToString(), Encoding.UTF8, "application/json");
var url = $"{_credentials.ApiUrl}/send";
var request = new HttpRequestMessage(HttpMethod.Post, url);
request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", _credentials.ApiKey);
_logger.Debug($"Sending query to {url} with content {body.ToString()} to obtain messages.");
var response = _httpClient.Send(request);
if (!response.IsSuccessStatusCode)
{
_logger.Error(response.ReasonPhrase);
throw new HttpRequestException("Can't send.", null, response.StatusCode);
}
}
public Contact[] GetYellowPages()
{
var url = $"{_credentials.ApiUrl}/yellowpages";
var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", _credentials.ApiKey);
_logger.Debug($"Sending query to {url} with content {request.ToString()}.");
var response = _httpClient.Send(request);
if (!response.IsSuccessStatusCode)
{
_logger.Error(response.ReasonPhrase);
throw new HttpRequestException("Can't receive.", null, response.StatusCode);
}
var responseContent = response.Content
.ReadAsStringAsync()
.GetAwaiter()
.GetResult();
var json = JsonNode.Parse(responseContent);
var contacts = json["users"].AsArray().Select(x => new Contact
{
Id = x["id"].GetValue<Guid>(),
Name = x["name"].GetValue<string>()
}).ToArray();
return contacts;
}
public void AckMessage(InboxMessage message)
{
}
}
}

9
code/MessengerApi.Contracts/Model/Contact.cs Normal file
View File

@ -0,0 +1,9 @@
namespace MessengerApi.Contracts
{
public class Contact
{
public Guid Id { get; set; }
public string Name { get; set; }
}
}

15
code/MessengerApi.Contracts/Model/Credentials.cs Normal file
View File

@ -0,0 +1,15 @@
namespace MessengerApi.Contracts
{
public class Credentials
{
public string ApiKey { get; private set; }
public string ApiUrl { get; private set; }
public Credentials(string apiKey, string apiUrl)
{
ApiKey = apiKey;
ApiUrl = apiUrl;
}
}
}

16
code/MessengerApi.Contracts/Model/Messages/InboxMessage.cs Normal file
View File

@ -0,0 +1,16 @@
namespace MessengerApi.Contracts
{
/// <summary>
/// Message when received is inbox. For server apps, this is request-type of message. For clients, this is a response-type of message.
/// </summary>
public class InboxMessage
{
public Guid Id { get; set; }
public Guid Sender { get; set; }
public string PayloadType { get; set; }
public string Payload { get; set; }
}
}

16
code/MessengerApi.Contracts/Model/Messages/OutboxMessage.cs Normal file
View File

@ -0,0 +1,16 @@
namespace MessengerApi.Contracts
{
/// <summary>
/// Outbox type of message. A server-app will treat this as a response. A client app will treat this as a request.
/// </summary>
public class OutboxMessage
{
public Guid? ToUserId { get; set; }
public string PayloadType { get; set; }
public string Payload { get; set; }
public int? LifespanInSeconds { get; set; }
}
}

50
code/MessengerApi.Tools.sln Normal file
View File

@ -0,0 +1,50 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.11.35312.102
MinimumVisualStudioVersion = 10.0.40219.1
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MessengerApi.Contracts", "MessengerApi.Contracts\MessengerApi.Contracts.csproj", "{833ED77F-A4E9-4FB3-BB84-4E55898B726A}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MessengerApi.SubscriptionClient", "MessengerApi.SubscriptionClient\MessengerApi.SubscriptionClient.csproj", "{127D24B0-47F3-40E9-9136-899AFF206F19}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MessengerApi.QueryClient", "MessengerApi.QueryClient\MessengerApi.QueryClient.csproj", "{6441673B-2621-4E2C-A9A0-971E83C3F80A}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8EC462FD-D22E-90A8-E5CE-7E832BA40C5D}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "workflows", "workflows", "{02EA681E-C7D8-13C7-8484-4AC65E1B71E8}"
ProjectSection(SolutionItems) = preProject
..\.gitea\workflows\publish-nuget.yml = ..\.gitea\workflows\publish-nuget.yml
EndProjectSection
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".gitea", ".gitea", "{C3305381-7A52-4E26-9527-1697692DDD5A}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{833ED77F-A4E9-4FB3-BB84-4E55898B726A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{833ED77F-A4E9-4FB3-BB84-4E55898B726A}.Debug|Any CPU.Build.0 = Debug|Any CPU
{833ED77F-A4E9-4FB3-BB84-4E55898B726A}.Release|Any CPU.ActiveCfg = Release|Any CPU
{833ED77F-A4E9-4FB3-BB84-4E55898B726A}.Release|Any CPU.Build.0 = Release|Any CPU
{127D24B0-47F3-40E9-9136-899AFF206F19}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{127D24B0-47F3-40E9-9136-899AFF206F19}.Debug|Any CPU.Build.0 = Debug|Any CPU
{127D24B0-47F3-40E9-9136-899AFF206F19}.Release|Any CPU.ActiveCfg = Release|Any CPU
{127D24B0-47F3-40E9-9136-899AFF206F19}.Release|Any CPU.Build.0 = Release|Any CPU
{6441673B-2621-4E2C-A9A0-971E83C3F80A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{6441673B-2621-4E2C-A9A0-971E83C3F80A}.Debug|Any CPU.Build.0 = Debug|Any CPU
{6441673B-2621-4E2C-A9A0-971E83C3F80A}.Release|Any CPU.ActiveCfg = Release|Any CPU
{6441673B-2621-4E2C-A9A0-971E83C3F80A}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(NestedProjects) = preSolution
{02EA681E-C7D8-13C7-8484-4AC65E1B71E8} = {C3305381-7A52-4E26-9527-1697692DDD5A}
{C3305381-7A52-4E26-9527-1697692DDD5A} = {8EC462FD-D22E-90A8-E5CE-7E832BA40C5D}
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {61948E36-4C2B-4BC9-80B6-9E155CE9F7DE}
EndGlobalSection
EndGlobal