PeerTube/server/models/actor/actor-follow.ts

673 lines
18 KiB
TypeScript
Raw Normal View History

2022-08-17 15:36:03 +02:00
import { difference } from 'lodash'
import { Attributes, FindOptions, Includeable, IncludeOptions, Op, QueryTypes, Transaction, WhereAttributeHash } from 'sequelize'
import {
AfterCreate,
AfterDestroy,
AfterUpdate,
AllowNull,
BelongsTo,
Column,
CreatedAt,
DataType,
Default,
ForeignKey,
2020-11-20 11:21:08 +01:00
Is,
IsInt,
Max,
Model,
Table,
UpdatedAt
} from 'sequelize-typescript'
2020-11-20 11:21:08 +01:00
import { isActivityPubUrlValid } from '@server/helpers/custom-validators/activitypub/misc'
2021-10-13 16:18:42 +02:00
import { afterCommitIfTransaction } from '@server/helpers/database-utils'
2020-11-20 11:21:08 +01:00
import { getServerActor } from '@server/models/application/application'
2019-08-15 11:53:26 +02:00
import {
2021-10-14 10:52:15 +02:00
MActor,
MActorFollowActors,
2019-08-15 11:53:26 +02:00
MActorFollowActorsDefault,
MActorFollowActorsDefaultSubscription,
MActorFollowFollowingHost,
2019-08-20 19:05:31 +02:00
MActorFollowFormattable,
2019-08-15 11:53:26 +02:00
MActorFollowSubscriptions
2020-06-18 10:45:25 +02:00
} from '@server/types/models'
import { AttributesOnly } from '@shared/typescript-utils'
2020-11-20 11:21:08 +01:00
import { FollowState } from '../../../shared/models/actors'
import { ActorFollow } from '../../../shared/models/actors/follow.model'
import { logger } from '../../helpers/logger'
import { ACTOR_FOLLOW_SCORE, CONSTRAINTS_FIELDS, FOLLOW_STATES, SERVER_ACTOR_NAME, SORTABLE_COLUMNS } from '../../initializers/constants'
2020-11-20 11:21:08 +01:00
import { AccountModel } from '../account/account'
import { ServerModel } from '../server/server'
import { doesExist } from '../shared/query'
2023-01-10 11:09:30 +01:00
import { buildSQLAttributes, createSafeIn, getSort, searchAttribute, throwIfNotValid } from '../shared'
2020-11-20 11:21:08 +01:00
import { VideoChannelModel } from '../video/video-channel'
import { ActorModel, unusedActorAttributesForAPI } from './actor'
import { InstanceListFollowersQueryBuilder, ListFollowersOptions } from './sql/instance-list-followers-query-builder'
import { InstanceListFollowingQueryBuilder, ListFollowingOptions } from './sql/instance-list-following-query-builder'
2017-12-14 17:38:41 +01:00
@Table({
tableName: 'actorFollow',
indexes: [
{
fields: [ 'actorId' ]
},
{
fields: [ 'targetActorId' ]
},
{
fields: [ 'actorId', 'targetActorId' ],
unique: true
},
{
fields: [ 'score' ]
2020-11-20 11:21:08 +01:00
},
{
fields: [ 'url' ],
unique: true
2017-12-14 17:38:41 +01:00
}
]
})
2021-05-12 14:09:04 +02:00
export class ActorFollowModel extends Model<Partial<AttributesOnly<ActorFollowModel>>> {
2017-12-14 17:38:41 +01:00
@AllowNull(false)
2022-08-17 15:36:03 +02:00
@Column(DataType.ENUM(...Object.values(FOLLOW_STATES)))
2017-12-14 17:38:41 +01:00
state: FollowState
@AllowNull(false)
@Default(ACTOR_FOLLOW_SCORE.BASE)
@IsInt
@Max(ACTOR_FOLLOW_SCORE.MAX)
@Column
score: number
2020-11-20 11:21:08 +01:00
// Allow null because we added this column in PeerTube v3, and don't want to generate fake URLs of remote follows
@AllowNull(true)
@Is('ActorFollowUrl', value => throwIfNotValid(value, isActivityPubUrlValid, 'url'))
@Column(DataType.STRING(CONSTRAINTS_FIELDS.COMMONS.URL.max))
url: string
2017-12-14 17:38:41 +01:00
@CreatedAt
createdAt: Date
@UpdatedAt
updatedAt: Date
@ForeignKey(() => ActorModel)
@Column
actorId: number
@BelongsTo(() => ActorModel, {
foreignKey: {
name: 'actorId',
allowNull: false
},
as: 'ActorFollower',
onDelete: 'CASCADE'
})
ActorFollower: ActorModel
@ForeignKey(() => ActorModel)
@Column
targetActorId: number
@BelongsTo(() => ActorModel, {
foreignKey: {
name: 'targetActorId',
allowNull: false
},
as: 'ActorFollowing',
onDelete: 'CASCADE'
})
ActorFollowing: ActorModel
2018-01-12 11:47:45 +01:00
@AfterCreate
@AfterUpdate
static incrementFollowerAndFollowingCount (instance: ActorFollowModel, options: any) {
2021-10-13 16:18:42 +02:00
return afterCommitIfTransaction(options.transaction, () => {
return Promise.all([
ActorModel.rebuildFollowsCount(instance.actorId, 'following'),
ActorModel.rebuildFollowsCount(instance.targetActorId, 'followers')
])
})
2018-01-12 11:47:45 +01:00
}
@AfterDestroy
static decrementFollowerAndFollowingCount (instance: ActorFollowModel, options: any) {
2021-10-13 16:18:42 +02:00
return afterCommitIfTransaction(options.transaction, () => {
return Promise.all([
ActorModel.rebuildFollowsCount(instance.actorId, 'following'),
ActorModel.rebuildFollowsCount(instance.targetActorId, 'followers')
])
})
2018-01-12 11:47:45 +01:00
}
2023-01-09 10:29:23 +01:00
// ---------------------------------------------------------------------------
static getSQLAttributes (tableName: string, aliasPrefix = '') {
return buildSQLAttributes({
model: this,
tableName,
aliasPrefix
})
}
// ---------------------------------------------------------------------------
2021-10-14 10:52:15 +02:00
/*
* @deprecated Use `findOrCreateCustom` instead
*/
static findOrCreate (): any {
2021-10-19 09:44:43 +02:00
throw new Error('Must not be called')
2021-10-14 10:52:15 +02:00
}
// findOrCreate has issues with actor follow hooks
static async findOrCreateCustom (options: {
byActor: MActor
targetActor: MActor
activityId: string
state: FollowState
transaction: Transaction
}): Promise<[ MActorFollowActors, boolean ]> {
const { byActor, targetActor, activityId, state, transaction } = options
let created = false
let actorFollow: MActorFollowActors = await ActorFollowModel.loadByActorAndTarget(byActor.id, targetActor.id, transaction)
if (!actorFollow) {
created = true
actorFollow = await ActorFollowModel.create({
actorId: byActor.id,
targetActorId: targetActor.id,
url: activityId,
state
}, { transaction })
actorFollow.ActorFollowing = targetActor
actorFollow.ActorFollower = byActor
}
return [ actorFollow, created ]
}
2019-08-02 09:46:48 +02:00
static removeFollowsOf (actorId: number, t?: Transaction) {
const query = {
where: {
[Op.or]: [
{
actorId
},
{
targetActorId: actorId
}
]
},
transaction: t
}
return ActorFollowModel.destroy(query)
}
// Remove actor follows with a score of 0 (too many requests where they were unreachable)
static async removeBadActorFollows () {
const actorFollows = await ActorFollowModel.listBadActorFollows()
const actorFollowsRemovePromises = actorFollows.map(actorFollow => actorFollow.destroy())
await Promise.all(actorFollowsRemovePromises)
const numberOfActorFollowsRemoved = actorFollows.length
if (numberOfActorFollowsRemoved) logger.info('Removed bad %d actor follows.', numberOfActorFollowsRemoved)
}
static isFollowedBy (actorId: number, followerActorId: number) {
const query = `SELECT 1 FROM "actorFollow" ` +
`WHERE "actorId" = $followerActorId AND "targetActorId" = $actorId AND "state" = 'accepted' ` +
`LIMIT 1`
2023-01-10 11:09:30 +01:00
return doesExist(this.sequelize, query, { actorId, followerActorId })
}
2020-12-08 14:30:29 +01:00
static loadByActorAndTarget (actorId: number, targetActorId: number, t?: Transaction): Promise<MActorFollowActorsDefault> {
2017-12-14 17:38:41 +01:00
const query = {
where: {
actorId,
2022-07-13 11:58:01 +02:00
targetActorId
2017-12-14 17:38:41 +01:00
},
include: [
{
model: ActorModel,
required: true,
as: 'ActorFollower'
},
{
model: ActorModel,
required: true,
as: 'ActorFollowing'
}
],
transaction: t
}
return ActorFollowModel.findOne(query)
}
static loadByActorAndTargetNameAndHostForAPI (options: {
actorId: number
targetName: string
targetHost: string
state?: FollowState
transaction?: Transaction
}): Promise<MActorFollowActorsDefaultSubscription> {
const { actorId, targetHost, targetName, state, transaction } = options
2019-04-18 11:28:17 +02:00
const actorFollowingPartInclude: IncludeOptions = {
model: ActorModel,
required: true,
as: 'ActorFollowing',
where: {
preferredUsername: targetName
2018-08-21 10:34:18 +02:00
},
include: [
{
2018-08-23 17:58:39 +02:00
model: VideoChannelModel.unscoped(),
2018-08-21 10:34:18 +02:00
required: false
}
]
}
if (targetHost === null) {
actorFollowingPartInclude.where['serverId'] = null
} else {
2018-08-21 10:34:18 +02:00
actorFollowingPartInclude.include.push({
model: ServerModel,
required: true,
where: {
host: targetHost
}
})
}
2022-07-27 13:44:40 +02:00
const where: WhereAttributeHash<Attributes<ActorFollowModel>> = { actorId }
if (state) where.state = state
const query: FindOptions<Attributes<ActorFollowModel>> = {
where,
2017-12-14 17:38:41 +01:00
include: [
actorFollowingPartInclude,
{
model: ActorModel,
required: true,
as: 'ActorFollower'
}
2017-12-14 17:38:41 +01:00
],
transaction
2017-12-14 17:38:41 +01:00
}
return ActorFollowModel.findOne(query)
2018-08-23 17:58:39 +02:00
}
2021-10-19 09:44:43 +02:00
static listSubscriptionsOf (actorId: number, targets: { name: string, host?: string }[]): Promise<MActorFollowFollowingHost[]> {
2018-08-23 17:58:39 +02:00
const whereTab = targets
.map(t => {
if (t.host) {
return {
2020-01-31 16:56:52 +01:00
[Op.and]: [
2018-08-23 17:58:39 +02:00
{
2020-01-31 16:56:52 +01:00
$preferredUsername$: t.name
2018-08-23 17:58:39 +02:00
},
{
2020-01-31 16:56:52 +01:00
$host$: t.host
2018-08-23 17:58:39 +02:00
}
]
}
}
return {
2020-01-31 16:56:52 +01:00
[Op.and]: [
2018-08-23 17:58:39 +02:00
{
2020-01-31 16:56:52 +01:00
$preferredUsername$: t.name
2018-08-23 17:58:39 +02:00
},
{
2020-01-31 16:56:52 +01:00
$serverId$: null
2018-08-23 17:58:39 +02:00
}
]
}
})
const query = {
2020-12-08 14:30:29 +01:00
attributes: [ 'id' ],
2018-08-23 17:58:39 +02:00
where: {
2020-01-31 16:56:52 +01:00
[Op.and]: [
2018-08-23 17:58:39 +02:00
{
2020-01-31 16:56:52 +01:00
[Op.or]: whereTab
2018-08-23 17:58:39 +02:00
},
{
state: 'accepted',
2018-08-23 17:58:39 +02:00
actorId
}
]
},
include: [
{
attributes: [ 'preferredUsername' ],
model: ActorModel.unscoped(),
required: true,
as: 'ActorFollowing',
include: [
{
attributes: [ 'host' ],
model: ServerModel.unscoped(),
required: false
}
]
}
]
}
return ActorFollowModel.findAll(query)
}
static listInstanceFollowingForApi (options: ListFollowingOptions) {
return Promise.all([
new InstanceListFollowingQueryBuilder(this.sequelize, options).countFollowing(),
new InstanceListFollowingQueryBuilder(this.sequelize, options).listFollowing()
]).then(([ total, data ]) => ({ total, data }))
2017-12-14 17:38:41 +01:00
}
static listFollowersForApi (options: ListFollowersOptions) {
return Promise.all([
new InstanceListFollowersQueryBuilder(this.sequelize, options).countFollowers(),
new InstanceListFollowersQueryBuilder(this.sequelize, options).listFollowers()
]).then(([ total, data ]) => ({ total, data }))
}
2020-07-23 21:30:04 +02:00
static listSubscriptionsForApi (options: {
actorId: number
start: number
count: number
sort: string
search?: string
}) {
const { actorId, start, count, sort } = options
const where = {
state: 'accepted',
2022-07-13 11:58:01 +02:00
actorId
2020-07-23 21:30:04 +02:00
}
if (options.search) {
Object.assign(where, {
[Op.or]: [
searchAttribute(options.search, '$ActorFollowing.preferredUsername$'),
searchAttribute(options.search, '$ActorFollowing.VideoChannel.name$')
]
})
}
const getQuery = (forCount: boolean) => {
let channelInclude: Includeable[] = []
if (forCount !== true) {
channelInclude = [
{
attributes: {
exclude: unusedActorAttributesForAPI
},
model: ActorModel,
required: true
},
{
model: AccountModel.unscoped(),
required: true,
include: [
{
attributes: {
exclude: unusedActorAttributesForAPI
2018-08-23 17:58:39 +02:00
},
model: ActorModel,
required: true
}
]
}
]
}
return {
attributes: forCount === true
? []
: SORTABLE_COLUMNS.USER_SUBSCRIPTIONS,
distinct: true,
offset: start,
limit: count,
order: getSort(sort),
where,
include: [
{
attributes: [ 'id' ],
model: ActorModel.unscoped(),
as: 'ActorFollowing',
required: true,
include: [
{
model: VideoChannelModel.unscoped(),
required: true,
include: channelInclude
}
]
}
]
}
}
return Promise.all([
ActorFollowModel.count(getQuery(true)),
ActorFollowModel.findAll<MActorFollowSubscriptions>(getQuery(false))
]).then(([ total, rows ]) => ({
total,
data: rows.map(r => r.ActorFollowing.VideoChannel)
}))
}
static async keepUnfollowedInstance (hosts: string[]) {
const followerId = (await getServerActor()).id
const query = {
2019-09-04 11:39:25 +02:00
attributes: [ 'id' ],
where: {
actorId: followerId
},
include: [
{
2019-09-04 11:39:25 +02:00
attributes: [ 'id' ],
model: ActorModel.unscoped(),
required: true,
as: 'ActorFollowing',
where: {
preferredUsername: SERVER_ACTOR_NAME
},
include: [
{
attributes: [ 'host' ],
model: ServerModel.unscoped(),
required: true,
where: {
host: {
[Op.in]: hosts
}
}
}
]
}
]
}
const res = await ActorFollowModel.findAll(query)
2019-09-04 11:39:25 +02:00
const followedHosts = res.map(row => row.ActorFollowing.Server.host)
return difference(hosts, followedHosts)
}
2019-04-18 11:28:17 +02:00
static listAcceptedFollowerUrlsForAP (actorIds: number[], t: Transaction, start?: number, count?: number) {
2017-12-14 17:38:41 +01:00
return ActorFollowModel.createListAcceptedFollowForApiQuery('followers', actorIds, t, start, count)
}
2019-04-18 11:28:17 +02:00
static listAcceptedFollowerSharedInboxUrls (actorIds: number[], t: Transaction) {
2018-01-09 17:22:26 +01:00
return ActorFollowModel.createListAcceptedFollowForApiQuery(
2018-01-09 18:13:00 +01:00
'followers',
2018-01-09 17:22:26 +01:00
actorIds,
t,
undefined,
undefined,
2018-01-09 18:13:00 +01:00
'sharedInboxUrl',
true
2018-01-09 17:22:26 +01:00
)
2017-12-14 17:38:41 +01:00
}
2019-04-18 11:28:17 +02:00
static listAcceptedFollowingUrlsForApi (actorIds: number[], t: Transaction, start?: number, count?: number) {
2017-12-14 17:38:41 +01:00
return ActorFollowModel.createListAcceptedFollowForApiQuery('following', actorIds, t, start, count)
}
2018-02-28 18:04:46 +01:00
static async getStats () {
const serverActor = await getServerActor()
const totalInstanceFollowing = await ActorFollowModel.count({
where: {
actorId: serverActor.id,
state: 'accepted'
2018-02-28 18:04:46 +01:00
}
})
const totalInstanceFollowers = await ActorFollowModel.count({
where: {
targetActorId: serverActor.id,
state: 'accepted'
2018-02-28 18:04:46 +01:00
}
})
return {
totalInstanceFollowing,
totalInstanceFollowers
}
}
2019-08-06 17:19:53 +02:00
static updateScore (inboxUrl: string, value: number, t?: Transaction) {
const query = `UPDATE "actorFollow" SET "score" = LEAST("score" + ${value}, ${ACTOR_FOLLOW_SCORE.MAX}) ` +
'WHERE id IN (' +
2018-12-26 10:36:24 +01:00
'SELECT "actorFollow"."id" FROM "actorFollow" ' +
'INNER JOIN "actor" ON "actor"."id" = "actorFollow"."actorId" ' +
`WHERE "actor"."inboxUrl" = '${inboxUrl}' OR "actor"."sharedInboxUrl" = '${inboxUrl}'` +
')'
const options = {
2019-04-18 11:28:17 +02:00
type: QueryTypes.BULKUPDATE,
transaction: t
}
return ActorFollowModel.sequelize.query(query, options)
}
2019-08-06 17:19:53 +02:00
static async updateScoreByFollowingServers (serverIds: number[], value: number, t?: Transaction) {
if (serverIds.length === 0) return
const me = await getServerActor()
2021-05-12 14:09:04 +02:00
const serverIdsString = createSafeIn(ActorFollowModel.sequelize, serverIds)
2019-08-06 17:19:53 +02:00
2019-08-06 17:30:09 +02:00
const query = `UPDATE "actorFollow" SET "score" = LEAST("score" + ${value}, ${ACTOR_FOLLOW_SCORE.MAX}) ` +
2019-08-06 17:19:53 +02:00
'WHERE id IN (' +
'SELECT "actorFollow"."id" FROM "actorFollow" ' +
'INNER JOIN "actor" ON "actor"."id" = "actorFollow"."targetActorId" ' +
`WHERE "actorFollow"."actorId" = ${me.Account.actorId} ` + // I'm the follower
`AND "actor"."serverId" IN (${serverIdsString})` + // Criteria on followings
')'
const options = {
type: QueryTypes.BULKUPDATE,
transaction: t
}
return ActorFollowModel.sequelize.query(query, options)
}
2018-01-09 18:13:00 +01:00
private static async createListAcceptedFollowForApiQuery (
type: 'followers' | 'following',
actorIds: number[],
2019-04-18 11:28:17 +02:00
t: Transaction,
2018-01-09 18:13:00 +01:00
start?: number,
count?: number,
columnUrl = 'url',
distinct = false
) {
2017-12-14 17:38:41 +01:00
let firstJoin: string
let secondJoin: string
if (type === 'followers') {
firstJoin = 'targetActorId'
secondJoin = 'actorId'
} else {
firstJoin = 'actorId'
secondJoin = 'targetActorId'
}
2018-01-09 18:13:00 +01:00
const selections: string[] = []
if (distinct === true) selections.push(`DISTINCT("Follows"."${columnUrl}") AS "selectionUrl"`)
else selections.push(`"Follows"."${columnUrl}" AS "selectionUrl"`)
2018-01-09 18:13:00 +01:00
selections.push('COUNT(*) AS "total"')
2020-12-08 14:30:29 +01:00
const tasks: Promise<any>[] = []
2017-12-14 17:38:41 +01:00
2020-01-31 16:56:52 +01:00
for (const selection of selections) {
2017-12-14 17:38:41 +01:00
let query = 'SELECT ' + selection + ' FROM "actor" ' +
'INNER JOIN "actorFollow" ON "actorFollow"."' + firstJoin + '" = "actor"."id" ' +
'INNER JOIN "actor" AS "Follows" ON "actorFollow"."' + secondJoin + '" = "Follows"."id" ' +
`WHERE "actor"."id" = ANY ($actorIds) AND "actorFollow"."state" = 'accepted' AND "Follows"."${columnUrl}" IS NOT NULL `
2017-12-14 17:38:41 +01:00
if (count !== undefined) query += 'LIMIT ' + count
if (start !== undefined) query += ' OFFSET ' + start
const options = {
bind: { actorIds },
2019-04-18 11:28:17 +02:00
type: QueryTypes.SELECT,
2017-12-14 17:38:41 +01:00
transaction: t
}
tasks.push(ActorFollowModel.sequelize.query(query, options))
}
2018-11-16 15:38:09 +01:00
const [ followers, [ dataTotal ] ] = await Promise.all(tasks)
const urls: string[] = followers.map(f => f.selectionUrl)
2017-12-14 17:38:41 +01:00
return {
data: urls,
2018-11-16 15:38:09 +01:00
total: dataTotal ? parseInt(dataTotal.total, 10) : 0
2017-12-14 17:38:41 +01:00
}
}
private static listBadActorFollows () {
const query = {
where: {
score: {
2019-04-18 11:28:17 +02:00
[Op.lte]: 0
}
},
2018-01-19 13:58:13 +01:00
logging: false
}
return ActorFollowModel.findAll(query)
}
2019-08-20 19:05:31 +02:00
toFormattedJSON (this: MActorFollowFormattable): ActorFollow {
2017-12-14 17:38:41 +01:00
const follower = this.ActorFollower.toFormattedJSON()
const following = this.ActorFollowing.toFormattedJSON()
return {
id: this.id,
follower,
following,
score: this.score,
2017-12-14 17:38:41 +01:00
state: this.state,
createdAt: this.createdAt,
updatedAt: this.updatedAt
}
}
}