veryfront 0.1.545 → 0.1.546

package/src/src/server/handlers/studio/bridge-modules.handler.ts

@@ -1,131 +0,0 @@
-/**
- * Studio Bridge Handler
- *
- * Serves the studio bridge script. In compiled binaries, uses a pre-bundled
- * version generated at build time. In dev mode, bundles on-the-fly with esbuild.
- *
- * Route: /_veryfront/studio-bridge.js
- *
- * @module server/handlers/studio/bridge-modules
- */
-import * as dntShim from "../../../../_dnt.shims.js";
-
-
-import { BaseHandler } from "../../../security/index.js";
-import type {
-  HandlerContext,
-  HandlerMetadata,
-  HandlerPriority,
-  HandlerResult,
-} from "../types.js";
-import { HTTP_OK, PRIORITY_HIGH_DEV } from "../../../utils/constants/index.js";
-import { STUDIO_BRIDGE_BUNDLE } from "../../../studio/bridge/bridge-bundle.generated.js";
-import { serverLogger } from "../../../utils/index.js";
-
-const logger = serverLogger.component("studio-bridge-handler");
-
-/** Cached bundle output. */
-let bundleCache: { js: string; etag: string } | null = null;
-
-/** Resolve the bridge source directory from this module's location. */
-const BRIDGE_DIR = new URL("../../../studio/bridge/", import.meta.url).pathname;
-
-/**
- * Compute a content hash for ETag.
- */
-async function computeEtag(content: string): Promise<string> {
-  const data = new TextEncoder().encode(content);
-  const hashBuffer = await dntShim.crypto.subtle.digest("SHA-256", data);
-  const hashArray = Array.from(new Uint8Array(hashBuffer));
-  return hashArray.slice(0, 16).map((b) => b.toString(16).padStart(2, "0")).join("");
-}
-
-/**
- * Bundle the bridge coordinator (and all its imports) into a single JS file.
- * Uses pre-bundled output when available (compiled binary), falls back to
- * esbuild JIT bundling in dev mode.
- */
-async function bundleBridge(): Promise<{ js: string; etag: string }> {
-  if (bundleCache) return bundleCache;
-
-  // Use pre-bundled output if available (compiled binary / CI builds)
-  if (STUDIO_BRIDGE_BUNDLE) {
-    const etag = await computeEtag(STUDIO_BRIDGE_BUNDLE);
-    bundleCache = { js: STUDIO_BRIDGE_BUNDLE, etag };
-    return bundleCache;
-  }
-
-  // Dev mode: bundle on-the-fly with esbuild
-  const entryPoint = `${BRIDGE_DIR}bridge-coordinator.ts`;
-  const source = await dntShim.Deno.readTextFile(entryPoint);
-
-  const { build } = await import("../../../extensions/bundler/index.js");
-  const { outputFiles } = await build({
-    bundle: true,
-    write: false,
-    format: "esm",
-    platform: "browser",
-    target: "es2022",
-    stdin: {
-      contents: source,
-      loader: "ts",
-      resolveDir: BRIDGE_DIR,
-      sourcefile: entryPoint,
-    },
-  });
-
-  const js = outputFiles?.[0]?.text ?? "";
-  const etag = await computeEtag(js);
-  bundleCache = { js, etag };
-  return bundleCache;
-}
-
-export class StudioBridgeModulesHandler extends BaseHandler {
-  metadata: HandlerMetadata = {
-    name: "StudioBridgeModulesHandler",
-    priority: PRIORITY_HIGH_DEV as HandlerPriority,
-    patterns: [{ pattern: "/_veryfront/studio-bridge.js", exact: true }],
-    enabled: () => true,
-  };
-
-  async handle(req: Request, ctx: HandlerContext): Promise<HandlerResult> {
-    if (!this.shouldHandle(req, ctx)) {
-      return this.continue();
-    }
-
-    const ifNoneMatch = req.headers.get("if-none-match");
-
-    try {
-      const { js, etag } = await bundleBridge();
-
-      if (ifNoneMatch === `"${etag}"`) {
-        return this.respond(
-          new Response(null, {
-            status: 304,
-            headers: { ETag: `"${etag}"`, "Cache-Control": "no-cache" },
-          }),
-        );
-      }
-
-      return this.respond(
-        new Response(js, {
-          status: HTTP_OK,
-          headers: {
-            "Content-Type": "application/javascript; charset=utf-8",
-            "Cache-Control": "no-cache",
-            ETag: `"${etag}"`,
-          },
-        }),
-      );
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      logger.error("Bundle error", { message });
-      return this.respond(
-        new Response(`// Bundle error: ${message}`, {
-          status: 500,
-          headers: { "Content-Type": "application/javascript; charset=utf-8" },
-        }),
-      );
-    }
-  }
-}

