summaryrefslogtreecommitdiff
path: root/src/server/api/endpoints/pages/show.ts
blob: c8e5ad1d9bd29e62aa887fa6f729ac18a169eaab (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
import $ from 'cafy';
import define from '../../define';
import { ApiError } from '../../error';
import { Pages, Users } from '../../../../models';
import { ID } from '../../../../misc/cafy-id';
import { Page } from '../../../../models/entities/page';

export const meta = {
	desc: {
		'ja-JP': '指定したページの情報を取得します。',
	},

	tags: ['pages'],

	requireCredential: false as const,

	params: {
		pageId: {
			validator: $.optional.type(ID),
			desc: {
				'ja-JP': '対象のページのID',
				'en-US': 'Target page ID.'
			}
		},

		name: {
			validator: $.optional.str,
		},

		username: {
			validator: $.optional.str,
		},
	},

	res: {
		type: 'object' as const,
		optional: false as const, nullable: false as const,
		ref: 'Page',
	},

	errors: {
		noSuchPage: {
			message: 'No such page.',
			code: 'NO_SUCH_PAGE',
			id: '222120c0-3ead-4528-811b-b96f233388d7'
		}
	}
};

export default define(meta, async (ps, user) => {
	let page: Page | undefined;

	if (ps.pageId) {
		page = await Pages.findOne(ps.pageId);
	} else if (ps.name && ps.username) {
		const author = await Users.findOne({
			host: null,
			usernameLower: ps.username.toLowerCase()
		});
		if (author) {
			page = await Pages.findOne({
				name: ps.name,
				userId: author.id
			});
		}
	}

	if (page == null) {
		throw new ApiError(meta.errors.noSuchPage);
	}

	return await Pages.pack(page, user);
});