granola-toolkit 0.34.4 → 0.34.6

package/README.md

@@ -30,8 +30,8 @@ granola tui
 
 ## Documentation
 
-The detailed documentation now lives in the dedicated docs app under
-[`docs/`](https://github.com/kkarimi/granola-toolkit/tree/main/docs).
+The detailed documentation now lives at
+[`kkarimi.github.io/granola-toolkit`](https://kkarimi.github.io/granola-toolkit/).
 
 Local docs development:
 
@@ -42,13 +42,13 @@ npm run docs:check
 
 Key docs entry points:
 
-- [`Overview`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/index.mdx)
-- [`Getting Started`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/getting-started.mdx)
-- [`Exporting`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/exporting.mdx)
-- [`Meetings and Folders`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/meetings-and-folders.mdx)
-- [`Server, Web, and TUI`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/server-web-and-tui.mdx)
-- [`Auth and Configuration`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/auth-and-configuration.mdx)
-- [`Development`](https://github.com/kkarimi/granola-toolkit/blob/main/docs/content/docs/development.mdx)
+- [`Overview`](https://kkarimi.github.io/granola-toolkit/docs/)
+- [`Getting Started`](https://kkarimi.github.io/granola-toolkit/docs/getting-started/)
+- [`Exporting`](https://kkarimi.github.io/granola-toolkit/docs/exporting/)
+- [`Meetings and Folders`](https://kkarimi.github.io/granola-toolkit/docs/meetings-and-folders/)
+- [`Server, Web, and TUI`](https://kkarimi.github.io/granola-toolkit/docs/server-web-and-tui/)
+- [`Auth and Configuration`](https://kkarimi.github.io/granola-toolkit/docs/auth-and-configuration/)
+- [`Development`](https://kkarimi.github.io/granola-toolkit/docs/development/)
 
 ## Local Development
 

package/dist/cli.js

@@ -4414,10 +4414,115 @@ async function openExternalUrl(url, options = {}) {
 	}))(command.file, command.args);
 }
 //#endregion
+//#region src/web/client-state.ts
+function parseWorkspaceTab(value) {
+	switch (value) {
+		case "metadata":
+		case "raw":
+		case "transcript": return value;
+		default: return "notes";
+	}
+}
+function startupSelectionFromSearch(search) {
+	const params = new URLSearchParams(search);
+	return {
+		folderId: params.get("folder")?.trim() || "",
+		meetingId: params.get("meeting")?.trim() || "",
+		workspaceTab: parseWorkspaceTab(params.get("tab"))
+	};
+}
+function buildBrowserUrlPath(currentHref, selection) {
+	const url = new URL(currentHref);
+	if (selection.selectedFolderId) url.searchParams.set("folder", selection.selectedFolderId);
+	else url.searchParams.delete("folder");
+	if (selection.selectedMeetingId) url.searchParams.set("meeting", selection.selectedMeetingId);
+	else url.searchParams.delete("meeting");
+	if (parseWorkspaceTab(selection.workspaceTab) !== "notes") url.searchParams.set("tab", parseWorkspaceTab(selection.workspaceTab));
+	else url.searchParams.delete("tab");
+	return `${url.pathname}${url.search}${url.hash}`;
+}
+function exportScopeLabel(scope) {
+	return scope && scope.mode === "folder" ? `Folder: ${scope.folderName || scope.folderId}` : "Scope: All meetings";
+}
+function currentFilterSummary(filters) {
+	const parts = [];
+	if (filters.selectedFolderId) {
+		const folder = filters.folders.find((candidate) => candidate.id === filters.selectedFolderId);
+		parts.push(`folder "${folder ? folder.name : filters.selectedFolderId}"`);
+	}
+	if (filters.search) parts.push(`search "${filters.search}"`);
+	if (filters.updatedFrom) parts.push(`from ${filters.updatedFrom}`);
+	if (filters.updatedTo) parts.push(`to ${filters.updatedTo}`);
+	return parts.join(", ");
+}
+function selectMeetingId(meetings, selectedMeetingId) {
+	if (selectedMeetingId && meetings.some((meeting) => meeting.id === selectedMeetingId)) return selectedMeetingId;
+	return meetings[0]?.id ?? null;
+}
+function buildMeetingsQuery(filters, options = {}) {
+	const params = new URLSearchParams();
+	params.set("limit", String(options.limit ?? 100));
+	params.set("sort", filters.sort || "updated-desc");
+	if (filters.search) params.set("search", filters.search);
+	if (filters.updatedFrom) params.set("updatedFrom", filters.updatedFrom);
+	if (filters.updatedTo) params.set("updatedTo", filters.updatedTo);
+	if (filters.selectedFolderId) params.set("folderId", filters.selectedFolderId);
+	if (options.refresh) params.set("refresh", "true");
+	return `?${params.toString()}`;
+}
+function buildNotesExportRequest(selectedFolderId) {
+	return {
+		folderId: selectedFolderId || void 0,
+		format: "markdown"
+	};
+}
+function buildTranscriptsExportRequest(selectedFolderId) {
+	return {
+		folderId: selectedFolderId || void 0,
+		format: "text"
+	};
+}
+function nextWorkspaceTab(currentTab, key) {
+	const current = parseWorkspaceTab(currentTab);
+	switch (key) {
+		case "1": return "notes";
+		case "2": return "transcript";
+		case "3": return "metadata";
+		case "4": return "raw";
+		case "]":
+			switch (current) {
+				case "notes": return "transcript";
+				case "transcript": return "metadata";
+				case "metadata": return "raw";
+				case "raw": return "notes";
+			}
+			break;
+		case "[":
+			switch (current) {
+				case "notes": return "raw";
+				case "transcript": return "notes";
+				case "metadata": return "transcript";
+				case "raw": return "metadata";
+			}
+			break;
+		default: return;
+	}
+}
+//#endregion
 //#region src/web/client-script.ts
 const granolaWebClientScript = String.raw`
 const serverConfig = window.__GRANOLA_SERVER__ || { passwordRequired: false };
 const workspaceTabs = ["notes", "transcript", "metadata", "raw"];
+${parseWorkspaceTab.toString()}
+${startupSelectionFromSearch.toString()}
+${buildBrowserUrlPath.toString()}
+${exportScopeLabel.toString()}
+${currentFilterSummary.toString()}
+${selectMeetingId.toString()}
+${buildMeetingsQuery.toString()}
+${buildNotesExportRequest.toString()}
+${buildTranscriptsExportRequest.toString()}
+${nextWorkspaceTab.toString()}
 
 const state = {
   appState: null,
@@ -4466,41 +4571,12 @@ const els = {
   workspaceTabs: document.querySelectorAll("[data-workspace-tab]"),
 };
 
-function parseWorkspaceTab(value) {
-  return workspaceTabs.includes(value) ? value : "notes";
-}
-
-function startupSelection() {
-  const params = new URLSearchParams(window.location.search);
-  return {
-    folderId: params.get("folder")?.trim() || "",
-    meetingId: params.get("meeting")?.trim() || "",
-    workspaceTab: parseWorkspaceTab(params.get("tab")),
-  };
-}
-
 function syncBrowserUrl() {
-  const url = new URL(window.location.href);
-
-  if (state.selectedFolderId) {
-    url.searchParams.set("folder", state.selectedFolderId);
-  } else {
-    url.searchParams.delete("folder");
-  }
-
-  if (state.selectedMeetingId) {
-    url.searchParams.set("meeting", state.selectedMeetingId);
-  } else {
-    url.searchParams.delete("meeting");
-  }
-
-  if (state.workspaceTab !== "notes") {
-    url.searchParams.set("tab", state.workspaceTab);
-  } else {
-    url.searchParams.delete("tab");
-  }
-
-  const nextPath = url.pathname + url.search + url.hash;
+  const nextPath = buildBrowserUrlPath(window.location.href, {
+    selectedFolderId: state.selectedFolderId,
+    selectedMeetingId: state.selectedMeetingId,
+    workspaceTab: state.workspaceTab,
+  });
   const currentPath = window.location.pathname + window.location.search + window.location.hash;
   if (nextPath !== currentPath) {
     history.replaceState(null, "", nextPath);
@@ -4515,12 +4591,6 @@ function escapeHtml(value) {
     .replaceAll('"', """);
 }
 
-function exportScopeLabel(scope) {
-  return scope && scope.mode === "folder"
-    ? "Folder: " + (scope.folderName || scope.folderId)
-    : "Scope: All meetings";
-}
-
 function setStatus(label, tone = "idle") {
   els.stateBadge.textContent = label;
   els.stateBadge.dataset.tone = tone;
@@ -4534,29 +4604,6 @@ function syncFilterInputs() {
   els.updatedTo.value = state.updatedTo;
 }
 
-function currentFilterSummary() {
-  const parts = [];
-
-  if (state.selectedFolderId) {
-    const folder = state.folders.find((candidate) => candidate.id === state.selectedFolderId);
-    parts.push("folder " + (folder ? '"' + folder.name + '"' : '"' + state.selectedFolderId + '"'));
-  }
-
-  if (state.search) {
-    parts.push('search "' + state.search + '"');
-  }
-
-  if (state.updatedFrom) {
-    parts.push("from " + state.updatedFrom);
-  }
-
-  if (state.updatedTo) {
-    parts.push("to " + state.updatedTo);
-  }
-
-  return parts.join(", ");
-}
-
 function renderWorkspaceTabs() {
   for (const button of els.workspaceTabs) {
     button.dataset.selected = button.dataset.workspaceTab === state.workspaceTab ? "true" : "false";
@@ -4730,7 +4777,13 @@ function renderMeetingList() {
     state.selectedMeeting = null;
     state.selectedMeetingBundle = null;
     syncBrowserUrl();
-    const filterSummary = currentFilterSummary();
+    const filterSummary = currentFilterSummary({
+      folders: state.folders,
+      search: state.search,
+      selectedFolderId: state.selectedFolderId,
+      updatedFrom: state.updatedFrom,
+      updatedTo: state.updatedTo,
+    });
     const message = filterSummary
       ? "No meetings match " + filterSummary + "."
       : "No meetings yet. Try Refresh.";
@@ -4739,10 +4792,7 @@ function renderMeetingList() {
     return;
   }
 
-  const visibleIds = new Set(state.meetings.map((meeting) => meeting.id));
-  if (!state.selectedMeetingId || !visibleIds.has(state.selectedMeetingId)) {
-    state.selectedMeetingId = state.meetings[0]?.id || null;
-  }
+  state.selectedMeetingId = selectMeetingId(state.meetings, state.selectedMeetingId);
   syncBrowserUrl();
 
   els.list.innerHTML = state.meetings
@@ -4886,34 +4936,6 @@ async function fetchJson(path, init) {
   return payload;
 }
 
-function buildMeetingsQuery(limit = 100, refresh = false) {
-  const params = new URLSearchParams();
-  params.set("limit", String(limit));
-  params.set("sort", state.sort);
-
-  if (state.search) {
-    params.set("search", state.search);
-  }
-
-  if (state.updatedFrom) {
-    params.set("updatedFrom", state.updatedFrom);
-  }
-
-  if (state.updatedTo) {
-    params.set("updatedTo", state.updatedTo);
-  }
-
-  if (state.selectedFolderId) {
-    params.set("folderId", state.selectedFolderId);
-  }
-
-  if (refresh) {
-    params.set("refresh", "true");
-  }
-
-  return "?" + params.toString();
-}
-
 async function loadFolders(options = {}) {
   const refresh = options.refresh === true;
 
@@ -4953,7 +4975,22 @@ async function loadMeetings(options = {}) {
 
   try {
     state.listError = "";
-    const payload = await fetchJson("/meetings" + buildMeetingsQuery(100, refresh));
+    const payload = await fetchJson(
+      "/meetings" +
+        buildMeetingsQuery(
+          {
+            search: state.search,
+            selectedFolderId: state.selectedFolderId,
+            sort: state.sort,
+            updatedFrom: state.updatedFrom,
+            updatedTo: state.updatedTo,
+          },
+          {
+            limit: 100,
+            refresh,
+          },
+        ),
+    );
     state.meetings = payload.meetings || [];
     state.meetingSource = payload.source || "live";
 
@@ -5063,10 +5100,7 @@ async function syncAuthState() {
 async function exportNotes() {
   setStatus(state.selectedFolderId ? "Exporting folder notes…" : "Exporting notes…", "busy");
   await fetchJson("/exports/notes", {
-    body: JSON.stringify({
-      folderId: state.selectedFolderId || undefined,
-      format: "markdown",
-    }),
+    body: JSON.stringify(buildNotesExportRequest(state.selectedFolderId)),
     headers: { "content-type": "application/json" },
     method: "POST",
   });
@@ -5079,10 +5113,7 @@ async function exportTranscripts() {
     "busy",
   );
   await fetchJson("/exports/transcripts", {
-    body: JSON.stringify({
-      folderId: state.selectedFolderId || undefined,
-      format: "text",
-    }),
+    body: JSON.stringify(buildTranscriptsExportRequest(state.selectedFolderId)),
     headers: { "content-type": "application/json" },
     method: "POST",
   });
@@ -5386,50 +5417,15 @@ document.addEventListener("keydown", (event) => {
     return;
   }
 
-  const tabs = ["notes", "transcript", "metadata", "raw"];
-  if (event.key === "1") {
-    state.workspaceTab = "notes";
-    syncBrowserUrl();
-    renderMeetingDetail();
-    return;
-  }
-
-  if (event.key === "2") {
-    state.workspaceTab = "transcript";
-    syncBrowserUrl();
-    renderMeetingDetail();
-    return;
-  }
-
-  if (event.key === "3") {
-    state.workspaceTab = "metadata";
-    syncBrowserUrl();
-    renderMeetingDetail();
-    return;
-  }
-
-  if (event.key === "4") {
-    state.workspaceTab = "raw";
-    syncBrowserUrl();
-    renderMeetingDetail();
-    return;
-  }
-
-  const currentIndex = tabs.indexOf(state.workspaceTab);
-  if (event.key === "]") {
-    state.workspaceTab = tabs[(currentIndex + 1) % tabs.length];
-    syncBrowserUrl();
-    renderMeetingDetail();
-  }
-
-  if (event.key === "[") {
-    state.workspaceTab = tabs[(currentIndex + tabs.length - 1) % tabs.length];
+  const nextTab = nextWorkspaceTab(state.workspaceTab, event.key);
+  if (nextTab) {
+    state.workspaceTab = nextTab;
     syncBrowserUrl();
     renderMeetingDetail();
   }
 });
 
-const initialSelection = startupSelection();
+const initialSelection = startupSelectionFromSearch(window.location.search);
 state.selectedFolderId = initialSelection.folderId || null;
 state.selectedMeetingId = initialSelection.meetingId || null;
 state.workspaceTab = initialSelection.workspaceTab;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.34.4",
+  "version": "0.34.6",
   "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",
@@ -8,7 +8,7 @@
     "notes",
     "transcripts"
   ],
-  "homepage": "https://github.com/kkarimi/granola-toolkit#readme",
+  "homepage": "https://kkarimi.github.io/granola-toolkit/",
   "bugs": {
     "url": "https://github.com/kkarimi/granola-toolkit/issues"
   },