@peaske7/readit 0.3.0-rc.0 → 0.3.0-rc.1

package/vscode-readit/src/server-manager.ts

@@ -1,272 +0,0 @@
-import { type ChildProcess, spawn } from "node:child_process";
-import * as net from "node:net";
-import * as vscode from "vscode";
-
-/**
- * Manages the lifecycle of a readit Bun server process.
- *
- * Spawns `bun dist/index.js <file> --no-open --port <port>` as a child process.
- * Subsequent files are attached via POST /api/documents to the running server.
- * The server is killed when the extension deactivates or the last panel closes.
- */
-export class ServerManager implements vscode.Disposable {
-  private process: ChildProcess | null = null;
-  private port: number | null = null;
-  private outputChannel: vscode.OutputChannel;
-  private startPromise: Promise<number> | null = null;
-
-  constructor(outputChannel: vscode.OutputChannel) {
-    this.outputChannel = outputChannel;
-  }
-
-  /** Returns the port of the running server, or null if not started. */
-  getPort(): number | null {
-    return this.port;
-  }
-
-  /** Returns the base URL of the running server. */
-  getBaseUrl(): string | null {
-    if (this.port === null) return null;
-    return `http://127.0.0.1:${this.port}`;
-  }
-
-  /** True if the server process is running. */
-  isRunning(): boolean {
-    return this.process !== null && this.process.exitCode === null;
-  }
-
-  /**
-   * Ensures the server is running and the given file is loaded.
-   * If the server is not started, spawns it with the file.
-   * If already running, attaches the file via the HTTP API.
-   * Returns the port number.
-   */
-  async ensureRunning(
-    filePath: string,
-    readitDistDir: string,
-  ): Promise<number> {
-    if (this.startPromise) {
-      const port = await this.startPromise;
-      await this.attachFile(filePath);
-      return port;
-    }
-
-    if (this.isRunning() && this.port !== null) {
-      await this.attachFile(filePath);
-      return this.port;
-    }
-
-    return this.start(filePath, readitDistDir);
-  }
-
-  /**
-   * Starts the Bun server process.
-   * Resolves with the port once the server is healthy.
-   */
-  private start(filePath: string, readitDistDir: string): Promise<number> {
-    this.startPromise = this.doStart(filePath, readitDistDir);
-    return this.startPromise;
-  }
-
-  private async doStart(
-    filePath: string,
-    readitDistDir: string,
-  ): Promise<number> {
-    const config = vscode.workspace.getConfiguration("readit");
-    const bunPath = config.get<string>("bunPath", "bun");
-    const configPort = config.get<number>("serverPort", 0);
-
-    const port = configPort > 0 ? configPort : await findFreePort();
-
-    const cliEntry = vscode.Uri.joinPath(
-      vscode.Uri.file(readitDistDir),
-      "index.js",
-    ).fsPath;
-
-    const args = [cliEntry, filePath, "--no-open", "--port", String(port)];
-
-    this.outputChannel.appendLine(
-      `Starting readit server: ${bunPath} ${args.join(" ")}`,
-    );
-
-    return new Promise<number>((resolve, reject) => {
-      const child = spawn(bunPath, args, {
-        stdio: ["ignore", "pipe", "pipe"],
-        env: {
-          ...process.env,
-          NODE_ENV: "production",
-        },
-      });
-
-      this.process = child;
-      let settled = false;
-      let timer: NodeJS.Timeout | undefined;
-
-      const rejectStartup = (message: string) => {
-        if (settled) return;
-        settled = true;
-        if (timer) {
-          clearInterval(timer);
-        }
-        this.cleanup(child);
-        reject(new Error(message));
-      };
-
-      child.stdout?.on("data", (data: Buffer) => {
-        this.outputChannel.appendLine(data.toString().trimEnd());
-      });
-
-      child.stderr?.on("data", (data: Buffer) => {
-        this.outputChannel.appendLine(`[stderr] ${data.toString().trimEnd()}`);
-      });
-
-      child.on("error", (err) => {
-        this.outputChannel.appendLine(`Server process error: ${err.message}`);
-        rejectStartup(
-          `Failed to start readit server. Is Bun installed? (${err.message})`,
-        );
-      });
-
-      const handleProcessExit = (
-        code: number | null,
-        signal: NodeJS.Signals | null,
-      ) => {
-        this.outputChannel.appendLine(
-          `Server process exited with code ${code}${signal ? ` (signal: ${signal})` : ""}`,
-        );
-        if (!settled) {
-          rejectStartup(
-            `readit server exited before it became ready (${code === null ? (signal ?? "unknown") : `code ${code}`})`,
-          );
-          return;
-        }
-        this.cleanup(child);
-      };
-
-      child.on("exit", handleProcessExit);
-
-      // Poll for server readiness
-      const maxWaitMs = 15_000;
-      const intervalMs = 200;
-      const startTime = Date.now();
-
-      timer = setInterval(async () => {
-        if (Date.now() - startTime > maxWaitMs) {
-          clearInterval(timer);
-          child.kill("SIGTERM");
-          rejectStartup("readit server failed to start within 15 seconds");
-          return;
-        }
-
-        try {
-          const res = await fetch(`http://127.0.0.1:${port}/api/health`);
-          if (res.ok) {
-            clearInterval(timer);
-            settled = true;
-            this.port = port;
-            this.outputChannel.appendLine(`Server ready on port ${port}`);
-            resolve(port);
-          }
-        } catch {
-          // Not ready yet, keep polling
-        }
-      }, intervalMs);
-    });
-  }
-
-  /**
-   * Attaches a file to the running server via POST /api/documents.
-   */
-  private async attachFile(filePath: string): Promise<void> {
-    if (this.port === null) return;
-
-    try {
-      const res = await fetch(`http://127.0.0.1:${this.port}/api/documents`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ path: filePath }),
-      });
-
-      if (!res.ok) {
-        const raw = await res.text();
-        let errorMessage = res.statusText;
-        if (raw) {
-          try {
-            const data = JSON.parse(raw) as { error?: string };
-            errorMessage = data.error ?? raw;
-          } catch {
-            errorMessage = raw;
-          }
-        }
-        this.outputChannel.appendLine(
-          `Failed to attach file ${filePath}: ${errorMessage}`,
-        );
-      } else {
-        const data = (await res.json()) as {
-          status?: string;
-          fileName?: string;
-        };
-        this.outputChannel.appendLine(
-          `File ${data.fileName ?? filePath}: ${data.status ?? "attached"}`,
-        );
-      }
-    } catch (err) {
-      this.outputChannel.appendLine(
-        `Error attaching file: ${err instanceof Error ? err.message : String(err)}`,
-      );
-    }
-  }
-
-  /** Stops the server process. */
-  stop(): void {
-    const child = this.process;
-    if (child) {
-      this.outputChannel.appendLine("Stopping readit server...");
-      child.kill("SIGTERM");
-      let hasExited = false;
-
-      // Force kill after 3 seconds
-      const forceKillTimer = setTimeout(() => {
-        if (!hasExited && child.exitCode === null) {
-          child.kill("SIGKILL");
-        }
-      }, 3_000);
-
-      child.once("exit", () => {
-        hasExited = true;
-        clearTimeout(forceKillTimer);
-      });
-    }
-    this.cleanup();
-  }
-
-  private cleanup(child?: ChildProcess): void {
-    if (child && this.process !== child) {
-      return;
-    }
-    this.process = null;
-    this.port = null;
-    this.startPromise = null;
-  }
-
-  dispose(): void {
-    this.stop();
-  }
-}
-
-/** Finds a free TCP port by binding to port 0 and reading the assigned port. */
-function findFreePort(): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const server = net.createServer();
-    server.listen(0, "127.0.0.1", () => {
-      const addr = server.address();
-      if (addr && typeof addr === "object") {
-        const port = addr.port;
-        server.close(() => resolve(port));
-      } else {
-        server.close(() => reject(new Error("Could not determine free port")));
-      }
-    });
-    server.on("error", reject);
-  });
-}

