gotosocial/web/source/settings/views/user/applications/new.tsx

/*
	GoToSocial
	Copyright (C) GoToSocial Authors admin@gotosocial.org
	SPDX-License-Identifier: AGPL-3.0-or-later

	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/>.
*/

import React from "react";
import useFormSubmit from "../../../lib/form/submit";
import { useTextInput } from "../../../lib/form";
import MutationButton from "../../../components/form/mutation-button";
import { TextArea, TextInput } from "../../../components/form/inputs";
import { useLocation } from "wouter";
import { useCreateAppMutation } from "../../../lib/query/user/applications";
import { urlValidator } from "../../../lib/util/formvalidators";
import { useCallbackURL } from "./common";

export default function NewApp() {
	const [ _location, setLocation ] = useLocation();
	const callbackURL = useCallbackURL();

	const form = {
		name: useTextInput("client_name"),
		redirect_uris: useTextInput("redirect_uris", {
			validator: (redirectURIs: string) => {
				if (redirectURIs === "") {
					return "";
				}

				const invalids = redirectURIs.
					split("\n").
					map(redirectURI => redirectURI === "urn:ietf:wg:oauth:2.0:oob" ? "" : urlValidator(redirectURI)).
					flatMap((invalid) => invalid || []);

				return invalids.join(", ");
			}
		}),
		scopes: useTextInput("scopes"),
		website: useTextInput("website", {
			validator: urlValidator,
		}),
	};

	const [formSubmit, result] = useFormSubmit(
		form,
		useCreateAppMutation(),
		{
			changedOnly: false,
			onFinish: (res) => {
				if (res.data) {
					// Creation successful,
					// redirect to apps overview.
					setLocation(`/search`);
				}
			},
		});

	return (
		<form
			onSubmit={formSubmit}
			// Prevent password managers
			// trying to fill in fields.
			autoComplete="off"
		>
			<div className="form-section-docs">
				<h2>New Application</h2>
				<p>
					On this page you can create a new managed OAuth application, with the specified redirect URIs and scopes.
					<br/>Application name is required, but other fields are optional.
					<br/>If you want to obtain an access token right here in the settings panel, be sure to include <code>{callbackURL}</code> in your redirect URIs.
					<br/>If not specified, redirect URIs defaults to <code>urn:ietf:wg:oauth:2.0:oob</code>, and scopes defaults to <code>read</code>.
				</p>
				<a
					href="https://docs.gotosocial.org/en/latest/user_guide/settings/#applications"
					target="_blank"
					className="docslink"
					rel="noreferrer"
				>
					Learn more about application redirect URIs and scopes (opens in a new tab)
				</a>
			</div>

			<TextInput
				field={form.name}
				label="Application name"
				placeholder="My Cool Application"
				autoCapitalize="words"
				spellCheck="false"
				required={true}
			/>

			<TextInput
				field={form.website}
				label="Application website (optional)"
				placeholder="https://example.org/my_cool_application"
				autoCapitalize="none"
				spellCheck="false"
				type="url"
			/>

			<TextArea
				field={form.redirect_uris}
				label="Redirect URIs (optional, newline-separated entries)"
				placeholder={`https://example.org/my_cool_application`}
				autoCapitalize="none"
				spellCheck="false"
				rows={5}
			/>

			<TextInput
				field={form.scopes}
				label="Scopes (optional, space-separated entries)"
				placeholder={`read write push`}
				autoCapitalize="none"
				spellCheck="false"
			/>

			<MutationButton
				label="Create"
				result={result}
				disabled={!form.name.value}
			/>
		</form>
	);
}