lopata 0.10.2 → 0.11.0

package/dist/dashboard/{chunk-jpd3vqkt.js → chunk-5h0jr7cs.js}

@@ -7196,6 +7196,180 @@ function HomeView() {
   }, undefined, true, undefined, this);
 }
 
+// src/dashboard/views/hosts.tsx
+var STATUS_COLORS = {
+  ok: "bg-emerald-500/15 text-emerald-500",
+  missing: "bg-red-500/15 text-red-500",
+  wrong_address: "bg-red-500/15 text-red-500",
+  wildcard: "bg-yellow-500/15 text-yellow-500"
+};
+var STATUS_LABELS = {
+  ok: "ok",
+  missing: "missing",
+  wrong_address: "wrong address",
+  wildcard: "wildcard"
+};
+function CopyButton({ text, label }) {
+  const [copied, setCopied] = d2(false);
+  const timerRef = A2(null);
+  y2(() => {
+    return () => {
+      if (timerRef.current)
+        clearTimeout(timerRef.current);
+    };
+  }, []);
+  const handleCopy = () => {
+    navigator.clipboard.writeText(text).then(() => {
+      setCopied(true);
+      if (timerRef.current)
+        clearTimeout(timerRef.current);
+      timerRef.current = setTimeout(() => setCopied(false), 2000);
+    });
+  };
+  return /* @__PURE__ */ u3("button", {
+    onClick: handleCopy,
+    class: "inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-mono rounded-md border border-border bg-panel hover:bg-panel-hover text-text-secondary hover:text-ink transition-colors",
+    children: copied ? /* @__PURE__ */ u3(k, {
+      children: [
+        /* @__PURE__ */ u3("svg", {
+          class: "w-3.5 h-3.5 text-emerald-500",
+          viewBox: "0 0 16 16",
+          fill: "none",
+          stroke: "currentColor",
+          "stroke-width": "2",
+          children: /* @__PURE__ */ u3("path", {
+            d: "M3 8.5l3 3 7-7",
+            "stroke-linecap": "round",
+            "stroke-linejoin": "round"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this),
+        "Copied!"
+      ]
+    }, undefined, true, undefined, this) : /* @__PURE__ */ u3(k, {
+      children: [
+        /* @__PURE__ */ u3("svg", {
+          class: "w-3.5 h-3.5",
+          viewBox: "0 0 16 16",
+          fill: "none",
+          stroke: "currentColor",
+          "stroke-width": "1.5",
+          children: [
+            /* @__PURE__ */ u3("rect", {
+              x: "5",
+              y: "5",
+              width: "8",
+              height: "8",
+              rx: "1",
+              "stroke-linecap": "round",
+              "stroke-linejoin": "round"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ u3("path", {
+              d: "M11 5V3.5A1.5 1.5 0 009.5 2h-6A1.5 1.5 0 002 3.5v6A1.5 1.5 0 003.5 11H5",
+              "stroke-linecap": "round",
+              "stroke-linejoin": "round"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        label
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+function HostsView() {
+  const { data } = useQuery("hosts.check");
+  const results = data?.results ?? [];
+  const failing = results.filter((r3) => r3.status === "missing" || r3.status === "wrong_address");
+  const missingHostnames = [...new Set(failing.map((r3) => r3.hostname))];
+  const hostsLine = `127.0.0.1  ${missingHostnames.join(" ")}`;
+  const fixCommand = data?.hostsFilePath ? `sudo sh -c 'echo "${hostsLine}" >> ${data.hostsFilePath}'` : "";
+  return /* @__PURE__ */ u3("div", {
+    class: "p-4 sm:p-8",
+    children: [
+      /* @__PURE__ */ u3(PageHeader, {
+        title: "Hosts Check",
+        subtitle: data?.hostsFilePath ? `Reading ${data.hostsFilePath}` : "Checking host routing setup"
+      }, undefined, false, undefined, this),
+      data?.error ? /* @__PURE__ */ u3("div", {
+        class: "rounded-lg border border-red-500/30 bg-red-500/10 p-4 text-sm text-red-400",
+        children: data.error
+      }, undefined, false, undefined, this) : !results.length ? /* @__PURE__ */ u3(EmptyState, {
+        message: "No host routing configured. Add hosts to workers in lopata.config.ts."
+      }, undefined, false, undefined, this) : /* @__PURE__ */ u3(k, {
+        children: [
+          /* @__PURE__ */ u3(Table, {
+            headers: ["Hostname", "Worker", "Address", "Status"],
+            rows: results.map((r3) => [
+              /* @__PURE__ */ u3("span", {
+                class: "font-mono text-xs font-medium",
+                children: r3.hostname
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("span", {
+                class: "text-text-secondary",
+                children: r3.workerName
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("span", {
+                class: "font-mono text-xs text-text-secondary",
+                children: r3.status === "ok" ? r3.address : r3.status === "wrong_address" ? r3.address : "—"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3(StatusBadge, {
+                status: STATUS_LABELS[r3.status] ?? r3.status,
+                colorMap: STATUS_COLORS
+              }, undefined, false, undefined, this)
+            ])
+          }, undefined, false, undefined, this),
+          missingHostnames.length > 0 && /* @__PURE__ */ u3("div", {
+            class: "mt-6 rounded-lg border border-yellow-500/30 bg-yellow-500/5 p-4",
+            children: [
+              /* @__PURE__ */ u3("div", {
+                class: "text-sm font-medium text-yellow-500 mb-2",
+                children: "Missing hosts file entries"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("div", {
+                class: "text-xs text-text-secondary mb-3",
+                children: "Modifying the hosts file requires root privileges. Copy the command below and run it in your terminal:"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("div", {
+                class: "flex items-stretch gap-2",
+                children: [
+                  /* @__PURE__ */ u3("pre", {
+                    class: "flex-1 text-xs font-mono bg-surface p-3 rounded border border-border select-all overflow-x-auto",
+                    children: fixCommand
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ u3(CopyButton, {
+                    text: fixCommand,
+                    label: "Copy command"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ u3("div", {
+                class: "mt-3 text-[11px] text-text-muted",
+                children: [
+                  "Or manually add this line to ",
+                  data?.hostsFilePath,
+                  ":"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ u3("div", {
+                class: "flex items-stretch gap-2 mt-1",
+                children: [
+                  /* @__PURE__ */ u3("pre", {
+                    class: "flex-1 text-xs font-mono bg-surface p-3 rounded border border-border select-all",
+                    children: hostsLine
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ u3(CopyButton, {
+                    text: hostsLine,
+                    label: "Copy line"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
 // src/dashboard/views/kv.tsx
 function KvView({ route }) {
   const parts = route.split("/").filter(Boolean);
@@ -9982,6 +10156,7 @@ var NAV_GROUPS = [
     items: [
       { path: "/workers", label: "Workers", icon: "workers" },
       { path: "/routes", label: "Routes", icon: "routes" },
+      { path: "/hosts", label: "Hosts Check", icon: "routes" },
       { path: "/do", label: "Durable Objects", icon: "do" },
       { path: "/containers", label: "Containers", icon: "containers" },
       { path: "/workflows", label: "Workflows", icon: "workflows" },
@@ -10120,6 +10295,8 @@ function App() {
       return /* @__PURE__ */ u3(WorkersView, {}, undefined, false, undefined, this);
     if (route.startsWith("/routes"))
       return /* @__PURE__ */ u3(RoutesView, {}, undefined, false, undefined, this);
+    if (route.startsWith("/hosts"))
+      return /* @__PURE__ */ u3(HostsView, {}, undefined, false, undefined, this);
     if (route.startsWith("/generations"))
       return /* @__PURE__ */ u3(GenerationsView, {}, undefined, false, undefined, this);
     if (route.startsWith("/kv"))

package/dist/dashboard/{chunk-jzyhpjad.css → chunk-n1xkdmxt.css}

@@ -564,6 +564,10 @@
     margin-top: calc(var(--spacing) * 4);
   }
 
+  .mt-6 {
+    margin-top: calc(var(--spacing) * 6);
+  }
+
   .mt-8 {
     margin-top: calc(var(--spacing) * 8);
   }
@@ -684,6 +688,10 @@
     height: calc(var(--spacing) * 2.5);
   }
 
+  .h-3\.5 {
+    height: calc(var(--spacing) * 3.5);
+  }
+
   .h-4 {
     height: calc(var(--spacing) * 4);
   }
@@ -760,6 +768,10 @@
     width: calc(var(--spacing) * 2.5);
   }
 
+  .w-3\.5 {
+    width: calc(var(--spacing) * 3.5);
+  }
+
   .w-4 {
     width: calc(var(--spacing) * 4);
   }
@@ -969,6 +981,10 @@
     align-items:  flex-start;
   }
 
+  .items-stretch {
+    align-items: stretch;
+  }
+
   .justify-between {
     justify-content: space-between;
   }
@@ -1607,6 +1623,16 @@
     background-color: var(--color-yellow-400);
   }
 
+  .bg-yellow-500\/5 {
+    background-color: #edb2000d;
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    .bg-yellow-500\/5 {
+      background-color: color-mix(in oklab, var(--color-yellow-500) 5%, transparent);
+    }
+  }
+
   .bg-yellow-500\/15 {
     background-color: #edb20026;
   }
@@ -2149,6 +2175,11 @@
     outline-style: none;
   }
 
+  .select-all {
+    -webkit-user-select: all;
+    user-select: all;
+  }
+
   .select-none {
     -webkit-user-select: none;
     user-select: none;

package/dist/dashboard/index.html

@@ -8,7 +8,7 @@
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
   
-<link rel="stylesheet" crossorigin href="/__dashboard/assets/chunk-jzyhpjad.css"><script type="module" crossorigin src="/__dashboard/assets/chunk-jpd3vqkt.js"></script></head>
+<link rel="stylesheet" crossorigin href="/__dashboard/assets/chunk-n1xkdmxt.css"><script type="module" crossorigin src="/__dashboard/assets/chunk-5h0jr7cs.js"></script></head>
 <body class="h-full bg-surface text-ink" style="font-family: system-ui, -apple-system, sans-serif;">
   <script>
     // Apply saved theme before first paint to prevent flash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "lopata",
-	"version": "0.10.2",
+	"version": "0.11.0",
 	"type": "module",
 	"license": "MIT",
 	"repository": {

package/src/api/dispatch.ts

@@ -9,6 +9,7 @@ import { handlers as durableObjects } from './handlers/do'
 import { handlers as email } from './handlers/email'
 import { handlers as errors } from './handlers/errors'
 import { handlers as generations } from './handlers/generations'
+import { handlers as hosts } from './handlers/hosts'
 import { handlers as kv } from './handlers/kv'
 import { handlers as overview } from './handlers/overview'
 import { handlers as queue } from './handlers/queue'
@@ -42,6 +43,7 @@ const allHandlers = {
 	...analyticsEngine,
 	...warnings,
 	...routes,
+	...hosts,
 }
 
 export type Procedures = {

package/src/api/handlers/hosts.ts

@@ -0,0 +1,15 @@
+import { checkHostPatterns, readSystemHostsFile } from '../../hosts-check'
+import type { HandlerContext, HostsCheckResponse } from '../types'
+
+export const handlers = {
+	'hosts.check'(_input: {}, ctx: HandlerContext): HostsCheckResponse {
+		const hostsFile = readSystemHostsFile()
+
+		if ('error' in hostsFile) {
+			return { results: [], hostsFilePath: hostsFile.path, error: hostsFile.error }
+		}
+
+		const results = checkHostPatterns(hostsFile.entries, ctx.lopataConfig)
+		return { results, hostsFilePath: hostsFile.path }
+	},
+}

package/src/api/types.ts

@@ -2,6 +2,7 @@
 
 export type { GenerationInfo } from '../generation'
 import type { GenerationInfo } from '../generation'
+import type { HostCheckResult } from '../hosts-check'
 
 export interface Paginated<T> {
 	items: T[]
@@ -396,6 +397,12 @@ export interface HandlerContext {
 	hostRoutes: HostRouteInfo[]
 }
 
+export interface HostsCheckResponse {
+	results: HostCheckResult[]
+	hostsFilePath: string
+	error?: string
+}
+
 export interface RouteInfo {
 	pattern: string
 	workerName: string

package/src/cli/hosts.ts

@@ -0,0 +1,78 @@
+import { checkHostPatterns, readSystemHostsFile } from '../hosts-check'
+import { loadLopataConfig } from '../lopata-config'
+import type { CliContext } from './context'
+
+export async function run(_ctx: CliContext, args: string[]) {
+	const action = args[0]
+
+	if (action !== 'check') {
+		console.error('Usage: lopata hosts check')
+		process.exit(1)
+	}
+
+	const baseDir = process.cwd()
+	const lopataConfig = await loadLopataConfig(baseDir)
+
+	if (!lopataConfig?.workers?.some(w => w.hosts?.length)) {
+		console.log('No host routing configured. Nothing to check.')
+		console.log('Host routing is configured via the "hosts" field in lopata.config.ts workers.')
+		return
+	}
+
+	const hostsFile = readSystemHostsFile()
+	if ('error' in hostsFile) {
+		console.error(hostsFile.error)
+		console.error('Make sure you have read permissions.')
+		process.exit(1)
+	}
+
+	const results = checkHostPatterns(hostsFile.entries, lopataConfig)
+	const hostsPath = hostsFile.path
+
+	console.log(`Hosts file: ${hostsPath}`)
+	console.log('')
+
+	for (const r of results) {
+		switch (r.status) {
+			case 'ok':
+				console.log(`  ✓ ${r.hostname} (worker: ${r.workerName}) → ${r.address}`)
+				break
+			case 'missing':
+				console.log(`  ✗ ${r.hostname} (worker: ${r.workerName}) — not found in hosts file`)
+				break
+			case 'wrong_address':
+				console.log(`  ✗ ${r.hostname} (worker: ${r.workerName}) — points to ${r.address}, expected 127.0.0.1`)
+				break
+			case 'wildcard':
+				console.log(`  ⚠ ${r.hostname} (worker: ${r.workerName}) — wildcard pattern, cannot be checked in hosts file`)
+				console.log(`    You need to add specific subdomains to your hosts file manually.`)
+				if (process.platform === 'darwin') {
+					console.log(`    Alternatively, use dnsmasq or a local DNS resolver to handle wildcard domains.`)
+				}
+				break
+		}
+	}
+
+	console.log('')
+
+	const failing = results.filter(r => r.status === 'missing' || r.status === 'wrong_address')
+	if (failing.length > 0) {
+		console.log('Some hostnames are missing or misconfigured.')
+		console.log('')
+		console.log('Add the missing entries to your hosts file:')
+		console.log('')
+
+		const uniqueHostnames = [...new Set(failing.map(m => m.hostname))]
+		console.log(`  ${hostsPath}:`)
+		console.log(`  127.0.0.1  ${uniqueHostnames.join(' ')}`)
+		console.log('')
+
+		if (process.platform !== 'win32') {
+			console.log(`Run: sudo sh -c 'echo "127.0.0.1  ${uniqueHostnames.join(' ')}" >> ${hostsPath}'`)
+		} else {
+			console.log('Open Notepad as Administrator and add the line above to the hosts file.')
+		}
+	} else if (!results.some(r => r.status === 'wildcard')) {
+		console.log('All host routes are correctly configured.')
+	}
+}

package/src/cli.ts

@@ -55,6 +55,11 @@ switch (command) {
 		await mod.run(ctx, commandArgs.slice(1))
 		break
 	}
+	case 'hosts': {
+		const mod = await import('./cli/hosts')
+		await mod.run(ctx, commandArgs.slice(1))
+		break
+	}
 	case 'trace': {
 		const mod = await import('./cli/traces')
 		await mod.run(ctx, commandArgs.slice(1))
@@ -91,6 +96,7 @@ Commands:
   queues message purge <queue> Purge queue messages
   cache list                  List cache names
   cache purge [--name CACHE]  Purge cache entries
+  hosts check                 Check hosts file for configured host routes
   trace list [options]        List traces (--limit, --since, --search, --cursor)
   trace get <traceId>         Get trace detail as JSON
 

package/src/hosts-check.ts

@@ -0,0 +1,75 @@
+import { readFileSync } from 'node:fs'
+import type { LopataConfig } from './lopata-config'
+
+export interface HostsEntry {
+	address: string
+	hostnames: string[]
+}
+
+export interface HostCheckResult {
+	hostname: string
+	workerName: string
+	status: 'ok' | 'missing' | 'wrong_address' | 'wildcard'
+	address?: string
+}
+
+const LOCALHOST_ADDRESSES = new Set(['127.0.0.1', '::1', 'localhost'])
+
+export function getHostsFilePath(): string {
+	if (process.platform === 'win32') {
+		return 'C:\\Windows\\System32\\drivers\\etc\\hosts'
+	}
+	return '/etc/hosts'
+}
+
+export function parseHostsFile(content: string): HostsEntry[] {
+	const entries: HostsEntry[] = []
+	for (const line of content.split('\n')) {
+		const trimmed = line.trim()
+		if (trimmed === '' || trimmed.startsWith('#')) continue
+		const parts = trimmed.split(/\s+/)
+		if (parts.length < 2) continue
+		entries.push({ address: parts[0]!, hostnames: parts.slice(1) })
+	}
+	return entries
+}
+
+export function readSystemHostsFile(): { path: string; entries: HostsEntry[] } | { path: string; error: string } {
+	const path = getHostsFilePath()
+	try {
+		const content = readFileSync(path, 'utf-8')
+		return { path, entries: parseHostsFile(content) }
+	} catch {
+		return { path, error: `Could not read hosts file at ${path}` }
+	}
+}
+
+export function checkHostPatterns(
+	hostsEntries: HostsEntry[],
+	lopataConfig: LopataConfig | null,
+): HostCheckResult[] {
+	const results: HostCheckResult[] = []
+
+	if (!lopataConfig?.workers) return results
+
+	for (const worker of lopataConfig.workers) {
+		if (!worker.hosts) continue
+		for (const host of worker.hosts) {
+			if (host.startsWith('*.')) {
+				results.push({ hostname: host, workerName: worker.name, status: 'wildcard' })
+				continue
+			}
+
+			const entry = hostsEntries.find(e => e.hostnames.includes(host))
+			if (!entry) {
+				results.push({ hostname: host, workerName: worker.name, status: 'missing' })
+			} else if (!LOCALHOST_ADDRESSES.has(entry.address)) {
+				results.push({ hostname: host, workerName: worker.name, status: 'wrong_address', address: entry.address })
+			} else {
+				results.push({ hostname: host, workerName: worker.name, status: 'ok', address: entry.address })
+			}
+		}
+	}
+
+	return results
+}