server/util/Seeder/Recipes/IndividualUserRecipe.cs

using Bit.Seeder.Models;
using Bit.Seeder.Options;
using Bit.Seeder.Pipeline;

namespace Bit.Seeder.Recipes;

/// <summary>
/// Seeds a standalone individual user from an embedded preset or programmatic options.
/// </summary>
/// <remarks>
/// Thin facade over the internal Pipeline architecture (RecipeOrchestrator).
/// All orchestration logic is encapsulated within the Pipeline, keeping this Recipe simple.
/// The CLI remains "dumb" - it creates this recipe and calls Seed().
/// </remarks>
public class IndividualUserRecipe(SeederDependencies deps)
{
    private readonly RecipeOrchestrator _orchestrator = new(deps);

    /// <summary>
    /// Seeds an individual user from an embedded preset.
    /// </summary>
    /// <param name="presetName">Name of the embedded preset (e.g., "individual.free")</param>
    /// <param name="password">Optional password for the seeded account</param>
    /// <param name="kdfIterations">Optional KDF iteration count override</param>
    /// <returns>The user ID and summary statistics.</returns>
    public UserSeedResult Seed(string presetName,
        string? password = null, int? kdfIterations = null)
    {
        var result = _orchestrator.Execute(presetName, password, kdfIterations);

        if (result.UserId is null)
        {
            throw new InvalidOperationException(
                $"Preset '{presetName}' is not an individual user preset. Use OrganizationRecipe instead.");
        }

        return UserSeedResult.From(result);
    }

    /// <summary>
    /// Seeds an individual user from programmatic options (CLI arguments).
    /// </summary>
    /// <param name="options">Options specifying what to seed.</param>
    /// <returns>The user ID and summary statistics.</returns>
    public UserSeedResult Seed(IndividualUserOptions options)
    {
        var result = _orchestrator.Execute(options);
        return UserSeedResult.From(result);
    }
}