homeio

1export const RECENT_COMMAND_ACTIONS_STORAGE_KEY = "homeio.command-palette.recent.v1";
2const MAX_RECENT_COMMAND_ACTIONS = 6;
3
4export type RecentCommandAction =
5  | {
6      key: string;
7      kind: "window";
8      title: string;
9      subtitle: string;
10      windowId: "files" | "settings" | "app-store" | "terminal" | "monitor" | "notifications" | "app-settings" | "disk-manager";
11    }
12  | {
13      key: string;
14      kind: "settings-section";
15      title: string;
16      subtitle: string;
17      sectionId: string;
18    }
19  | {
20      key: string;
21      kind: "app-store-search";
22      title: string;
23      subtitle: string;
24      search: string;
25      appId?: string;
26    };
27
28type WindowRecentAction = Extract<RecentCommandAction, { kind: "window" }>;
29
30function isWindowId(value: unknown): value is WindowRecentAction["windowId"] {
31  return (
32    value === "files" ||
33    value === "settings" ||
34    value === "app-store" ||
35    value === "terminal" ||
36    value === "monitor" ||
37    value === "notifications" ||
38    value === "app-settings" ||
39    value === "disk-manager"
40  );
41}
42
43function isRecentCommandAction(value: unknown): value is RecentCommandAction {
44  if (!value || typeof value !== "object") return false;
45
46  const candidate = value as Partial<RecentCommandAction>;
47  if (
48    typeof candidate.key !== "string" ||
49    typeof candidate.title !== "string" ||
50    typeof candidate.subtitle !== "string"
51  ) {
52    return false;
53  }
54
55  if (candidate.kind === "window") {
56    return isWindowId(candidate.windowId);
57  }
58
59  if (candidate.kind === "settings-section") {
60    return typeof candidate.sectionId === "string";
61  }
62
63  if (candidate.kind === "app-store-search") {
64    return (
65      typeof candidate.search === "string" &&
66      (candidate.appId === undefined || typeof candidate.appId === "string")
67    );
68  }
69
70  return false;
71}
72
73export function readRecentCommandActions(storage: Storage | undefined) {
74  if (!storage) return [];
75
76  try {
77    const rawValue = storage.getItem(RECENT_COMMAND_ACTIONS_STORAGE_KEY);
78    if (!rawValue) return [];
79
80    const parsed = JSON.parse(rawValue) as unknown;
81    if (!Array.isArray(parsed)) return [];
82
83    return parsed.filter(isRecentCommandAction).slice(0, MAX_RECENT_COMMAND_ACTIONS);
84  } catch {
85    return [];
86  }
87}
88
89export function writeRecentCommandActions(
90  storage: Storage | undefined,
91  actions: RecentCommandAction[],
92) {
93  if (!storage) return;
94
95  try {
96    storage.setItem(
97      RECENT_COMMAND_ACTIONS_STORAGE_KEY,
98      JSON.stringify(actions.slice(0, MAX_RECENT_COMMAND_ACTIONS)),
99    );
100  } catch {
101    // Best-effort only.
102  }
103}
104
105export function pushRecentCommandAction(
106  storage: Storage | undefined,
107  action: RecentCommandAction,
108) {
109  const current = readRecentCommandActions(storage);
110  const next = [action, ...current.filter((entry) => entry.key !== action.key)].slice(
111    0,
112    MAX_RECENT_COMMAND_ACTIONS,
113  );
114  writeRecentCommandActions(storage, next);
115  return next;
116}
117