@knotpad/app 0.1.5 → 0.1.7

package/public/sw.js

@@ -0,0 +1,137 @@
+// Brief service worker — offline read layer for the cloud-deployed PWA.
+//
+// Strategy (online behavior is unchanged — network is always tried first for
+// app content, so this only adds offline fallbacks):
+//   • Navigations (HTML documents): network-first → cache the result → on
+//     failure serve the exact cached page, else a cached shell route, else the
+//     offline fallback. Fixes dynamic routes (e.g. /notes/<id>) 404-ing offline.
+//   • RSC payloads (client-side navigations): network-first → cache → fallback.
+//   • Immutable build assets (/_next/static): cache-first (safe, content-hashed).
+//   • API GET reads: stale-while-revalidate so previously-loaded data shows
+//     offline. Non-GET (writes) are passed straight through — they will fail
+//     offline until the IndexedDB outbox lands (offline-writes phase).
+//
+// NOTE: cached pages/API responses are user-specific. This is fine for a
+// single-user installed PWA; on signout the app posts {type:"brief-purge"} to
+// wipe caches (handled below).
+
+const CACHE = "brief-shell-v3";
+const SHELL_URLS = ["/", "/notes", "/list", "/kanban", "/graph", "/calendar"];
+const OFFLINE_FALLBACK = "/notes";
+
+self.addEventListener("install", (e) => {
+  e.waitUntil(
+    caches.open(CACHE).then((cache) => cache.addAll(SHELL_URLS).catch(() => {}))
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    caches
+      .keys()
+      .then((keys) =>
+        Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k)))
+      )
+      .then(() => self.clients.claim())
+  );
+});
+
+// Allow the page to wipe caches on signout.
+self.addEventListener("message", (e) => {
+  if (e.data && e.data.type === "brief-purge") {
+    e.waitUntil(caches.keys().then((keys) => Promise.all(keys.map((k) => caches.delete(k)))));
+  }
+});
+
+function isRscRequest(request, url) {
+  return request.headers.get("RSC") === "1" || url.searchParams.has("_rsc");
+}
+
+async function networkFirst(request, { fallbackToShell } = {}) {
+  const cache = await caches.open(CACHE);
+  try {
+    const res = await fetch(request);
+    if (res && res.ok) cache.put(request, res.clone());
+    return res;
+  } catch {
+    const cached = await cache.match(request);
+    if (cached) return cached;
+    if (fallbackToShell) {
+      const shell = (await cache.match(OFFLINE_FALLBACK)) || (await cache.match("/"));
+      if (shell) return shell;
+    }
+    return new Response("Offline", { status: 503, statusText: "Offline" });
+  }
+}
+
+async function staleWhileRevalidate(request) {
+  const cache = await caches.open(CACHE);
+  const cached = await cache.match(request);
+  const network = fetch(request)
+    .then((res) => {
+      if (res && res.ok) cache.put(request, res.clone());
+      return res;
+    })
+    .catch(() => null);
+  if (cached) {
+    void network; // fire-and-forget revalidation
+    return cached;
+  }
+  const res = await network;
+  if (res) return res;
+  return new Response(JSON.stringify({ error: "offline" }), {
+    status: 503,
+    headers: { "Content-Type": "application/json" },
+  });
+}
+
+async function cacheFirst(request) {
+  const cache = await caches.open(CACHE);
+  const cached = await cache.match(request);
+  if (cached) return cached;
+  try {
+    const res = await fetch(request);
+    if (res && res.ok) cache.put(request, res.clone());
+    return res;
+  } catch {
+    return new Response("Offline", { status: 503 });
+  }
+}
+
+self.addEventListener("fetch", (e) => {
+  const { request } = e;
+  if (request.method !== "GET") return; // writes pass through (outbox handles offline later)
+
+  const url = new URL(request.url);
+  if (url.origin !== self.location.origin) return; // only same-origin
+
+  // Immutable, content-hashed build output → cache-first.
+  if (url.pathname.startsWith("/_next/static/")) {
+    e.respondWith(cacheFirst(request));
+    return;
+  }
+
+  // API reads → stale-while-revalidate so data is available offline.
+  // Write-like API routes (POST/PATCH/DELETE) already pass through above.
+  // Skip SWR for routes that trigger side-effects on read (e.g. sync endpoints).
+  if (url.pathname.startsWith("/api/") && !url.pathname.includes("/sync")) {
+    e.respondWith(staleWhileRevalidate(request));
+    return;
+  }
+
+  // Client-navigation RSC payloads → network-first with cache fallback.
+  if (isRscRequest(request, url)) {
+    e.respondWith(networkFirst(request));
+    return;
+  }
+
+  // Full-page navigations → network-first, fall back to cached page/shell.
+  if (request.mode === "navigate") {
+    e.respondWith(networkFirst(request, { fallbackToShell: true }));
+    return;
+  }
+
+  // Everything else same-origin → network-first with cache fallback.
+  e.respondWith(networkFirst(request));
+});

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 1155 1000"><path fill="#fff" d="m577.3 0 577.4 1000H0z"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><path fill="#666" fill-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" clip-rule="evenodd"/></svg>