package/src/src/server/handlers/types.ts

@@ -1,22 +0,0 @@
-/**
- * Shared types for the runtime handler architecture
- *
- * Re-exported from #veryfront/types for backward compatibility.
- * New code should import directly from #veryfront/types.
- */
-
-export type {
-  AppRouteMatch,
-  Handler,
-  HandlerContext,
-  HandlerMetadata,
-  HandlerResult,
-  MiddlewareFunction,
-  ParsedDomain,
-  RouteHandlerModule,
-  RoutePattern,
-  RouteRegistryConfig,
-  SecurityConfig,
-} from "../../types/index.js";
-
-export { HandlerPriority } from "../../types/index.js";

package/src/src/server/handlers/utils/content-types.ts

@@ -1,107 +0,0 @@
-import {
-  HTTP_CONTENT_TYPE_IMAGE_GIF,
-  HTTP_CONTENT_TYPE_IMAGE_ICO,
-  HTTP_CONTENT_TYPE_IMAGE_JPEG,
-  HTTP_CONTENT_TYPE_IMAGE_PNG,
-  HTTP_CONTENT_TYPE_IMAGE_SVG,
-  HTTP_CONTENT_TYPE_IMAGE_WEBP,
-} from "../../../utils/index.js";
-
-export const CONTENT_TYPES: Record<string, string> = {
-  ".html": "text/html; charset=utf-8",
-  ".htm": "text/html; charset=utf-8",
-  ".xml": "application/xml; charset=utf-8",
-  ".txt": "text/plain; charset=utf-8",
-  ".md": "text/markdown; charset=utf-8",
-  ".js": "application/javascript; charset=utf-8",
-  ".mjs": "application/javascript; charset=utf-8",
-  ".cjs": "application/javascript; charset=utf-8",
-  ".ts": "application/typescript; charset=utf-8",
-  ".tsx": "application/typescript; charset=utf-8",
-  ".jsx": "application/javascript; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".scss": "text/x-scss; charset=utf-8",
-  ".sass": "text/x-sass; charset=utf-8",
-  ".less": "text/x-less; charset=utf-8",
-  ".json": "application/json; charset=utf-8",
-  ".jsonld": "application/ld+json; charset=utf-8",
-  ".csv": "text/csv; charset=utf-8",
-  ".yaml": "text/yaml; charset=utf-8",
-  ".yml": "text/yaml; charset=utf-8",
-  ".toml": "application/toml; charset=utf-8",
-  ".png": HTTP_CONTENT_TYPE_IMAGE_PNG,
-  ".jpg": HTTP_CONTENT_TYPE_IMAGE_JPEG,
-  ".jpeg": HTTP_CONTENT_TYPE_IMAGE_JPEG,
-  ".gif": HTTP_CONTENT_TYPE_IMAGE_GIF,
-  ".svg": HTTP_CONTENT_TYPE_IMAGE_SVG,
-  ".ico": HTTP_CONTENT_TYPE_IMAGE_ICO,
-  ".webp": HTTP_CONTENT_TYPE_IMAGE_WEBP,
-  ".avif": "image/avif",
-  ".bmp": "image/bmp",
-  ".tiff": "image/tiff",
-  ".tif": "image/tiff",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2",
-  ".ttf": "font/ttf",
-  ".otf": "font/otf",
-  ".eot": "application/vnd.ms-fontobject",
-  ".mp3": "audio/mpeg",
-  ".ogg": "audio/ogg",
-  ".wav": "audio/wav",
-  ".m4a": "audio/mp4",
-  ".aac": "audio/aac",
-  ".flac": "audio/flac",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm",
-  ".ogv": "video/ogg",
-  ".avi": "video/x-msvideo",
-  ".mov": "video/quicktime",
-  ".wmv": "video/x-ms-wmv",
-  ".flv": "video/x-flv",
-  ".mkv": "video/x-matroska",
-  ".zip": "application/zip",
-  ".tar": "application/x-tar",
-  ".gz": "application/gzip",
-  ".bz2": "application/x-bzip2",
-  ".7z": "application/x-7z-compressed",
-  ".rar": "application/vnd.rar",
-  ".pdf": "application/pdf",
-  ".doc": "application/msword",
-  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-  ".xls": "application/vnd.ms-excel",
-  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-  ".ppt": "application/vnd.ms-powerpoint",
-  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-  ".wasm": "application/wasm",
-};
-
-const DEFAULT_CONTENT_TYPE = "application/octet-stream";
-const COMPRESSIBLE_PATTERNS = ["javascript", "json", "xml", "svg"];
-const COMPRESSED_PATTERNS = ["gzip", "zip", "compressed", "jpeg", "jpg", "png", "webp", "avif"];
-
-export function getContentType(extension: string): string {
-  return CONTENT_TYPES[extension.toLowerCase()] ?? DEFAULT_CONTENT_TYPE;
-}
-
-export function getContentTypeForPath(path: string): string {
-  const lastDot = path.lastIndexOf(".");
-  if (lastDot === -1) return DEFAULT_CONTENT_TYPE;
-  return getContentType(path.slice(lastDot));
-}
-
-export function isCompressible(contentType: string): boolean {
-  if (contentType.startsWith("text/")) return true;
-  if (COMPRESSIBLE_PATTERNS.some((p) => contentType.includes(p))) return true;
-  if (COMPRESSED_PATTERNS.some((p) => contentType.includes(p))) return false;
-  // Unknown types are not compressible by default
-  return false;
-}
-
-export function isCacheable(contentType: string): boolean {
-  if (contentType.startsWith("image/")) return true;
-  if (contentType.startsWith("font/")) return true;
-  if (contentType.includes("javascript")) return true;
-  if (contentType.includes("css")) return true;
-  // HTML and JSON are not cacheable, and unknown types default to false
-  return false;
-}

