homeio

1export const POWER_ACTION_STATE_STORAGE_KEY = "system.power.action.v1";
2export const POWER_ACTION_COMPLETION_STORAGE_KEY = "system.power.action.completed.v1";
3export const POWER_ACTION_STATE_CHANGED_EVENT = "homeio:power-action-state-changed";
4
5export type PersistedPowerActionState = {
6  action: "reboot" | "shutdown" | "factory-reset" | "restore" | "update";
7  startedAt: string;
8  requestDispatchedAt?: string;
9};
10
11export type PersistedPowerActionCompletion = {
12  action: PersistedPowerActionState["action"];
13  completedAt: string;
14};
15
16function parsePersistedPowerActionState(rawValue: string | null) {
17  if (!rawValue) return null;
18
19  try {
20    const parsed = JSON.parse(rawValue) as Partial<PersistedPowerActionState>;
21    if (
22      parsed.action !== "reboot" &&
23      parsed.action !== "shutdown" &&
24      parsed.action !== "factory-reset" &&
25      parsed.action !== "restore" &&
26      parsed.action !== "update"
27    ) {
28      return null;
29    }
30    if (typeof parsed.startedAt !== "string" || parsed.startedAt.length === 0) {
31      return null;
32    }
33
34    return {
35      action: parsed.action,
36      startedAt: parsed.startedAt,
37      requestDispatchedAt:
38        typeof parsed.requestDispatchedAt === "string" && parsed.requestDispatchedAt.length > 0
39          ? parsed.requestDispatchedAt
40          : undefined,
41    };
42  } catch {
43    return null;
44  }
45}
46
47function parsePersistedPowerActionCompletion(rawValue: string | null) {
48  if (!rawValue) return null;
49
50  try {
51    const parsed = JSON.parse(rawValue) as Partial<PersistedPowerActionCompletion>;
52    if (
53      parsed.action !== "reboot" &&
54      parsed.action !== "shutdown" &&
55      parsed.action !== "factory-reset" &&
56      parsed.action !== "restore" &&
57      parsed.action !== "update"
58    ) {
59      return null;
60    }
61    if (typeof parsed.completedAt !== "string" || parsed.completedAt.length === 0) {
62      return null;
63    }
64
65    return {
66      action: parsed.action,
67      completedAt: parsed.completedAt,
68    };
69  } catch {
70    return null;
71  }
72}
73
74function dispatchPowerActionStateChanged() {
75  if (typeof window === "undefined") return;
76
77  window.dispatchEvent(new Event(POWER_ACTION_STATE_CHANGED_EVENT));
78}
79
80export function readPersistedPowerActionState(storage: Storage | undefined) {
81  if (!storage) return null;
82
83  try {
84    return parsePersistedPowerActionState(
85      storage.getItem(POWER_ACTION_STATE_STORAGE_KEY),
86    );
87  } catch {
88    return null;
89  }
90}
91
92export function writePersistedPowerActionState(
93  storage: Storage | undefined,
94  state: PersistedPowerActionState,
95) {
96  if (!storage) return;
97
98  try {
99    storage.setItem(POWER_ACTION_STATE_STORAGE_KEY, JSON.stringify(state));
100    dispatchPowerActionStateChanged();
101  } catch {
102    // Best-effort only.
103  }
104}
105
106export function clearPersistedPowerActionState(storage: Storage | undefined) {
107  if (!storage) return;
108
109  try {
110    storage.removeItem(POWER_ACTION_STATE_STORAGE_KEY);
111    dispatchPowerActionStateChanged();
112  } catch {
113    // Best-effort only.
114  }
115}
116
117export function readPersistedPowerActionCompletion(storage: Storage | undefined) {
118  if (!storage) return null;
119
120  try {
121    return parsePersistedPowerActionCompletion(
122      storage.getItem(POWER_ACTION_COMPLETION_STORAGE_KEY),
123    );
124  } catch {
125    return null;
126  }
127}
128
129export function writePersistedPowerActionCompletion(
130  storage: Storage | undefined,
131  completion: PersistedPowerActionCompletion,
132) {
133  if (!storage) return;
134
135  try {
136    storage.setItem(POWER_ACTION_COMPLETION_STORAGE_KEY, JSON.stringify(completion));
137    dispatchPowerActionStateChanged();
138  } catch {
139    // Best-effort only.
140  }
141}
142
143export function clearPersistedPowerActionCompletion(storage: Storage | undefined) {
144  if (!storage) return;
145
146  try {
147    storage.removeItem(POWER_ACTION_COMPLETION_STORAGE_KEY);
148    dispatchPowerActionStateChanged();
149  } catch {
150    // Best-effort only.
151  }
152}
153