mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-10-28 13:52:25 -05:00 
			
		
		
		
	# Description Adds JSON logging as an optional alternative log output format. In the process this moves our log formatting itself into a separate subpkg to make it more easily modular, and improves caller name getting with some calling function name caching. ## Checklist - [x] I/we have read the [GoToSocial contribution guidelines](https://codeberg.org/superseriousbusiness/gotosocial/src/branch/main/CONTRIBUTING.md). - [x] I/we have discussed the proposed changes already, either in an issue on the repository, or in the Matrix chat. - [x] I/we have not leveraged AI to create the proposed changes. - [x] I/we have performed a self-review of added code. - [x] I/we have written code that is legible and maintainable by others. - [x] I/we have commented the added code, particularly in hard-to-understand areas. - [x] I/we have made any necessary changes to documentation. - [ ] I/we have added tests that cover new code. - [x] I/we have run tests and they pass locally with the changes. - [x] I/we have run `go fmt ./...` and `golangci-lint run`. Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4355 Co-authored-by: kim <grufwub@gmail.com> Co-committed-by: kim <grufwub@gmail.com>
		
			
				
	
	
		
			236 lines
		
	
	
	
		
			7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			236 lines
		
	
	
	
		
			7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| // GoToSocial
 | |
| // Copyright (C) GoToSocial Authors admin@gotosocial.org
 | |
| // SPDX-License-Identifier: AGPL-3.0-or-later
 | |
| //
 | |
| // This program is free software: you can redistribute it and/or modify
 | |
| // it under the terms of the GNU Affero General Public License as published by
 | |
| // the Free Software Foundation, either version 3 of the License, or
 | |
| // (at your option) any later version.
 | |
| //
 | |
| // This program is distributed in the hope that it will be useful,
 | |
| // but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
| // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | |
| // GNU Affero General Public License for more details.
 | |
| //
 | |
| // You should have received a copy of the GNU Affero General Public License
 | |
| // along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | |
| 
 | |
| package federatingdb
 | |
| 
 | |
| import (
 | |
| 	"context"
 | |
| 	"encoding/json"
 | |
| 	"fmt"
 | |
| 	"net/url"
 | |
| 
 | |
| 	"code.superseriousbusiness.org/activity/streams"
 | |
| 	"code.superseriousbusiness.org/activity/streams/vocab"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/ap"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/config"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/gtscontext"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/gtsmodel"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/id"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/log"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/uris"
 | |
| 	"codeberg.org/gruf/go-byteutil"
 | |
| )
 | |
| 
 | |
| func typeNames(objects []ap.TypeOrIRI) []string {
 | |
| 	names := make([]string, len(objects))
 | |
| 	for i, object := range objects {
 | |
| 		if object.IsIRI() {
 | |
| 			names[i] = "IRI"
 | |
| 		} else if t := object.GetType(); t != nil {
 | |
| 			names[i] = t.GetTypeName()
 | |
| 		} else {
 | |
| 			names[i] = "nil"
 | |
| 		}
 | |
| 	}
 | |
| 	return names
 | |
| }
 | |
| 
 | |
| // isSender returns whether an object with AttributedTo property comes from the given requesting account.
 | |
| func isSender(with ap.WithAttributedTo, requester *gtsmodel.Account) bool {
 | |
| 	for _, uri := range ap.GetAttributedTo(with) {
 | |
| 		if uri.String() == requester.URI {
 | |
| 			return true
 | |
| 		}
 | |
| 	}
 | |
| 	return false
 | |
| }
 | |
| 
 | |