package/src/src/server/handlers/utils/etag.ts

@@ -1,44 +0,0 @@
-import { HASH_SEED_DJB2 } from "../../../utils/index.js";
-
-function computeHash(content: string | Uint8Array): number {
-  let hash = HASH_SEED_DJB2;
-
-  if (typeof content === "string") {
-    for (let i = 0; i < content.length; i++) {
-      hash = ((hash << 5) + hash) ^ content.charCodeAt(i);
-    }
-    return hash >>> 0;
-  }
-
-  for (let i = 0; i < content.length; i++) {
-    hash = ((hash << 5) + hash) ^ (content[i] ?? 0);
-  }
-
-  return hash >>> 0;
-}
-
-export function computeEtag(content: string | Uint8Array, weak = true): string {
-  const hash = computeHash(content).toString(16);
-  return weak ? `W/"${hash}"` : `"${hash}"`;
-}
-
-export function computeStrongEtag(content: string | Uint8Array): string {
-  return computeEtag(content, false);
-}
-
-export function hasMatchingEtag(req: Request, etag: string): boolean {
-  return req.headers.get("if-none-match") === etag;
-}
-
-export function parseIfNoneMatch(header: string | null): string[] {
-  if (!header) return [];
-  return header
-    .split(",")
-    .map((tag) => tag.trim())
-    .filter(Boolean);
-}
-
-export function matchesAnyEtag(etag: string, ifNoneMatch: string | null): boolean {
-  const tags = parseIfNoneMatch(ifNoneMatch);
-  return tags.includes("*") || tags.includes(etag);
-}

package/src/src/server/index.ts

