mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-11-03 20:22:25 -06:00 
			
		
		
		
	* specifically use a much shorter refresh limit for statuses with polls * allow specifying whether status must be upToDate in calls to Get(Visible)?TargetStatusBy_(), limit force refresh to 5 minute cooldown * remove the PollID check from statusUpToDate() * remove unnecessary force flag checks * remove unused field * check refresh status error * use argument name 'refresh' instead of 'upToDate' to better fit with the codebase * add statuses_poll_id_idx * remove the definitely-not copy-pasted comment i accidentally typed out in full * only synchronously refresh if the refresh flag is provided, otherwise do async * fix wrong force value being provided for async --------- Co-authored-by: tobi <tobi.smethurst@protonmail.com>
		
			
				
	
	
		
			84 lines
		
	
	
	
		
			4.1 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			84 lines
		
	
	
	
		
			4.1 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 db
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/gtsmodel"
 | 
						|
)
 | 
						|
 | 
						|
// Status contains functions for getting statuses, creating statuses, and checking various other fields on statuses.
 | 
						|
type Status interface {
 | 
						|
	// GetStatusByID fetches the status from the database with matching id column.
 | 
						|
	GetStatusByID(ctx context.Context, id string) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusByURI fetches the status from the database with matching uri column.
 | 
						|
	GetStatusByURI(ctx context.Context, uri string) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusByURL fetches the status from the database with matching url column.
 | 
						|
	GetStatusByURL(ctx context.Context, uri string) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusByPollID fetches the status from the database with matching poll_id column.
 | 
						|
	GetStatusByPollID(ctx context.Context, pollID string) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusBoost fetches the status whose boost_of_id column refers to boostOfID, authored by given account ID.
 | 
						|
	GetStatusBoost(ctx context.Context, boostOfID string, byAccountID string) (*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// PopulateStatus ensures that all sub-models of a status are populated (e.g. mentions, attachments, etc).
 | 
						|
	PopulateStatus(ctx context.Context, status *gtsmodel.Status) error
 | 
						|
 | 
						|
	// PutStatus stores one status in the database.
 | 
						|
	PutStatus(ctx context.Context, status *gtsmodel.Status) error
 | 
						|
 | 
						|
	// UpdateStatus updates one status in the database.
 | 
						|
	UpdateStatus(ctx context.Context, status *gtsmodel.Status, columns ...string) error
 | 
						|
 | 
						|
	// DeleteStatusByID deletes one status from the database.
 | 
						|
	DeleteStatusByID(ctx context.Context, id string) error
 | 
						|
 | 
						|
	// GetStatuses gets a slice of statuses corresponding to the given status IDs.
 | 
						|
	GetStatusesByIDs(ctx context.Context, ids []string) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusesUsingEmoji fetches all status models using emoji with given ID stored in their 'emojis' column.
 | 
						|
	GetStatusesUsingEmoji(ctx context.Context, emojiID string) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusReplies returns the *direct* (i.e. in_reply_to_id column) replies to this status ID, ordered DESC by ID.
 | 
						|
	GetStatusReplies(ctx context.Context, statusID string) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// CountStatusReplies returns the number of stored *direct* (i.e. in_reply_to_id column) replies to this status ID.
 | 
						|
	CountStatusReplies(ctx context.Context, statusID string) (int, error)
 | 
						|
 | 
						|
	// GetStatusBoosts returns all statuses whose boost_of_id column refer to given status ID.
 | 
						|
	GetStatusBoosts(ctx context.Context, statusID string) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// CountStatusBoosts returns the number of stored boosts for status ID.
 | 
						|
	CountStatusBoosts(ctx context.Context, statusID string) (int, error)
 | 
						|
 | 
						|
	// IsStatusBoostedBy checks whether the given status ID is boosted by account ID.
 | 
						|
	IsStatusBoostedBy(ctx context.Context, statusID string, accountID string) (bool, error)
 | 
						|
 | 
						|
	// GetStatusParents gets the parent statuses of a given status.
 | 
						|
	GetStatusParents(ctx context.Context, status *gtsmodel.Status) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// GetStatusChildren gets the child statuses of a given status.
 | 
						|
	GetStatusChildren(ctx context.Context, statusID string) ([]*gtsmodel.Status, error)
 | 
						|
 | 
						|
	// IsStatusBookmarkedBy checks if a given status has been bookmarked by a given account ID
 | 
						|
	IsStatusBookmarkedBy(ctx context.Context, status *gtsmodel.Status, accountID string) (bool, error)
 | 
						|
}
 |