summaryrefslogtreecommitdiff
path: root/internal/gtsmodel/account.go
blob: a59746be514319276844c367e14c4f125efe948a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
/*
   GoToSocial
   Copyright (C) 2021 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 gtsmodel contains types used *internally* by GoToSocial and added/removed/selected from the database.
// These types should never be serialized and/or sent out via public APIs, as they contain sensitive information.
// The annotation used on these structs is for handling them via the bun-db ORM.
// See here for more info on bun model annotations: https://bun.uptrace.dev/guide/models.html
package gtsmodel

import (
	"crypto/rsa"
	"time"
)

// Account represents either a local or a remote fediverse account, gotosocial or otherwise (mastodon, pleroma, etc)
type Account struct {
	/*
		BASIC INFO
	*/

	// id of this account in the local database
	ID string `bun:"type:CHAR(26),pk,nullzero,notnull,unique"`
	// Username of the account, should just be a string of [a-z0-9_]. Can be added to domain to create the full username in the form ``[username]@[domain]`` eg., ``user_96@example.org``
	Username string `bun:",notnull,unique:userdomain,nullzero"` // username and domain should be unique *with* each other
	// Domain of the account, will be null if this is a local account, otherwise something like ``example.org`` or ``mastodon.social``. Should be unique with username.
	Domain string `bun:",unique:userdomain,nullzero"` // username and domain should be unique *with* each other

	/*
		ACCOUNT METADATA
	*/

	// ID of the avatar as a media attachment
	AvatarMediaAttachmentID string           `bun:"type:CHAR(26),nullzero"`
	AvatarMediaAttachment   *MediaAttachment `bun:"rel:belongs-to"`
	// For a non-local account, where can the header be fetched?
	AvatarRemoteURL string `bun:",nullzero"`
	// ID of the header as a media attachment
	HeaderMediaAttachmentID string           `bun:"type:CHAR(26),nullzero"`
	HeaderMediaAttachment   *MediaAttachment `bun:"rel:belongs-to"`
	// For a non-local account, where can the header be fetched?
	HeaderRemoteURL string `bun:",nullzero"`
	// DisplayName for this account. Can be empty, then just the Username will be used for display purposes.
	DisplayName string `bun:",nullzero"`
	// a key/value map of fields that this account has added to their profile
	Fields []Field
	// A note that this account has on their profile (ie., the account's bio/description of themselves)
	Note string `bun:",nullzero"`
	// Is this a memorial account, ie., has the user passed away?
	Memorial bool `bun:",nullzero"`
	// This account has moved this account id in the database
	MovedToAccountID string `bun:"type:CHAR(26),nullzero"`
	// When was this account created?
	CreatedAt time.Time `bun:",nullzero,notnull,default:current_timestamp"`
	// When was this account last updated?
	UpdatedAt time.Time `bun:",nullzero,notnull,default:current_timestamp"`
	// Does this account identify itself as a bot?
	Bot bool
	// What reason was given for signing up when this account was created?
	Reason string `bun:",nullzero"`

	/*
		USER AND PRIVACY PREFERENCES
	*/

	// Does this account need an approval for new followers?
	Locked bool `bun:",default:true"`
	// Should this account be shown in the instance's profile directory?
	Discoverable bool `bun:",default:false"`
	// Default post privacy for this account
	Privacy Visibility `bun:",default:'public'"`
	// Set posts from this account to sensitive by default?
	Sensitive bool `bun:",default:false"`
	// What language does this account post in?
	Language string `bun:",default:'en'"`

	/*
		ACTIVITYPUB THINGS
	*/

	// What is the activitypub URI for this account discovered by webfinger?
	URI string `bun:",unique,nullzero"`
	// At which URL can we see the user account in a web browser?
	URL string `bun:",unique,nullzero"`
	// Last time this account was located using the webfinger API.
	LastWebfingeredAt time.Time `bun:",nullzero"`
	// Address of this account's activitypub inbox, for sending activity to
	InboxURI string `bun:",unique,nullzero"`
	// Address of this account's activitypub outbox
	OutboxURI string `bun:",unique,nullzero"`
	// URI for getting the following list of this account
	FollowingURI string `bun:",unique,nullzero"`
	// URI for getting the followers list of this account
	FollowersURI string `bun:",unique,nullzero"`
	// URL for getting the featured collection list of this account
	FeaturedCollectionURI string `bun:",unique,nullzero"`
	// What type of activitypub actor is this account?
	ActorType string `bun:",nullzero"`
	// This account is associated with x account id
	AlsoKnownAs string `bun:",nullzero"`

	/*
		CRYPTO FIELDS
	*/

	// Privatekey for validating activitypub requests, will only be defined for local accounts
	PrivateKey *rsa.PrivateKey
	// Publickey for encoding activitypub requests, will be defined for both local and remote accounts
	PublicKey *rsa.PublicKey
	// Web-reachable location of this account's public key
	PublicKeyURI string `bun:",nullzero"`

	/*
		ADMIN FIELDS
	*/

	// When was this account set to have all its media shown as sensitive?
	SensitizedAt time.Time `bun:",nullzero"`
	// When was this account silenced (eg., statuses only visible to followers, not public)?
	SilencedAt time.Time `bun:",nullzero"`
	// When was this account suspended (eg., don't allow it to log in/post, don't accept media/posts from this account)
	SuspendedAt time.Time `bun:",nullzero"`
	// Should we hide this account's collections?
	HideCollections bool
	// id of the database entry that caused this account to become suspended -- can be an account ID or a domain block ID
	SuspensionOrigin string `bun:"type:CHAR(26),nullzero"`
}

// Field represents a key value field on an account, for things like pronouns, website, etc.
// VerifiedAt is optional, to be used only if Value is a URL to a webpage that contains the
// username of the user.
type Field struct {
	Name       string
	Value      string
	VerifiedAt time.Time `bun:",nullzero"`
}