Wire the client to PrivaPub: one sign-in, real feeds, a globe, nerd stats

One sign-in for both of PrivaPub's APIs: the root logs in on /clientapi,
picks a persona, and each persona gets its own Mastodon token in
exchange for the JWT (PersonaExchange). HttpService picks credentials
and JSON by route (JWT and camelCase for /clientapi, the persona token
and snake_case for /api, nothing for /oauth), retries a refused persona
token once, and records every request for the nerd stats.

The feed page is three columns: navigation with a persona switcher, the
feed with a tab per kind (home, local, federated, nearby, communities
and circles, direct, notifications, favourites, bookmarks, hashtags),
and a 3D globe that looks at the spherical mean of the posts in view
and draws a pulse and an arc to a hovered one. Posts sit at their own
place, their event's venue, the reader (located posts) or their
author's server as PrivaPub publishes it. Cards favourite, boost,
bookmark, reply, mute, block and delete; the composer posts with a
content warning, visibility, media and alt text, or as a located post.
Older pages load as the end nears; newer ones are polled while visible.
Nerd stats in tooltips: provenance, author and server, place, media,
counts, paging, the globe's camera and frame rate.

The mock (Faker, MessagesService, the Message models and store) and the
OIDC template leftovers are gone. Strings in English and Italian.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsXgEaXee4GCU1hwYgPJXw
This commit is contained in:
thepraandClaude Opus 5.5 committed 2026-10-04 11:03:14 +02:00
1 parent f41ebf2160
commit 827ecb770e
56 files changed
+5367 -832

No files matched your search

