import useSWR, { SWRResponse } from 'swr'; import { AxiosError } from 'axios'; import { useParams } from 'react-router-dom'; import http from '@/api/http'; import { Model, UUID, withRelationships, WithRelationships } from '@/api/admin/index'; import { Allocation, Node } from '@/api/admin/node'; import { Transformers, User } from '@definitions/admin'; import { Egg, EggVariable } from '@/api/admin/egg'; import { Nest } from '@/api/admin/nest'; /** * Defines the limits for a server that exists on the Panel. */ interface ServerLimits { memory: number; swap: number; disk: number; io: number; cpu: number; threads: string | null; oomDisabled: boolean; } export interface ServerVariable extends EggVariable { serverValue: string; } /** * Defines a single server instance that is returned from the Panel's admin * API endpoints. */ export interface Server extends Model { id: number; uuid: UUID; externalId: string | null; identifier: string; name: string; description: string; status: string; userId: number; nodeId: number; allocationId: number; eggId: number; nestId: number; limits: ServerLimits; featureLimits: { databases: number; allocations: number; backups: number; }; container: { startup: string | null; image: string; environment: Record; }; createdAt: Date; updatedAt: Date; relationships: { allocations?: Allocation[]; nest?: Nest; egg?: Egg; node?: Node; user?: User; variables?: ServerVariable[]; }; } /** * A standard API response with the minimum viable details for the frontend * to correctly render a server. */ type LoadedServer = WithRelationships; /** * Fetches a server from the API and ensures that the allocations, user, and * node data is loaded. */ export const getServer = async (id: number | string): Promise => { const { data } = await http.get(`/api/application/servers/${id}`, { params: { include: ['allocations', 'user', 'node', 'variables'], }, }); return withRelationships(Transformers.toServer(data), 'allocations', 'user', 'node', 'variables'); }; /** * Returns an SWR instance by automatically loading in the server for the currently * loaded route match in the admin area. */ export const useServerFromRoute = (): SWRResponse => { const params = useParams<'id'>(); return useSWR(`/api/application/servers/${params.id}`, async () => getServer(Number(params.id)), { revalidateOnMount: false, revalidateOnFocus: false, }); };