sharkey/src/server/api/endpoints/admin/relays/add.ts

import { URL } from 'url';
import $ from 'cafy';
import define from '../../../define.js';
import { addRelay } from '@/services/relay.js';
import { ApiError } from '../../../error.js';

export const meta = {
	tags: ['admin'],

	requireCredential: true as const,
	requireModerator: true as const,

	params: {
		inbox: {
			validator: $.str
		},
	},

	errors: {
		invalidUrl: {
			message: 'Invalid URL',
			code: 'INVALID_URL',
			id: 'fb8c92d3-d4e5-44e7-b3d4-800d5cef8b2c'
		},
	},

	res: {
		type: 'object' as const,
		optional: false as const, nullable: false as const,
		properties: {
			id: {
				type: 'string' as const,
				optional: false as const, nullable: false as const,
				format: 'id'
			},
			inbox: {
				type: 'string' as const,
				optional: false as const, nullable: false as const,
				format: 'url'
			},
			status: {
				type: 'string' as const,
				optional: false as const, nullable: false as const,
				default: 'requesting',
				enum: [
					'requesting',
					'accepted',
					'rejected'
				]
			}
		}
	}
};

export default define(meta, async (ps, user) => {
	try {
		if (new URL(ps.inbox).protocol !== 'https:') throw 'https only';
	} catch {
		throw new ApiError(meta.errors.invalidUrl);
	}

	return await addRelay(ps.inbox);
});