thoughtsync/frontend/src/adapters/repo.ts

// The data-source seam. Stores/views talk to this typed repository interface
// instead of reaching for the HTTP client directly, so the SAME UI can run
// against the REST backend (web + a server-connected desktop) or a fully-local
// on-device source (offline desktop). `rest.ts` implements it over `api/client`;
// `local.ts` (M10.5) implements it over Tauri `invoke`; `index.ts` picks one.
//
// Keep this interface a thin, semantic mirror of the current calls: every method
// maps 1:1 to a backend operation and returns the same shape the stores already
// consume. Client-side logic (list reconciliation, optimistic updates, toasts)
// stays in the stores — the repo is data access only.

import type { NoteColor } from "../notes/colors";
import type { Note, NoteFacets, NoteView, NoteRevision } from "../stores/notes";
import type { Label } from "../stores/labels";
import type { SavedFilter } from "../stores/savedFilters";
import type { Device } from "../stores/devices";
import type { TitleEntry } from "../stores/titles";
import type { User } from "../stores/session";
import type { PublicConfig } from "../stores/config";

// ---- notes payload shapes ----------------------------------------------------

// The full board query the GET /api/notes endpoint accepts. `rest.ts` renders it
// to a query string (the one place that knows the URL shape); a local source
// reads the same fields structurally.
export interface NoteListQuery {
  view: NoteView;
  labelId?: string | null;
  facets?: NoteFacets;
  // The timeline view sorts by creation instead of the board's pinned/position order.
  sort?: "created";
}

export interface NoteCreateInput {
  body: string;
  color: NoteColor;
  items?: string[];
}

// The mutable subset of a note (PATCH /api/notes/:id).
export type NoteChanges = Partial<
  Pick<Note, "body" | "color" | "pinned" | "archived" | "remind_at" | "recurrence">
>;

export interface ChecklistItemChanges {
  text?: string;
  checked?: boolean;
}


export interface ImportResult {
  source: string;
  imported: number;
  skipped: number;
}

export interface DeviceToken {
  token: string;
  device: Device;
}

// ---- per-domain repositories -------------------------------------------------

export interface ConfigRepo {
  get(): Promise<PublicConfig>;
}

export interface AuthRepo {
  me(): Promise<User>;
  login(email: string, password: string): Promise<User>;
  register(email: string, password: string, displayName: string): Promise<User>;
  logout(): Promise<void>;
}

export interface DevicesRepo {
  list(): Promise<Device[]>;
  create(name: string): Promise<DeviceToken>;
  remove(id: string): Promise<void>;
}

export interface LabelsRepo {
  list(): Promise<Label[]>;
  create(name: string): Promise<Label>;
  rename(id: string, name: string): Promise<Label>;
  setColor(id: string, color: string): Promise<Label>;
  remove(id: string): Promise<void>;
  merge(sourceId: string, into: string): Promise<Label>;
}

export interface NotesRepo {
  list(query: NoteListQuery): Promise<Note[]>;
  get(id: string): Promise<Note>;
  create(input: NoteCreateInput): Promise<Note>;
  update(id: string, changes: NoteChanges): Promise<Note>;
  completeReminder(id: string): Promise<Note>;
  snoozeReminder(id: string, minutes: number): Promise<Note>;
  setLabels(id: string, labelIds: string[]): Promise<Note>;
  addItem(id: string, text: string): Promise<Note>;
  updateItem(id: string, itemId: string, changes: ChecklistItemChanges): Promise<Note>;
  deleteItem(id: string, itemId: string): Promise<Note>;
  uploadAttachment(id: string, file: File): Promise<Note>;
  deleteAttachment(id: string, attId: string): Promise<Note>;
  unfurl(id: string, url: string): Promise<Note>;
  deletePreview(id: string, previewId: string): Promise<Note>;
  import(file: File): Promise<ImportResult>;
  reorder(orderedIds: string[]): Promise<void>;
  trash(id: string): Promise<Note>;
  restore(id: string): Promise<Note>;
  deleteForever(id: string): Promise<void>;
  revisions(id: string): Promise<NoteRevision[]>;
  restoreRevision(id: string, revId: string): Promise<Note>;
  reminders(): Promise<Note[]>;
  titles(): Promise<TitleEntry[]>;
}

export interface SavedFiltersRepo {
  list(): Promise<SavedFilter[]>;
  create(name: string, params: NoteFacets): Promise<SavedFilter>;
  remove(id: string): Promise<void>;
  rename(id: string, name: string): Promise<SavedFilter>;
}

export interface Repo {
  config: ConfigRepo;
  auth: AuthRepo;
  devices: DevicesRepo;
  labels: LabelsRepo;
  notes: NotesRepo;
  savedFilters: SavedFiltersRepo;
}