Files
SocialPub/PrivaPub/Models/Jobs/RemoteInstance.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

99 lines
4.3 KiB
C#

using MongoDB.Entities;
namespace PrivaPub.Models.Jobs
{
public class RemoteInstance : Entity
{
public string Host { get; set; }
public int ConsecutiveFailures { get; set; }
public DateTime? UnavailableUntil { get; set; }
public DateTime? LastSuccessAt { get; set; }
public DateTime? LastFailureAt { get; set; }
public string LastError { get; set; }
public string Software { get; set; }//NodeInfo software.name: for display, never for deciding behaviour, but for two
//owner decisions: a first private message to Lemmy before 1.0 or Mbin is a ChatMessage (2026-10-05), and a report
//to a community on Lemmy, PieFed or Mbin leaves from the reporter in Lemmy's shape (2026-10-06,
//ReportService.ServiceReportTakers)
public string SoftwareVersion { get; set; }
public string NodeName { get; set; }
public List<string> Protocols { get; set; } = new();
public bool? OpenRegistrations { get; set; }
public string NodeInfo { get; set; }//the raw document, when small enough
public DateTime? DescribedAt { get; set; }
public string DescriptionError { get; set; }
public string Seen { get; set; }//"touched": we exchanged something with it; "crawled": only its peers list named it
public DateTime? FirstSeenAt { get; set; }
public DateTime? LastSeenAt { get; set; }
public DateTime? LastCrawledAt { get; set; }
public string CrawlError { get; set; }
public bool? RobotsDisallowed { get; set; }
public int? PeersCount { get; set; }
public string NodeInfoVersion { get; set; }
public string NodeDescription { get; set; }
public long? UsersTotal { get; set; }//as the server publishes them in its NodeInfo
public long? UsersActiveMonth { get; set; }
public long? UsersActiveHalfyear { get; set; }
public long? LocalPosts { get; set; }
public long? LocalComments { get; set; }
public string InstanceApi { get; set; }//"mastodon-v2" or "mastodon-v1"
public string InstanceApiRaw { get; set; }//admin only: it names maintainers and contact accounts
public string Title { get; set; }
[System.Diagnostics.CodeAnalysis.SuppressMessage("HouseRules", "HR0006", Justification = "Null when the server does not report its languages, which is not the same as none.")]
public List<string> Languages { get; set; }
public string RegistrationMode { get; set; }//open, approval, closed
public int? MaxPostChars { get; set; }
public int? MastodonApiVersion { get; set; }
public string SourceUrl { get; set; }
public InstanceGeo Geo { get; set; }
}
public class InstanceGeo
{
public string Country { get; set; }
public string City { get; set; }
public double? Latitude { get; set; }//rounded to one decimal
public double? Longitude { get; set; }
public int? Asn { get; set; }
public string AsnOrg { get; set; }
public string Cdn { get; set; }//the CDN in front of it, whose edge address says nothing about where it runs
public string CdnDomain { get; set; }//the CDN's own domain, which groups its servers (CdnProvider.Key)
public string CdnSource { get; set; }//how the CDN was found: "ranges", "headers" or "asn"
public bool? Ipv6 { get; set; }
public string Source { get; set; }
public DateTime? LocatedAt { get; set; }
}
public class RemoteInstanceSnapshot : Entity
{
public string Host { get; set; }
public string Week { get; set; }//ISO week, "2026-W40"
public DateTime TakenAt { get; set; }
public string Seen { get; set; }
public bool Reachable { get; set; }
public string Software { get; set; }
public string SoftwareVersion { get; set; }
public long? UsersTotal { get; set; }
public long? UsersActiveMonth { get; set; }
public long? UsersActiveHalfyear { get; set; }
public long? LocalPosts { get; set; }
public bool? OpenRegistrations { get; set; }
public string RegistrationMode { get; set; }
[System.Diagnostics.CodeAnalysis.SuppressMessage("HouseRules", "HR0006", Justification = "Null when the server does not report its languages, which is not the same as none.")]
public List<string> Languages { get; set; }
public string Country { get; set; }
public string City { get; set; }
public double? Latitude { get; set; }
public double? Longitude { get; set; }
public int? Asn { get; set; }
public string Cdn { get; set; }
public string CdnDomain { get; set; }
public string CdnSource { get; set; }
public bool? Ipv6 { get; set; }
}
}