Files
kandev/apps/web/components/settings/notification-permission-section.tsx
T
João Salavisa e4c4efec18 feat(i18n): localize Settings > General > Notifications
Settings > General > Notifications held all of its copy as literals, so the page
stayed English under a locale switch. Every string now resolves through t() /
<Trans> at render, and the page is on the i18nGuardFiles allowlist so it cannot
drift back.

Event titles, sound preset names and the permission button label resolve from
maps of catalog keys rather than module-scope t(), so they follow a locale
switch. The Apprise install notice is a single <Trans> message so the link stays
inside the sentence. SCREENS in the pseudo-locale oracle gains a per-screen
allow list for text the frontend must not translate (backend-owned provider
names).
2026-08-02 01:49:44 +02:00

149 lines
5.3 KiB
TypeScript

import { useCallback, useEffect, useState } from "react";
import { IconBell, IconRefresh } from "@tabler/icons-react";
import { useTranslation } from "react-i18next";
import { Button } from "@kandev/ui/button";
import { HoverCard, HoverCardContent, HoverCardTrigger } from "@kandev/ui/hover-card";
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@kandev/ui/tooltip";
import {
nativeNotifications,
type NativeNotificationPermission,
} from "@/lib/desktop/native-notification-client";
import type { PermissionRefresh } from "./notifications-settings-actions";
type NotificationPermissionState =
| NativeNotificationPermission
| NotificationPermission
| "unsupported"
| "error";
type DesktopNotificationsSectionProps = {
notificationPermission: NotificationPermissionState;
onRequestPermission: () => Promise<void>;
onRefreshPermission: () => Promise<void>;
onTestNotification: () => void;
};
/**
* Returns a catalog key rather than copy: `permission` is a sentinel compared
* with `===` and this helper runs outside a component, so resolving here would
* either freeze the copy at the boot locale or need a `t` threaded through.
*/
function permissionActionLabelKey(permission: NotificationPermissionState) {
if (permission === "granted") return "settings:notificationPermissionEnabled";
if (permission === "error") return "settings:notificationPermissionRetry";
return "settings:notificationPermissionEnable";
}
export function DesktopNotificationsSection({
notificationPermission,
onRequestPermission,
onRefreshPermission,
onTestNotification,
}: DesktopNotificationsSectionProps) {
const { t } = useTranslation();
return (
<div className="space-y-4">
<div className="flex items-center justify-between gap-4">
<div>
<div className="text-base font-medium">{t("settings:desktopNotifications")}</div>
<p className="text-sm text-muted-foreground">
{t("settings:desktopNotificationsDescription")}
</p>
</div>
<div className="flex items-center gap-2">
<Button
title={t("settings:enableDesktopNotifications")}
variant="default"
size="sm"
onClick={() => void onRequestPermission()}
disabled={
notificationPermission === "granted" || notificationPermission === "unsupported"
}
className={
notificationPermission === "granted"
? "bg-emerald-500 text-white hover:bg-emerald-500"
: "cursor-pointer"
}
>
{t(permissionActionLabelKey(notificationPermission))}
</Button>
<TooltipProvider>
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="ghost"
size="icon"
aria-label={t("settings:refreshNotificationPermission")}
className="cursor-pointer"
onClick={() => void onRefreshPermission()}
>
<IconRefresh className="h-4 w-4" />
</Button>
</TooltipTrigger>
<TooltipContent>{t("settings:refreshPermissionStatus")}</TooltipContent>
</Tooltip>
</TooltipProvider>
<HoverCard>
<HoverCardTrigger asChild>
<Button
title={t("settings:sendTestNotification")}
variant="outline"
className="cursor-pointer"
size="icon"
onClick={() => {
void onTestNotification();
}}
>
<IconBell className="h-4 w-4" />
</Button>
</HoverCardTrigger>
<HoverCardContent side="top" className="text-sm">
{t("settings:notificationsNotShowingHint")}
</HoverCardContent>
</HoverCard>
</div>
</div>
{notificationPermission === "denied" && (
<p className="text-sm text-amber-600">
{nativeNotifications.isAvailable()
? t("settings:notificationsBlockedInOs")
: t("settings:notificationsBlockedInBrowser")}
</p>
)}
{notificationPermission === "unsupported" && (
<p className="text-sm text-amber-600">{t("settings:notificationsUnsupported")}</p>
)}
{notificationPermission === "error" && (
<p className="text-sm text-amber-600">{t("settings:notificationPermissionCheckFailed")}</p>
)}
</div>
);
}
export function useNotificationPermission() {
const [notificationPermission, setNotificationPermission] =
useState<NotificationPermissionState>("default");
const refreshPermission = useCallback<PermissionRefresh>(async (error) => {
if (error) {
setNotificationPermission("error");
return;
}
try {
if (nativeNotifications.isAvailable()) {
setNotificationPermission(await nativeNotifications.permission.get());
return;
}
setNotificationPermission(
typeof Notification === "undefined" ? "unsupported" : Notification.permission,
);
} catch {
setNotificationPermission("error");
}
}, []);
useEffect(() => {
void refreshPermission();
}, [refreshPermission]);
return { notificationPermission, refreshPermission };
}