rustore.push.maui.server 1.0.0

Rustore.Push.Server

Russian version

Server-side .NET library (NuGet package) for sending push notifications via the RuStore Universal Push API. Supports all four providers in a single request: RuStore, FCM, APNS, HMS.

• Idiomatic DI registration on top of IHttpClientFactory.
• Multi-provider fan-out in one call.
• Low-level "raw" API + ergonomic high-level overloads.
• Replaceable IRustoreCredentialsProvider (Vault, Secrets Manager, multi-tenant).
• Mandatory client-side 4 KB payload check.
• Typed exception hierarchy (VALIDATION_ERROR / PROVIDER_ERROR / network / 5xx).
• IOptionsMonitor-based hot-reload of options.

Install

dotnet add package Rustore.Push.Server

Quick Start

using Rustore.Push.Server.Abstractions;
using Rustore.Push.Server.Configuration;
using Rustore.Push.Server.DependencyInjection;
using Rustore.Push.Server.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRustorePush(o =>
{
    o.Rustore = new RustoreProviderOptions
    {
        AuthToken = "AAAbbbCC123",
        ProjectId = "aabbcc",
    };
});

var app = builder.Build();

app.MapPost("/notify", async (IRustorePushClient push, CancellationToken ct) =>
{
    await push.SendAsync(
        RustoreProvider.Rustore,
        new[] { "device-token-1" },
        new RustoreNotification("Title", "Body"),
        ct);
    return Results.Ok();
});

app.Run();

Multi-provider send

var tokens = new Dictionary<RustoreProvider, IReadOnlyCollection<string>>
{
    [RustoreProvider.Rustore] = new[] { "rustore-token-1" },
    [RustoreProvider.Fcm]     = new[] { "fcm-token-1", "fcm-token-2" },
};

await push.SendAsync(
    new[] { RustoreProvider.Rustore, RustoreProvider.Fcm },
    tokens,
    new RustoreMessage(
        new RustoreNotification("Hi", "Hello from RuStore"),
        Data: new Dictionary<string, string> { ["deep_link"] = "/orders/42" }));

Or use SendToAllAsync to take the provider set straight from the tokens dictionary:

await push.SendToAllAsync(tokens, new RustoreMessage(new RustoreNotification("Hi", "Hello")));

Custom credentials provider

If your secrets live in Vault / AWS Secrets Manager / a tenant database, implement IRustoreCredentialsProvider:

public sealed class VaultCredentialsProvider : IRustoreCredentialsProvider
{
    private readonly IVaultClient _vault;
    public VaultCredentialsProvider(IVaultClient vault) => _vault = vault;

    public async Task<RustoreProviderCredentials?> GetCredentialsAsync(
        RustoreProvider provider, CancellationToken ct = default)
    {
        var secret = await _vault.ReadAsync($"push/{provider}", ct);
        return secret is null
            ? null
            : new RustoreProviderCredentials(secret.AuthToken, secret.ProjectId);
    }
}

builder.Services
    .AddRustorePush(_ => { })
    .AddCredentialsProvider<VaultCredentialsProvider>();

The default OptionsRustoreCredentialsProvider reads from RustorePushOptions via IOptionsMonitor, so changes to appsettings.json are picked up without restart.

Low-level API

For full control over the request (e.g. multi-tenant with credentials computed on the fly), use the overload that accepts RustoreUniversalPushRequest. In this mode IRustoreCredentialsProvider is not consulted:

var request = new RustoreUniversalPushRequest(
    new RustoreProviders(Rustore: new RustoreProviderAuth("AUTH", "PROJ")),
    new RustoreTokens(Rustore: new[] { "token" }),
    new RustoreMessage(new RustoreNotification("t", "b")));

await push.SendAsync(request);

Message models

Error handling

All inherit from RustorePushException and carry HttpStatus, Status, Code, Errors[], and RawResponse.

4 KB limit

The API rejects payloads larger than 4096 bytes. The client serializes JSON and verifies the size before the network call — if the limit is exceeded, RustoreMessageTooLargeException is thrown and no request is sent.

Retry

There is no built-in retry/backoff — wire Microsoft.Extensions.Http.Resilience or Polly into the named HttpClient registered by AddRustorePush.

License

MIT.