I think that's all AP things relevant

ap/accept-action.go

@@ -0,0 +1,12 @@
+package ap
+
+import "net/url"
+
+// Sent when a follow request is approved, manually or automatically
+type AcceptAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Url to this action
+	Type    string          `json:"type"`               // Should always be "Accept"
+	Actor   url.URL         `json:"actor"`              // Who is accepting what
+	Object  FollowAction    `json:"object"`             // Action that is being accepted
+}

ap/announce-action.go

@@ -0,0 +1,14 @@
+package ap
+
+import "net/url"
+
+// Announce == boost/share/retweet
+type AnnounceAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Url to this action
+	Type    string          `json:"type"`               // Should always be "Announce"
+	Actor   url.URL         `json:"actor"`              // Who is announcing something
+	To      []url.URL       `json:"to"`                 // Targets to share to
+	Cc      []url.URL       `json:"cc"`                 // More targets to send to
+	Object  url.URL         `json:"object"`             // Url to announced object
+}

ap/attachment.go

@@ -1,5 +1,6 @@
 package ap
 
+// An info field on an account page
 type PersonInfoField struct {
 	Type  string `json:"type"`  // Type of the attachment. Probably should always be "PropertyValue"
 	Name  string `json:"name"`  // Name of the property. Example: Source

ap/create-action.go

@@ -5,12 +5,14 @@ import (
 	"time"
 )
 
+// Sent when posting something
 type CreateAction struct {
+	Context   *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
 	ID        url.URL         `json:"id"`                 // URL to this resource
 	Actor     url.URL         `json:"actor"`              // Account that created this action, links to the AP url
 	Type      string          `json:"type"`               // Should always be "Create"
 	Published time.Time       `json:"published"`          // When this action was created
-	Object    map[string]any `json:"object"`    // Content of the action, is an AP object, like notes or questions (survey)
+	Object    any             `json:"object"`             // Content of the action, is an AP object, like notes or questions (survey)
-	To        []url.URL      `json:"to"`        // Array of url targets to deliver it to?
+	To        []url.URL       `json:"to"`                 // Array of url targets to deliver it to. With dms, oonly includes target accounts. Followers only goes to followers url of posting account
 	Cc        []url.URL       `json:"cc"`                 // More targets to deliver to?
 }

ap/delete-action.go

@@ -0,0 +1,16 @@
+package ap
+
+import (
+	"net/url"
+	"time"
+)
+
+// When a message is deleted
+type DeleteAction struct {
+	Context   *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id        url.URL         `json:"id"`                 // Location of this resource
+	Type      string          `json:"type"`               // Should always be "Delete"
+	Actor     url.URL         `json:"actor"`              // Account deleting something
+	Target    url.URL         `json:"object"`             // Account that the actor wants to follow
+	Published time.Time       `json:"published"`          // When this was done
+}

ap/emote.go

@@ -0,0 +1,15 @@
+package ap
+
+import (
+	"net/url"
+	"time"
+)
+
+// Custom emote information
+type Emote struct {
+	Icon    Media     `json:"icon"`    // Emote source file
+	ID      url.URL   `json:"id"`      // Url of the image
+	Name    string    `json:"name"`    // Name of the emote, example: ":neocat_heart:"
+	Type    string    `json:"type"`    // Should always be "Emoji"
+	Updated time.Time `json:"updated"` // When this was last updated. Akkoma seems to set this to unix epoch
+}

ap/follow-action.go

@@ -0,0 +1,12 @@
+package ap
+
+import "net/url"
+
+// A follow request
+type FollowAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Location of this resource
+	Type    string          `json:"type"`               // Should always be "Follow"
+	Actor   url.URL         `json:"actor"`              // Account instanciating the follow request
+	Target  url.URL         `json:"object"`             // Account that the actor wants to follow
+}

ap/like-action.go

@@ -0,0 +1,12 @@
+package ap
+
+import "net/url"
+
+// Action to like a post
+type LikeAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Url to this action
+	Type    string          `json:"type"`               // Should always be "Like"
+	Actor   url.URL         `json:"actor"`              // Who is liking something
+	Object  url.URL         `json:"object"`             // What is being liked
+}

ap/media.go

@@ -2,8 +2,9 @@ package ap
 
 import "net/url"
 
+// Media content (video files, images, audio)
 type Media struct {
 	Type      string  `json:"type"`                // Should probably always be "Image", "Video" or similar. Dunno if "Video" is correct
-	MediaType string  `json:"mediaType"` // What media type the linked resource is. Something like "image/png"
+	MediaType *string `json:"mediaType,omitempty"` // What media type the linked resource is. Something like "image/png"
 	Url       url.URL `json:"url"`                 // Where to find the media file
 }

