BccCode.Notifications.Client 3.0.1

BCC Notifications .NET Client

A clean and simple .NET client for the BCC Notifications API

🚀 Key Features

• Platform-First Architecture: Built on BccCode.Platform.Apis and BccCode.Platform.Auth
• Scope-Based Authentication: Automatic OAuth token management with proper scopes
• Full Feature Support: Email (with attachments), SMS, and In-App notifications

📦 Installation

dotnet add package BccCode.Notifications.Client

⚡ Setup

// Standard BCC Platform chain
builder.Services.AddBccPlatform(AppEnvironment.Sandbox, clientId, clientSecret)
 .AddBccCoreApiClient(/* scopes */)
 .AddBccPubSub()
 .AddBccNotifications(); // ← Works exactly the same way

That's it! No configuration options, no overloads, just one simple method.

🔧 Usage

public class EmailService
{
 private readonly INotificationClient _notificationClient;

 public EmailService(INotificationClient notificationClient)
 {
 _notificationClient = notificationClient;
 }

 public async Task SendWelcomeEmail(Guid personUid)
 {
 var payload = new EmailPayload
 {
 PersonUid = personUid,
 NotificationPayload = new List<EmailContent>
 {
 new()
 {
 Language = "en-US",
 Subject = "Welcome!",
 Title = "Welcome to our service!",
 Content = "<h1>Hello [firstName]!</h1><p>Welcome to our service!</p>",
 ShowFooter = true // Optional: control footer visibility (default: true)
 }
 }
 };

 var response = await _notificationClient.SendEmailAsync(payload);
 Console.WriteLine($"Email queued with ID: {response.Id}");
 }
}

⚠️ Error Handling

The client provides clear, actionable error messages:

InvalidOperationException: Could not instantiate NotificationClient due to missing credentials.
Call AddBccPlatform(...) in startup to add BCC platform credentials.

🔧 Dependency Graph

BccCode.Notifications.Client v2.2.0
├── BccCode.Platform.Apis (authentication, HTTP management)
├── BccCode.Platform.Config (environment configuration)
└── Microsoft.Extensions.Http (HTTP client factory)

📄 API Reference

Email Notifications

Task<NotificationResponse> SendEmailAsync(EmailPayload payload, bool dryRun = false, CancellationToken cancellationToken = default)

SMS Notifications

Task<NotificationResponse> SendSmsAsync(SmsPayload payload, bool dryRun = false, CancellationToken cancellationToken = default)

Native Push Notifications

Task<NotificationResponse> SendNativePushAsync(NativePushPayload payload, bool dryRun = false, CancellationToken cancellationToken = default)

In-App Notifications

Task<NotificationResponse> SendInAppAsync(InAppPayload payload, bool dryRun = false, CancellationToken cancellationToken = default)

🚀 Quick Start

1. Install the package with dotnet add package BccCode.Notifications.Client
2. Configure BCC Platform (if not already done)
3. Add Notifications with .AddBccNotifications() - no parameters needed!
4. Inject and use INotificationClient