feat: ability to disable cloud collection storage

entrypoints/options/layouts/StorageSection.tsx

@@ -1,4 +1,6 @@
 import { useDialog } from "@/contexts/DialogProvider";
+import { cloudDisabled, setCloudStorage } from "@/features/collectionStorage";
+import { useDangerStyles } from "@/hooks/useDangerStyles";
 import useStorageInfo from "@/hooks/useStorageInfo";
 import { Button, Field, MessageBar, MessageBarBody, MessageBarTitle, ProgressBar } from "@fluentui/react-components";
 import { ArrowDownload20Regular, ArrowUpload20Regular } from "@fluentui/react-icons";
@@ -10,9 +12,17 @@ export default function StorageSection(): React.ReactElement
 {
 	const { bytesInUse, storageQuota, usedStorageRatio } = useStorageInfo();
 	const [importResult, setImportResult] = useState<boolean | null>(null);
+	const [isCloudDisabled, setCloudDisabled] = useState<boolean>(null!);
 
 	const dialog = useDialog();
 	const cls = useOptionsStyles();
+	const dangerCls = useDangerStyles();
+
+	useEffect(() =>
+	{
+		cloudDisabled.getValue().then(setCloudDisabled);
+		return cloudDisabled.watch(setCloudDisabled);
+	}, []);
 
 	const handleImport = (): void =>
 		dialog.pushPrompt({
@@ -30,15 +40,32 @@ export default function StorageSection(): React.ReactElement
 			)
 		});
 
+	const handleDisableCloud = (): void =>
+		dialog.pushPrompt({
+			title: i18n.t("options_page.storage.disable"),
+			content: i18n.t("options_page.storage.disable_prompt.text"),
+			confirmText: i18n.t("options_page.storage.disable_prompt.action"),
+			destructive: true,
+			onConfirm: () => setCloudStorage(false)
+		});
+
 	return (
 		<>
-			<Field
-				label={ i18n.t("options_page.storage.capacity.title") }
-				hint={ i18n.t("options_page.storage.capacity.description", [(bytesInUse / 1024).toFixed(1), storageQuota / 1024]) }
-				validationState={ usedStorageRatio >= 0.8 ? "error" : undefined }
-			>
-				<ProgressBar value={ usedStorageRatio } thickness="large" />
-			</Field>
+			{ isCloudDisabled === false &&
+				<Field
+					label={ i18n.t("options_page.storage.capacity.title") }
+					hint={ i18n.t("options_page.storage.capacity.description", [(bytesInUse / 1024).toFixed(1), storageQuota / 1024]) }
+					validationState={ usedStorageRatio >= 0.8 ? "error" : undefined }
+				>
+					<ProgressBar value={ usedStorageRatio } thickness="large" />
+				</Field>
+			}
+
+			{ isCloudDisabled === true &&
+				<Button appearance="primary" onClick={ () => setCloudStorage(true) }>
+					{ i18n.t("options_page.storage.enable") }
+				</Button>
+			}
 
 			<div className={ cls.horizontalButtons }>
 				<Button icon={ <ArrowDownload20Regular /> } onClick={ exportData }>
@@ -59,6 +86,17 @@ export default function StorageSection(): React.ReactElement
 					</MessageBarBody>
 				</MessageBar>
 			}
+
+			{ isCloudDisabled === false &&
+				<div className={ cls.horizontalButtons }>
+					<Button
+						appearance="subtle" className={ dangerCls.buttonSubtle }
+						onClick={ handleDisableCloud }
+					>
+						{ i18n.t("options_page.storage.disable") }
+					</Button>
+				</div>
+			}
 		</>
 	);
 }

features/collectionStorage/index.ts

@@ -4,6 +4,9 @@ export * from "./utils/getCollections";
 export { default as getCollections } from "./utils/getCollections";
 export { default as resoveConflict } from "./utils/resolveConflict";
 export { default as saveCollections } from "./utils/saveCollections";
+export { default as setCloudStorage } from "./utils/setCloudStorage";
 
 export const collectionCount = collectionStorage.count;
 export const graphics = collectionStorage.graphics;
+
+export const cloudDisabled = collectionStorage.disableCloud;

features/collectionStorage/utils/collectionStorage.ts

@@ -8,5 +8,6 @@ export const collectionStorage =
 	localCollections: storage.defineItem<CollectionItem[]>("local:collections", { fallback: [] }),
 	count: storage.defineItem<number>("local:count", { fallback: 0 }),
 	graphics: storage.defineItem<GraphicsStorage>("local:graphics", { fallback: {} }),
+	disableCloud: storage.defineItem<boolean>("sync:disableCloud", { fallback: false }),
 	maxChunkCount: 12
 };

features/collectionStorage/utils/getCollections.ts

@@ -1,14 +1,17 @@
 import { CollectionItem } from "@/models/CollectionModels";
+import getLogger from "@/utils/getLogger";
 import { collectionStorage } from "./collectionStorage";
 import getCollectionsFromCloud from "./getCollectionsFromCloud";
 import getCollectionsFromLocal from "./getCollectionsFromLocal";
 import saveCollectionsToLocal from "./saveCollectionsToLocal";
