SSSD.Notification.Client 1.1.0

SSSD.Notification.Client

.NET client library for the SSSD Notification Platform — send push notifications, attach files, and publish documents to users of your internal application.

Internal use only. This package is published to the SSSD private NuGet feed.

Installation

dotnet add package SSSD.Notification.Client

Quick Start

1. Register in Program.cs

Bind from appsettings.json (recommended):

builder.Services.AddSssdNotifications(builder.Configuration);

"NotificationClient": {
  "BaseUrl": "https://sssdtech.com/notification",
  "ApplicationName": "Payroll System",
  "Domain": "https://erp.sssdtech.com"
}

Or configure inline:

builder.Services.AddSssdNotifications(options =>
{
    options.BaseUrl         = "https://sssdtech.com/notification";
    options.ApplicationName = "Payroll System";
    options.Domain          = "https://erp.sssdtech.com";
});

• ApplicationName must exactly match the application name registered in the Admin Panel.
• Domain is the origin of this application (scheme + hostname, no path). The server matches it against the Allowed Domains list configured on the application in the Admin Panel.
• No credentials are required — access is controlled entirely by domain allowlisting.

2. Send a Notification

public class SalaryService(INotificationClient notify)
{
    public async Task NotifySlipReady(Guid userId, string month)
    {
        await notify.SendAsync(new NotificationRequest
        {
            Title            = "Salary Slip Ready",
            Content          = $"Your salary slip for <strong>{month}</strong> is available.",
            ContentType      = NotificationContentType.Html,
            Priority         = NotificationPriority.Important,
            RecipientUserIds = [userId.ToString()],   // UUID, email, or mobile number all accepted
            IdempotencyKey   = $"salary-slip-{userId}-{month}",
        });
    }
}

3. Broadcast to All Application Users

await notify.SendAsync(new NotificationRequest
{
    Title     = "System Maintenance",
    Content   = "Scheduled downtime tonight at 10 PM.",
    SendToAll = true,
});

4. Attach a File to a Notification

var result = await notify.SendAsync(request);
await notify.AttachFileAsync(result.NotificationId, pdfStream, "slip.pdf", "application/pdf");

5. Publish a File

await notify.PublishFileAsync(stream, "policy-2025.pdf", "application/pdf",
    description: "HR Policy Handbook 2025");

// Or from a local path
await notify.PublishFileAsync(@"C:\Reports\report.xlsx",
    description: "Monthly Sales Report");

Priority Levels

Content Types

Idempotency

Pass an IdempotencyKey to prevent duplicates on retry:

IdempotencyKey = $"leave-approved-{requestId}"

If the same key is sent twice, the second call returns the original result with IsIdempotent = true.

© 2025 SSSD Tech Solutions Pvt Ltd — Internal use only.