package/tsconfig.json

@@ -0,0 +1,35 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts",
+    "electron/**/*"
+  ],
+  "exclude": ["node_modules"]
+}

package/brief.js

@@ -1,311 +0,0 @@
-#!/usr/bin/env node
-/**
- * Knotpad CLI — npx @knotpad/app
- *
- * Sets up and starts a local Knotpad instance in under 60 seconds.
- * Requires: Node 18+ only. No external database needed.
- *
- * What it does:
- *  1. Checks Node version
- *  2. Downloads/clones the Knotpad source code if not present
- *  3. Finds or creates a .env file in the current directory
- *  4. Generates NEXTAUTH_SECRET / MCP_SECRET if not present
- *  5. Starts the Next.js server on port 3099
- *     → PGlite (embedded local DB) bootstraps automatically at startup
- *       via instrumentation.tsx → lib/prisma.ts + lib/db-init.ts
- *  6. Opens an app-mode window (Chrome/Edge — no address bar) or falls back to browser
- */
-
-"use strict";
-
-const { execSync, spawn } = require("child_process");
-const fs   = require("fs");
-const path = require("path");
-const { randomBytes } = require("crypto");
-const https = require("https");
-
-// ── Helpers ────────────────────────────────────────────────────────────────────
-
-function log(msg)  { process.stdout.write(`\x1b[36m[knotpad]\x1b[0m ${msg}\n`); }
-function ok(msg)   { process.stdout.write(`\x1b[32m[knotpad]\x1b[0m ${msg}\n`); }
-function die(msg)  { process.stderr.write(`\x1b[31m[knotpad]\x1b[0m ${msg}\n`); process.exit(1); }
-
-function genSecret(bytes = 32) {
-  return randomBytes(bytes).toString("base64url");
-}
-
-function openBrowser(url) {
-  const cmd =
-    process.platform === "win32"  ? `start "" "${url}"` :
-    process.platform === "darwin" ? `open "${url}"` :
-    `xdg-open "${url}"`;
-  try { execSync(cmd, { stdio: "ignore" }); } catch {}
-}
-
-// ── Download source code ──────────────────────────────────────────────────────────
-
-async function downloadSource() {
-  const INSTALL_DIR = path.join(WORK_DIR, ".brief", "app");
-  
-  if (fs.existsSync(INSTALL_DIR)) {
-    log("Knotpad source already installed");
-    return INSTALL_DIR;
-  }
-
-  log("Downloading Knotpad source (this may take a minute)…");
-  fs.mkdirSync(path.dirname(INSTALL_DIR), { recursive: true });
-
-  try {
-    // Try git clone first (faster and more reliable)
-    execSync(`git clone --depth 1 https://github.com/thillagen/brief.git "${INSTALL_DIR}"`, { 
-      stdio: "inherit",
-      cwd: path.dirname(INSTALL_DIR)
-    });
-    ok("Source downloaded via git");
-    return INSTALL_DIR;
-  } catch (e) {
-    // Fallback: download zip from GitHub
-    log("Git not available, downloading zip…");
-    const zipPath = path.join(path.dirname(INSTALL_DIR), "brief.zip");
-    
-    await new Promise((resolve, reject) => {
-      const file = fs.createWriteStream(zipPath);
-      https.get("https://github.com/thillagen/brief/archive/refs/heads/main.zip", (response) => {
-        response.pipe(file);
-        file.on("finish", () => {
-          file.close();
-          log("Extracting…");
-          try {
-            if (process.platform === "win32") {
-              execSync(`powershell -Command "Expand-Archive -Path '${zipPath}' -DestinationPath '${path.dirname(INSTALL_DIR)}' -Force"`, { stdio: "inherit" });
-            } else {
-              execSync(`unzip -q "${zipPath}" -d "${path.dirname(INSTALL_DIR)}"`, { stdio: "inherit" });
-            }
-            fs.unlinkSync(zipPath);
-            // Move the extracted folder to the expected location
-            const extractedDir = path.join(path.dirname(INSTALL_DIR), "brief-main");
-            if (fs.existsSync(extractedDir)) {
-              fs.renameSync(extractedDir, INSTALL_DIR);
-            }
-            ok("Source downloaded and extracted");
-            resolve();
-          } catch (err) {
-            reject(err);
-          }
-        });
-      }).on("error", (err) => {
-        if (fs.existsSync(zipPath)) fs.unlinkSync(zipPath);
-        reject(err);
-      });
-    });
-    
-    return INSTALL_DIR;
-  }
-}
-
-// ── Chrome / Edge app-mode detection ──────────────────────────────────────────
-
-/**
- * Find a Chrome or Edge binary on the system. Returns { bin, name } or null.
- */
-function findChromeOrEdge() {
-  const platform = process.platform;
-
-  if (platform === "win32") {
-    const pf   = process.env.ProgramFiles         || "";
-    const pfx  = process.env["ProgramFiles(x86)"] || "";
-    const local = process.env.LOCALAPPDATA        || "";
-    const candidates = [
-      { bin: path.join(pf,    "Google", "Chrome", "Application", "chrome.exe"), name: "chrome" },
-      { bin: path.join(pfx,   "Google", "Chrome", "Application", "chrome.exe"), name: "chrome" },
-      { bin: path.join(local, "Google", "Chrome", "Application", "chrome.exe"), name: "chrome" },
-      { bin: path.join(pf,    "Microsoft", "Edge", "Application", "msedge.exe"), name: "edge" },
-      { bin: path.join(pfx,   "Microsoft", "Edge", "Application", "msedge.exe"), name: "edge" },
-    ];
-    for (const c of candidates) {
-      if (c.bin && fs.existsSync(c.bin)) return c;
-    }
-    return null;
-  }
-
-  if (platform === "darwin") {
-    const candidates = [
-      { bin: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", name: "chrome" },
-      { bin: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge", name: "edge" },
-    ];
-    for (const c of candidates) {
-      if (fs.existsSync(c.bin)) return c;
-    }
-    return null;
-  }
-
-  // Linux / other unix-like
-  const bins = [
-    { bin: "google-chrome",  name: "chrome" },
-    { bin: "chromium",       name: "chrome" },
-    { bin: "microsoft-edge", name: "edge" },
-  ];
-  for (const c of bins) {
-    try {
-      execSync(`which ${c.bin}`, { stdio: "ignore" });
-      return { bin: c.bin, name: c.name };
-    } catch {}
-  }
-  return null;
-}
-
-/**
- * Open the app URL in a Chrome/Edge app-mode window (no address bar, no tabs).
- * Falls back to the regular browser if no Chrome/Edge is found.
- */
-function openAppWindow(url) {
-  const browser = findChromeOrEdge();
-  if (!browser) {
-    log("No Chrome/Edge found — falling back to default browser");
-    return openBrowser(url);
-  }
-
-  try {
-    const profileDir = path.join(WORK_DIR, ".brief", "chrome-profile");
-    fs.mkdirSync(profileDir, { recursive: true });
-
-    const args = [
-      `--app=${url}`,
-      `--user-data-dir=${profileDir}`,
-      "--window-size=1400,900",
-      "--no-first-run",
-      "--no-default-browser-check",
-    ];
-
-    log(`Launching ${browser.name} app-mode window…`);
-    const child = spawn(browser.bin, args, {
-      detached: true,
-      stdio: "ignore",
-    });
-    child.unref();
-  } catch {
-    log("Failed to launch app-mode window — falling back to default browser");
-    openBrowser(url);
-  }
-}
-
-// ── 1. Node version ────────────────────────────────────────────────────────────
-
-const [major] = process.versions.node.split(".").map(Number);
-if (major < 18) die(`Node 18+ required (you have ${process.versions.node}). Install from https://nodejs.org`);
-
-// ── 2. Download source ───────────────────────────────────────────────────────────
-
-const WORK_DIR = process.cwd();
-let PKG_DIR;
-
-async function main() {
-  PKG_DIR = await downloadSource();
-
-  // ── 3. Install dependencies ─────────────────────────────────────────────────────
-
-  const NODE_MODULES = path.join(PKG_DIR, "node_modules");
-  if (!fs.existsSync(NODE_MODULES)) {
-    log("Installing dependencies (this may take a minute)…");
-    try {
-      execSync("npm install", { cwd: PKG_DIR, stdio: "inherit" });
-      ok("Dependencies installed");
-    } catch (e) {
-      die("Failed to install dependencies. Please run manually: cd .brief/app && npm install");
-    }
-  }
-
-  // ── 4. .env setup ──────────────────────────────────────────────────────────────
-
-  const ENV_PATH = path.join(WORK_DIR, ".env");
-
-  let env = {};
-  if (fs.existsSync(ENV_PATH)) {
-    const raw = fs.readFileSync(ENV_PATH, "utf8");
-    for (const line of raw.split(/\r?\n/)) {
-      const m = /^([A-Z_][A-Z0-9_]*)=(.*)$/.exec(line.trim());
-      if (m) env[m[1]] = m[2].replace(/^["']|["']$/g, "");
-    }
-    log(".env found, loading existing config");
-  } else {
-    log("Creating .env with defaults…");
-  }
-
-  // Fill defaults — no DATABASE_URL needed; PGlite handles local storage automatically
-  // Port 3099 avoids clashing with dev servers (3000) commonly running alongside.
-  const defaults = {
-    NEXTAUTH_SECRET:     genSecret(),
-    NEXTAUTH_URL:        "http://localhost:3099",
-    MCP_SECRET:          genSecret(),
-    ENCRYPTION_PEPPER:   genSecret(),
-    NEXT_PUBLIC_APP_URL: "http://localhost:3099",
-    NEXT_PUBLIC_MCP_URL: "http://localhost:3099/mcp",
-    IS_CLOUD:            "false",
-    CRON_SECRET:         genSecret(16),
-  };
-
-  let changed = false;
-  for (const [k, v] of Object.entries(defaults)) {
-    if (!env[k]) { env[k] = v; changed = true; }
-  }
-
-  if (changed) {
-    const lines = Object.entries(env).map(([k, v]) => `${k}="${v}"`).join("\n");
-    fs.writeFileSync(ENV_PATH, lines + "\n", "utf8");
-    ok(".env written");
-  }
-
-  // Apply env for this process
-  for (const [k, v] of Object.entries(env)) {
-    process.env[k] = v;
-  }
-
-  // ── 5. Build (if not already built) ───────────────────────────────────────────
-
-  // BUILD_ID is only written after a successful build — a leftover .next/ from a
-  // failed build won't have it, so we correctly re-run in that case.
-  const BUILD_ID = path.join(PKG_DIR, ".next", "BUILD_ID");
-  if (!fs.existsSync(BUILD_ID)) {
-    log("Building Knotpad (first run — takes ~30 seconds)…");
-    try {
-      execSync("npx next build", { cwd: PKG_DIR, stdio: "inherit", env: process.env });
-      ok("Build complete");
-    } catch {
-      die("Build failed. Run `npx @knotpad/app` again after fixing any errors.");
-    }
-  }
-
-  // ── 6. Start server ────────────────────────────────────────────────────────────
-
-  // Pre-create PGlite data directory so the app can open it immediately at startup
-  fs.mkdirSync(path.join(WORK_DIR, ".brief", "db"), { recursive: true });
-
-  const PORT = parseInt(process.env.PORT ?? "3099", 10);
-  const URL  = `http://localhost:${PORT}`;
-
-  ok(`\nStarting Knotpad on ${URL}\n`);
-  process.stdout.write(`  ${"\x1b[2m"}Ctrl+C to stop${"\x1b[0m"}\n\n`);
-
-  const NEXT_BIN = path.join(PKG_DIR, "node_modules", "next", "dist", "bin", "next");
-  const server = spawn(process.execPath, [NEXT_BIN, "start", "--port", String(PORT)], {
-    cwd: PKG_DIR,
-    stdio: "inherit",
-    env: process.env,
-  });
-
-  server.on("error", (e) => die(`Failed to start server: ${e.message}`));
-  server.on("exit", (code) => {
-    if (code !== 0 && code !== null) die(`Server exited with code ${code}`);
-  });
-
-  // Open in app-mode Chrome/Edge window (falls back to browser if not found)
-  setTimeout(() => openAppWindow(URL), 1500);
-
-  // Graceful exit
-  process.on("SIGINT",  () => { server.kill("SIGINT");  process.exit(0); });
-  process.on("SIGTERM", () => { server.kill("SIGTERM"); process.exit(0); });
-}
-
-main().catch((err) => {
-  die(`Error: ${err.message}`);
-});