mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-11-02 20:02:25 -06:00 
			
		
		
		
	
		
			
				
	
	
		
			70 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			70 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
/*
 | 
						|
   GoToSocial
 | 
						|
   Copyright (C) 2021-2022 GoToSocial Authors admin@gotosocial.org
 | 
						|
 | 
						|
   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 dereferencing
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"net/url"
 | 
						|
	"sync"
 | 
						|
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/ap"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/db"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/gtsmodel"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/media"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/transport"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/typeutils"
 | 
						|
)
 | 
						|
 | 
						|
// Dereferencer wraps logic and functionality for doing dereferencing of remote accounts, statuses, etc, from federated instances.
 | 
						|
type Dereferencer interface {
 | 
						|
	GetRemoteAccount(ctx context.Context, username string, remoteAccountID *url.URL, refresh bool) (*gtsmodel.Account, bool, error)
 | 
						|
	EnrichRemoteAccount(ctx context.Context, username string, account *gtsmodel.Account) (*gtsmodel.Account, error)
 | 
						|
 | 
						|
	GetRemoteStatus(ctx context.Context, username string, remoteStatusID *url.URL, refresh, includeParent bool) (*gtsmodel.Status, ap.Statusable, bool, error)
 | 
						|
	EnrichRemoteStatus(ctx context.Context, username string, status *gtsmodel.Status, includeParent bool) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	GetRemoteInstance(ctx context.Context, username string, remoteInstanceURI *url.URL) (*gtsmodel.Instance, error)
 | 
						|
 | 
						|
	GetRemoteMedia(ctx context.Context, requestingUsername string, accountID string, remoteURL string, ai *media.AdditionalMediaInfo) (*media.ProcessingMedia, error)
 | 
						|
 | 
						|
	DereferenceAnnounce(ctx context.Context, announce *gtsmodel.Status, requestingUsername string) error
 | 
						|
	DereferenceThread(ctx context.Context, username string, statusIRI *url.URL) error
 | 
						|
 | 
						|
	Handshaking(ctx context.Context, username string, remoteAccountID *url.URL) bool
 | 
						|
}
 | 
						|
 | 
						|
type deref struct {
 | 
						|
	db                  db.DB
 | 
						|
	typeConverter       typeutils.TypeConverter
 | 
						|
	transportController transport.Controller
 | 
						|
	mediaManager        media.Manager
 | 
						|
	handshakes          map[string][]*url.URL
 | 
						|
	handshakeSync       *sync.Mutex // mutex to lock/unlock when checking or updating the handshakes map
 | 
						|
}
 | 
						|
 | 
						|
// NewDereferencer returns a Dereferencer initialized with the given parameters.
 | 
						|
func NewDereferencer(db db.DB, typeConverter typeutils.TypeConverter, transportController transport.Controller, mediaManager media.Manager) Dereferencer {
 | 
						|
	return &deref{
 | 
						|
		db:                  db,
 | 
						|
		typeConverter:       typeConverter,
 | 
						|
		transportController: transportController,
 | 
						|
		mediaManager:        mediaManager,
 | 
						|
		handshakeSync:       &sync.Mutex{},
 | 
						|
	}
 | 
						|
}
 |