| func sameActor(actor1 vocab.ActivityStreamsActorProperty, actor2 vocab.ActivityStreamsActorProperty) bool {
 | |
| 	if actor1 == nil || actor2 == nil {
 | |
| 		return false
 | |
| 	}
 | |
| 
 | |
| 	for a1Iter := actor1.Begin(); a1Iter != actor1.End(); a1Iter = a1Iter.Next() {
 | |
| 		a1IRI := a1Iter.GetIRI()
 | |
| 		if a1IRI == nil {
 | |
| 			return false
 | |
| 		}
 | |
| 
 | |
| 		a1IRIStr := a1IRI.String()
 | |
| 		for a2Iter := actor2.Begin(); a2Iter != actor2.End(); a2Iter = a2Iter.Next() {
 | |
| 			a2IRI := a2Iter.GetIRI()
 | |
| 			if a2IRI == nil {
 | |
| 				return false
 | |
| 			}
 | |
| 
 | |
| 			a2IRIStr := a2IRI.String()
 | |
| 			if a1IRIStr == a2IRIStr {
 | |
| 				return true
 | |
| 			}
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	return false
 | |
| }
 | |
| 
 | |
| // NewID creates a new IRI id for the provided activity or object. The
 | |
| // implementation does not need to set the 'id' property and simply
 | |
| // needs to determine the value.
 | |
| //
 | |
| // The go-fed library will handle setting the 'id' property on the
 | |
| // activity or object provided with the value returned.
 | |
| func (f *DB) NewID(ctx context.Context, t vocab.Type) (idURL *url.URL, err error) {
 | |
| 	log.DebugKV(ctx, "newID", serialize{t})
 | |
| 
 | |
| 	// Most of our types set an ID already
 | |
| 	// by this point, return this if found.
 | |
| 	idProp := t.GetJSONLDId()
 | |
| 	if idProp != nil && idProp.IsIRI() {
 | |
| 		return idProp.GetIRI(), nil
 | |
| 	}
 | |
| 
 | |
| 	if t.GetTypeName() == ap.ActivityFollow {
 | |
| 		follow, _ := t.(vocab.ActivityStreamsFollow)
 | |
| 
 | |
| 		// If an actor URI has been set, create a new ID
 | |
| 		// based on actor (i.e. followER not the followEE).
 | |
| 		if uri := ap.GetActorIRIs(follow); len(uri) == 1 {
 | |
| 			if actorAccount, err := f.state.DB.GetAccountByURI(ctx, uri[0].String()); err == nil {
 | |
| 				newID, err := id.NewRandomULID()
 | |
| 				if err != nil {
 | |
| 					return nil, err
 | |
| 				}
 | |
| 				return url.Parse(uris.GenerateURIForFollow(actorAccount.Username, newID))
 | |
| 			}
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	// Default fallback behaviour:
 | |
| 	// {proto}://{host}/{newULID}
 | |
| 	return &url.URL{
 | |
| 		Scheme: config.GetProtocol(),
 | |
| 		Host:   config.GetHost(),
 | |
| 		Path:   "/" + id.NewULID(),
 | |
| 	}, nil
 | |
| }
 | |
| 
 | |
| // ActorForOutbox fetches the local actor's IRI for the given outbox IRI.
 | |
| //
 | |
| // The library makes this call only after acquiring a lock first.
 | |
| func (f *DB) ActorForOutbox(ctx context.Context, outboxIRI *url.URL) (actorIRI *url.URL, err error) {
 | |
| 	acct, err := f.state.DB.GetOneAccountByOutboxURI(ctx, outboxIRI.String())
 | |
| 	if err != nil {
 | |
| 		return nil, err
 | |
| 	}
 | |
| 	return url.Parse(acct.URI)
 | |
| }
 | |
| 
 | |
| // ActorForInbox fetches the local actor's IRI for the given inbox IRI.
 | |
| //
 | |
| // The library makes this call only after acquiring a lock first.
 | |
| func (f *DB) ActorForInbox(ctx context.Context, inboxIRI *url.URL) (actorIRI *url.URL, err error) {
 | |
| 	acct, err := f.state.DB.GetOneAccountByInboxURI(ctx, inboxIRI.String())
 | |
| 	if err != nil {
 | |
| 		return nil, err
 | |
| 	}
 | |
| 	return url.Parse(acct.URI)
 | |
| }
 | |
| 
 | |
| // collectFollows takes a slice of iris and converts them into ActivityStreamsCollection of IRIs.
 | |
| func (f *DB) collectIRIs(_ context.Context, iris []*url.URL) (vocab.ActivityStreamsCollection, error) {
 | |
| 	collection := streams.NewActivityStreamsCollection()
 | |
| 	items := streams.NewActivityStreamsItemsProperty()
 | |
| 	for _, i := range iris {
 | |
| 		items.AppendIRI(i)
 | |
| 	}
 | |
| 	collection.SetActivityStreamsItems(items)
 | |
| 	return collection, nil
 | |
| }
 | |
| 
 | |
| // activityContext represents the context in
 | |
| // which a call to one of the federatingdb
 | |
| // functions is taking place, including the
 | |
| // account who initiated the request via POST
 | |
| // to an inbox, and the account who received
 | |
| // the request in their inbox.
 | |
| type activityContext struct {
 | |
| 	// The account that owns the inbox
 | |
| 	// or URI being interacted with.
 | |
| 	receivingAcct *gtsmodel.Account
 | |
| 
 | |
| 	// The account whose keyId was used
 | |
| 	// to POST a request to the inbox.
 | |
| 	requestingAcct *gtsmodel.Account
 | |
| 
 | |
| 	// Whether this is an internal request,
 | |
| 	// ie., one originating not from the
 | |
| 	// API but from inside the instance.
 | |
| 	//
 | |
| 	// If the request is internal, it's
 | |
| 	// safe to assume that the activity
 | |
| 	// has already been processed elsewhere,
 | |
| 	// and we can return with no action.
 | |
| 	internal bool
 | |
| }
 | |
| 
 | |
| // getActivityContext extracts the context in
 | |
| // which an Activity is taking place from the
 | |
| // context.Context passed in to one of the
 | |
| // federatingdb functions.
 | |
| func getActivityContext(ctx context.Context) activityContext {
 | |
| 	receivingAcct := gtscontext.ReceivingAccount(ctx)
 | |
| 	requestingAcct := gtscontext.RequestingAccount(ctx)
 | |
| 
 | |
| 	// If the receiving account wasn't set on
 | |
| 	// the context, that means this request
 | |
| 	// didn't pass through the fedi API, but
 | |
| 	// came from inside the instance as the
 | |
| 	// result of a local activity.
 | |
| 	internal := receivingAcct == nil
 | |
| 
 | |
| 	return activityContext{
 | |
| 		receivingAcct:  receivingAcct,
 | |
| 		requestingAcct: requestingAcct,
 | |
| 		internal:       internal,
 | |
| 	}
 | |
| }
 | |
| 
 | |
| // serialize wraps a vocab.Type to provide
 | |
| // lazy-serialization along with error output.
 | |
| type serialize struct{ item vocab.Type }
 | |
| 
 | |
| func (s serialize) MarshalJSON() ([]byte, error) {
 | |
| 	m, err := ap.Serialize(s.item)
 | |
| 	if err != nil {
 | |
| 		return nil, fmt.Errorf("error serializing: %w", err)
 | |
| 	}
 | |
| 	return json.Marshal(m)
 | |
| }
 | |
| 
 | |
| func (s serialize) String() string {
 | |
| 	m, err := ap.Serialize(s.item)
 | |
| 	if err != nil {
 | |
| 		return "!(error serializing: " + err.Error() + ")"
 | |
| 	}
 | |
| 
 | |
| 	b, err := json.Marshal(m)
 | |
| 	if err != nil {
 | |
| 		return "!(error marshaling: " + err.Error() + ")"
 | |
| 	}
 | |
| 
 | |
| 	return byteutil.B2S(b)
 | |
| }
 |