feat(dashboard): persist notification center state

src/shared/lib/actions/helpers.ts

@@ -31,6 +31,7 @@ export const revalidateConfig = {
 	budgets: ["/budgets"],
 	payers: ["/payers"],
 	notes: ["/notes", "/notes/archived", "/dashboard"],
+	notifications: ["/dashboard"],
 	transactions: ["/transactions", "/accounts"],
 	inbox: ["/inbox", "/transactions", "/dashboard"],
 } as const;
@@ -43,6 +44,7 @@ const DASHBOARD_ENTITIES: ReadonlySet<string> = new Set([
 	"budgets",
 	"payers",
 	"notes",
+	"notifications",
 	"inbox",
 	"recurring",
 ]);

src/shared/lib/notifications/is-table-missing.ts

@@ -0,0 +1,16 @@
+/**
+ * Detecta se um erro indica que a tabela `dashboard_notification_states`
+ * ainda nao existe no banco (migration pendente).
+ */
+export function isNotificationStatesTableMissing(error: unknown): boolean {
+	if (!(error instanceof Error)) {
+		return false;
+	}
+
+	const message = error.message.toLowerCase();
+
+	return (
+		message.includes("dashboard_notification_states") &&
+		(message.includes("does not exist") || message.includes("relation"))
+	);
+}

src/shared/lib/types/index.ts

@@ -1,3 +1,4 @@
 export * from "./actions";
 export * from "./calendar";
+export * from "./notifications";
 export * from "./reports";

src/shared/lib/types/notifications.ts

@@ -0,0 +1,39 @@
+export type NotificationType = "overdue" | "due_soon";
+
+export type BudgetStatus = "exceeded" | "critical";
+
+export type DashboardNotificationStateFields = {
+	notificationKey: string;
+	fingerprint: string;
+	href: string;
+	isRead: boolean;
+	isArchived: boolean;
+	readAt: Date | null;
+	archivedAt: Date | null;
+};
+
+export type DashboardNotification = {
+	type: "invoice" | "boleto";
+	name: string;
+	dueDate: string;
+	status: NotificationType;
+	amount: number;
+	period?: string;
+	showAmount: boolean;
+	cardLogo?: string | null;
+} & DashboardNotificationStateFields;
+
+export type BudgetNotification = {
+	categoryName: string;
+	budgetAmount: number;
+	spentAmount: number;
+	usedPercentage: number;
+	status: BudgetStatus;
+} & DashboardNotificationStateFields;
+
+export type DashboardNotificationsSnapshot = {
+	notifications: DashboardNotification[];
+	budgetNotifications: BudgetNotification[];
+	unreadCount: number;
+	visibleCount: number;
+};