Indice.Services 8.60.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/"
  }
}

WeMail:

{
  "Email": {
    "Provider": "WeMail"
  },
  "WeMail": {
    "Sender": "noreply@example.com",
    "SenderName": "MyApp",
    "ApiKey": "<api-key>"
  }
}

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"
  }
}

🔗 Webhooks

Webhook services can be registered independently of SMS services, allowing webhook handling for SMS providers or other integrations.

Register webhook services directly:

services.AddWebhookServices<YourWebhookHandler, YourWebhookHttpHandler>(configuration);

For SMS provider-specific webhooks:

services.AddSmsWebhooks<YourWebhookHandler>(configuration);

Configuration:

{
  "WebhookSettings": {
    "Enabled": true,
    "ChannelCapacity": 100
  }
}

• Enabled: Enables or disables webhook processing. Defaults to false.
• ChannelCapacity: Maximum number of pending webhook batches. Must be greater than zero when enabled.

Events are processed asynchronously by the hosted WebhookEventSink. When webhooks are disabled, webhook services are not registered.

Currently supported SMS providers: apifon.

Don't forget to also register Webhook endpoints for accepting and processing events:

app.MapWebhooks();

🔔 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