mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2025-11-16 01:21:16 +01:00
# Description of Changes <img width="1569" height="980" alt="image" src="https://github.com/user-attachments/assets/dca1c227-ed84-4393-97a1-e3ce6eb1620b" /> <img width="1596" height="935" alt="image" src="https://github.com/user-attachments/assets/2003e1be-034a-4cbb-869e-6d5d912ab61d" /> <img width="1543" height="997" alt="image" src="https://github.com/user-attachments/assets/fe0c4f4b-eeee-4db4-a041-e554f350255a" /> --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### Translations (if applicable) - [ ] I ran [`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details.
199 lines
6.0 KiB
TypeScript
199 lines
6.0 KiB
TypeScript
import { useEffect } from 'react';
|
|
import { useTranslation } from 'react-i18next';
|
|
import { Button, Stack, Paper, Text, Loader, Group, MultiSelect } from '@mantine/core';
|
|
import { alert } from '@app/components/toast';
|
|
import RestartConfirmationModal from '@app/components/shared/config/RestartConfirmationModal';
|
|
import { useRestartServer } from '@app/components/shared/config/useRestartServer';
|
|
import { useAdminSettings } from '@app/hooks/useAdminSettings';
|
|
import PendingBadge from '@app/components/shared/config/PendingBadge';
|
|
import { useLoginRequired } from '@app/hooks/useLoginRequired';
|
|
import LoginRequiredBanner from '@app/components/shared/config/LoginRequiredBanner';
|
|
|
|
interface EndpointsSettingsData {
|
|
toRemove?: string[];
|
|
groupsToRemove?: string[];
|
|
}
|
|
|
|
export default function AdminEndpointsSection() {
|
|
const { t } = useTranslation();
|
|
const { loginEnabled, validateLoginEnabled } = useLoginRequired();
|
|
const { restartModalOpened, showRestartModal, closeRestartModal, restartServer } = useRestartServer();
|
|
|
|
const {
|
|
settings,
|
|
setSettings,
|
|
loading,
|
|
saving,
|
|
fetchSettings,
|
|
saveSettings,
|
|
isFieldPending,
|
|
} = useAdminSettings<EndpointsSettingsData>({
|
|
sectionName: 'endpoints',
|
|
});
|
|
|
|
useEffect(() => {
|
|
if (loginEnabled) {
|
|
fetchSettings();
|
|
}
|
|
}, [loginEnabled, fetchSettings]);
|
|
|
|
const handleSave = async () => {
|
|
if (!validateLoginEnabled()) {
|
|
return;
|
|
}
|
|
|
|
try {
|
|
await saveSettings();
|
|
showRestartModal();
|
|
} catch (_error) {
|
|
alert({
|
|
alertType: 'error',
|
|
title: t('admin.error', 'Error'),
|
|
body: t('admin.settings.saveError', 'Failed to save settings'),
|
|
});
|
|
}
|
|
};
|
|
|
|
// Override loading state when login is disabled
|
|
const actualLoading = loginEnabled ? loading : false;
|
|
|
|
if (actualLoading) {
|
|
return (
|
|
<Stack align="center" justify="center" h={200}>
|
|
<Loader size="lg" />
|
|
</Stack>
|
|
);
|
|
}
|
|
|
|
// Common endpoint examples
|
|
const commonEndpoints = [
|
|
'img-to-pdf',
|
|
'pdf-to-img',
|
|
'merge-pdfs',
|
|
'split-pdf',
|
|
'rotate-pdf',
|
|
'compress-pdf',
|
|
'extract-images',
|
|
'extract-image-scans',
|
|
'add-watermark',
|
|
'remove-watermark',
|
|
'add-password',
|
|
'remove-password',
|
|
'change-permissions',
|
|
'ocr-pdf',
|
|
'pdf-to-pdfa',
|
|
'html-to-pdf',
|
|
'url-to-pdf',
|
|
'markdown-to-pdf',
|
|
'get-info-on-pdf',
|
|
'extract-pdf-metadata',
|
|
'pdf-to-single-page',
|
|
'crop',
|
|
'auto-split-pdf',
|
|
'sanitize-pdf',
|
|
'add-page-numbers',
|
|
'auto-rename',
|
|
'scale-pages',
|
|
'repair',
|
|
'flatten',
|
|
'remove-blanks',
|
|
'compare-pdfs'
|
|
];
|
|
|
|
// Common endpoint groups
|
|
const commonGroups = [
|
|
'Conversion',
|
|
'Security',
|
|
'Other',
|
|
'Organize',
|
|
'LibreOffice',
|
|
'CLI',
|
|
'Python',
|
|
'OpenCV'
|
|
];
|
|
|
|
return (
|
|
<Stack gap="lg">
|
|
<LoginRequiredBanner show={!loginEnabled} />
|
|
|
|
<div>
|
|
<Text fw={600} size="lg">{t('admin.settings.endpoints.title', 'API Endpoints')}</Text>
|
|
<Text size="sm" c="dimmed">
|
|
{t('admin.settings.endpoints.description', 'Control which API endpoints and endpoint groups are available.')}
|
|
</Text>
|
|
</div>
|
|
|
|
<Paper withBorder p="md" radius="md">
|
|
<Stack gap="md">
|
|
<Text fw={600} size="sm" mb="xs">{t('admin.settings.endpoints.management', 'Endpoint Management')}</Text>
|
|
|
|
<div>
|
|
<MultiSelect
|
|
label={
|
|
<Group gap="xs">
|
|
<span>{t('admin.settings.endpoints.toRemove.label', 'Disabled Endpoints')}</span>
|
|
<PendingBadge show={isFieldPending('toRemove')} />
|
|
</Group>
|
|
}
|
|
description={t('admin.settings.endpoints.toRemove.description', 'Select individual endpoints to disable')}
|
|
value={settings.toRemove || []}
|
|
onChange={(value) => {
|
|
if (!loginEnabled) return;
|
|
setSettings({ ...settings, toRemove: value });
|
|
}}
|
|
data={commonEndpoints.map(endpoint => ({ value: endpoint, label: endpoint }))}
|
|
searchable
|
|
clearable
|
|
placeholder="Select endpoints to disable"
|
|
comboboxProps={{ zIndex: 1400 }}
|
|
disabled={!loginEnabled}
|
|
/>
|
|
</div>
|
|
|
|
<div>
|
|
<MultiSelect
|
|
label={
|
|
<Group gap="xs">
|
|
<span>{t('admin.settings.endpoints.groupsToRemove.label', 'Disabled Endpoint Groups')}</span>
|
|
<PendingBadge show={isFieldPending('groupsToRemove')} />
|
|
</Group>
|
|
}
|
|
description={t('admin.settings.endpoints.groupsToRemove.description', 'Select endpoint groups to disable')}
|
|
value={settings.groupsToRemove || []}
|
|
onChange={(value) => {
|
|
if (!loginEnabled) return;
|
|
setSettings({ ...settings, groupsToRemove: value });
|
|
}}
|
|
data={commonGroups.map(group => ({ value: group, label: group }))}
|
|
searchable
|
|
clearable
|
|
placeholder="Select groups to disable"
|
|
comboboxProps={{ zIndex: 1400 }}
|
|
disabled={!loginEnabled}
|
|
/>
|
|
</div>
|
|
|
|
<Paper bg="var(--mantine-color-blue-light)" p="sm" radius="sm">
|
|
<Text size="xs" c="dimmed">
|
|
{t('admin.settings.endpoints.note', 'Note: Disabling endpoints restricts API access but does not remove UI components. Restart required for changes to take effect.')}
|
|
</Text>
|
|
</Paper>
|
|
</Stack>
|
|
</Paper>
|
|
|
|
<Group justify="flex-end">
|
|
<Button onClick={handleSave} loading={saving} size="sm" disabled={!loginEnabled}>
|
|
{t('admin.settings.save', 'Save Changes')}
|
|
</Button>
|
|
</Group>
|
|
|
|
{/* Restart Confirmation Modal */}
|
|
<RestartConfirmationModal
|
|
opened={restartModalOpened}
|
|
onClose={closeRestartModal}
|
|
onRestart={restartServer}
|
|
/>
|
|
</Stack>
|
|
);
|
|
}
|