@@ -1,386 +0,0 @@
-/**
- * Server Module Public API
- *
- * This module exports the public interface for the Veryfront server.
- * For routing utilities, import from "#veryfront/routing" directly.
- * For observability utilities, import from "#veryfront/observability" directly.
- *
- * @module server
- *
- * @example Composable service server
- * ```ts
- * import { createVeryfrontServer } from "veryfront/server";
- *
- * const server = createVeryfrontServer({
- *   modules: [{
- *     name: "agent",
- *     handle: (request) => new Response(`Handled ${request.url}`),
- *   }],
- * });
- *
- * await server.fetch(new Request("https://example.com/health"));
- * ```
- *
- * @see docs/deployment.md
- * @see docs/security.md
- */
-import "../../_dnt.polyfills.js";
-
-import * as dntShim from "../../_dnt.shims.js";
-
-
-import {
-  DevServer,
-  type DevServerOptions,
-  type FileWatcherMetrics,
-  type RouteDirectory,
-  startDevServer,
-} from "./dev-server.js";
-import {
-  type DiscoveryOptions,
-  type ServerHandle,
-  startProductionServer,
-  type StartProductionServerOptions,
-} from "./production-server.js";
-import { runtime } from "../platform/adapters/detect.js";
-import { cwd } from "../platform/compat/process.js";
-import { bootstrapProd } from "./bootstrap.js";
-import { createVeryfrontHandler } from "./runtime-handler/index.js";
-import { addClient, getClient, removeClient } from "./handlers/preview/hmr-client-manager.js";
-import { handleHmrClientMessage } from "./handlers/preview/hmr-client-message.js";
-import { RateLimiter } from "../modules/server/index.js";
-import { HMR_MAX_MESSAGES_PER_MINUTE } from "../utils/index.js";
-
-/** Default server port when no port is specified */
-const DEFAULT_SERVER_PORT = 3_000;
-
-export { DevServer, startDevServer, startProductionServer };
-export {
-  createVeryfrontServer,
-  type CreateVeryfrontServerOptions,
-  type NodeVeryfrontServiceServer,
-  startNodeVeryfrontServer,
-  type StartNodeVeryfrontServerOptions,
-  startVeryfrontServer,
-  type StartVeryfrontServerOptions,
-  type VeryfrontServiceServer,
-  type VeryfrontServiceServerFetch,
-  type VeryfrontServiceServerLogger,
-  type VeryfrontServiceServerModule,
-  type VeryfrontServiceServerModuleResponse,
-  type VeryfrontServiceServerRuntime,
-  type VeryfrontServiceServerRuntimeKind,
-} from "./service-server.js";
-export type {
-  DevServerOptions,
-  DiscoveryOptions,
-  FileWatcherMetrics,
-  RouteDirectory,
-  ServerHandle,
-  StartProductionServerOptions,
-};
-import { ReloadNotifier } from "./reload-notifier.js";
-export { ReloadNotifier };
-export type { BuildOptions, BuildStats } from "./build-types.js";
-
-/** Shared options for both development and production server modes. */
-interface BaseServerOptions {
-  /** Project root directory. Defaults to process.cwd(). */
-  projectDir?: string;
-  port?: number;
-  /** 0.0.0.0 = all interfaces, 127.0.0.1 = localhost only */
-  bindAddress?: string;
-  signal?: AbortSignal;
-  /** Default project slug when not provided via proxy headers (for tests/local mode) */
-  defaultProjectSlug?: string;
-  /** Default project ID when not provided via proxy headers (for tests/local mode) */
-  defaultProjectId?: string;
-  /**
-   * Optional request interceptor for combined mode.
-   * Transforms requests before they're processed by the core request handler.
-   */
-  requestInterceptor?: (req: Request) => Request | Promise<Request>;
-}
-
-export interface StartDevModeOptions extends BaseServerOptions {
-  mode?: "development";
-  moduleServerPort?: number;
-  enableHMR?: boolean;
-  enableFastRefresh?: boolean;
-  fileWatcherDebounceMs?: number;
-}
-
-export interface StartProductionModeOptions extends BaseServerOptions {
-  mode?: "production";
-  /** When true, expose additional debug logging. */
-  debug?: boolean;
-  /** Default environment for standalone mode (preview or production). Defaults to preview for safety. */
-  defaultEnvironment?: "preview" | "production";
-  /** Discovery configuration for AI primitives. Runs discoverAll() before serving. */
-  discoveryConfig?: DiscoveryOptions;
-  /** Map of local project slugs to their filesystem paths. */
-  localProjects?: Record<string, string>;
-}
-
-/**
- * Server options. Defaults to development mode with HMR.
- * Set `mode: "production"` for a production server.
- */
-export type StartServerOptions = StartDevModeOptions | StartProductionModeOptions;
-
-/** Running server instance with lifecycle controls. */
-export interface VeryfrontServer {
-  /** Resolves when the server is ready to accept requests. */
-  ready: Promise<void>;
-  /** Gracefully stop the server. */
-  stop: () => Promise<void>;
-  /** The port the server is listening on. */
-  port: number;
-  /** The full URL the server is listening on. */
-  url: string;
-}
-
-/** Web API request handler with WebSocket upgrade and HMR helpers. */
-export type VeryfrontHandler = ((req: Request) => Promise<Response>) & {
-  /**
-   * Attach WebSocket upgrade handling to a Node.js HTTP server.
-   * Required for HMR live reload when using an external server like Hono, Express, etc.
-   */
-  upgrade: (server: unknown) => void;
-  /**
-   * Connect an external WebSocket to the HMR live reload system.
-   * Use this for runtimes that manage WebSocket upgrades natively (e.g. Bun/Elysia)
-   * instead of `handler.upgrade(server)`.
-   */
-  connectHMR: (ws: WebSocket) => void;
-};
-
-/**
- * Create a Veryfront request handler for use with any HTTP framework.
- *
- * Defaults to development mode with file watching and live reload.
- *
- * @example
- * ```ts
- * import { Hono } from "hono"
- * import { serve } from "@hono/node-server"
- * import { createHandler } from "veryfront"
- *
- * const app = new Hono()
- * const handler = await createHandler()
- * app.all("*", (c) => handler(c.req.raw))
- * const server = serve({ fetch: app.fetch, port: 3000 })
- * handler.upgrade(server)
- * ```
- */
-// Ensure responses use the native global Response class.
-// The DNT (Deno-to-Node) build replaces all `Response` and `globalThis` references
-// with an undici polyfill, which breaks `instanceof Response` checks in frameworks
-// like h3. We use Function constructor to access the real global scope directly.
-// eslint-disable-next-line no-new-func
-const _nativeGlobal = new Function("return this")() as typeof dntShim.dntGlobalThis;
-const _NativeResponse: typeof Response = _nativeGlobal.Response;
-
-function toNativeResponse(res: Response): Response {
-  if (res instanceof _NativeResponse) return res;
-  // TS narrows to `never` after the instanceof check because it can't see the
-  // runtime class divergence between DNT's polyfill Response and native Response.
-  const src = res as unknown as Response;
-  return new _NativeResponse(src.body, {
-    status: src.status,
-    statusText: src.statusText,
-    headers: src.headers,
-  });
-}
-
-export async function createHandler(
-  options: { projectDir?: string; mode?: "development" | "production"; port?: number } = {},
-): Promise<VeryfrontHandler> {
-  const projectDir = options.projectDir ?? cwd();
-
-  if (options.mode === "production") {
-    const adapter = await runtime.get();
-    const bootstrap = await bootstrapProd(projectDir, adapter);
-    const internalHandler = createVeryfrontHandler(projectDir, bootstrap.adapter, { projectDir });
-    const handler = async (req: Request) => toNativeResponse(await internalHandler(req));
-    return Object.assign(handler, { upgrade: () => {}, connectHMR: () => {} });
-  }
-
-  // Development mode (default), includes file watching, HMR, cache invalidation
-  const port = options.port ?? DEFAULT_SERVER_PORT;
-  const devServer = new DevServer({
-    port,
-    projectDir,
-    enableHMR: true,
-    enableFastRefresh: true,
-    handlerOnly: true,
-  });
-  await devServer.start();
-
-  // ReloadNotifier subscription for HMR broadcast is now handled eagerly
-  // inside DevServer.start(), no additional subscription needed here.
-
-  const internalFetch = devServer.handler;
-  const fetch = async (req: Request) => toNativeResponse(await internalFetch(req));
-  const hmrRateLimiter = new RateLimiter(HMR_MAX_MESSAGES_PER_MINUTE);
-
-  const upgrade = (server: unknown) => {
-    const httpServer = server as import("node:http").Server;
-    let wsServer: import("ws").WebSocketServer | null = null;
-
-    httpServer.on("upgrade", async (request, socket, head) => {
-      try {
-        const { WebSocketServer } = await import("ws");
-        if (!wsServer) wsServer = new WebSocketServer({ noServer: true });
-
-        const key = request.headers["sec-websocket-key"];
-        const requestId = typeof key === "string" ? key : Array.isArray(key) ? key[0] ?? "" : "";
-
-        // Run request through handler pipeline so HMRHandler registers the WebSocket client
-        const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`);
-        const headersRecord: Record<string, string> = {};
-        for (const [key, value] of Object.entries(request.headers)) {
-          if (typeof value === "string") headersRecord[key] = value;
-          else if (Array.isArray(value)) headersRecord[key] = value[0] ?? "";
-        }
-        await fetch(new Request(url.toString(), { method: "GET", headers: headersRecord }));
-
-        // Complete transport-level WebSocket upgrade
-        const { resolveWebSocketUpgrade } = await import(
-          "../platform/adapters/runtime/node/http-server.js"
-        );
-
-        const server = wsServer;
-        server.handleUpgrade(request, socket, head, (ws: import("ws").WebSocket) => {
-          resolveWebSocketUpgrade(requestId, ws);
-          server.emit("connection", ws, request);
-        });
-      } catch (_error) {
-        socket.destroy();
-      }
-    });
-  };
-
-  const connectHMR = (ws: WebSocket) => {
-    const clientId = dntShim.crypto.randomUUID().slice(0, 8);
-    addClient({
-      id: clientId,
-      socket: ws,
-      connectedAt: Date.now(),
-      lastActivity: Date.now(),
-    });
-
-    let cleanedUp = false;
-    const cleanup = () => {
-      if (cleanedUp) return;
-      cleanedUp = true;
-      hmrRateLimiter.cleanup(ws);
-      removeClient(clientId);
-    };
-    ws.addEventListener("close", cleanup);
-    ws.addEventListener("error", cleanup);
-
-    ws.addEventListener("message", (event) => {
-      handleHmrClientMessage({
-        socket: ws,
-        data: event.data,
-        rateLimiter: hmrRateLimiter,
-        onActivity: () => {
-          const client = getClient(clientId);
-          if (client) client.lastActivity = Date.now();
-        },
-      });
-    });
-
-    const sendConnected = () => {
-      try {
-        ws.send(JSON.stringify({ type: "connected" }));
-      } catch (_) {
-        /* expected: socket may have closed immediately */
-      }
-    };
-
-    if (ws.readyState === WebSocket.OPEN) sendConnected();
-    else ws.addEventListener("open", sendConnected, { once: true });
-  };
-
-  return Object.assign(fetch, { upgrade, connectHMR });
-}
-
-/**
- * Convert a Web API request handler into a Node.js HTTP request listener.
- *
- * @example
- * ```ts
- * import { createServer } from "node:http"
- * import { createHandler, toNodeHandler } from "veryfront"
- *
- * const handler = await createHandler()
- * const server = createServer(toNodeHandler(handler))
- * ```
- */
-export { toNodeHandler } from "./node-handler.js";
-
-/**
- * Start a Veryfront server in development or production mode.
- *
- * This is the primary entry point for running a Veryfront server.
- * Defaults to development mode when `mode` is not specified.
- */
-export async function startServer(
-  options: StartServerOptions = {},
-): Promise<VeryfrontServer> {
-  const projectDir = options.projectDir ?? cwd();
-  const port = options.port ?? DEFAULT_SERVER_PORT;
-  const bindAddress = options.bindAddress ?? "localhost";
-
-  if (options?.mode === "production") {
-    const handle = await startProductionServer({
-      projectDir,
-      port,
-      bindAddress: options.bindAddress,
-      signal: options.signal,
-      defaultProjectSlug: options.defaultProjectSlug,
-      defaultProjectId: options.defaultProjectId,
-      requestInterceptor: options.requestInterceptor,
-      defaultEnvironment: options.defaultEnvironment,
-      discoveryConfig: options.discoveryConfig,
-      localProjects: options.localProjects,
-      debug: options.debug,
-    });
-    return {
-      ready: handle.ready,
-      stop: () => handle.stop(),
-      port,
-      url: `http://${bindAddress}:${port}`,
-    };
-  }
-
-  // Development mode (default)
-  const devServer = await startDevServer({
-    port,
-    projectDir,
-    bindAddress: options.bindAddress,
-    moduleServerPort: "moduleServerPort" in options ? options.moduleServerPort : undefined,
-    enableHMR: ("enableHMR" in options ? options.enableHMR : undefined) ?? true,
-    enableFastRefresh: ("enableFastRefresh" in options ? options.enableFastRefresh : undefined) ??
-      true,
-    fileWatcherDebounceMs: "fileWatcherDebounceMs" in options
-      ? options.fileWatcherDebounceMs
-      : undefined,
-    signal: options.signal,
-    requestInterceptor: options.requestInterceptor,
-    defaultProjectSlug: options.defaultProjectSlug,
-    defaultProjectId: options.defaultProjectId,
-  });
-  return {
-    ready: devServer.ready,
-    stop: () => devServer.stop(),
-    port,
-    url: `http://${bindAddress}:${port}`,
-  };
-}
-
-// Note: Wildcard re-exports removed to prevent circular dependency risks.
-// Import from "#veryfront/routing" for Route, RouteMatch, PageRouteMatcher, etc.
-// Import from "#veryfront/observability" for tracing and metrics utilities.