Indice.Services 8.56.0

Indice.Services

A comprehensive library of infrastructure service abstractions and implementations for .NET applications. This package provides production-ready integrations with Azure services and popular third-party providers for common application needs.

Installation

dotnet add package Indice.Services

Features

📁 File Storage

Store and retrieve files using different backing stores:

// Azure Blob Storage
services.AddFilesAzure(options => {
    options.ConnectionStringName = "StorageConnection";
    options.ContainerName = "my-container";
});

// Local file system
services.AddFilesLocal(options => {
    options.Path = "uploads";
});

🔧 Configuration (Azure Storage)

AzureClientFactory resolves the connection by ConnectionStringName (StorageConnection by default):

• First from ConnectionStrings:{ConnectionStringName} (or a direct value with the same key)
• Otherwise from managed-identity settings under {ConnectionStringName}

Standard connection string:

{
  "ConnectionStrings": {
    "StorageConnection": "DefaultEndpointsProtocol=https;AccountName=<NAME>;AccountKey=xxx;EndpointSuffix=core.windows.net"
  }
}

Managed Identity (system-assigned):

{
  "StorageConnection": {
    "accountName": "<NAME>",
    "serviceUri": "<SERVICE_URI>"
  }
}

Managed Identity (user-assigned):

{
  "StorageConnection": {
    "accountName": "<NAME>",
    "serviceUri": "<SERVICE_URI>",
    "clientId": "<CLIENT_ID>"
  }
}

For Azure Functions host, you need to provide these extra values too:

AzureWebJobsStorage__accountName = <NAME>
AzureWebJobsStorage__serviceUri = <BASE_SERVICE_URL>

For user-assigned Managed Identity, add this too:

AzureWebJobsStorage__clientId = <CLIENT_ID>

Proper RBAC roles to be assigned to the Managed Identity:

• Storage Account Contributor
• Storage Blob Data Owner
• Storage Queue Data Contributor
• Storage Queue Data Message Processor
• Storage Queue Data Message Sender
• Storage Queue Data Reader

📧 Email Services

Send emails through various providers with template rendering support:

// Auto-discover provider from configuration
services.AddEmailService(configuration);

Configuration examples (appsettings.json):

SMTP:

{
  "Email": {
    "Provider": "Smtp",
    "Sender": "noreply@example.com",
    "SenderName": "My App",
    "SmtpHost": "smtp.example.com",
    "SmtpPort": 587,
    "Username": "smtp-user",
    "Password": "smtp-password"
  }
}

SendGrid:

{
  "Email": {
    "Provider": "SendGrid"
  },
  "SendGrid": {
    "Sender": "noreply@example.com",
    "SenderName": "My App",
    "ApiKey": "<sendgrid-api-key>",
    "Api": "https://api.sendgrid.com/v3/"
  }
}

SparkPost:

{
  "Email": {
    "Provider": "SparkPost"
  },
  "SparkPost": {
    "Sender": "noreply@example.com",
    "SenderName": "My App",
    "ApiKey": "<sparkpost-api-key>",
    "Api": "https://api.eu.sparkpost.com/api/v1/"
  }
}

Brevo:

{
  "Email": {
    "Provider": "Brevo"
  },
  "Brevo": {
    "Sender": "noreply@example.com",
    "SenderName": "My App",
    "ApiKey": "<brevo-api-key>",
    "Api": "https://api.brevo.com/v3/"
  }
}

Azure Communication Services:

{
  "Email": {
    "Provider": "AzureCommunicationServices"
  },
  "AzureCommunicationServices": {
    "Sender": "DoNotReply@<your-domain>",
    "ClientId": "<app-client-id>",
    "ClientSecret": "<app-client-secret>",
    "TenantId": "<tenant-id>",
    "ResourceEndpoint": "https://<resource-name>.<region>.communication.azure.com",
    "WaitUntilCompleted": false
  }
}

📱 SMS Services

Send SMS messages through multiple gateway providers:

// Auto-discover provider(s) from Sms:Provider
services.AddSmsService(configuration);

{
  "Sms": {
    "Provider": "twilio",
    "Sender": "MyApp",
    "AccountSid": "<account-sid>",
    "AuthToken": "<auth-token>",
    "SenderPhoneNumber": "+15551234567"
  }
}

🔔 Push Notifications

Send push notifications via Azure Notification Hubs:

services.AddPushNotificationServiceAzure((sp, options) => {
    options.ConnectionString = "your-connection-string";
    options.NotificationHubPath = "your-hub-name";
});

📤 Event Dispatching

Dispatch events asynchronously using queue-based messaging:

services.AddEventDispatcherAzure(configuration);

// Raise events
await eventDispatcher.RaiseEventAsync(new OrderCreatedEvent { OrderId = orderId });

🔒 Distributed Locking

Coordinate distributed operations using lease-based locking:

services.AddLockManagerAzure(configuration);

// Acquire and use a lock
await using var lease = await lockManager.AcquireLock("my-resource", TimeSpan.FromSeconds(30));
if (lease.IsAcquired) {
    // Perform exclusive operation
}

📡 SignalR Proxy

Proxy SignalR connections through Azure SignalR Service:

services.AddSignalRProxyServices(configuration);

Configuration

Most services auto-configure from IConfiguration. Common connection string names:

Dependencies

• Azure.Storage.Blobs - Blob storage operations
• Azure.Storage.Queues - Queue storage operations
• Azure.Messaging.ServiceBus - Service Bus messaging
• MailKit - SMTP email sending
• Microsoft.Azure.NotificationHubs - Push notifications
• Microsoft.Azure.SignalR.Management - SignalR proxy

Target Frameworks

• .NET 8.0
• .NET 9.0

License

This project is licensed under the MIT License. See the LICENSE file for details.

Links

• GitHub Repository
• NuGet Package