desktop M10.3: frontend data-source adapter seam (repo interface + rest.ts)

Extract a typed repository interface (adapters/repo.ts) from the scattered
store/view -> api.* calls, backed by adapters/rest.ts (verbatim HTTP mapping)
and selected through adapters/index.ts. Every store and the notes-facing views
now depend on `repo`, never the HTTP client directly -- the seam the offline
local source (M10.5, over Tauri invoke) plugs into next.

Behavior-preserving for web: rest.ts maps each semantic method to the exact
endpoint the code called before; query-string and multipart building moved out
of the stores/views into rest.ts (the one place that knows the URL shape).
Client-side logic (reconcile/sort/optimistic reorder/toasts) stays in the
stores. GraphView + admin SettingsView keep direct api calls -- out of the
offline-core scope (M10.5 is board/editor/capture/search/filter/labels/
checklists/reminders).

Task 1992.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FRgehjoz7Yv8LkUfADxACm

frontend/src/stores/notes.ts

@@ -1,6 +1,6 @@
 import { defineStore } from "pinia";
 import { ref } from "vue";
-import { api } from "../api/client";
+import { repo } from "../adapters";
 import { useUiStore } from "./ui";
 import type { NoteColor } from "../notes/colors";
 
@@ -127,19 +127,7 @@ export const useNotesStore = defineStore("notes", () => {
     activeFacets.value = facets;
     loading.value = true;
     try {
-      const params = new URLSearchParams();
-      params.set("filter", v);
-      if (labelId) params.append("label", labelId);
-      for (const id of facets.label ?? []) if (id) params.append("label", id);
-      if (facets.q) params.set("q", facets.q);
-      if (facets.color) params.set("color", facets.color);
-      if (facets.kind) params.set("kind", facets.kind);
-      if (facets.has_reminder) params.set("has_reminder", "true");
-      if (facets.has_attachment) params.set("has_attachment", "true");
-      if (facets.created_after) params.set("created_after", facets.created_after);
-      if (facets.created_before) params.set("created_before", facets.created_before);
-      const res = await api.get<{ notes: Note[] }>(`/api/notes?${params.toString()}`);
-      items.value = res.notes;
+      items.value = await repo.notes.list({ view: v, labelId, facets });
       sortItems();
     } finally {
       loading.value = false;
@@ -153,7 +141,7 @@ export const useNotesStore = defineStore("notes", () => {
     kind?: NoteKind;
     items?: string[];
   }): Promise<Note> {
-    const note = await api.post<Note>("/api/notes", input);
+    const note = await repo.notes.create(input);
     reconcile(note);
     return note;
   }
@@ -164,7 +152,7 @@ export const useNotesStore = defineStore("notes", () => {
       Pick<Note, "title" | "body" | "color" | "kind" | "pinned" | "archived" | "remind_at" | "recurrence">
     >,
   ): Promise<void> {
-    reconcile(await api.patch<Note>(`/api/notes/${id}`, changes));
+    reconcile(await repo.notes.update(id, changes));
   }
 
   const setPinned = (id: string, pinned: boolean) => mutate(id, { pinned });
@@ -180,50 +168,46 @@ export const useNotesStore = defineStore("notes", () => {
   const saveEdit = (id: string, changes: { title: string; body: string; color: NoteColor }) => mutate(id, changes);
 
   async function completeReminder(id: string): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/reminder/complete`));
+    reconcile(await repo.notes.completeReminder(id));
   }
   async function snoozeReminder(id: string, minutes: number): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/reminder/snooze`, { minutes }));
+    reconcile(await repo.notes.snoozeReminder(id, minutes));
   }
 
   async function setLabels(id: string, labelIds: string[]): Promise<void> {
-    reconcile(await api.put<Note>(`/api/notes/${id}/labels`, { label_ids: labelIds }));
+    reconcile(await repo.notes.setLabels(id, labelIds));
   }
 
   async function addItem(id: string, text: string): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/items`, { text }));
+    reconcile(await repo.notes.addItem(id, text));
   }
 
   async function updateItem(id: string, itemId: string, changes: { text?: string; checked?: boolean }): Promise<void> {
-    reconcile(await api.patch<Note>(`/api/notes/${id}/items/${itemId}`, changes));
+    reconcile(await repo.notes.updateItem(id, itemId, changes));
   }
 
   async function deleteItem(id: string, itemId: string): Promise<void> {
-    reconcile(await api.del<Note>(`/api/notes/${id}/items/${itemId}`));
+    reconcile(await repo.notes.deleteItem(id, itemId));
   }
 
   async function uploadAttachment(id: string, file: File): Promise<void> {
-    const form = new FormData();
-    form.append("file", file);
-    reconcile(await api.postForm<Note>(`/api/notes/${id}/attachments`, form));
+    reconcile(await repo.notes.uploadAttachment(id, file));
   }
 
   async function deleteAttachment(id: string, attId: string): Promise<void> {
-    reconcile(await api.del<Note>(`/api/notes/${id}/attachments/${attId}`));
+    reconcile(await repo.notes.deleteAttachment(id, attId));
   }
 
   async function unfurl(id: string, url: string): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/unfurl`, { url }));
+    reconcile(await repo.notes.unfurl(id, url));
   }
 
   async function deletePreview(id: string, previewId: string): Promise<void> {
-    reconcile(await api.del<Note>(`/api/notes/${id}/previews/${previewId}`));
+    reconcile(await repo.notes.deletePreview(id, previewId));
   }
 
   async function importNotes(file: File): Promise<{ source: string; imported: number; skipped: number }> {
-    const form = new FormData();
-    form.append("file", file);
-    const data = await api.postForm<{ source: string; imported: number; skipped: number }>("/api/notes/import", form);
+    const data = await repo.notes.import(file);
     // Refresh the current lens so imported notes appear (labels reloaded by caller).
     await load(view.value, activeLabel.value, activeFacets.value);
     return data;
@@ -231,14 +215,14 @@ export const useNotesStore = defineStore("notes", () => {
 
   async function fetchOne(id: string): Promise<Note | null> {
     try {
-      return await api.get<Note>(`/api/notes/${id}`);
+      return await repo.notes.get(id);
     } catch {
       return null;
     }
   }
 
   async function createTitled(title: string): Promise<Note> {
-    const created = await api.post<Note>("/api/notes", { title, body: "" });
+    const created = await repo.notes.createTitled(title);
     reconcile(created);
     return created;
   }
@@ -252,31 +236,30 @@ export const useNotesStore = defineStore("notes", () => {
       if (n) n.position = total - index;
     });
     sortItems();
-    await api.post("/api/notes/reorder", { ids: orderedIds });
+    await repo.notes.reorder(orderedIds);
   }
 
   async function trash(id: string): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/trash`));
+    reconcile(await repo.notes.trash(id));
     useUiStore().showToast("Note moved to trash", { label: "Undo", run: () => void restore(id) });
   }
 
   async function restore(id: string): Promise<void> {
-    reconcile(await api.post<Note>(`/api/notes/${id}/restore`));
+    reconcile(await repo.notes.restore(id));
   }
 
   async function deleteForever(id: string): Promise<void> {
-    await api.del(`/api/notes/${id}`);
+    await repo.notes.deleteForever(id);
     const idx = items.value.findIndex((n) => n.id === id);
     if (idx >= 0) items.value.splice(idx, 1);
   }
 
   async function fetchRevisions(id: string): Promise<NoteRevision[]> {
-    const res = await api.get<{ revisions: NoteRevision[] }>(`/api/notes/${id}/revisions`);
-    return res.revisions;
+    return await repo.notes.revisions(id);
   }
 
   async function restoreRevision(id: string, revId: string): Promise<Note> {
-    const note = await api.post<Note>(`/api/notes/${id}/revisions/${revId}/restore`);
+    const note = await repo.notes.restoreRevision(id, revId);
     reconcile(note);
     return note;
   }