package/vscode-readit/src/webview-provider.ts

@@ -1,204 +0,0 @@
-import * as path from "node:path";
-import * as vscode from "vscode";
-import type { ServerManager } from "./server-manager";
-
-/**
- * Manages readit webview panels.
- *
- * Each panel contains an iframe pointing at the readit server on 127.0.0.1.
- * This preserves the full interactive experience: SSE live-reload, comment
- * CRUD, keyboard shortcuts, and all Svelte reactivity — without duplicating
- * any rendering logic.
- */
-export class ReaditWebviewProvider implements vscode.Disposable {
-  private panels = new Map<string, vscode.WebviewPanel>();
-  private disposables: vscode.Disposable[] = [];
-
-  constructor(
-    private readonly extensionUri: vscode.Uri,
-    private readonly serverManager: ServerManager,
-    private readonly outputChannel: vscode.OutputChannel,
-  ) {}
-
-  /**
-   * Opens (or reveals) a readit preview panel for the given file.
-   * @param filePath Absolute path to the markdown file.
-   * @param readitDistDir Absolute path to the readit dist/ directory.
-   * @param column Which editor column to open the panel in.
-   */
-  async openPreview(
-    filePath: string,
-    readitDistDir: string,
-    column: vscode.ViewColumn = vscode.ViewColumn.Active,
-  ): Promise<void> {
-    // If a panel for this file already exists, reveal it
-    const existing = this.panels.get(filePath);
-    if (existing) {
-      existing.reveal(column);
-      return;
-    }
-
-    // Ensure the server is running with this file loaded
-    let port: number;
-    try {
-      port = await this.serverManager.ensureRunning(filePath, readitDistDir);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      vscode.window.showErrorMessage(`readit: ${message}`);
-      return;
-    }
-
-    const fileName = path.basename(filePath);
-
-    const panel = vscode.window.createWebviewPanel(
-      "readitPreview",
-      `readit: ${fileName}`,
-      column,
-      {
-        enableScripts: true,
-        retainContextWhenHidden: true,
-        localResourceRoots: [this.extensionUri],
-        // Allow the webview to access the local readit server
-        portMapping: [
-          {
-            webviewPort: port,
-            extensionHostPort: port,
-          },
-        ],
-      },
-    );
-
-    panel.iconPath = vscode.Uri.joinPath(this.extensionUri, "icon.svg");
-    panel.webview.html = this.getWebviewContent(port, filePath, panel.webview);
-
-    this.panels.set(filePath, panel);
-
-    // Clean up when the panel is closed
-    panel.onDidDispose(
-      () => {
-        this.panels.delete(filePath);
-        // If no panels remain, stop the server
-        if (this.panels.size === 0) {
-          this.outputChannel.appendLine("Last panel closed, stopping server.");
-          this.serverManager.stop();
-        }
-      },
-      null,
-      this.disposables,
-    );
-  }
-
-  /**
-   * Generates the HTML content for the webview.
-   * Uses an iframe pointing at the local readit server so the full Svelte app
-   * runs unmodified — SSE, comments, settings, and all.
-   */
-  private getWebviewContent(
-    port: number,
-    _filePath: string,
-    webview: vscode.Webview,
-  ): string {
-    const serverUrl = `http://127.0.0.1:${port}`;
-    const nonce = getNonce();
-
-    // The CSP allows framing the local readit server and running inline scripts
-    // with a nonce. The iframe approach means all readit functionality works
-    // without any modification to the Svelte frontend.
-    const csp = [
-      `default-src 'none'`,
-      `frame-src http://127.0.0.1:${port}`,
-      `style-src 'unsafe-inline'`,
-      `script-src 'nonce-${nonce}'`,
-    ].join("; ");
-
-    // Use the VS Code webview API to properly resolve the resource
-    void webview;
-
-    return /* html */ `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <meta http-equiv="Content-Security-Policy" content="${csp}" />
-  <title>readit</title>
-  <style>
-    html, body {
-      margin: 0;
-      padding: 0;
-      width: 100%;
-      height: 100%;
-      overflow: hidden;
-      background: var(--vscode-editor-background, #1e1e1e);
-    }
-    iframe {
-      border: none;
-      width: 100%;
-      height: 100%;
-    }
-    .loading {
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      width: 100%;
-      height: 100%;
-      color: var(--vscode-foreground, #ccc);
-      font-family: var(--vscode-font-family, sans-serif);
-      font-size: 14px;
-    }
-    .loading.hidden {
-      display: none;
-    }
-  </style>
-</head>
-<body>
-  <div id="loading" class="loading">Starting readit server...</div>
-  <iframe
-    id="readit-frame"
-    src="${serverUrl}"
-    sandbox="allow-scripts allow-same-origin allow-forms allow-popups"
-    style="display: none;"
-  ></iframe>
-  <script nonce="${nonce}">
-    const iframe = document.getElementById('readit-frame');
-    const loading = document.getElementById('loading');
-    iframe.addEventListener('load', () => {
-      loading.classList.add('hidden');
-      iframe.style.display = 'block';
-    });
-    // Show iframe after a max timeout even if load event doesn't fire
-    setTimeout(() => {
-      loading.classList.add('hidden');
-      iframe.style.display = 'block';
-    }, 10000);
-  </script>
-</body>
-</html>`;
-  }
-
-  /** Closes all open panels. */
-  closeAll(): void {
-    for (const panel of this.panels.values()) {
-      panel.dispose();
-    }
-    this.panels.clear();
-  }
-
-  dispose(): void {
-    this.closeAll();
-    for (const d of this.disposables) {
-      d.dispose();
-    }
-    this.disposables = [];
-  }
-}
-
-/** Generate a random nonce for CSP inline script tags. */
-function getNonce(): string {
-  const chars =
-    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  let result = "";
-  for (let i = 0; i < 32; i++) {
-    result += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return result;
-}

package/vscode-readit/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022"],
-    "types": ["node"],
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "rootDir": "src",
-    "noUnusedLocals": true,
-    "noUnusedParameters": true
-  },
-  "include": ["src"],
-  "exclude": ["node_modules", "dist"]
-}