484e023c0c
* remove empty file If the endpoint is to be implemented later, the file can be added back, but for now it is confusing to have an empty file. * enhance(doc): document defaults Default for `isPublic` is based on the database schema default value. Defaults for `local` and `withFiles` are based on the behaviour of the endpoint. * enhance(doc): explain nullable emoji category * fix: make nullable if default is null * enhance(doc): explain mute attribute expiresAt * fix: define required fields - `notes/create`: the default for `text` has been removed because ajv can not handle `default` inside of `anyOf`, see https://ajv.js.org/guide/modifying-data.html#assigning-defaults and the default value cannot be `null` if text is `nullable: false` in the `anyOf` first alternative. - `notes/create`: The `mediaIds` property has been marked as deprecated because it has the same behaviour as using `fileIds`, but the implementation tries to handlè `fileIds` first. - The result schema for `admin/emoji/list` has been altered because the `host` property will always be `null` as it is filtered this way in the database query. See packages/backend/src/server/api/endpoints/admin/emoji/list.ts line 67. * enhance(doc): explain nullable hostname * update changelog Co-authored-by: syuilo <Syuilotan@yahoo.co.jp>
118 lines
3.9 KiB
TypeScript
118 lines
3.9 KiB
TypeScript
import config from '@/config/index.js';
|
|
import define from '../../define.js';
|
|
import { Instances } from '@/models/index.js';
|
|
import { fetchMeta } from '@/misc/fetch-meta.js';
|
|
|
|
export const meta = {
|
|
tags: ['federation'],
|
|
|
|
requireCredential: false,
|
|
|
|
res: {
|
|
type: 'array',
|
|
optional: false, nullable: false,
|
|
items: {
|
|
type: 'object',
|
|
optional: false, nullable: false,
|
|
ref: 'FederationInstance',
|
|
},
|
|
},
|
|
} as const;
|
|
|
|
export const paramDef = {
|
|
type: 'object',
|
|
properties: {
|
|
host: { type: 'string', nullable: true, description: 'Omit or use `null` to not filter by host.' },
|
|
blocked: { type: 'boolean', nullable: true },
|
|
notResponding: { type: 'boolean', nullable: true },
|
|
suspended: { type: 'boolean', nullable: true },
|
|
federating: { type: 'boolean', nullable: true },
|
|
subscribing: { type: 'boolean', nullable: true },
|
|
publishing: { type: 'boolean', nullable: true },
|
|
limit: { type: 'integer', minimum: 1, maximum: 100, default: 30 },
|
|
offset: { type: 'integer', default: 0 },
|
|
sort: { type: 'string' },
|
|
},
|
|
required: [],
|
|
} as const;
|
|
|
|
// eslint-disable-next-line import/no-default-export
|
|
export default define(meta, paramDef, async (ps, me) => {
|
|
const query = Instances.createQueryBuilder('instance');
|
|
|
|
switch (ps.sort) {
|
|
case '+pubSub': query.orderBy('instance.followingCount', 'DESC').orderBy('instance.followersCount', 'DESC'); break;
|
|
case '-pubSub': query.orderBy('instance.followingCount', 'ASC').orderBy('instance.followersCount', 'ASC'); break;
|
|
case '+notes': query.orderBy('instance.notesCount', 'DESC'); break;
|
|
case '-notes': query.orderBy('instance.notesCount', 'ASC'); break;
|
|
case '+users': query.orderBy('instance.usersCount', 'DESC'); break;
|
|
case '-users': query.orderBy('instance.usersCount', 'ASC'); break;
|
|
case '+following': query.orderBy('instance.followingCount', 'DESC'); break;
|
|
case '-following': query.orderBy('instance.followingCount', 'ASC'); break;
|
|
case '+followers': query.orderBy('instance.followersCount', 'DESC'); break;
|
|
case '-followers': query.orderBy('instance.followersCount', 'ASC'); break;
|
|
case '+caughtAt': query.orderBy('instance.caughtAt', 'DESC'); break;
|
|
case '-caughtAt': query.orderBy('instance.caughtAt', 'ASC'); break;
|
|
case '+lastCommunicatedAt': query.orderBy('instance.lastCommunicatedAt', 'DESC'); break;
|
|
case '-lastCommunicatedAt': query.orderBy('instance.lastCommunicatedAt', 'ASC'); break;
|
|
|
|
default: query.orderBy('instance.id', 'DESC'); break;
|
|
}
|
|
|
|
if (typeof ps.blocked === 'boolean') {
|
|
const meta = await fetchMeta(true);
|
|
if (ps.blocked) {
|
|
query.andWhere('instance.host IN (:...blocks)', { blocks: meta.blockedHosts });
|
|
} else {
|
|
query.andWhere('instance.host NOT IN (:...blocks)', { blocks: meta.blockedHosts });
|
|
}
|
|
}
|
|
|
|
if (typeof ps.notResponding === 'boolean') {
|
|
if (ps.notResponding) {
|
|
query.andWhere('instance.isNotResponding = TRUE');
|
|
} else {
|
|
query.andWhere('instance.isNotResponding = FALSE');
|
|
}
|
|
}
|
|
|
|
if (typeof ps.suspended === 'boolean') {
|
|
if (ps.suspended) {
|
|
query.andWhere('instance.isSuspended = TRUE');
|
|
} else {
|
|
query.andWhere('instance.isSuspended = FALSE');
|
|
}
|
|
}
|
|
|
|
if (typeof ps.federating === 'boolean') {
|
|
if (ps.federating) {
|
|
query.andWhere('((instance.followingCount > 0) OR (instance.followersCount > 0))');
|
|
} else {
|
|
query.andWhere('((instance.followingCount = 0) AND (instance.followersCount = 0))');
|
|
}
|
|
}
|
|
|
|
if (typeof ps.subscribing === 'boolean') {
|
|
if (ps.subscribing) {
|
|
query.andWhere('instance.followersCount > 0');
|
|
} else {
|
|
query.andWhere('instance.followersCount = 0');
|
|
}
|
|
}
|
|
|
|
if (typeof ps.publishing === 'boolean') {
|
|
if (ps.publishing) {
|
|
query.andWhere('instance.followingCount > 0');
|
|
} else {
|
|
query.andWhere('instance.followingCount = 0');
|
|
}
|
|
}
|
|
|
|
if (ps.host) {
|
|
query.andWhere('instance.host like :host', { host: '%' + ps.host.toLowerCase() + '%' });
|
|
}
|
|
|
|
const instances = await query.take(ps.limit).skip(ps.offset).getMany();
|
|
|
|
return await Instances.packMany(instances);
|
|
});
|