+58
View File
@@ -0,0 +1,58 @@
namespace decePubClient.Models.Mastodon;
/// <summary>A persona, a remote account or a community, as PrivaPub's Mastodon API sends it.</summary>
public class Account
{
public string Id { get; set; }
public string Username { get; set; }
/// <summary>username for a local account, username@host for a remote one.</summary>
public string Acct { get; set; }
public string DisplayName { get; set; }
public bool Locked { get; set; }
public bool Bot { get; set; }
public bool Group { get; set; }
public DateTime? CreatedAt { get; set; }
public string Note { get; set; }
public string Url { get; set; }
public string Uri { get; set; }
public string Avatar { get; set; }
public string AvatarStatic { get; set; }
public string Header { get; set; }
public string HeaderStatic { get; set; }
public int FollowersCount { get; set; }
public int FollowingCount { get; set; }
public int StatusesCount { get; set; }
public string LastStatusAt { get; set; }
public List<CustomEmoji> Emojis { get; set; } = [];
public List<AccountField> Fields { get; set; } = [];
/// <summary>The account's server: the host of its ActivityPub id.</summary>
public string Host => System.Uri.TryCreate(Uri, UriKind.Absolute, out var uri) ? uri.Host.ToLowerInvariant() : default;
/// <summary>The name to show: the display name, or the username when there is none.</summary>
public string Name => string.IsNullOrWhiteSpace(DisplayName) ? Username : DisplayName;
}
public class AccountField
{
public string Name { get; set; }
public string Value { get; set; }
public DateTime? VerifiedAt { get; set; }
}
public class CustomEmoji
{
public string Shortcode { get; set; }
public string Url { get; set; }
public string StaticUrl { get; set; }
}
public class Relationship
{
public string Id { get; set; }
public bool Following { get; set; }
public bool FollowedBy { get; set; }
public bool Blocking { get; set; }
public bool Muting { get; set; }
public bool Requested { get; set; }
}
+41
View File
@@ -0,0 +1,41 @@
namespace decePubClient.Models.Mastodon;
/// <summary>
/// A picture, video or audio file. Url and PreviewUrl go through PrivaPub (its own files or its media proxy);
/// RemoteUrl is where a remote file came from.
/// </summary>
public class MediaAttachment
{
public string Id { get; set; }
/// <summary>image, gifv, video, audio or unknown.</summary>
public string Type { get; set; }
public string Url { get; set; }
public string PreviewUrl { get; set; }
public string RemoteUrl { get; set; }
public MediaMeta Meta { get; set; }
public string Description { get; set; }
public string Blurhash { get; set; }
}
public class MediaMeta
{
public MediaSize Original { get; set; }
/// <summary>h:mm:ss.ff, for video and audio.</summary>
public string Length { get; set; }
public MediaFocus Focus { get; set; }
}
public class MediaSize
{
public int? Width { get; set; }
public int? Height { get; set; }
public string Size { get; set; }
public double? Aspect { get; set; }
public double? Duration { get; set; }
}
public class MediaFocus
{
public double X { get; set; }
public double Y { get; set; }
}
+24
View File
@@ -0,0 +1,24 @@
namespace decePubClient.Models.Mastodon;
/// <summary>
/// type: mention, status, reblog, follow, follow_request, favourite, poll, update, quote, quoted_update or
/// pleroma:emoji_reaction. Status is null for follows.
/// </summary>
public class Notification
{
public string Id { get; set; }
public string Type { get; set; }
public DateTime CreatedAt { get; set; }
public Account Account { get; set; }
public Status Status { get; set; }
public string Emoji { get; set; }
}
/// <summary>A direct conversation: its participants and its last post.</summary>
public class Conversation
{
public string Id { get; set; }
public bool Unread { get; set; }
public List<Account> Accounts { get; set; } = [];
public Status LastStatus { get; set; }
}
+122
View File
@@ -0,0 +1,122 @@
using System.Text.Json.Nodes;
namespace decePubClient.Models.Mastodon;
/// <summary>/api/privapub/v1/instances: what PrivaPub stored about a server, and where it is.</summary>
public class InstanceDescription
{
public string Host { get; set; }
public string Software { get; set; }
public string Version { get; set; }
public string NodeName { get; set; }
public List<string> Protocols { get; set; } = [];
public bool? OpenRegistrations { get; set; }
public DateTime? DescribedAt { get; set; }
public string DescriptionError { get; set; }
public JsonNode NodeInfo { get; set; }
public InstanceDelivery Delivery { get; set; }
public InstanceLocation Geo { get; set; }
}
public class InstanceDelivery
{
public int ConsecutiveFailures { get; set; }
public DateTime? UnavailableUntil { get; set; }
public DateTime? LastSuccessAt { get; set; }
public DateTime? LastFailureAt { get; set; }
}
/// <summary>
/// The public projection of a server's place. Precision: city (coordinates to 0.1°, city and network), country (the
/// country only) or cdn (the CDN's name only).
/// </summary>
public class InstanceLocation
{
public string Precision { get; set; }
public string Country { get; set; }
public string City { get; set; }
public double? Latitude { get; set; }
public double? Longitude { get; set; }
public string Network { get; set; }
public string Cdn { get; set; }
public string Source { get; set; }
public DateTime? LocatedAt { get; set; }
}
/// <summary>/api/privapub/v1/statuses/{id}/provenance: how a remote post reached PrivaPub. Path is local for a local post.</summary>
public class Provenance
{
public string ObjectUri { get; set; }
public string ObjectType { get; set; }
public string Url { get; set; }
/// <summary>delivered, fetched, unrecorded or local.</summary>
public string Path { get; set; }
public bool Refetched { get; set; }
public ProvenanceActivity Activity { get; set; }
public string Inbox { get; set; }
public string FetchedBy { get; set; }
public ProvenanceSignature Signature { get; set; }
public DateTime? ReceivedAt { get; set; }
public DateTime? Published { get; set; }
public DateTime? Updated { get; set; }
public List<string> Extensions { get; set; } = [];
public List<string> ContextNamespaces { get; set; } = [];
public JsonNode Raw { get; set; }
public int RawBytes { get; set; }
public string RawHash { get; set; }
public bool RawTruncated { get; set; }
public List<ProvenanceRevision> Revisions { get; set; } = [];
public InstanceDescription Instance { get; set; }
}
public class ProvenanceActivity
{
public string Id { get; set; }
public string Type { get; set; }
public string Actor { get; set; }
}
public class ProvenanceSignature
{
public string Scheme { get; set; }
public string KeyId { get; set; }
public string Algorithm { get; set; }
public List<string> Headers { get; set; } = [];
}
public class ProvenanceRevision
{
public string ActivityId { get; set; }
public DateTime? Updated { get; set; }
public DateTime? ReceivedAt { get; set; }
public string RawHash { get; set; }
}
/// <summary>The answer of /oauth/token.</summary>
public class TokenResponse
{
public string AccessToken { get; set; }
public string TokenType { get; set; }
public string IssuedTokenType { get; set; }
public string Scope { get; set; }
public long CreatedAt { get; set; }
}
/// <summary>An error of the Mastodon API or of /oauth: {"error": ..., "error_description": ...}.</summary>
public class MastodonError
{
public string Error { get; set; }
public string ErrorDescription { get; set; }
}
/// <summary>POST /api/v1/statuses. The text is plain: the Mastodon API does not take Markdown.</summary>
public class PostStatusForm
{
public string Status { get; set; }
public List<string> MediaIds { get; set; } = [];
public string InReplyToId { get; set; }
public bool Sensitive { get; set; }
public string SpoilerText { get; set; }
public string Visibility { get; set; }
public string Language { get; set; }
}
+90
View File
@@ -0,0 +1,90 @@
namespace decePubClient.Models.Mastodon;
/// <summary>Status.privapub: what a Mastodon status cannot say (PrivaPub's Mastodon client API invariant 7).</summary>
public class PrivaPubStatus
{
/// <summary>The ActivityPub type of a remote object: Note, Article, Page, Video, Audio, Event, Question…</summary>
public string ObjectType { get; set; }
public string Title { get; set; }
public string Excerpt { get; set; }
public string Cover { get; set; }
public PrivaPubSource Source { get; set; }
public PrivaPubLink Link { get; set; }
public PrivaPubVideo Video { get; set; }
public PrivaPubAudio Audio { get; set; }
public PrivaPubEvent Event { get; set; }
/// <summary>A remote post's own place (Pixelfed's location), shown only.</summary>
public PrivaPubPlace Place { get; set; }
public PrivaPubVotes Votes { get; set; }
}
public class PrivaPubSource
{
public string Content { get; set; }
public string MediaType { get; set; }
}
public class PrivaPubLink
{
public string Url { get; set; }
public string Title { get; set; }
public string Description { get; set; }
public string Image { get; set; }
public bool FromPublisher { get; set; }
}
public class PrivaPubVariant
{
public string Url { get; set; }
public string MediaType { get; set; }
public int? Width { get; set; }
public int? Height { get; set; }
public double? Fps { get; set; }
public long? Size { get; set; }
}
public class PrivaPubVideo
{
public double? Duration { get; set; }
public List<PrivaPubVariant> Variants { get; set; } = [];
public bool IsLive { get; set; }
public long? Views { get; set; }
public string Licence { get; set; }
public string Category { get; set; }
}
public class PrivaPubAudio
{
public double? Duration { get; set; }
public List<PrivaPubVariant> Variants { get; set; } = [];
public string Album { get; set; }
public string Licence { get; set; }
}
public class PrivaPubEvent
{
public DateTime? Start { get; set; }
public DateTime? End { get; set; }
public string TimeZone { get; set; }
public List<PrivaPubPlace> Places { get; set; } = [];
public string OnlineUrl { get; set; }
public int? Participants { get; set; }
public int? Capacity { get; set; }
public string Status { get; set; }
}
public class PrivaPubPlace
{
public string Name { get; set; }
public string Address { get; set; }
public string Country { get; set; }
public double? Latitude { get; set; }
public double? Longitude { get; set; }
public string Url { get; set; }
}
public class PrivaPubVotes
{
public int Up { get; set; }
public int Down { get; set; }
}
+109
View File
@@ -0,0 +1,109 @@
namespace decePubClient.Models.Mastodon;
/// <summary>
/// A post as PrivaPub's Mastodon API sends it (snake_case JSON, MastodonJsonContext). PrivaPub-only details are in
/// Privapub; ids are opaque strings.
/// </summary>
public class Status
{
public string Id { get; set; }
public string Uri { get; set; }
public string Url { get; set; }
public Account Account { get; set; }
public string InReplyToId { get; set; }
public string InReplyToAccountId { get; set; }
public Status Reblog { get; set; }
public string Content { get; set; }
public DateTime CreatedAt { get; set; }
public DateTime? EditedAt { get; set; }
public List<CustomEmoji> Emojis { get; set; } = [];
public int RepliesCount { get; set; }
public int ReblogsCount { get; set; }
public int FavouritesCount { get; set; }
public bool Reblogged { get; set; }
public bool Favourited { get; set; }
public bool Muted { get; set; }
public bool Bookmarked { get; set; }
public bool Pinned { get; set; }
public bool Sensitive { get; set; }
public string SpoilerText { get; set; }
/// <summary>public, unlisted, private (followers and circles) or direct.</summary>
public string Visibility { get; set; }
public List<MediaAttachment> MediaAttachments { get; set; } = [];
public List<StatusMention> Mentions { get; set; } = [];
public List<StatusTag> Tags { get; set; } = [];
public PreviewCard Card { get; set; }
public Poll Poll { get; set; }
public StatusApplication Application { get; set; }
public string Language { get; set; }
/// <summary>The plain text source, only on the author's own deleted or edited post.</summary>
public string Text { get; set; }
public PrivaPubStatus Privapub { get; set; }
public Quote Quote { get; set; }
public int QuotesCount { get; set; }
}
public class StatusMention
{
public string Id { get; set; }
public string Username { get; set; }
public string Url { get; set; }
public string Acct { get; set; }
}
public class StatusTag
{
public string Name { get; set; }
public string Url { get; set; }
}
public class StatusApplication
{
public string Name { get; set; }
public string Website { get; set; }
}
public class Quote
{
public string State { get; set; }
public Status QuotedStatus { get; set; }
public string QuotedStatusId { get; set; }
}
public class StatusContext
{
public List<Status> Ancestors { get; set; } = [];
public List<Status> Descendants { get; set; } = [];
}
public class Poll
{
public string Id { get; set; }
public DateTime? ExpiresAt { get; set; }
public bool Expired { get; set; }
public bool Multiple { get; set; }
public int VotesCount { get; set; }
public int? VotersCount { get; set; }
public bool? Voted { get; set; }
public List<PollOption> Options { get; set; } = [];
}
public class PollOption
{
public string Title { get; set; }
public int? VotesCount { get; set; }
}
public class PreviewCard
{
public string Url { get; set; }
public string Title { get; set; }
public string Description { get; set; }
public string Type { get; set; }
public string ProviderName { get; set; }
public string Image { get; set; }
public string ImageDescription { get; set; }
public int Width { get; set; }
public int Height { get; set; }
public string Blurhash { get; set; }
}