@supatype/cli 0.1.1 → 0.1.3

package/src/commands/cache.ts

@@ -1,24 +1,30 @@
 /**
- * supatype cache — list and clean cached component binaries.
+ * supatype cache — list and clean cached component binaries + REST Valkey cache.
  */
 
 import type { Command } from "commander"
 import { existsSync, readdirSync, rmSync, statSync } from "node:fs"
 import { join } from "node:path"
 import { cacheRoot, type Component } from "../binary-cache.js"
-import { info, plain } from "../ui/messages.js"
+import {
+  deleteRestCacheEntry,
+  flushRestCache,
+  getRestCacheEntry,
+  listRestCacheEntries,
+} from "../rest-cache-admin.js"
+import { error, info, plain } from "../ui/messages.js"
 
 const COMPONENTS: Component[] = ["engine", "server", "postgres", "deno"]
 
 export function registerCache(program: Command): void {
   const cache = program
     .command("cache")
-    .description("Manage cached component binaries")
+    .description("Manage cached component binaries and REST API response cache")
 
   cache
     .command("list")
     .description("List cached component binaries and their sizes")
-    .action(() => {
+    .action(async () => {
       const root = cacheRoot()
       if (!existsSync(root)) {
         info("Cache is empty.")
@@ -62,7 +68,7 @@ export function registerCache(program: Command): void {
         "  supatype cache clean engine    # remove all engine versions\n" +
         "  supatype cache clean engine 0.4.2",
     )
-    .action((component?: string, version?: string) => {
+    .action(async (component?: string, version?: string) => {
       const root = cacheRoot()
       if (!existsSync(root)) {
         info("Cache is already empty.")
@@ -91,6 +97,100 @@ export function registerCache(program: Command): void {
 
       info("Done.")
     })
+
+  const rest = cache
+    .command("rest")
+    .description("Manage REST API response cache in Valkey")
+
+  rest
+    .command("list")
+    .description("List cached REST GET entries")
+    .option("--table <name>", "Filter by table name")
+    .option("--json", "Output JSON")
+    .action(async (opts: { table?: string; json?: boolean }) => {
+      const cwd = process.cwd()
+      try {
+        const result = await listRestCacheEntries(cwd, { table: opts.table, limit: 100 })
+        if (opts.json) {
+          plain(JSON.stringify(result, null, 2))
+          return
+        }
+        if (result.entries.length === 0) {
+          info("No REST cache entries.")
+          return
+        }
+        for (const e of result.entries) {
+          plain(
+            `  ${e.table ?? "?"}  ${e.scope ?? "?"}  ttl=${e.ttl_seconds}s  ${e.size_bytes}B  ${e.key}`,
+          )
+        }
+        if (result.cursor !== "0") {
+          plain(`\n(more available — cursor ${result.cursor})`)
+        }
+      } catch (e) {
+        error(e instanceof Error ? e.message : String(e))
+        process.exitCode = 1
+      }
+    })
+
+  rest
+    .command("get <key>")
+    .description("Show one cache entry (full Valkey key)")
+    .option("--json", "Output JSON")
+    .action(async (key: string, opts: { json?: boolean }) => {
+      const cwd = process.cwd()
+      try {
+        const detail = await getRestCacheEntry(cwd, key)
+        if (opts.json) {
+          plain(JSON.stringify(detail, null, 2))
+          return
+        }
+        plain(`key:     ${detail.key}`)
+        plain(`table:   ${detail.table ?? ""}`)
+        plain(`scope:   ${detail.scope ?? ""}`)
+        plain(`ttl:     ${detail.ttl_seconds}s`)
+        plain(`status:  ${detail.status_code}`)
+        if (detail.body_preview) plain(`body:\n${detail.body_preview}`)
+      } catch (e) {
+        error(e instanceof Error ? e.message : String(e))
+        process.exitCode = 1
+      }
+    })
+
+  rest
+    .command("delete <key>")
+    .description("Delete one cache entry")
+    .action(async (key: string) => {
+      const cwd = process.cwd()
+      try {
+        await deleteRestCacheEntry(cwd, key)
+        info(`Deleted ${key}`)
+      } catch (e) {
+        error(e instanceof Error ? e.message : String(e))
+        process.exitCode = 1
+      }
+    })
+
+  rest
+    .command("flush")
+    .description("Flush REST cache entries")
+    .option("--table <name>", "Only flush one table")
+    .option("--yes", "Confirm flush")
+    .action(async (opts: { table?: string; yes?: boolean }) => {
+      if (!opts.yes) {
+        error("Pass --yes to confirm flush")
+        process.exitCode = 1
+        return
+      }
+      const cwd = process.cwd()
+      try {
+        await flushRestCache(cwd, opts.table)
+        info(opts.table ? `Flushed cache for table ${opts.table}` : "Flushed all REST cache entries")
+      } catch (e) {
+        error(e instanceof Error ? e.message : String(e))
+        process.exitCode = 1
+      }
+    })
 }
 
 function dirSize(dir: string): number {

package/src/commands/dev.ts

@@ -36,13 +36,15 @@ import {
 import { ensureBinary } from "../ensure-binary.js"
 import { startProxyDevApp } from "../app/proxy-dev-app.js"
 import { ProcessManager } from "../process-manager.js"
-import { startStudioViteDevServer } from "../studio-dev-server.js"
+import { STUDIO_DEV_PORT, startStudioViteDevServer } from "../studio-dev-server.js"
 import { restoreSystemRelationTargets } from "../restore-system-relation-targets.js"
 import { localStorageEnv } from "../local-storage.js"
 import { beginDevSession, endDevSession, resolveDevUiMode, startDevSession } from "../dev-session.js"
+import { publishDevReady } from "../dev-ready-panel.js"
 import { probeDockerDaemon, reportDockerUnavailable } from "../docker-runtime.js"
 import { fatalError } from "../ui/fatal.js"
 import { registerDevShutdown } from "../dev-shutdown.js"
+import { ensureValkeySidecar, stopValkeySidecar } from "../valkey-sidecar.js"
 import {
   initdb,
   start as pgStart,
@@ -133,7 +135,6 @@ export function registerDev(program: Command): void {
       }
 
       beginDevSession(resolveDevUiMode(opts.stream === true))
-      startDevSession()
       if (hasMeaningfulOverrides(config)) {
         console.warn("[supatype] Local binary overrides active:")
         for (const line of describeActiveOverrides(config)) {
@@ -326,9 +327,13 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO authenticate
               ? "ses"
               : "smtp"
 
+      const valkeySidecar = ensureValkeySidecar(projectName)
+
       const serverEnv: Record<string, string> = {
         // supatype-server outer layer
         SUPATYPE_MODE: config.server.mode ?? "dev",
+        ...(valkeySidecar.addr ? { SUPATYPE_VALKEY_ADDR: valkeySidecar.addr } : {}),
+        SUPATYPE_MANAGED_PROJECT_REF: projectName,
         SUPATYPE_MANIFEST_PATH: manifestPath,
         SUPATYPE_ADMIN_CONFIG_PATH: adminConfigPath,
         SUPATYPE_POSTGREST_URL: `http://127.0.0.1:${postgrestPort}`,
@@ -471,7 +476,7 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO authenticate
       }
 
       // ── 9d. Studio (optional) ─────────────────────────────────────────────
-      const studioPort = 3002
+      const studioPort = STUDIO_DEV_PORT
       let studioProc: ProcessManager | null = null
 
       const studioOverride = config.overrides?.studio
@@ -489,25 +494,24 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO authenticate
 
       const appProc = startProxyDevApp(cwd, config, pidDir)
 
-      // ── Print status ──────────────────────────────────────────────────────
-      console.log(`
-[supatype] Services running:
-  Postgres         ${dbURL}
-  supatype-server  http://localhost:${serverPort}
-    REST API       http://localhost:${serverPort}/rest/v1/
-    Auth           http://localhost:${serverPort}/auth/v1/
-    Storage        http://localhost:${serverPort}/storage/v1/
-    Realtime       ws://localhost:${serverPort}/realtime/v1/${studioProc ? `\n  Studio           http://localhost:${studioPort}` : ""}
-
-  API keys (local dev only):
-    anon key       ${anonKey}
-    service_role   ${serviceRoleKey}
-
-  JWT secret: ${LOCAL_JWT_SECRET}
-
-  Press Ctrl+C to stop.
-`)
+      const links = [
+        { label: "API", url: `http://localhost:${serverPort}` },
+        { label: "REST", url: `http://localhost:${serverPort}/rest/v1/` },
+        { label: "Auth", url: `http://localhost:${serverPort}/auth/v1/` },
+        { label: "Storage", url: `http://localhost:${serverPort}/storage/v1/` },
+        { label: "Realtime", url: `ws://localhost:${serverPort}/realtime/v1/` },
+      ]
+      if (studioProc) {
+        links.push({ label: "Studio", url: `http://localhost:${studioPort}` })
+      }
 
+      publishDevReady({
+        title: "Services running",
+        links,
+        anonKey,
+        serviceRoleKey,
+        hints: [`Postgres ${dbURL}`, `JWT secret: ${LOCAL_JWT_SECRET}`],
+      })
 
       // ── Shutdown handler ──────────────────────────────────────────────────
       registerDevShutdown(async () => {
@@ -518,6 +522,7 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO authenticate
           studioProc?.stop(),
           appProc?.stop(),
         ])
+        stopValkeySidecar(valkeySidecar.containerName)
         await stopPostgres()
       })