-import getLogger from "@/utils/getLogger";
 
 const logger = getLogger("getCollections");
 
 export default async function getCollections(): Promise<[CollectionItem[], CloudStorageIssueType | null]>
 {
+	if (await collectionStorage.disableCloud.getValue() === true)
+		return [await getCollectionsFromLocal(), null];
+
 	const lastUpdatedLocal: number = await collectionStorage.localLastUpdated.getValue();
 	const lastUpdatedSync: number = await collectionStorage.syncLastUpdated.getValue();
 

features/collectionStorage/utils/saveCollections.ts

@@ -1,6 +1,7 @@
 import { CollectionItem, GraphicsStorage } from "@/models/CollectionModels";
 import getLogger from "@/utils/getLogger";
 import sendNotification from "@/utils/sendNotification";
+import { collectionStorage } from "./collectionStorage";
 import saveCollectionsToCloud from "./saveCollectionsToCloud";
 import saveCollectionsToLocal from "./saveCollectionsToLocal";
 import updateGraphics from "./updateGraphics";
@@ -16,7 +17,7 @@ export default async function saveCollections(
 	const timestamp: number = Date.now();
 	await saveCollectionsToLocal(collections, timestamp);
 
-	if (updateCloud)
+	if (updateCloud && await collectionStorage.disableCloud.getValue() !== true)
 		try
 		{
 			await saveCollectionsToCloud(collections, timestamp);

features/collectionStorage/utils/setCloudStorage.ts

@@ -0,0 +1,19 @@
+import { collectionStorage } from "./collectionStorage";
+import saveCollectionsToCloud from "./saveCollectionsToCloud";
+
+export default async function setCloudStorage(enable: boolean): Promise<void>
+{
+	if (enable)
+	{
+		await collectionStorage.disableCloud.setValue(false);
+		const collections = await collectionStorage.localCollections.getValue();
+		const lastUpdated = await collectionStorage.localLastUpdated.getValue();
+		await saveCollectionsToCloud(collections, lastUpdated);
+	}
+	else
+	{
+		await collectionStorage.disableCloud.setValue(true);
+		await saveCollectionsToCloud([], 0);
+		browser.runtime.reload();
+	}
+}

hooks/useDangerStyles.ts

@@ -24,5 +24,19 @@ export const useDangerStyles = makeStyles({
 				backgroundColor: tokens.colorStatusDangerBackground3Pressed
 			}
 		}
+	},
+	buttonSubtle:
+	{
+		color: tokens.colorStatusDangerForeground1,
+
+		"&:hover":
+		{
+			color: tokens.colorStatusDangerForeground2,
+
+			"&:active":
+			{
+				color: tokens.colorStatusDangerForeground3
+			}
+		}
 	}
 });

locales/en.yml

@@ -116,6 +116,11 @@ options_page:
       warning_title: "This is an irreversible action"
       warning_text: "This will overwrite all your data. Make sure you picked a correct file, otherwise data corruption or loss may occur. It is recommended to export data first."
       proceed: "Pick a file"
+    enable: "Enable cloud storage"
+    disable: "Disable cloud storage"
+    disable_prompt:
+      text: "This action will disable collection synchronization between your devices. Extension's settings will still be synchronized."
+      action: "Disable and reload the extension"
   about:
     title: "About"
     developed_by: "Developed by Eugene Fox"

locales/ru.yml

@@ -116,6 +116,11 @@ options_page:
       warning_title: "Это необратимое действие!"
       warning_text: "Оно перезапишет все ваши данные. Убедитесь, что вы выбрали правильный файл, иначе это может привести к повреждению или потере данных. Рекомендуется сначала экспортировать данные."
       proceed: "Выбрать файл"
+    enable: "Включить облачное хранилище"
+    disable: "Отключить облачное хранилище"
+    disable_prompt:
+      text: "Это действие отключит синхронизацию коллекций между вашими устройствами. Настройки расширения продолжат храниться в облаке."
+      action: "Отключить и перезагрузить расширение"
   about:
     title: "О расширении"
     developed_by: "Разработчик: Евгений Лис"

locales/uk.yml

@@ -116,6 +116,11 @@ options_page:
       warning_title: "Це незворотна дія!"
       warning_text: "Вона перезапише всі ваші дані. Переконайтеся, що ви вибрали правильний файл, інакше це може призвести до пошкодження або втрати даних. Рекомендується спочатку експортувати дані."
       proceed: "Вибрати файл"
+    disable: "Вимкнути хмарне сховище"
+    enable: "Увімкнути хмарне сховище"
+    disable_prompt:
+      text: "Ця дія вимкне синхронізацію колекцій між вашими пристроями. Налаштування продовжать зберігатися у хмарі."
+      action: "Вимкнути та перезавантажити розширення"
   about:
     title: "О розширенні"
     developed_by: "Розробник: Євген Лис"