backnotprop__plannotator/packages/server/editor-annotations.ts

/**
 * Editor Annotations — ephemeral in-memory store for VS Code editor selections.
 *
 * The VS Code extension POSTs annotations from the editor; the webview app
 * polls to pick them up. The array lives in this closure and dies when the
 * server stops. No disk persistence.
 */

import type { EditorAnnotation } from "@plannotator/shared/types";

export type { EditorAnnotation };

export interface EditorAnnotationHandler {
  handle: (req: Request, url: URL) => Promise<Response | null>;
}

export function createEditorAnnotationHandler(): EditorAnnotationHandler {
  const annotations: EditorAnnotation[] = [];

  return {
    async handle(req: Request, url: URL): Promise<Response | null> {
      // GET /api/editor-annotations — return all
      if (url.pathname === "/api/editor-annotations" && req.method === "GET") {
        return Response.json({ annotations });
      }

      // POST /api/editor-annotation — add one
      if (url.pathname === "/api/editor-annotation" && req.method === "POST") {
        try {
          const body = (await req.json()) as {
            filePath?: string;
            selectedText?: string;
            lineStart?: number;
            lineEnd?: number;
            comment?: string;
          };

          if (!body.filePath || !body.selectedText || !body.lineStart || !body.lineEnd) {
            return Response.json({ error: "Missing required fields" }, { status: 400 });
          }

          const annotation: EditorAnnotation = {
            id: crypto.randomUUID(),
            filePath: body.filePath,
            selectedText: body.selectedText,
            lineStart: body.lineStart,
            lineEnd: body.lineEnd,
            comment: body.comment,
            createdAt: Date.now(),
          };

          annotations.push(annotation);
          return Response.json({ id: annotation.id });
        } catch {
          return Response.json({ error: "Invalid JSON" }, { status: 400 });
        }
      }

      // DELETE /api/editor-annotation?id=xxx — remove one
      if (url.pathname === "/api/editor-annotation" && req.method === "DELETE") {
        const id = url.searchParams.get("id");
        if (!id) {
          return Response.json({ error: "Missing id parameter" }, { status: 400 });
        }
        const idx = annotations.findIndex((a) => a.id === id);
        if (idx !== -1) {
          annotations.splice(idx, 1);
        }
        return Response.json({ ok: true });
      }

      // Not handled
      return null;
    },
  };
}