litepub

README

litepub

Helpers to write ActivityPub etc integrations.

Documentation

Index

• func CheckSignature(r *http.Request) error
• func FetchActivityPubURL(identifier string) (string, error)
• func FetchFollowing(url string) ([]string, error)
• func GeneratePrivateKey(seed [4]byte) (*rsa.PrivateKey, error)
• func HandleWebfingerRequest(r *http.Request) (string, error)
• func ParsePrivateKeyFromPEM(pemString string) (*rsa.PrivateKey, error)
• func ParsePublicKeyFromPEM(pemString string) (*rsa.PublicKey, error)
• func PublicKeyToPEM(pk *rsa.PublicKey) (string, error)
• func SendSigned(privateKey *rsa.PrivateKey, publicKeyId string, target string, ...) (*http.Response, error)
• type Accept
• type Actor
  • func FetchActor(url string) (*Actor, error)
  • func FetchActorFromIdentifier(theirId string) (*Actor, error)
• type ActorImage
• type Base
• type Create
  • func WrapCreate(note Note, createId string) (create Create[Note])
• type DummyBaseContext
  • func (c DummyBaseContext) MarshalJSON() ([]byte, error)
  • func (c *DummyBaseContext) UnmarshalJSON([]byte) error
• type Follow
• type Note
  • func FetchNote(url string) (*Note, error)
  • func FetchNotes(url string) ([]Note, error)
• type OrderedCollection
• type OrderedCollectionPage
• type PublicKey
• type WebfingerLink
• type WebfingerResponse

Functions

func CheckSignature

func CheckSignature(r *http.Request) error

func FetchActivityPubURL

func FetchActivityPubURL(identifier string) (string, error)

func FetchFollowing

func FetchFollowing(url string) ([]string, error)

func GeneratePrivateKey

func GeneratePrivateKey(seed [4]byte) (*rsa.PrivateKey, error)

func HandleWebfingerRequest

func HandleWebfingerRequest(r *http.Request) (string, error)

func ParsePrivateKeyFromPEM

func ParsePrivateKeyFromPEM(pemString string) (*rsa.PrivateKey, error)

func ParsePublicKeyFromPEM

func ParsePublicKeyFromPEM(pemString string) (*rsa.PublicKey, error)

func PublicKeyToPEM

func PublicKeyToPEM(pk *rsa.PublicKey) (string, error)

func SendSigned

func SendSigned(
	privateKey *rsa.PrivateKey,
	publicKeyId string,
	target string,
	data interface{},
) (*http.Response, error)

Types

type Accept

type Accept struct {
	Base

	Object interface{} `json:"object"`
}

type Actor

type Actor struct {
	Base

	Name                      string     `json:"name"`
	PreferredUsername         string     `json:"preferredUsername"`
	ManuallyApprovesFollowers bool       `json:"manuallyApprovesFollowers"`
	Image                     ActorImage `json:"image,omitempty"`
	Icon                      ActorImage `json:"icon,omitempty"`
	Summary                   string     `json:"summary,omitempty"`
	URL                       string     `json:"url"`
	Inbox                     string     `json:"inbox"`
	Outbox                    string     `json:"outbox"`
	Followers                 string     `json:"followers"`
	Following                 string     `json:"following"`
	Published                 time.Time  `json:"published"`

	PublicKey PublicKey `json:"publicKey"`
}

func FetchActor

func FetchActor(url string) (*Actor, error)

func FetchActorFromIdentifier

func FetchActorFromIdentifier(theirId string) (*Actor, error)

type ActorImage

type ActorImage struct {
	Type string `json:"type,omitempty"`
	URL  string `json:"url,omitempty"`
}

type Base

type Base struct {
	Context DummyBaseContext `json:"@context"`
	Id      string           `json:"id"`
	Type    string           `json:"type"`
}

type Create

type Create[O any] struct {
	Base

	Actor  string `json:"actor"`
	Object O      `json:"object"`
}

func WrapCreate

func WrapCreate(note Note, createId string) (create Create[Note])

type DummyBaseContext

type DummyBaseContext struct{}

func (DummyBaseContext) MarshalJSON

func (c DummyBaseContext) MarshalJSON() ([]byte, error)

func (*DummyBaseContext) UnmarshalJSON

func (c *DummyBaseContext) UnmarshalJSON([]byte) error

type Follow

type Follow struct {
	Base

	Actor  string `json:"actor"`
	Object string `json:"object"`
}

type Note

type Note struct {
	Base

	Published    time.Time `json:"published"`
	AttributedTo string    `json:"attributedTo"`
	InReplyTo    string    `json:"InReplyToAtomUri"`
	Content      string    `json:"content"`
	To           []string  `json:"to"`
	CC           []string  `json:"cc"`
}

func FetchNote

func FetchNote(url string) (*Note, error)

func FetchNotes

func FetchNotes(url string) ([]Note, error)

type OrderedCollection

type OrderedCollection struct {
	Base

	TotalItems int             `json:"totalItems"`
	First      json.RawMessage `json:"first"`
}

type OrderedCollectionPage

type OrderedCollectionPage[I any] struct {
	Base

	TotalItems   int    `json:"totalItems"`
	PartOf       string `json:"partOf"`
	OrderedItems []I    `json:"orderedItems"`
	Next         string `json:"next"`
}

type PublicKey

type PublicKey struct {
	Id           string `json:"id"`
	Owner        string `json:"owner"`
	PublicKeyPEM string `json:"publicKeyPem"`
}

type WebfingerLink

type WebfingerLink struct {
	Rel  string `json:"rel"`
	Type string `json:"type"`
	Href string `json:"href"`
}

type WebfingerResponse

type WebfingerResponse struct {
	Subject string          `json:"subject"`
	Links   []WebfingerLink `json:"links"`
}