1 1d5ddf5d 2024-02-20 o // apub is an implementation of the ActivityPub protocol.
  2 1d5ddf5d 2024-02-20 o //
  3 1d5ddf5d 2024-02-20 o // https://www.w3.org/TR/activitypub/
  4 1d5ddf5d 2024-02-20 o // https://www.w3.org/TR/activitystreams-core/
  5 1d5ddf5d 2024-02-20 o // https://www.w3.org/TR/activitystreams-vocabulary/
  6 1d5ddf5d 2024-02-20 o package apub
  7 1d5ddf5d 2024-02-20 o 
  8 1d5ddf5d 2024-02-20 o import (
  9 1d5ddf5d 2024-02-20 o 	"bytes"
 10 1d5ddf5d 2024-02-20 o 	"encoding/json"
 11 1d5ddf5d 2024-02-20 o 	"errors"
 12 1d5ddf5d 2024-02-20 o 	"fmt"
 13 1d5ddf5d 2024-02-20 o 	"io"
 14 1d5ddf5d 2024-02-20 o 	"net/mail"
 15 1d5ddf5d 2024-02-20 o 	"strings"
 16 1d5ddf5d 2024-02-20 o 	"time"
 17 1d5ddf5d 2024-02-20 o )
 18 1d5ddf5d 2024-02-20 o 
 19 186ac3bf 2024-03-12 o // NormContext is a URL referencing the
 20 186ac3bf 2024-03-12 o // normative Activity Streams 2.0 JSON-LD @context definition.
 21 186ac3bf 2024-03-12 o // All [Activity] variables should have their AtContext field set to this value.
 22 186ac3bf 2024-03-12 o // See [Activity Streams 2.0] section 2.1.
 23 186ac3bf 2024-03-12 o //
 24 186ac3bf 2024-03-12 o // [Activity Streams 2.0]: https://www.w3.org/TR/activitystreams-core/
 25 186ac3bf 2024-03-12 o const NormContext string = "https://www.w3.org/ns/activitystreams"
 26 1d5ddf5d 2024-02-20 o 
 27 25fed994 2024-03-12 o // ContentType is the MIME media type for ActivityPub.
 28 1d5ddf5d 2024-02-20 o const ContentType string = "application/activity+json"
 29 1d5ddf5d 2024-02-20 o 
 30 25fed994 2024-03-12 o // PublicCollection is the ActivityPub ID for the special collection indicating public access.
 31 25fed994 2024-03-12 o // Any Activity addressed to this collection is meant to be available to all users,
 32 25fed994 2024-03-12 o // authenticated or not.
 33 77918b00 2024-03-07 o // See W3C Recommendation ActivityPub Section 5.6.
 34 77918b00 2024-03-07 o const PublicCollection string = "https://www.w3.org/ns/activitystreams#Public"
 35 1d5ddf5d 2024-02-20 o 
 36 71191436 2024-02-28 o var ErrNotExist = errors.New("no such activity")
 37 71191436 2024-02-28 o 
 38 186ac3bf 2024-03-12 o // Activity represents the Activity Streams Object core type.
 39 186ac3bf 2024-03-12 o // See Activity Streams 2.0, section 4.1.
 40 1d5ddf5d 2024-02-20 o type Activity struct {
 41 1d5ddf5d 2024-02-20 o 	AtContext    string     `json:"@context"`
 42 1d5ddf5d 2024-02-20 o 	ID           string     `json:"id"`
 43 1d5ddf5d 2024-02-20 o 	Type         string     `json:"type"`
 44 1d5ddf5d 2024-02-20 o 	Name         string     `json:"name,omitempty"`
 45 1d5ddf5d 2024-02-20 o 	Actor        string     `json:"actor,omitempty"`
 46 1d5ddf5d 2024-02-20 o 	Username     string     `json:"preferredUsername,omitempty"`
 47 77918b00 2024-03-07 o 	Summary      string     `json:"summary,omitempty"`
 48 1d5ddf5d 2024-02-20 o 	Inbox        string     `json:"inbox,omitempty"`
 49 1d5ddf5d 2024-02-20 o 	Outbox       string     `json:"outbox,omitempty"`
 50 1d5ddf5d 2024-02-20 o 	To           []string   `json:"to,omitempty"`
 51 1d5ddf5d 2024-02-20 o 	CC           []string   `json:"cc,omitempty"`
 52 77918b00 2024-03-07 o 	Followers    string     `json:"followers,omitempty"`
 53 1d5ddf5d 2024-02-20 o 	InReplyTo    string     `json:"inReplyTo,omitempty"`
 54 1d5ddf5d 2024-02-20 o 	Published    *time.Time `json:"published,omitempty"`
 55 1d5ddf5d 2024-02-20 o 	AttributedTo string     `json:"attributedTo,omitempty"`
 56 1d5ddf5d 2024-02-20 o 	Content      string     `json:"content,omitempty"`
 57 1d5ddf5d 2024-02-20 o 	MediaType    string     `json:"mediaType,omitempty"`
 58 1d5ddf5d 2024-02-20 o 	Source       struct {
 59 1d5ddf5d 2024-02-20 o 		Content   string `json:"content,omitempty"`
 60 1d5ddf5d 2024-02-20 o 		MediaType string `json:"mediaType,omitempty"`
 61 1d5ddf5d 2024-02-20 o 	} `json:"source,omitempty"`
 62 77918b00 2024-03-07 o 	PublicKey *PublicKey      `json:"publicKey,omitempty"`
 63 77918b00 2024-03-07 o 	Audience  string          `json:"audience,omitempty"`
 64 d802abd8 2024-03-12 o 	Href      string          `json:"href,omitempty"`
 65 1738cb32 2024-03-12 o 	Tag       []Activity      `json:"tag,omitempty"`
 66 186ac3bf 2024-03-12 o 	// Contains a JSON-encoded Activity, or a URL as a JSON string
 67 186ac3bf 2024-03-12 o 	// pointing to an Activity. Use Activity.Unwrap() to access
 68 186ac3bf 2024-03-12 o 	// the enclosed, decoded value.
 69 77918b00 2024-03-07 o 	Object    json.RawMessage `json:"object,omitempty"`
 70 1d5ddf5d 2024-02-20 o }
 71 1d5ddf5d 2024-02-20 o 
 72 1d5ddf5d 2024-02-20 o func (act *Activity) UnmarshalJSON(b []byte) error {
 73 1d5ddf5d 2024-02-20 o 	type Alias Activity
 74 1d5ddf5d 2024-02-20 o 	aux := &struct {
 75 1d5ddf5d 2024-02-20 o 		AtContext interface{} `json:"@context"`
 76 1d5ddf5d 2024-02-20 o 		Object    interface{}
 77 1d5ddf5d 2024-02-20 o 		*Alias
 78 1d5ddf5d 2024-02-20 o 	}{
 79 1d5ddf5d 2024-02-20 o 		Alias: (*Alias)(act),
 80 1d5ddf5d 2024-02-20 o 	}
 81 1d5ddf5d 2024-02-20 o 	if err := json.Unmarshal(b, &aux); err != nil {
 82 1d5ddf5d 2024-02-20 o 		return err
 83 1d5ddf5d 2024-02-20 o 	}
 84 1d5ddf5d 2024-02-20 o 	switch v := aux.AtContext.(type) {
 85 1d5ddf5d 2024-02-20 o 	case string:
 86 1d5ddf5d 2024-02-20 o 		act.AtContext = v
 87 1d5ddf5d 2024-02-20 o 	case []interface{}:
 88 1d5ddf5d 2024-02-20 o 		if vv, ok := v[0].(string); ok {
 89 1d5ddf5d 2024-02-20 o 			act.AtContext = vv
 90 1d5ddf5d 2024-02-20 o 		}
 91 1d5ddf5d 2024-02-20 o 	}
 92 1d5ddf5d 2024-02-20 o 	return nil
 93 1d5ddf5d 2024-02-20 o }
 94 1d5ddf5d 2024-02-20 o 
 95 25fed994 2024-03-12 o // Unwrap returns the JSON-encoded Activity, if any, enclosed in act.
 96 25fed994 2024-03-12 o // The Activity may be referenced by ID,
 97 25fed994 2024-03-12 o // in which case the activity is looked up by client or by
 98 25fed994 2024-03-12 o // apub.defaultClient if client is nil.
 99 1d5ddf5d 2024-02-20 o func (act *Activity) Unwrap(client *Client) (*Activity, error) {
100 1d5ddf5d 2024-02-20 o 	if act.Object == nil {
101 1d5ddf5d 2024-02-20 o 		return nil, errors.New("no wrapped activity")
102 1d5ddf5d 2024-02-20 o 	}
103 1d5ddf5d 2024-02-20 o 
104 1d5ddf5d 2024-02-20 o 	var buf io.Reader
105 1d5ddf5d 2024-02-20 o 	buf = bytes.NewReader(act.Object)
106 1d5ddf5d 2024-02-20 o 	if strings.HasPrefix(string(act.Object), "https") {
107 1d5ddf5d 2024-02-20 o 		if client == nil {
108 1d5ddf5d 2024-02-20 o 			return Lookup(string(act.Object))
109 1d5ddf5d 2024-02-20 o 		}
110 1d5ddf5d 2024-02-20 o 		return client.Lookup(string(act.Object))
111 1d5ddf5d 2024-02-20 o 	}
112 1d5ddf5d 2024-02-20 o 	return Decode(buf)
113 1d5ddf5d 2024-02-20 o }
114 1d5ddf5d 2024-02-20 o 
115 1d5ddf5d 2024-02-20 o func Decode(r io.Reader) (*Activity, error) {
116 1d5ddf5d 2024-02-20 o 	var a Activity
117 1d5ddf5d 2024-02-20 o 	if err := json.NewDecoder(r).Decode(&a); err != nil {
118 1d5ddf5d 2024-02-20 o 		return nil, fmt.Errorf("decode activity: %w", err)
119 1d5ddf5d 2024-02-20 o 	}
120 1d5ddf5d 2024-02-20 o 	return &a, nil
121 1d5ddf5d 2024-02-20 o }
122 1d5ddf5d 2024-02-20 o 
123 71191436 2024-02-28 o func DecodeActor(r io.Reader) (*Actor, error) {
124 71191436 2024-02-28 o 	a, err := Decode(r)
125 71191436 2024-02-28 o 	if err != nil {
126 71191436 2024-02-28 o 		return nil, err
127 71191436 2024-02-28 o 	}
128 71191436 2024-02-28 o 	return activityToActor(a), nil
129 71191436 2024-02-28 o }
130 71191436 2024-02-28 o 
131 1d5ddf5d 2024-02-20 o type Actor struct {
132 71191436 2024-02-28 o 	AtContext string     `json:"@context"`
133 71191436 2024-02-28 o 	ID        string     `json:"id"`
134 71191436 2024-02-28 o 	Type      string     `json:"type"`
135 71191436 2024-02-28 o 	Name      string     `json:"name"`
136 71191436 2024-02-28 o 	Username  string     `json:"preferredUsername"`
137 77918b00 2024-03-07 o 	Summary   string     `json:"summary,omitempty"`
138 71191436 2024-02-28 o 	Inbox     string     `json:"inbox"`
139 71191436 2024-02-28 o 	Outbox    string     `json:"outbox"`
140 77918b00 2024-03-07 o 	Followers string     `json:"followers"`
141 71191436 2024-02-28 o 	Published *time.Time `json:"published,omitempty"`
142 71191436 2024-02-28 o 	PublicKey PublicKey  `json:"publicKey"`
143 1d5ddf5d 2024-02-20 o }
144 1d5ddf5d 2024-02-20 o 
145 1d5ddf5d 2024-02-20 o type PublicKey struct {
146 1d5ddf5d 2024-02-20 o 	ID           string `json:"id"`
147 1d5ddf5d 2024-02-20 o 	Owner        string `json:"owner"`
148 1d5ddf5d 2024-02-20 o 	PublicKeyPEM string `json:"publicKeyPem"`
149 1d5ddf5d 2024-02-20 o }
150 1d5ddf5d 2024-02-20 o 
151 25fed994 2024-03-12 o // Address generates the most likely address of the Actor.
152 25fed994 2024-03-12 o // The Actor's name (not the username) is used as the address' proper name, if present.
153 25fed994 2024-03-12 o // Implementors should verify the address using WebFinger.
154 25fed994 2024-03-12 o // For example, the followers address for Actor ID
155 25fed994 2024-03-12 o // https://hachyderm.io/users/otl is:
156 25fed994 2024-03-12 o //
157 25fed994 2024-03-12 o //	"Oliver Lowe" <otl+followers@hachyderm.io>
158 1d5ddf5d 2024-02-20 o func (a *Actor) Address() *mail.Address {
159 71191436 2024-02-28 o 	if a.Username == "" && a.Name == "" {
160 71191436 2024-02-28 o 		return &mail.Address{"", a.ID}
161 71191436 2024-02-28 o 	}
162 1d5ddf5d 2024-02-20 o 	trimmed := strings.TrimPrefix(a.ID, "https://")
163 1d5ddf5d 2024-02-20 o 	host, _, _ := strings.Cut(trimmed, "/")
164 1d5ddf5d 2024-02-20 o 	addr := fmt.Sprintf("%s@%s", a.Username, host)
165 1d5ddf5d 2024-02-20 o 	return &mail.Address{a.Name, addr}
166 1d5ddf5d 2024-02-20 o }
167 77918b00 2024-03-07 o 
168 25fed994 2024-03-12 o // FollowersAddress generates a non-standard address representing the Actor's followers
169 25fed994 2024-03-12 o // using plus addressing.
170 25fed994 2024-03-12 o // It is the Actor's address username part with a "+followers" suffix.
171 25fed994 2024-03-12 o // The address cannot be resolved using WebFinger.
172 25fed994 2024-03-12 o //
173 25fed994 2024-03-12 o // For example, the followers address for Actor ID
174 25fed994 2024-03-12 o // https://hachyderm.io/users/otl is:
175 25fed994 2024-03-12 o //
176 25fed994 2024-03-12 o //	"Oliver Lowe (followers)" <otl+followers@hachyderm.io>
177 77918b00 2024-03-07 o func (a *Actor) FollowersAddress() *mail.Address {
178 77918b00 2024-03-07 o 	if a.Followers == "" {
179 77918b00 2024-03-07 o 		return &mail.Address{"", ""}
180 77918b00 2024-03-07 o 	}
181 77918b00 2024-03-07 o 	addr := a.Address()
182 77918b00 2024-03-07 o 	user, domain, found := strings.Cut(addr.Address, "@")
183 77918b00 2024-03-07 o 	if !found {
184 77918b00 2024-03-07 o 		return &mail.Address{"", ""}
185 77918b00 2024-03-07 o 	}
186 77918b00 2024-03-07 o 	addr.Address = fmt.Sprintf("%s+followers@%s", user, domain)
187 77918b00 2024-03-07 o 	if addr.Name != "" {
188 77918b00 2024-03-07 o 		addr.Name += " (followers)"
189 77918b00 2024-03-07 o 	}
190 77918b00 2024-03-07 o 	return addr
191 77918b00 2024-03-07 o }