bitwarden-server/util/EfShared/MigrationBuilderExtensions.cs

using System.Runtime.CompilerServices;
using Bit.Core.Utilities;
using Microsoft.EntityFrameworkCore.Migrations;

namespace Bit;

// This file is a manual addition to a project that it helps, a project that chooses to compile it
// should have a projet reference to Core.csproj and a package reference to Microsoft.EntityFrameworkCore.Design
// The reason for this is that if it belonged to it's own library you would have to add manual references to the above
// and manage the version for the EntityFrameworkCore package. This way it also doesn't create another dll
// To include this you can view examples in the MySqlMigrations and PostgresMigrations .csproj files. 
// <Compile Include="..\EfShared\MigrationBuilderExtensions.cs" />

public static class MigrationBuilderExtensions
{
    /// <summary>
    /// Reads an embedded resource for it's SQL contents and formats it with the specified direction for easier custom migration steps
    /// </summary>
    /// <param name="migrationBuilder">The MigrationBuilder instance the sql should be applied to</param>
    /// <param name="resourceName">The file name portion of the resource name, it is assumed to be in a Scripts folder</param>
    /// <param name="dir">The direction of the migration taking place</param>
    public static void SqlResource(this MigrationBuilder migrationBuilder, string resourceName, [CallerMemberName] string dir = null)
    {
        var formattedResourceName = string.IsNullOrEmpty(dir) ? resourceName : string.Format(resourceName, dir);

        migrationBuilder.Sql(CoreHelpers.GetEmbeddedResourceContentsAsync(
            $"Scripts.{formattedResourceName}"));
    }
}