homeio

1export const UPDATE_REMINDER_STORAGE_KEY = "desktop.update-reminder.v1";
2
3/** How long "Later" hides the update reminder before it comes back. */
4export const UPDATE_REMINDER_SNOOZE_MS = 60 * 60 * 1000;
5
6export type UpdateReminderSnooze = {
7  /** The version the user postponed; a newer one shows straight away. */
8  version: string;
9  snoozedUntil: number;
10};
11
12type StorageLike = Pick<Storage, "getItem" | "setItem">;
13
14export function readUpdateReminderSnooze(storage: StorageLike): UpdateReminderSnooze | null {
15  try {
16    const raw = storage.getItem(UPDATE_REMINDER_STORAGE_KEY);
17    if (!raw) return null;
18    const value = JSON.parse(raw) as Partial<UpdateReminderSnooze>;
19    if (typeof value.version !== "string" || typeof value.snoozedUntil !== "number") return null;
20    return { version: value.version, snoozedUntil: value.snoozedUntil };
21  } catch {
22    return null;
23  }
24}
25
26export function writeUpdateReminderSnooze(
27  storage: StorageLike,
28  version: string,
29  now: number,
30  durationMs = UPDATE_REMINDER_SNOOZE_MS,
31): UpdateReminderSnooze {
32  const snooze = { version, snoozedUntil: now + durationMs };
33  try {
34    storage.setItem(UPDATE_REMINDER_STORAGE_KEY, JSON.stringify(snooze));
35  } catch {
36    // Private windows and full storage throw; the snooze then lasts until reload.
37  }
38  return snooze;
39}
40
41/** Milliseconds until the reminder may show again for `version`, or 0 if it can show now. */
42export function updateReminderSnoozeRemaining(
43  snooze: UpdateReminderSnooze | null,
44  version: string,
45  now: number,
46): number {
47  if (!snooze || snooze.version !== version) return 0;
48  return Math.max(0, snooze.snoozedUntil - now);
49}
50