Files
OmniRoute/src/shared/components/CloudSyncStatus.tsx
Diego Rodrigues de Sa e Souza cefbcfb278 feat(dashboard): routing/settings UX clarity — share %, Cloud Sync rename, base-URL override (#6147) (#6253)
feat(dashboard): routing/settings UX clarity (#6147) — effective share %, Cloud Sync→Remote Settings Sync rename, opt-in advanced base-URL override. TDD guard routing-settings-ux-6147.test.ts (6/6). Base-reds only. Integrated into release/v3.8.45.
2026-07-05 07:46:18 -03:00

105 lines
3.6 KiB
TypeScript

"use client";
/**
* CloudSyncStatus — Compact sync status indicator for the sidebar
*
* Shows cloud sync connection state with a small icon + label.
* Fetches status from /api/sync/cloud periodically.
* Listens for 'cloud-status-changed' events to re-poll immediately.
*
* @module shared/components/CloudSyncStatus
*/
import { useState, useEffect, useRef, useCallback } from "react";
import { useRouter } from "next/navigation";
// #6147 — user-facing labels renamed from "Cloud …" to "Remote Settings Sync"
// wording (this feature syncs the operator's own settings to their own remote
// store — it is not a cloud/telemetry service). Internal state keys, the
// `cloud_*` material icons and the cloudSync.* wiring are intentionally kept.
const STATUS_CONFIG = {
connected: { icon: "cloud_done", color: "text-green-500", label: "Synced" },
syncing: { icon: "cloud_sync", color: "text-blue-400 animate-pulse", label: "Syncing..." },
disconnected: { icon: "cloud_off", color: "text-amber-500", label: "Sync Off" },
error: { icon: "cloud_off", color: "text-red-400", label: "Sync Error" },
disabled: { icon: "cloud_off", color: "text-text-muted/50", label: "Disabled" },
};
export default function CloudSyncStatus({ collapsed = false }) {
const [status, setStatus] = useState("disabled");
const [lastSync, setLastSync] = useState(null);
const mountedRef = useRef(true);
const router = useRouter();
const poll = useCallback(async () => {
try {
const res = await fetch("/api/sync/cloud");
if (!mountedRef.current) return;
if (!res.ok) {
setStatus("disconnected");
return;
}
const data = await res.json();
if (!mountedRef.current) return;
if (!data.enabled) setStatus("disabled");
else if (data.syncing) setStatus("syncing");
else if (data.connected) {
setStatus("connected");
if (data.lastSync) setLastSync(new Date(data.lastSync));
} else setStatus("disconnected");
} catch {
if (mountedRef.current) setStatus("disconnected");
}
}, []);
useEffect(() => {
mountedRef.current = true;
// Schedule initial poll outside of effect body to avoid setState-in-effect lint
queueMicrotask(poll);
const interval = setInterval(poll, 30000);
// Listen for immediate re-poll events from EndpointPageClient
const handleCloudChange = () => {
setTimeout(poll, 500); // Small delay to let backend settle
};
globalThis.addEventListener("cloud-status-changed", handleCloudChange);
return () => {
mountedRef.current = false;
clearInterval(interval);
globalThis.removeEventListener("cloud-status-changed", handleCloudChange);
};
}, [poll]);
// Don't render if cloud sync is disabled
if (status === "disabled") return null;
const config = STATUS_CONFIG[status];
return (
<button
onClick={() => router.push("/dashboard/endpoint")}
className="flex items-center gap-2 px-3 py-1.5 text-xs rounded-lg hover:bg-white/5 transition-colors cursor-pointer w-full"
title={
lastSync
? `Remote settings sync ${status === "connected" ? "connected" : "disconnected"} — Last sync: ${lastSync.toLocaleTimeString()}`
: config.label
}
aria-label={`Remote settings sync status: ${config.label}`}
>
<span className={`material-symbols-outlined text-[16px] ${config.color}`} aria-hidden="true">
{config.icon}
</span>
{!collapsed && (
<span
className={`truncate ${status === "connected" ? "text-green-500" : "text-text-muted"}`}
>
{config.label}
</span>
)}
</button>
);
}