DaprCryptographyServiceCollectionExtensions.cs

// ------------------------------------------------------------------------
//  Copyright 2025 The Dapr Authors
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//      http://www.apache.org/licenses/LICENSE-2.0
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//  ------------------------------------------------------------------------

using System.Diagnostics.CodeAnalysis;
using Dapr.Common.Extensions;
using Microsoft.Extensions.DependencyInjection;

namespace Dapr.Cryptography.Encryption.Extensions;

/// <summary>
/// Contains extension methods for using Dapr cryptography with dependency injection.
/// </summary>
[Experimental("DAPR_CRYPTOGRAPHY",
    UrlFormat = "https://docs.dapr.io/developing-applications/building-blocks/cryptography/cryptography-overview/")]
public static class DaprCryptographyServiceCollectionExtensions
{
    /// <summary>
    /// Adds Dapr encryption/decryption support to the service collection.
    /// </summary>
    /// <param name="services">The <see cref="IServiceCollection"/>.</param>
    /// <param name="configure">Optionally allows greater configuration of the <see cref="DaprEncryptionClient"/> using injected services.</param>
    /// <param name="lifetime">The lifetime of the registered services.</param>
    /// <returns></returns>
    public static IDaprCryptographyBuilder AddDaprEncryptionClient(
        this IServiceCollection services,
        Action<IServiceProvider, DaprEncryptionClientBuilder>? configure = null,
        ServiceLifetime lifetime = ServiceLifetime.Singleton)
    {
        services.AddTransient<IDecryptionStreamProcessor, DecryptionStreamProcessor>();
        services.AddTransient<IEncryptionStreamProcessor, EncryptionStreamProcessor>();
        return services
            .AddDaprClient<DaprEncryptionClient, DaprEncryptionGrpcClient, DaprCryptographyBuilder,
                DaprEncryptionClientBuilder>(configure, null, lifetime);
    }

    /// <summary>
    /// Adds Dapr encryption/decryption support to the service collection.
    /// </summary>
    /// <param name="services">The <see cref="IServiceCollection"/>.</param>
    /// <param name="configure">Optionally allows greater configuration of the <see cref="DaprEncryptionClient"/> using injected services.</param>
    /// <param name="configureHttpClient">Optionally allows greater configuration of the <see cref="HttpClient"/> used by the <see cref="DaprEncryptionClient"/>.</param>  
    /// <param name="lifetime">The lifetime of the registered services.</param>
    /// <returns></returns>
    public static IDaprCryptographyBuilder AddDaprEncryptionClient(
        this IServiceCollection services,
        Action<IServiceProvider, DaprEncryptionClientBuilder>? configure = null,
        Action<IServiceProvider, HttpClient>? configureHttpClient = null,
        ServiceLifetime lifetime = ServiceLifetime.Singleton)
    {
        services.AddTransient<IDecryptionStreamProcessor, DecryptionStreamProcessor>();
        services.AddTransient<IEncryptionStreamProcessor, EncryptionStreamProcessor>();
        return services
            .AddDaprClient<DaprEncryptionClient, DaprEncryptionGrpcClient, DaprCryptographyBuilder,
                DaprEncryptionClientBuilder>(configure, configureHttpClient, lifetime);
    }
}