create-domain.page.tsx•3.17 kB
/**
* Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
* http://github.com/fonoster/fonoster
*
* This file is part of Fonoster
*
* Licensed under the MIT License (the "License");
* you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* https://opensource.org/licenses/MIT
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import { Page } from "~/core/components/general/page/page";
import { PageHeader } from "~/core/components/general/page/page-header";
import type { Route } from "./+types/create-domain.page";
import { Button } from "~/core/components/design-system/ui/button/button";
import { Box } from "@mui/material";
import { CreateDomainForm } from "./create-domain.form";
import { useCreateDomain } from "./create-domain.hook";
import { useRef } from "react";
/**
* Page metadata for the "Create Domain" page.
*
* Sets the page title and description for SEO and browser tabs.
*
* @param _ - Meta arguments provided by the router (not used here).
* @returns An array of metadata objects for the page.
*/
export function meta(_: Route.MetaArgs) {
return [
{ title: "Create New Domain | Fonoster" },
{
name: "description",
content:
"A SIP Domain is used to group multiple SIP Agents for internal calling and organization."
}
];
}
/**
* CreateDomain component.
*
* Page component for creating a new voice domain.
* Includes:
* - Page header with navigation and actions.
* - Form for entering domain details.
* - Save action to submit the form.
*
* @returns {JSX.Element} The rendered Create Domain page.
*/
export default function CreateDomain() {
/** Custom hook to create a domain via API with optimistic updates. */
const { onGoBack, onSave, isPending } = useCreateDomain();
const formRef = useRef<HTMLFormElement | null>(null);
const handleSave = () => {
if (formRef.current) {
const submitEvent = new Event("submit", {
bubbles: true,
cancelable: true
});
formRef.current.dispatchEvent(submitEvent);
}
};
/**
* Renders the Create Domain page layout.
*/
return (
<Page variant="form">
<PageHeader
title="Create New Domain"
description="A SIP Domain is used to group multiple SIP Agents for internal calling and organization."
onBack={{ label: "Back to domains", onClick: onGoBack }}
actions={
<Button size="small" disabled={isPending} onClick={handleSave}>
{isPending ? "Saving..." : "Save Domain"}
</Button>
}
/>
{/* Form container with a max width for readability and consistent layout */}
<Box sx={{ maxWidth: "440px" }}>
<CreateDomainForm
onSubmit={onSave}
formRef={formRef as React.RefObject<HTMLFormElement>}
/>
</Box>
</Page>
);
}