lopata 0.10.2 → 0.12.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.12.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/dev.ts

@@ -140,6 +140,12 @@ export async function run(ctx: CliContext) {
 
 		// Build route dispatcher (aux workers only — main is the fallback)
 		routeDispatcher = new RouteDispatcher(mainManager)
+
+		// Register main worker host patterns so they take priority over wildcard aux hosts
+		if (lopataConfig.hosts?.length) {
+			routeDispatcher.addHostWorker(mainManager, mainConfig.name, lopataConfig.hosts)
+		}
+
 		for (const workerDef of lopataConfig.workers ?? []) {
 			const auxMgr = registry.getManager(workerDef.name)
 			if (!auxMgr) continue
@@ -159,6 +165,11 @@ export async function run(ctx: CliContext) {
 
 		// Expose host routes to the dashboard API
 		const hostRoutes: Array<{ pattern: string; workerName: string }> = []
+		if (lopataConfig.hosts?.length) {
+			for (const host of lopataConfig.hosts) {
+				hostRoutes.push({ pattern: host, workerName: mainConfig.name })
+			}
+		}
 		for (const workerDef of lopataConfig.workers ?? []) {
 			if (!workerDef.hosts) continue
 			for (const host of workerDef.hosts) {

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
+}

package/src/lopata-config.ts

@@ -4,6 +4,8 @@ import { dirname, join, resolve } from 'node:path'
 export interface LopataConfig {
 	/** Path to the main worker's wrangler config (HTTP entrypoint) */
 	main: string
+	/** Host patterns that route to the main worker (takes priority over wildcard auxiliary hosts). */
+	hosts?: string[]
 	/** Auxiliary workers, each with a service name and wrangler config path */
 	workers?: Array<{
 		name: string

package/src/route-matcher.ts

@@ -77,6 +77,12 @@ export function matchHost(hostname: string, pattern: string): boolean {
 	return false
 }
 
+/** Check if host patterns contain any wildcard entries (e.g. `*.localhost`). */
+function hasWildcardHost(patterns?: string[]): boolean {
+	if (!patterns) return false
+	return patterns.some(p => p.includes('*'))
+}
+
 /** Count the number of path segments in a pattern (ignoring trailing wildcard). */
 function segmentCount(pattern: string): number {
 	const clean = pattern.replace(/\/?\*$/, '')
@@ -90,6 +96,8 @@ interface RouteEntry {
 	manager: RoutableManager
 	/** When set, this route only matches requests whose hostname matches one of these patterns. */
 	hostPatterns?: string[]
+	/** Pre-computed: true if any hostPattern contains a wildcard. Used for sort ordering. */
+	hasWildcardHost: boolean
 }
 
 /**
@@ -143,7 +151,7 @@ export class RouteDispatcher {
 				continue
 			}
 
-			this.routes.push({ pattern, workerName, manager, hostPatterns })
+			this.routes.push({ pattern, workerName, manager, hostPatterns, hasWildcardHost: hasWildcardHost(hostPatterns) })
 			this.sorted = false
 		}
 	}
@@ -152,7 +160,7 @@ export class RouteDispatcher {
 	addHostWorker(manager: RoutableManager, workerName: string, hostPatterns: string[]): void {
 		// Clear existing routes for this worker to support re-registration
 		this.routes = this.routes.filter(r => r.workerName !== workerName)
-		this.routes.push({ pattern: '/*', workerName, manager, hostPatterns })
+		this.routes.push({ pattern: '/*', workerName, manager, hostPatterns, hasWildcardHost: hasWildcardHost(hostPatterns) })
 		this.sorted = false
 	}
 
@@ -175,6 +183,8 @@ export class RouteDispatcher {
 			const aSlashStar = a.pattern.endsWith('/*')
 			const bSlashStar = b.pattern.endsWith('/*')
 			if (aSlashStar !== bSlashStar) return aSlashStar ? -1 : 1
+			// Exact host patterns beat wildcard host patterns (e.g. admin.localhost before *.localhost)
+			if (a.hasWildcardHost !== b.hasWildcardHost) return a.hasWildcardHost ? 1 : -1
 			// Longer pattern string as tiebreaker
 			return b.pattern.length - a.pattern.length
 		})

package/src/vite-plugin/dev-server-plugin.ts

@@ -8,6 +8,7 @@ import { extractHostname, RouteDispatcher } from '../route-matcher.ts'
 interface DevServerPluginOptions {
 	configPath?: string
 	envName: string
+	hosts?: string[]
 	auxiliaryWorkers?: { configPath: string; name?: string; hosts?: string[] }[]
 }
 
@@ -425,6 +426,12 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 
 				// Build route dispatcher (aux workers only — main is the fallback)
 				routeDispatcher = new RouteDispatcher(mainAdapter)
+
+				// Register main worker host patterns so they take priority over wildcard aux hosts
+				if (options.hosts?.length) {
+					routeDispatcher.addHostWorker(mainAdapter, config.name, options.hosts)
+				}
+
 				for (const workerDef of options.auxiliaryWorkers) {
 					const cached = auxConfigs.get(workerDef.configPath)
 					if (!cached) continue
@@ -446,6 +453,11 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 
 				// Expose host routes to the dashboard API
 				const hostRoutes: Array<{ pattern: string; workerName: string }> = []
+				if (options.hosts?.length) {
+					for (const host of options.hosts) {
+						hostRoutes.push({ pattern: host, workerName: config.name })
+					}
+				}
 				for (const workerDef of options.auxiliaryWorkers) {
 					if (!workerDef.hosts) continue
 					const cached = auxConfigs.get(workerDef.configPath)

package/src/vite-plugin/index.ts

@@ -10,6 +10,8 @@ export interface LopataPluginConfig {
 	configPath?: string
 	/** Vite environment name for SSR. Default: "ssr" */
 	viteEnvironment?: { name?: string }
+	/** Host patterns that route to the main worker (takes priority over wildcard auxiliary hosts). */
+	hosts?: string[]
 	/** Auxiliary workers loaded via native Bun import (not through Vite). */
 	auxiliaryWorkers?: { configPath: string; name?: string; hosts?: string[] }[]
 }
@@ -36,6 +38,7 @@ export function lopata(config?: LopataPluginConfig): Plugin[] {
 		devServerPlugin({
 			configPath: config?.configPath,
 			envName,
+			hosts: config?.hosts,
 			auxiliaryWorkers: config?.auxiliaryWorkers,
 		}),
 		reactRouterPlugin(),