Files
SocialPub/PrivaPub/Models/ServerSetup.cs
T
thepraandClaude Opus 5.5 0f73f69239
Build / Build (push) Successful in 30s
House rules: primary constructors, a cancellation token on every async call, and the rules fail the build
- Services, controllers and jobs take their dependencies through primary
  constructors and use them directly; where a method already named a local
  after a dependency, the dependency takes its type's name.
- Every async method takes a CancellationToken last and passes it down to
  MongoDB, HTTP and the job queue. The setup claim is still given back when
  a request is cancelled.
- The federation and media options are read through IOptionsMonitor.
- The Mastodon entities keep sending "" for empty strings, and every model
  field where null means something says so.
- The inbox's 503 with Retry-After, which other servers retry, is the one
  server error left, and says why.
- Arasaka.HouseRules.Analyzers checks all of this in every build, here and in
  PrivaPub.ClientModels as decePubClient builds it.

Checked against GoToSocial in the pasture: 64 passed, 0 failed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W4YtEJrgxG12Pc39Fai8Bd
2026-11-10 01:24:43 +01:00

65 lines
2.7 KiB
C#

using MongoDB.Driver;
using MongoDB.Entities;
namespace PrivaPub.Models
{
// The server's first-time setup (owner decision 2026-10-16): while no administrator exists, the client's setup page makes
// the first login, which becomes the administrator; this document then closes setup for good, whoever is demoted or
// deleted later (the CLI stays the way back). The first request to insert it wins, so two setups at once make one
// administrator. A backup never holds it and a restore never drops it (ServerBackup.Excluded): a restore tombstones an
// administrator made after the backup, and setup would otherwise be open to whoever came first.
public class ServerSetup : Entity
{
public const string Name = "setup";
public string AdminId { get; set; }//null while the claiming request is still making its login
public DateTime SealedAt { get; set; }
public static async Task<bool> IsPending(CancellationToken token) =>
!await DB.Default.Find<ServerSetup>().Match(s => s.ID == Name).ExecuteAnyAsync(token);
/// <summary>Takes the setup for one request: false when it is done, or another request took it first.</summary>
public static async Task<bool> Claim(CancellationToken token)
{
try
{
await DB.Default.InsertAsync(new ServerSetup { ID = Name, SealedAt = DateTime.UtcNow }, token);
return true;
}
catch (MongoWriteException ex) when (ex.WriteError?.Category == ServerErrorCategory.DuplicateKey)
{
return false;
}
}
/// <summary>Names the administrator the claiming request made.</summary>
public static Task Claimed(string adminId, CancellationToken token) =>
DB.Default.Update<ServerSetup>().Match(s => s.ID == Name && s.AdminId == null).Modify(s => s.AdminId, adminId).ExecuteAsync(token);
/// <summary>Gives a claim back when its login couldn't be made; a named administrator is never given back.</summary>
public static Task Release(CancellationToken token = default) =>
DB.Default.DeleteAsync<ServerSetup>(s => s.ID == Name && s.AdminId == null);//a delete takes no token outside a transaction
/// <summary>Closes setup for an administrator made elsewhere (the CLI, a server that had one already).</summary>
public static async Task Seal(string adminId, CancellationToken token)
{
try
{
await DB.Default.Update<ServerSetup>().Match(s => s.ID == Name)
.Modify(b => b.SetOnInsert(s => s.AdminId, adminId))
.Modify(b => b.SetOnInsert(s => s.SealedAt, DateTime.UtcNow))
.Option(o => o.IsUpsert = true)
.ExecuteAsync(token);
}
catch (MongoCommandException ex) when (ex.Code == 11000)
{
//sealed meanwhile
}
catch (MongoWriteException ex) when (ex.WriteError?.Category == ServerErrorCategory.DuplicateKey)
{
//sealed meanwhile
}
}
}
}