Files
Stirling-PDF/frontend/src/core/components/shared/BulkShareModal.tsx
T
James BruntonandGitHub a3e45bc182 Add frontend autoformatting and set CI to require formatted code for all languages (#6052)
# Description of Changes
Changes the strategy for autoformatting to reject PRs if they are not
formatted correctly instead of allowing them to merge and then spawning
a new PR to fix the formatting. The old strategy just caused more work
for us because we'd have to manually approve the followup PR and get it
merged, which required 2 reviewers so in practice it rarely got done and
just meant everyone's PRs ended up containing reformatting for unrelated
files, which makes code review unnecessarily difficult. If the PR's code
is not formatted correctly after this PR, a comment will be added
automatically to tell the author how to run the formatter script to fix
their code so it can go in.

This also enables autoformatting for the frontend code, using Prettier.
I've enabled it for pretty much everything in the frontend folder, other
than 3rd party files and files it doesn't make sense for. I also
excluded Markdown because it sounds likely to be more annoying to have
to autoformat the Markdown in the frontend folder but nowhere else. Open
to changing this though if people disagree.

> [!note]
> 
> Advice to reviewers: The first commit contains all of the actual logic
I've introduced (CI changes, Prettier config, etc.)
> The second commit is just the reformatting of the entire frontend
folder.
> The first commit needs proper review, the second one just give it a
spot-check that it's doing what you'd expect.
2026-04-10 17:41:19 +01:00

248 lines
8.5 KiB
TypeScript

import React, { useCallback, useEffect, useMemo, useState } from "react";
import { Modal, Stack, Text, Button, Group, Alert, TextInput, Paper, Select } from "@mantine/core";
import LinkIcon from "@mui/icons-material/Link";
import ContentCopyRoundedIcon from "@mui/icons-material/ContentCopyRounded";
import { useTranslation } from "react-i18next";
import apiClient from "@app/services/apiClient";
import { absoluteWithBasePath } from "@app/constants/app";
import { alert } from "@app/components/toast";
import { Z_INDEX_OVER_FILE_MANAGER_MODAL } from "@app/styles/zIndex";
import { useAppConfig } from "@app/contexts/AppConfigContext";
import type { StirlingFileStub } from "@app/types/fileContext";
import { uploadHistoryChains } from "@app/services/serverStorageUpload";
import { fileStorage } from "@app/services/fileStorage";
import { useFileActions } from "@app/contexts/FileContext";
import type { FileId } from "@app/types/file";
interface BulkShareModalProps {
opened: boolean;
onClose: () => void;
files: StirlingFileStub[];
onShared?: () => Promise<void> | void;
}
const BulkShareModal: React.FC<BulkShareModalProps> = ({ opened, onClose, files, onShared }) => {
const { t } = useTranslation();
const { config } = useAppConfig();
const { actions } = useFileActions();
const shareLinksEnabled = config?.storageShareLinksEnabled === true;
const [isWorking, setIsWorking] = useState(false);
const [errorMessage, setErrorMessage] = useState<string | null>(null);
const [shareToken, setShareToken] = useState<string | null>(null);
const [shareRole, setShareRole] = useState<"editor" | "commenter" | "viewer">("editor");
useEffect(() => {
if (!opened) {
setIsWorking(false);
setErrorMessage(null);
setShareToken(null);
}
}, [opened]);
useEffect(() => {
if (opened) {
setShareRole("editor");
}
}, [opened]);
const shareUrl = useMemo(() => {
if (!shareToken) return "";
const frontendUrl = (config?.frontendUrl || "").trim();
if (frontendUrl) {
const normalized = frontendUrl.endsWith("/") ? frontendUrl.slice(0, -1) : frontendUrl;
return `${normalized}/share/${shareToken}`;
}
return absoluteWithBasePath(`/share/${shareToken}`);
}, [config?.frontendUrl, shareToken]);
const createShareLink = useCallback(
async (storedFileId: number) => {
const response = await apiClient.post(`/api/v1/storage/files/${storedFileId}/shares/links`, {
accessRole: shareRole,
});
return response.data as { token?: string };
},
[shareRole],
);
const handleGenerateLink = useCallback(async () => {
if (!shareLinksEnabled) {
alert({
alertType: "warning",
title: t("storageShare.linksDisabled", "Share links are disabled."),
expandable: false,
durationMs: 2500,
});
return;
}
setIsWorking(true);
setErrorMessage(null);
setShareToken(null);
try {
const rootIds = Array.from(new Set(files.map((file) => (file.originalFileId || file.id) as FileId)));
const remoteIds = Array.from(new Set(files.map((file) => file.remoteStorageId).filter(Boolean) as number[]));
const existingRemoteId = rootIds.length === 1 && remoteIds.length === 1 ? remoteIds[0] : undefined;
const { remoteId: storedId, updatedAt, chain } = await uploadHistoryChains(rootIds, existingRemoteId);
const shareResponse = await createShareLink(storedId);
setShareToken(shareResponse.token ?? null);
for (const stub of chain) {
actions.updateStirlingFileStub(stub.id, {
remoteStorageId: storedId,
remoteStorageUpdatedAt: updatedAt,
remoteOwnedByCurrentUser: true,
remoteSharedViaLink: false,
remoteHasShareLinks: true,
});
await fileStorage.updateFileMetadata(stub.id, {
remoteStorageId: storedId,
remoteStorageUpdatedAt: updatedAt,
remoteOwnedByCurrentUser: true,
remoteSharedViaLink: false,
remoteHasShareLinks: true,
});
}
alert({
alertType: "success",
title: t("storageShare.generated", "Share link generated"),
expandable: false,
durationMs: 3000,
});
if (onShared) {
await onShared();
}
} catch (error: any) {
console.error("Failed to generate share link:", error);
setErrorMessage(t("storageShare.failure", "Unable to generate a share link. Please try again."));
} finally {
setIsWorking(false);
}
}, [actions, createShareLink, files, onShared, shareLinksEnabled, t]);
const handleCopyLink = useCallback(async () => {
if (!shareUrl) return;
try {
await navigator.clipboard.writeText(shareUrl);
alert({
alertType: "success",
title: t("storageShare.copied", "Link copied to clipboard"),
expandable: false,
durationMs: 2000,
});
} catch (error) {
console.error("Failed to copy share link:", error);
alert({
alertType: "warning",
title: t("storageShare.copyFailed", "Copy failed"),
expandable: false,
durationMs: 2500,
});
}
}, [shareUrl, t]);
return (
<Modal
opened={opened}
onClose={onClose}
centered
title={t("storageShare.bulkTitle", "Share selected files")}
zIndex={Z_INDEX_OVER_FILE_MANAGER_MODAL}
size="lg"
overlayProps={{ blur: 6 }}
>
<Stack gap="md">
<Paper withBorder radius="md" p="md">
<Stack gap={4}>
<Text size="sm">
{t("storageShare.bulkDescription", "Create one link to share all selected files with signed-in users.")}
</Text>
<Text size="sm" c="dimmed">
{t("storageShare.fileCount", "{{count}} files selected", {
count: files.length,
})}
</Text>
</Stack>
</Paper>
{errorMessage && (
<Alert color="red" title={t("storageShare.errorTitle", "Share failed")}>
{errorMessage}
</Alert>
)}
{!shareLinksEnabled && (
<Alert color="yellow" title={t("storageShare.linksDisabled", "Share links are disabled.")}>
{t("storageShare.linksDisabledBody", "Share links are disabled by your server settings.")}
</Alert>
)}
{shareUrl && (
<Paper withBorder radius="md" p="md">
<Stack gap="xs">
<TextInput
readOnly
value={shareUrl}
label={t("storageShare.linkLabel", "Share link")}
rightSection={
<Button
variant="subtle"
size="xs"
leftSection={<ContentCopyRoundedIcon style={{ fontSize: 16 }} />}
onClick={handleCopyLink}
>
{t("storageShare.copy", "Copy")}
</Button>
}
/>
</Stack>
</Paper>
)}
<Paper withBorder radius="md" p="md">
<Stack gap="xs">
<Text size="sm" fw={500}>
{t("storageShare.linkAccessTitle", "Share link access")}
</Text>
<Select
label={t("storageShare.roleLabel", "Role")}
value={shareRole}
onChange={(value) => setShareRole((value as typeof shareRole) || "editor")}
comboboxProps={{ withinPortal: true, zIndex: Z_INDEX_OVER_FILE_MANAGER_MODAL + 10 }}
data={[
{ value: "editor", label: t("storageShare.roleEditor", "Editor") },
{ value: "commenter", label: t("storageShare.roleCommenter", "Commenter") },
{ value: "viewer", label: t("storageShare.roleViewer", "Viewer") },
]}
/>
{shareRole === "commenter" && (
<Text size="xs" c="dimmed">
{t("storageShare.commenterHint", "Commenting is coming soon.")}
</Text>
)}
</Stack>
</Paper>
<Group justify="flex-end" gap="sm">
<Button variant="default" onClick={onClose} disabled={isWorking}>
{t("cancel", "Cancel")}
</Button>
<Button
leftSection={<LinkIcon style={{ fontSize: 18 }} />}
onClick={handleGenerateLink}
loading={isWorking}
disabled={!shareLinksEnabled}
>
{t("storageShare.generate", "Generate Link")}
</Button>
</Group>
</Stack>
</Modal>
);
};
export default BulkShareModal;