using Bifrost.Web.Data;
using Bifrost.Web.Domain;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Diagnostics;
using Microsoft.EntityFrameworkCore.Infrastructure;
using Microsoft.EntityFrameworkCore.Migrations;
using Npgsql;
namespace Bifrost.Web.Tests;
///
/// The merge tests that need a real server run only when BIFROST_TEST_PG holds a Postgres connection string (no Database=; a role that
/// may create databases). Every other merge test runs on the in-memory provider, which enforces no unique index, transaction,
/// concurrency token or trigger, so the rules that rest on those are proven here, on a database each test creates, builds through the
/// real migrations and the class drops. See AGENTS.md (Live Postgres tests).
///
public static class PostgresGate
{
public const string Variable = "BIFROST_TEST_PG";
public static string? Skip =>
string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable(Variable))
? $"live Postgres tests: set {Variable} to a connection string without Database= (see AGENTS.md, Live Postgres tests)"
: null;
}
public sealed class PostgresFactAttribute : FactAttribute
{
public PostgresFactAttribute() => Skip = PostgresGate.Skip;
}
public sealed class PostgresTheoryAttribute : TheoryAttribute
{
public PostgresTheoryAttribute() => Skip = PostgresGate.Skip;
}
public sealed class MergePostgres : IAsyncLifetime
{
private readonly List _databases = [];
private static string? Admin => Environment.GetEnvironmentVariable(PostgresGate.Variable);
public Task InitializeAsync() => Task.CompletedTask;
/// A fresh database, built by the real migrations, and a world over it.
public async Task NewWorldAsync()
{
var name = $"bifrost_merge_{Guid.NewGuid():N}";
await using (var admin = new NpgsqlConnection(Admin))
{
await admin.OpenAsync();
await using var create = new NpgsqlCommand($"CREATE DATABASE \"{name}\"", admin);
await create.ExecuteNonQueryAsync();
}
_databases.Add(name);
var world = AccountMergeLedgerTests.World.OnPostgres(new NpgsqlConnectionStringBuilder(Admin) { Database = name }.ConnectionString);
await using var db = world.Db();
await db.Database.MigrateAsync();
return world;
}
public async Task DisposeAsync()
{
if (_databases.Count == 0)
{
return;
}
NpgsqlConnection.ClearAllPools();
await using var admin = new NpgsqlConnection(Admin);
await admin.OpenAsync();
foreach (var name in _databases)
{
await using var drop = new NpgsqlCommand($"DROP DATABASE IF EXISTS \"{name}\" WITH (FORCE)", admin);
await drop.ExecuteNonQueryAsync();
}
}
}
public sealed class AccountMergePostgresTests(MergePostgres postgres) : IClassFixture
{
private static PostgresException Pg(Exception error)
{
for (var current = error; current is not null; current = current.InnerException!)
{
if (current is PostgresException pg)
{
return pg;
}
}
throw new Xunit.Sdk.XunitException($"no PostgresException under {error.GetType().Name}");
}
/// Runs an action once, just before the first save of a context: the rival writer that lands inside a read-then-save window.
private sealed class BeforeFirstSave(Func rival) : SaveChangesInterceptor
{
private int _fired;
public override async ValueTask> SavingChangesAsync(DbContextEventData eventData, InterceptionResult result, CancellationToken cancellationToken = default)
{
if (Interlocked.Exchange(ref _fired, 1) == 0)
{
await rival();
}
return result;
}
}
/// Holds each of two contexts at its save until both have arrived, so both have read before either writes.
private sealed class Rendezvous : SaveChangesInterceptor
{
private readonly Barrier _barrier = new(2);
public override async ValueTask> SavingChangesAsync(DbContextEventData eventData, InterceptionResult result, CancellationToken cancellationToken = default)
{
await Task.Run(() => _barrier.SignalAndWait(TimeSpan.FromSeconds(30)), cancellationToken);
return result;
}
}
private static string ConnectionOf(AccountMergeLedgerTests.World world)
{
using var db = world.Db();
return db.Database.GetConnectionString()!;
}
private static async Task ExecuteAsync(AccountMergeLedgerTests.World world, string sql)
{
await using var db = world.Db();
await db.Database.ExecuteSqlRawAsync(sql);
}
// ---- commit atomicity ----
[PostgresFact]
public async Task A_commit_that_fails_midway_leaves_nothing_applied_and_the_retry_commits_once()
{
var world = await postgres.NewWorldAsync();
var survivor = await world.AccountAsync("survivor");
var folded = await world.AccountAsync("folded");
var motion = await world.MotionAsync();
await world.VoteAsync(motion, survivor, VoteChoice.For);
await world.VoteAsync(motion, folded, VoteChoice.Against);
var merge = await world.MergeAsync(survivor, folded);
await ExecuteAsync(world, """
CREATE FUNCTION fail_merged() RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN IF NEW."Status" = 'Merged' THEN RAISE EXCEPTION 'injected fault'; END IF; RETURN NEW; END $$;
CREATE TRIGGER fail_merged BEFORE UPDATE ON "Memberships" FOR EACH ROW EXECUTE FUNCTION fail_merged();
""");
var fault = await Assert.ThrowsAsync(() => world.CommitAsync(merge));
Assert.Contains("injected fault", Pg(fault).MessageText);
await using (var check = world.Db())
{
Assert.Equal(AccountMergeState.HeimdallMoved, (await check.AccountMerges.SingleAsync()).State);
Assert.Empty(check.AccountMergeEntries);
Assert.All(await check.Votes.IgnoreQueryFilters().ToListAsync(), v => Assert.Null(v.VoidedByMergeId));
Assert.Equal(MembershipStatus.Active, (await check.Memberships.SingleAsync(x => x.UserAccountId == folded.Id)).Status);
}
await ExecuteAsync(world, "DROP TRIGGER fail_merged ON \"Memberships\"");
Assert.Equal(AccountMergeState.Committed, (await world.CommitAsync(merge)).State);
var journal = await world.JournalAsync(merge);
Assert.Equal(1, journal.Count(x => x.Kind == AccountMergeEntryKind.Vote));
Assert.Equal(AccountMergeState.Committed, (await world.CommitAsync(merge)).State); // a second commit is a no-op
Assert.Equal(journal.Count, (await world.JournalAsync(merge)).Count);
}
[PostgresFact]
public async Task The_journal_refuses_a_second_entry_with_the_same_merge_and_seq()
{
var world = await postgres.NewWorldAsync();
var merge = await world.MergeAsync(await world.AccountAsync("survivor"), await world.AccountAsync("folded"));
await using var db = world.Db();
AccountMergeEntry Entry() => new() { MergeId = merge.Id, Seq = 1, Kind = AccountMergeEntryKind.Vote, Action = AccountMergeEntryAction.Voided, RecordId = Guid.NewGuid(), AtUtc = AccountMergeLedgerTests.T0 };
db.AccountMergeEntries.Add(Entry());
await db.SaveChangesAsync();
db.AccountMergeEntries.Add(Entry());
var error = await Assert.ThrowsAsync(() => db.SaveChangesAsync());
Assert.Equal(("23505", "IX_AccountMergeEntries_MergeId_Seq"), (Pg(error).SqlState, Pg(error).ConstraintName));
}
[PostgresFact]
public async Task Two_commits_of_the_same_merge_racing_apply_it_exactly_once()
{
var world = await postgres.NewWorldAsync();
var survivor = await world.AccountAsync("survivor");
var folded = await world.AccountAsync("folded");
var motion = await world.MotionAsync();
await world.VoteAsync(motion, survivor, VoteChoice.For);
await world.VoteAsync(motion, folded, VoteChoice.Against);
var merge = await world.MergeAsync(survivor, folded);
var committers = AccountMergeLedgerTests.World.OnPostgres(ConnectionOf(world), new Rendezvous());
async Task TryCommit()
{
try
{
await committers.CommitAsync(merge);
return null;
}
catch (Exception error)
{
return error;
}
}
var results = await Task.WhenAll(Task.Run(TryCommit), Task.Run(TryCommit));
Assert.Equal(1, results.Count(x => x is null));
Assert.All(results.OfType(), e => Assert.IsAssignableFrom(e)); // the loser: the unique index or the token
var journal = await world.JournalAsync(merge);
Assert.Equal(journal.Count, journal.Select(x => x.Seq).Distinct().Count());
Assert.Equal(1, journal.Count(x => x.Kind == AccountMergeEntryKind.Vote));
Assert.Single((await world.AllVotesAsync(motion)).Where(v => v.VoidedByMergeId == merge.Id));
}
[PostgresFact]
public async Task A_voided_vote_leaves_every_tally_on_a_real_database()
{
var world = await postgres.NewWorldAsync();
var survivor = await world.AccountAsync("survivor");
var folded = await world.AccountAsync("folded");
var moderator = await world.AccountAsync("mod", moderator: true);
var motion = await world.MotionAsync();
await world.VoteAsync(motion, survivor, VoteChoice.Against, 1m);
await world.VoteAsync(motion, folded, VoteChoice.For, 3m);
await world.CommitAsync(await world.MergeAsync(survivor, folded));
var item = await world.StateOfAsync(motion, moderator);
Assert.Equal((0m, 1m), (item.VotesFor, item.VotesAgainst));
Assert.Equal(MotionStatus.Failed, await world.CloseAsync(motion, moderator));
}
// ---- the sweeper against the saga ----
[PostgresFact]
public async Task The_sweep_does_not_overwrite_an_UndoRequested_written_after_it_read_the_merge()
{
var plain = await postgres.NewWorldAsync();
var merge = await plain.CommitAsync(await plain.MergeAsync(await plain.AccountAsync("survivor"), await plain.AccountAsync("folded")));
var sweeper = AccountMergeLedgerTests.World.OnPostgres(
ConnectionOf(plain), new BeforeFirstSave(() => plain.SetStateAsync(merge, AccountMergeState.UndoRequested)));
await using (var db = sweeper.Db())
{
Assert.Equal(0, await sweeper.Ledger(db).FinalizeDueAsync(AccountMergeLedgerTests.T0.AddDays(8), default));
}
await using var read = plain.Db();
var row = await read.AccountMerges.SingleAsync();
Assert.Equal(AccountMergeState.UndoRequested, row.State);
Assert.Null(row.FinalizedUtc);
}
[PostgresFact]
public async Task An_UndoRequested_written_from_a_stale_Committed_read_cannot_overwrite_Final()
{
var world = await postgres.NewWorldAsync();
var merge = await world.CommitAsync(await world.MergeAsync(await world.AccountAsync("survivor"), await world.AccountAsync("folded")));
await using var saga = world.Db();
var stale = await saga.AccountMerges.SingleAsync(x => x.Id == merge.Id); // the saga read Committed
await using (var sweep = world.Db())
{
Assert.Equal(1, await world.Ledger(sweep).FinalizeDueAsync(AccountMergeLedgerTests.T0.AddDays(8), default));
}
stale.State = AccountMergeState.UndoRequested;
await Assert.ThrowsAsync(() => saga.SaveChangesAsync());
await using var read = world.Db();
Assert.Equal(AccountMergeState.Final, (await read.AccountMerges.SingleAsync()).State);
}
[PostgresFact]
public async Task A_sweep_that_loses_one_merge_to_the_saga_still_finalizes_the_others()
{
var plain = await postgres.NewWorldAsync();
var survivor = await plain.AccountAsync("survivor");
await plain.CommitAsync(await plain.MergeAsync(survivor, await plain.AccountAsync("folded-a")));
await plain.CommitAsync(await plain.MergeAsync(survivor, await plain.AccountAsync("folded-b")));
var sweeper = AccountMergeLedgerTests.World.OnPostgres(
ConnectionOf(plain), new BeforeFirstSave(async () =>
{
// Whichever merge the sweep saves first, the saga takes one of the two before it does.
await using var rival = plain.Db();
var taken = await rival.AccountMerges.Where(x => x.State == AccountMergeState.Committed).OrderBy(x => x.Id).FirstAsync();
taken.State = AccountMergeState.UndoRequested;
await rival.SaveChangesAsync();
}));
await using (var db = sweeper.Db())
{
Assert.Equal(1, await sweeper.Ledger(db).FinalizeDueAsync(AccountMergeLedgerTests.T0.AddDays(8), default));
}
await using var read = plain.Db();
Assert.Equal([AccountMergeState.Final, AccountMergeState.UndoRequested], (await read.AccountMerges.ToListAsync()).Select(x => x.State).Order());
}
// ---- overlapping merges, refused by the database ----
[PostgresFact]
public async Task A_second_live_merge_folding_the_same_account_is_refused_and_a_finished_one_frees_it()
{
var world = await postgres.NewWorldAsync();
var s1 = await world.AccountAsync("acct-s1");
var s2 = await world.AccountAsync("acct-s2");
var folded = await world.AccountAsync("folded");
var second = await world.MergeAsync(s2, folded, AccountMergeState.Proposed); // proposals may coexist
var first = await world.MergeAsync(s1, folded, AccountMergeState.Confirmed);
var refused = await Assert.ThrowsAsync(() => world.SetStateAsync(second, AccountMergeState.Confirmed));
Assert.Equal(("23505", "UX_AccountMerges_FoldedUserAccountId_Live"), (Pg(refused).SqlState, Pg(refused).ConstraintName));
var inserted = await Assert.ThrowsAsync(() => world.MergeAsync(s2, folded, AccountMergeState.Final));
Assert.Equal("23505", Pg(inserted).SqlState);
await world.SetStateAsync(first, AccountMergeState.Undone);
await world.SetStateAsync(second, AccountMergeState.Confirmed); // the slot is free again
}
[PostgresTheory]
[InlineData(AccountMergeState.Confirmed, AccountMergeState.Confirmed)]
[InlineData(AccountMergeState.Final, AccountMergeState.Confirmed)]
[InlineData(AccountMergeState.Committed, AccountMergeState.HeimdallMoved)]
public async Task A_chain_is_refused_in_either_arrival_order_and_the_same_survivor_twice_is_fine(AccountMergeState earlier, AccountMergeState later)
{
var world = await postgres.NewWorldAsync();
foreach (var survivorFirst in new[] { true, false })
{
var tag = survivorFirst ? "a" : "b";
var s = await world.AccountAsync("acct-s" + tag);
var f = await world.AccountAsync("acct-f" + tag);
var g = await world.AccountAsync("acct-g" + tag);
var other = await world.AccountAsync("other" + tag);
await world.MergeAsync(s, other, AccountMergeState.Confirmed); // one survivor may carry two folded accounts
await world.MergeAsync(s, f, earlier);
// f survives a live merge and folds into g, or s folds into g while it survives one: both are chains.
var chain = await Assert.ThrowsAsync(() => survivorFirst ? world.MergeAsync(f, g, later) : world.MergeAsync(g, s, later));
Assert.Equal("23P01", Pg(chain).SqlState);
}
}
[PostgresFact]
public async Task Two_transactions_racing_to_chain_the_same_account_cannot_both_commit()
{
var world = await postgres.NewWorldAsync();
var s = await world.AccountAsync("acct-s");
var f = await world.AccountAsync("acct-f");
var g = await world.AccountAsync("acct-g");
await using var first = world.Db();
await using var firstTransaction = await first.Database.BeginTransactionAsync();
first.AccountMerges.Add(new AccountMerge { SurvivorUserAccountId = s.Id, FoldedUserAccountId = f.Id, State = AccountMergeState.Confirmed, CreatedUtc = AccountMergeLedgerTests.T0 });
await first.SaveChangesAsync();
await using var second = world.Db();
await using var secondTransaction = await second.Database.BeginTransactionAsync();
second.AccountMerges.Add(new AccountMerge { SurvivorUserAccountId = f.Id, FoldedUserAccountId = g.Id, State = AccountMergeState.Confirmed, CreatedUtc = AccountMergeLedgerTests.T0 });
var racing = second.SaveChangesAsync();
await Task.Delay(1500);
Assert.False(racing.IsCompleted); // it waits on the first, which holds the lock on f
await firstTransaction.CommitAsync();
var refused = await Assert.ThrowsAsync(() => racing.WaitAsync(TimeSpan.FromSeconds(30)));
Assert.Equal("23P01", Pg(refused).SqlState);
}
// ---- rollback ----
[PostgresFact]
public async Task Reverting_the_migration_is_refused_while_a_merge_has_voided_a_vote_and_allowed_after()
{
var world = await postgres.NewWorldAsync();
var survivor = await world.AccountAsync("survivor");
var folded = await world.AccountAsync("folded");
var motion = await world.MotionAsync();
await world.VoteAsync(motion, survivor, VoteChoice.For);
await world.VoteAsync(motion, folded, VoteChoice.Against);
await world.CommitAsync(await world.MergeAsync(survivor, folded));
await using (var db = world.Db())
{
var error = await Assert.ThrowsAnyAsync(() => db.GetService().MigrateAsync("20261113120000_AddPasskeyCredentials"));
Assert.Contains("cannot be reverted", Pg(error).MessageText);
Assert.Equal("20261114120000_AddAccountMerges", (await db.Database.GetAppliedMigrationsAsync()).Last());
}
await ExecuteAsync(world, "UPDATE \"Votes\" SET \"VoidedByMergeId\" = NULL, \"VoidedUtc\" = NULL");
await using var down = world.Db();
await down.GetService().MigrateAsync("20261113120000_AddPasskeyCredentials");
Assert.Equal("20261113120000_AddPasskeyCredentials", (await down.Database.GetAppliedMigrationsAsync()).Last());
await down.GetService().MigrateAsync(); // and up again, trigger and all
Assert.Equal("20261114120000_AddAccountMerges", (await down.Database.GetAppliedMigrationsAsync()).Last());
}
}