ap/mention.go

@@ -0,0 +1,10 @@
+package ap
+
+import "net/url"
+
+// Tag type for mentions
+type Mention struct {
+	Type string  `json:"type"` // Should always be "Mention"
+	Href url.URL `json:"href"` // Url to mentioned account
+	Name string  `json:"name"` // Name of the account ("@foo@example.com")
+}

ap/note-object.go

@@ -5,17 +5,17 @@ import (
 	"time"
 )
 
+// A post
 type Note struct {
-	Context      map[string]any      `json:"@context,omitempty"`  // Lots of something. Not included if note is embedded as object in another object
+	Context      *map[string]any     `json:"@context,omitempty"`  // Lots of something. Not included if note is embedded as object in another object
 	ID           url.URL             `json:"id"`                  // Url to this resource
 	Type         string              `json:"type"`                // Should always be "Note"
 	AttributedTo url.URL             `json:"attributedTo"`        // Author of this note
 	Content      string              `json:"content"`             // Content of this note
-	MkContent    string              `json:"_misskey_content"`    // Misskey version of content
+	Source       *RawNoteContent     `json:"source"`              // Raw content
-	Source       RawNoteContent      `json:"source"`              // Raw content
 	InReplyTo    *url.URL            `json:"inReplyTo,omitempty"` // Note this is a reply to. Empty if not a reply
 	Attachment   []map[string]string `json:"attachment"`          // Media attachments            - TODO: Make proper type for this
-	Tag          []Tag               `json:"tag"`                 // List of hashtags
+	Tag          []any               `json:"tag"`                 // List of hashtags, mentions & custom emotes
 	Published    time.Time           `json:"published"`           // When this note was created
 	To           []url.URL           `json:"to"`                  // Where this note should get sent to
 	Cc           []url.URL           `json:"cc"`                  // More where this note should get sent to
@@ -23,6 +23,7 @@ type Note struct {
 	Summary   *string `json:"summary"`   // Summary of a post (also known as content warning)
 	Sensitive bool    `json:"sensitive"` // Does this note have a content warning?
 
+	MkContent *string  `json:"_misskey_content,omitempty"` // Misskey version of content
 	MkQuote   *url.URL `json:"_misskey_quote,omitempty"`   // Misskey link to note this quotes
 	QuoteUrl  *url.URL `json:"quoteUrl,omitempty"`         // Link to quoted note object
 	QuoteUri  *url.URL `json:"quoteUri,omitempty"`         // Same as Quote Url?

ap/ordered-collection.go

@@ -2,22 +2,24 @@ package ap
 
 import "net/url"
 
+// Ordered collection of things (paged)
 type OrderedCollection struct {
 	Context    map[string]any `json:"@context"`             // Big chunk of hopefully don't give a fuck
 	ID         url.URL        `json:"id"`                   // URL to this resource
 	Type       string         `json:"type"`                 // Should always be "OrderedCollection"
-	TotalItems int            `json:"totalItems"` // Number of resources in this collection
+	TotalItems *int           `json:"totalItems,omitempty"` // Number of resources in this collection, Akoma doesn't include this
 	First      url.URL        `json:"first"`                // Link to the first resource in this collection, an OrderedCollectionPage object
 	Last       url.URL        `json:"last"`                 // Link to the last resource in this collection, an OrderedCollectionPage object
 }
 
+// One page of an ordered collection
 type OrderedCollectionPage struct {
 	Context      map[string]any   `json:"@context"`             // Big chunk of hopefully don't give a fuck
 	ID           url.URL          `json:"id"`                   // URL to this resource
 	PartOf       url.URL          `json:"partOf"`               // URL to the collection this is a part of
 	Type         string           `json:"type"`                 // Should always be "OrderedCollectionPage"
-	TotalItems   int              `json:"totalItems"`   // Number of resources in this collection
+	TotalItems   *int             `json:"totalItems,omitempty"` // Number of resources in this collection. Mk yes, Masto no, Akoma no
 	OrderedItems []map[string]any `json:"orderedItems"`         // Items in this list. Should all be AP objects/actions
-	Previous     *url.URL         `json:"prev"`         // Previous page
+	Previous     *url.URL         `json:"prev"`                 // Previous page, empty if no items? I think?
 	Next         *url.URL         `json:"next"`                 // Next page
 }

ap/person.go

@@ -5,39 +5,47 @@ import (
 	"time"
 )
 
+// An account
 type Person struct {
 	Context           map[string]any    `json:"@context"`                  // Big chunk of hopefully don't give a fuck
 	ID                url.URL           `json:"id"`                        // URL to this resource
-	Type              string            `json:"type"`                      // Should always be of content "Person"
+	Type              string            `json:"type"`                      // Should always be of content "Person" (or "Service", if a bot)
 	Following         url.URL           `json:"following"`                 // Ordered collection of accounts this account follows
 	Followers         url.URL           `json:"followers"`                 // Ordered collection of accounts following this account
 	Inbox             url.URL           `json:"inbox"`                     // Where others send activities to (posts, follow requests, reactions, etc)
 	Outbox            url.URL           `json:"outbox"`                    // Where others can read this account's activities from
 	Featured          url.URL           `json:"featured"`                  // Ordered collection of something featured                   - TODO: Find out what this is
-	FeaturedTags      *url.URL          `json:"featuredTags"`              // Collection of something, not ordered     - TODO: Find out what this is
 	PreferredUsername string            `json:"preferredUsername"`         // Username
 	Name              string            `json:"name"`                      // Vanity name
 	Summary           string            `json:"summary"`                   // Description of the account. Could contain html or maybe mfm for *key
 	Url               url.URL           `json:"url"`                       // Public location of the account
-	Locked            bool              `json:"manuallyApprovesFollowers"` // Does this account have to approve of follows before they are actual follows?
+	ManualApproval    bool              `json:"manuallyApprovesFollowers"` // Does this account have to approve of follows before they are actual follows?
 	Discoverable      bool              `json:"discoverable"`              // If this account can be found via search things? I guess?
-	Indexable         *bool             `json:"indexable"`                 // Probably if this account will be shown to search engines and crawlers?
-	Published         *time.Time        `json:"published"`                 // When this account was created I guess?
-	Memorial          *bool             `json:"memorial"`                  // If this account is closed? Or moved? Probably closed
-	Devices           *url.URL          `json:"devices"`                   // Collection of something                  - TODO: Find out what this is
 	PublicKey         PublicKey         `json:"publicKey"`                 // public key of that account. For verifying that that account is actually them
-	Tag               []any             `json:"tag"`                       // Array of something. Probably urls or strings
+	Tag               []Emote           `json:"tag"`                       // Contains custom emote info - TODO: Add proper type
 	Attachment        PersonInfoField   `json:"attachment"`                // Additional profile information (fields below the description, like "Source: https://gitlab.com/mstarongitlab/linstrom")
 	Endpoints         map[string]string `json:"endpoints"`                 // Stores at least the shared inbox of the server this account is on in "sharedInbox", which is an url
-	Icon              *Media            `json:"icon"`                      // Profile image of the account
+	Icon              *Media            `json:"icon"`                      // Profile image of the account, null if not set
-	Image             *Media            `json:"image"`                     // Header image of the account
+	Image             *Media            `json:"image"`                     // Header image of the account, null if not set
 
-	SharedInbox *url.URL `json:"sharedInbox"`      // Replicates the shared inbox url here I guess
+	// Section: Mastodon only
-	MkSummary   *string  `json:"_misskey_summary"` // Misskey's version of the summary
+	Indexable    *bool      `json:"indexable,omitempty"`    // Probably if this account will be shown to search engines and crawlers?
-	Background  *url.URL `json:"backgroundUrl"`    // Background image
+	FeaturedTags *url.URL   `json:"featuredTags,omitempty"` // Collection of something, not ordered     - TODO: Find out what this is
-	IsCat       *bool    `json:"isCat"`            // Is the user a cat (apply cat ears in that case)
+	Published    *time.Time `json:"published,omitempty"`    // When this account was created I guess?
-	NoIndex     *bool    `json:"noindex"`          // probably the same as Indexable, just reversed?
+	Memorial     *bool      `json:"memorial,omitempty"`     // If this account is closed? Or moved? Probably closed
-	SpeakAsCat  *bool    `json:"speakAsCat"`       // Does the account speak like a cat
+	Devices      *url.URL   `json:"devices,omitempty"`      // Collection of something                  - TODO: Find out what this is
-	Birthday    *string  `json:"vcard:bday"`       // Birthday date, but doesn't quite follow normalised datetime
+
-	Location    *string  `json:"vcard:Address"`    // Where the user of the account lives, could technically be anything as just a string
+	// Section: Misskey only
+	SharedInbox *url.URL `json:"sharedInbox,omitempty"`      // Replicates the shared inbox url here I guess
+	MkSummary   *string  `json:"_misskey_summary,omitempty"` // Misskey's version of the summary
+	Background  *url.URL `json:"backgroundUrl,omitempty"`    // Background image
+	IsCat       *bool    `json:"isCat,omitempty"`            // Is the user a cat (apply cat ears in that case)
+	NoIndex     *bool    `json:"noindex,omitempty"`          // probably the same as Indexable, just reversed?
+	SpeakAsCat  *bool    `json:"speakAsCat,omitempty"`       // Does the account speak like a cat
+	Birthday    *string  `json:"vcard:bday,omitempty"`       // Birthday date, but doesn't quite follow normalised datetime
+	Location    *string  `json:"vcard:Address,omitempty"`    // Where the user of the account lives, could technically be anything as just a string
+
+	// Section: Akkoma things
+	AlsoKnownAs  *[]any          `json:"alsoKnownAs"`  // Meaning unknown
+	Capabilities *map[string]any `json:"capabilities"` // Meaning unknown
 }

ap/public_key.go

@@ -2,6 +2,7 @@ package ap
 
 import "net/url"
 
+// The public key associated with an account
 type PublicKey struct {
 	ID      url.URL `json:"id"`           // ID of the key
 	Owner   url.URL `json:"owner"`        // Who this key belongs to

ap/question-entry.go

@@ -1,5 +1,6 @@
 package ap
 
+// One option for a survey
 type QuestionEntry struct {
 	Type    string `json:"type"` // Should always be "Note"
 	Name    string `json:"name"` // Name of the entry

ap/question-object.go

@@ -5,6 +5,7 @@ import (
 	"time"
 )
 
+// A survey. Options are in the field OneOf if it's single choice, AnyOf if multipleChoice
 type Question struct {
 	Context      map[string]any      `json:"@context,omitempty"` // Lots of something. Not included if note is embedded as object in another object
 	ID           url.URL             `json:"id"`                 // Url to this object
@@ -20,7 +21,7 @@ type Question struct {
 	Attachment   []map[string]string `json:"attachment"`         // File attachments         - TODO: Move to concrete type
 	Sensitive    bool                `json:"sensitive"`          // Whether this post has a content warning
 	Summary      *string             `json:"summary"`            // Summary of a post (also known as content warning)
-	Tag          []Tag               `json:"tag"`                // Hashtags
+	Tag          []Hashtag           `json:"tag"`                // Hashtags
 	EndTime      *time.Time          `json:"endTime"`            // Timestamp of when the question ends
 	OneOf        []QuestionEntry     `json:"oneOf,omitempty"`    // All available options to vote for. Used if single choice vote
 	AnyOf        []QuestionEntry     `json:"anyOf,omitempty"`    // All available options to vote for. Used if multiple choice vote

ap/raw-note-content.go

@@ -1,5 +1,6 @@
 package ap
 
+// Raw content of a note I think. Added by Misskey and Akkoma
 type RawNoteContent struct {
 	Content   string `json:"content"`
 	MediaType string `json:"mediaType"`

ap/reject-action.go

@@ -0,0 +1,12 @@
+package ap
+
+import "net/url"
+
+// Follow request rejected (or maybe I think "confirmation" on unfollow)
+type RejectAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Location of this resource
+	Type    string          `json:"type"`               // Should always be "Reject"
+	Actor   url.URL         `json:"actor"`              // Account rejecting the follow request
+	Request FollowAction    `json:"object"`             // Request that's being rejected
+}

ap/tag.go

@@ -2,7 +2,8 @@ package ap
 
 import "net/url"
 
-type Tag struct {
+// Describes a hashtag's data
+type Hashtag struct {
 	Type string  `json:"type"` // Should always be "Hashtag"
 	Href url.URL `json:"href"` // Url to that hashtag
 	Name string  `json:"name"` // Name of the hashtag, example: "#some-hashtag"

ap/tombstone-object.go

@@ -0,0 +1,10 @@
+package ap
+
+import "net/url"
+
+// The tombstone of a message
+type Tombstone struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Location of this resource
+	Type    string          `json:"type"`               // Should always be "Tombstone"
+}

ap/undo-action.go

@@ -0,0 +1,12 @@
+package ap
+
+import "net/url"
+
+// Undo == unfollow
+type UndoAction struct {
+	Context *map[string]any `json:"@context,omitempty"` // Lots of something. Not included if action is embedded as object in another object
+	Id      url.URL         `json:"id"`                 // Location of this resource
+	Type    string          `json:"type"`               // Should always be "Undo"
+	Actor   url.URL         `json:"actor"`              // Account instanciating the follow request
+	Target  FollowAction    `json:"object"`             // Follow to undo
+}