devflare 1.0.0-next.2 → 1.0.0-next.3

package/dist/bridge/proxy.d.ts

@@ -20,14 +20,13 @@ export declare function createEnvProxy(options?: EnvProxyOptions & {
 /**
  * Get the global env proxy for bridge RPC
  *
- * Note: This is distinct from `devflare/runtime`'s `env` which provides
- * request-scoped context access. Use `bridgeEnv` for standalone bridge usage
- * (e.g., testing, scripts) and the runtime `env` within request handlers.
+ * Note: This is distinct from the published `import { env } from 'devflare'`
+ * proxy, which provides unified request/test/bridge-aware access.
+ * Use `bridgeEnv` for standalone internal bridge usage and `env` from the
+ * main package within request handlers and normal test flows.
  *
  * @example
  * ```ts
- * import { bridgeEnv } from 'devflare'
- *
  * await bridgeEnv.MY_KV.get('key')
  * await bridgeEnv.MY_DO.get(id).fetch(request)
  * ```

package/dist/bridge/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/bridge/proxy.ts"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAYvD,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CAC9C;AA0aD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAA;CACxF;AAKD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsEhH;AAqED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAO5C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,yBAAY,CAAA;AAE5B;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAIzD"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/bridge/proxy.ts"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAYvD,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CAC9C;AA0aD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAA;CACxF;AAKD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsEhH;AAqED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAO5C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,yBAAY,CAAA;AAE5B;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAIzD"}

package/dist/cli/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AA+DjE,wBAAsB,aAAa,CAClC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CAgGpB"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAgEjE,wBAAsB,aAAa,CAClC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CA4JpB"}

package/dist/cli/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAUjE,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CAqMpB"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAWjE,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CAoMpB"}

package/dist/{dev-qnxet3j9.js → dev-pa8dhm20.js}

@@ -1,3 +1,8 @@
+import {
+  detectViteProject,
+  stopSpawnedProcessTree,
+  waitForViteReady
+} from "./index-18hvb6gb.js";
 import {
   findFiles
 } from "./index-rbht7m9r.js";
@@ -1663,6 +1668,7 @@ function createDevServer(options) {
     configPath,
     vitePort = 5173,
     miniflarePort = 8787,
+    enableVite = true,
     persist = true,
     logger,
     verbose = false,
@@ -1878,7 +1884,8 @@ function createDevServer(options) {
     const args = ["vite", "dev", "--port", String(vitePort)];
     viteProcess = spawn("bunx", args, {
       cwd,
-      stdio: "inherit",
+      stdio: ["inherit", "pipe", "pipe"],
+      windowsHide: true,
       env: {
         ...process.env,
         DEVFLARE_DEV: "true",
@@ -1886,7 +1893,19 @@ function createDevServer(options) {
         FORCE_COLOR: "1"
       }
     });
-    logger?.success(`Vite dev server started on http://localhost:${vitePort}`);
+    const readyUrl = await waitForViteReady(viteProcess, {
+      onStdout(chunk) {
+        process.stdout.write(chunk);
+      },
+      onStderr(chunk) {
+        process.stderr.write(chunk);
+      }
+    });
+    if (readyUrl) {
+      logger?.success(`Vite dev server started on ${readyUrl}`);
+      return;
+    }
+    logger?.warn("Vite process started, but the final local URL could not be confirmed yet");
   }
   async function start() {
     logger?.info("Starting unified dev server...");
@@ -1945,16 +1964,13 @@ function createDevServer(options) {
       await doBundler.watch();
     }
     await startMiniflare(doResult);
-    await startVite();
+    if (enableVite) {
+      await startVite();
+    } else {
+      logger?.info("Vite startup skipped (no local vite.config.* found for this package)");
+    }
     await new Promise((r) => setTimeout(r, 1000));
     await runD1Migrations();
-    const cleanup = async () => {
-      logger?.info("Shutting down...");
-      await stop();
-      process.exit(0);
-    };
-    process.on("SIGINT", cleanup);
-    process.on("SIGTERM", cleanup);
   }
   async function stop() {
     if (doBundler) {
@@ -1966,7 +1982,7 @@ function createDevServer(options) {
       miniflare = null;
     }
     if (viteProcess) {
-      viteProcess.kill("SIGTERM");
+      await stopSpawnedProcessTree(viteProcess);
       viteProcess = null;
     }
     if (browserShim) {
@@ -2025,6 +2041,7 @@ async function runDevCommand(parsed, logger, options) {
   const persistEnabled = parsed.options.persist === true;
   const debugEnabled = parsed.options.debug === true || process.env.DEVFLARE_DEBUG === "true";
   const verbose = parsed.options.verbose === true || debugEnabled;
+  const viteProject = await detectViteProject(cwd);
   const logWriter = await createLogWriter(cwd, {
     log: logEnabled,
     logTemp: logTempEnabled
@@ -2052,42 +2069,91 @@ async function runDevCommand(parsed, logger, options) {
   }
   try {
     logger.info("");
-    logger.info("\uD83D\uDE80 Devflare Unified Dev Server");
-    logger.info("   ├─ Vite: Full HMR for frontend");
-    logger.info("   ├─ Miniflare: All Cloudflare bindings");
-    logger.info("   ├─ Rolldown: Fast DO bundling with watch");
-    logger.info("   └─ Bridge: WebSocket RPC connection");
+    if (viteProject.shouldStartVite) {
+      logger.info("\uD83D\uDE80 Devflare Unified Dev Server");
+      logger.info("   ├─ Vite: Full HMR for frontend");
+      logger.info("   ├─ Miniflare: All Cloudflare bindings");
+      logger.info("   ├─ Rolldown: Fast DO bundling with watch");
+      logger.info("   └─ Bridge: WebSocket RPC connection");
+    } else {
+      logger.info("\uD83D\uDE80 Devflare Worker Dev Server");
+      logger.info("   ├─ Miniflare: All Cloudflare bindings");
+      logger.info("   ├─ Rolldown: Fast DO bundling with watch");
+      logger.info("   └─ Vite: Disabled (no local vite.config.* found)");
+      if (viteProject.wantsViteIntegration) {
+        logger.warn("Vite-related dependencies were found, but no local vite.config.* was detected");
+        logger.warn("Skipping Vite startup and running in worker-only mode");
+      }
+    }
     logger.info("");
     const devServer = createDevServer({
       cwd,
       configPath,
       vitePort: port ? parseInt(port, 10) : 5173,
       miniflarePort: 8787,
+      enableVite: viteProject.shouldStartVite,
       persist: persistEnabled,
       logger: devLogger,
       verbose,
       debug: debugEnabled
     });
-    const cleanup = async () => {
+    let isCleaningUp = false;
+    const cleanupHandlers = new Map;
+    const removeCleanupHandlers = () => {
+      for (const [event, handler] of cleanupHandlers) {
+        process.off(event, handler);
+      }
+      cleanupHandlers.clear();
+    };
+    const cleanup = async (exitCode, reason) => {
+      if (isCleaningUp) {
+        return;
+      }
+      isCleaningUp = true;
+      removeCleanupHandlers();
+      if (reason) {
+        const message = reason instanceof Error ? reason.stack ?? reason.message : String(reason);
+        logger.error(message);
+      }
       logger.info("");
       logger.info("Shutting down...");
-      await devServer.stop();
-      logWriter?.close();
-      process.exit(0);
+      try {
+        await devServer.stop();
+      } finally {
+        logWriter?.close();
+        process.exit(exitCode);
+      }
+    };
+    const registerCleanupHandler = (event, handler) => {
+      cleanupHandlers.set(event, handler);
+      process.on(event, handler);
     };
-    process.on("SIGINT", cleanup);
-    process.on("SIGTERM", cleanup);
+    registerCleanupHandler("SIGINT", () => {
+      cleanup(0);
+    });
+    registerCleanupHandler("SIGTERM", () => {
+      cleanup(0);
+    });
+    registerCleanupHandler("SIGHUP", () => {
+      cleanup(0);
+    });
+    registerCleanupHandler("uncaughtException", (error) => {
+      cleanup(1, error);
+    });
+    registerCleanupHandler("unhandledRejection", (reason) => {
+      cleanup(1, reason);
+    });
     await devServer.start();
     await new Promise(() => {});
     return { exitCode: 0 };
   } catch (error) {
+    logWriter?.close();
     if (error instanceof Error) {
       logger.error("Dev server failed:", error.message);
       if (verbose) {
         logger.error(error.stack);
       }
     }
-    logWriter?.close();
     return { exitCode: 1 };
   }
 }

package/dist/dev-server/server.d.ts

@@ -9,6 +9,8 @@ export interface DevServerOptions {
     vitePort?: number;
     /** Miniflare port for gateway (default: 8787) */
     miniflarePort?: number;
+    /** Whether to start Vite for this package */
+    enableVite?: boolean;
     /** Persist storage data */
     persist?: boolean;
     /** Logger instance */

package/dist/dev-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dev-server/server.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAA;AAa3D,MAAM,WAAW,gBAAgB;IAChC,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACzB,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,0BAA0B;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,yCAAyC;IACzC,YAAY,IAAI,aAAa,GAAG,IAAI,CAAA;CACpC;AA2kBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAmepE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dev-server/server.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAA;AAc3D,MAAM,WAAW,gBAAgB;IAChC,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACzB,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,0BAA0B;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,yCAAyC;IACzC,YAAY,IAAI,aAAa,GAAG,IAAI,CAAA;CACpC;AA2kBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA4epE"}

package/dist/dev-server/vite-utils.d.ts

@@ -0,0 +1,37 @@
+export declare const VITE_CONFIG_FILES: readonly ["vite.config.ts", "vite.config.js", "vite.config.mts", "vite.config.mjs"];
+export interface ViteProjectFileSystem {
+    access(path: string): Promise<void>;
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+}
+export interface ViteProjectDetection {
+    viteConfigPath: string | null;
+    hasLocalViteDependency: boolean;
+    hasLocalCloudflareVitePluginDependency: boolean;
+    shouldStartVite: boolean;
+    wantsViteIntegration: boolean;
+}
+export interface SpawnedLikeProcess {
+    pid?: number;
+    stdout: NodeJS.ReadableStream | null;
+    stderr: NodeJS.ReadableStream | null;
+    readonly killed: boolean;
+    kill(signal?: NodeJS.Signals): boolean;
+    on(event: 'exit', handler: (code: number | null, signal: NodeJS.Signals | null) => void): SpawnedLikeProcess;
+    on(event: 'error', handler: (error: Error) => void): SpawnedLikeProcess;
+}
+export interface WaitForViteReadyOptions {
+    timeoutMs?: number;
+    onStdout?: (chunk: string | Buffer) => void;
+    onStderr?: (chunk: string | Buffer) => void;
+}
+export interface StopProcessTreeOptions {
+    platform?: NodeJS.Platform;
+    timeoutMs?: number;
+    runCommand?: (command: string, args: string[]) => Promise<void>;
+}
+export declare function detectViteProject(cwd: string, fs?: ViteProjectFileSystem): Promise<ViteProjectDetection>;
+export declare function stripAnsi(value: string): string;
+export declare function extractViteReadyUrl(output: string): string | null;
+export declare function waitForViteReady(process: SpawnedLikeProcess, options?: WaitForViteReadyOptions): Promise<string | null>;
+export declare function stopSpawnedProcessTree(process: Pick<SpawnedLikeProcess, 'pid' | 'kill' | 'killed' | 'on'>, options?: StopProcessTreeOptions): Promise<void>;
+//# sourceMappingURL=vite-utils.d.ts.map

package/dist/dev-server/vite-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-utils.d.ts","sourceRoot":"","sources":["../../src/dev-server/vite-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,qFAKpB,CAAA;AAEV,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,oBAAoB;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sBAAsB,EAAE,OAAO,CAAA;IAC/B,sCAAsC,EAAE,OAAO,CAAA;IAC/C,eAAe,EAAE,OAAO,CAAA;IACxB,oBAAoB,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IACpC,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IACtC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,KAAK,IAAI,GAAG,kBAAkB,CAAA;IAC5G,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,kBAAkB,CAAA;CACvE;AAED,MAAM,WAAW,uBAAuB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAwBD,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,MAAM,EACX,EAAE,CAAC,EAAE,qBAAqB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAoC/B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBjE;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuDxB;AA2CD,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC,EACnE,OAAO,GAAE,sBAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/{doctor-e8fy6fj5.js → doctor-fmgb3d28.js}

@@ -1,3 +1,6 @@
+import {
+  detectViteProject
+} from "./index-18hvb6gb.js";
 import {
   loadConfig,
   resolveConfigPath
@@ -13,6 +16,7 @@ async function runDoctorCommand(parsed, logger, options) {
   const cwd = options.cwd || process.cwd();
   const checks = [];
   const { fs } = await getDependencies();
+  const viteProject = await detectViteProject(cwd, fs);
   logger.info(`Running diagnostics...
 `);
   try {
@@ -67,63 +71,63 @@ async function runDoctorCommand(parsed, logger, options) {
         message: "devflare not in dependencies"
       });
     }
-    if (deps.vite) {
+  } catch {
+    checks.push({
+      name: "package.json",
+      status: "fail",
+      message: "package.json not found"
+    });
+  }
+  if (viteProject.wantsViteIntegration) {
+    checks.push({
+      name: "Vite Integration",
+      status: "pass",
+      message: "Enabled for this package"
+    });
+    if (viteProject.hasLocalViteDependency) {
       checks.push({
         name: "vite dep",
         status: "pass",
-        message: `Version: ${deps.vite}`
+        message: "Found in package.json"
       });
     } else {
       checks.push({
         name: "vite dep",
-        status: "fail",
-        message: "vite required but not found"
+        status: "warn",
+        message: "Not declared in this package.json (workspace-hoisted installs may still work)"
       });
     }
-    if (deps["@cloudflare/vite-plugin"]) {
+    if (viteProject.hasLocalCloudflareVitePluginDependency) {
       checks.push({
         name: "@cloudflare/vite-plugin",
         status: "pass",
-        message: `Version: ${deps["@cloudflare/vite-plugin"]}`
+        message: "Found in package.json"
       });
     } else {
       checks.push({
         name: "@cloudflare/vite-plugin",
-        status: "fail",
-        message: "@cloudflare/vite-plugin required but not found"
+        status: "warn",
+        message: "Not declared in this package.json"
       });
     }
-  } catch {
-    checks.push({
-      name: "package.json",
-      status: "fail",
-      message: "package.json not found"
-    });
-  }
-  const viteConfigPaths = [
-    "vite.config.ts",
-    "vite.config.js",
-    "vite.config.mts",
-    "vite.config.mjs"
-  ];
-  let viteConfigFound = false;
-  for (const configName of viteConfigPaths) {
-    try {
-      await fs.access(resolve(cwd, configName));
-      viteConfigFound = true;
+    if (viteProject.viteConfigPath) {
       checks.push({
         name: "Vite Config",
         status: "pass",
-        message: `Found: ${configName}`
+        message: `Found: ${viteProject.viteConfigPath}`
       });
-      break;
-    } catch {}
-  }
-  if (!viteConfigFound) {
+    } else {
+      checks.push({
+        name: "Vite Config",
+        status: "warn",
+        message: "No vite.config found. Create one with @cloudflare/vite-plugin"
+      });
+    }
+  } else {
     checks.push({
-      name: "Vite Config",
-      status: "warn",
-      message: "No vite.config found. Create one with @cloudflare/vite-plugin"
+      name: "Vite Integration",
+      status: "pass",
+      message: "Not enabled for this package (worker-only mode)"
     });
   }
   try {

package/dist/index-18hvb6gb.js

@@ -0,0 +1,194 @@
+import {
+  __require
+} from "./index-37x76zdn.js";
+
+// src/dev-server/vite-utils.ts
+import { resolve } from "pathe";
+import { spawn } from "node:child_process";
+var VITE_CONFIG_FILES = [
+  "vite.config.ts",
+  "vite.config.js",
+  "vite.config.mts",
+  "vite.config.mjs"
+];
+var ANSI_REGEX = /\x1b\[[0-9;]*m/g;
+var LOCAL_VITE_URL_REGEX = /https?:\/\/(?:localhost|127\.0\.0\.1|\[::1\])(?::\d+)?\/?/i;
+async function getNodeFs() {
+  return await import("node:fs/promises");
+}
+function safeParsePackageJson(content) {
+  try {
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+function readDependencyFlag(pkg, name) {
+  const dependencies = pkg.dependencies;
+  const devDependencies = pkg.devDependencies;
+  return Boolean(dependencies?.[name] ?? devDependencies?.[name]);
+}
+async function detectViteProject(cwd, fs) {
+  const fileSystem = fs ?? await getNodeFs();
+  let viteConfigPath = null;
+  for (const configName of VITE_CONFIG_FILES) {
+    const absolutePath = resolve(cwd, configName);
+    try {
+      await fileSystem.access(absolutePath);
+      viteConfigPath = absolutePath;
+      break;
+    } catch {
+      continue;
+    }
+  }
+  let pkg = {};
+  try {
+    const packageJson = await fileSystem.readFile(resolve(cwd, "package.json"), "utf-8");
+    pkg = safeParsePackageJson(packageJson);
+  } catch {
+    pkg = {};
+  }
+  const hasLocalViteDependency = readDependencyFlag(pkg, "vite");
+  const hasLocalCloudflareVitePluginDependency = readDependencyFlag(pkg, "@cloudflare/vite-plugin");
+  const wantsViteIntegration = Boolean(viteConfigPath || hasLocalViteDependency || hasLocalCloudflareVitePluginDependency);
+  return {
+    viteConfigPath,
+    hasLocalViteDependency,
+    hasLocalCloudflareVitePluginDependency,
+    shouldStartVite: Boolean(viteConfigPath),
+    wantsViteIntegration
+  };
+}
+function stripAnsi(value) {
+  return value.replace(ANSI_REGEX, "");
+}
+function extractViteReadyUrl(output) {
+  const cleaned = stripAnsi(output);
+  const lines = cleaned.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  for (const line of lines) {
+    if (!line.toLowerCase().includes("local:")) {
+      continue;
+    }
+    const match = line.match(LOCAL_VITE_URL_REGEX);
+    if (match) {
+      return match[0];
+    }
+  }
+  const fallbackMatch = cleaned.match(LOCAL_VITE_URL_REGEX);
+  return fallbackMatch?.[0] ?? null;
+}
+async function waitForViteReady(process, options = {}) {
+  const {
+    timeoutMs = 15000,
+    onStdout,
+    onStderr
+  } = options;
+  let combinedOutput = "";
+  return await new Promise((resolvePromise, rejectPromise) => {
+    let settled = false;
+    let timeout;
+    const settle = (resolver) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timeout);
+      resolver();
+    };
+    const inspectChunk = (chunk) => {
+      combinedOutput += typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+      const readyUrl = extractViteReadyUrl(combinedOutput);
+      if (readyUrl) {
+        settle(() => resolvePromise(readyUrl));
+      }
+    };
+    process.stdout?.on("data", (chunk) => {
+      onStdout?.(chunk);
+      inspectChunk(chunk);
+    });
+    process.stderr?.on("data", (chunk) => {
+      onStderr?.(chunk);
+      inspectChunk(chunk);
+    });
+    process.on("error", (error) => {
+      settle(() => rejectPromise(error));
+    });
+    process.on("exit", (code, signal) => {
+      settle(() => {
+        const reason = signal ? `signal ${signal}` : `exit code ${code ?? "unknown"}`;
+        rejectPromise(new Error(`Vite exited before reporting a ready URL (${reason})`));
+      });
+    });
+    timeout = setTimeout(() => {
+      settle(() => resolvePromise(null));
+    }, timeoutMs);
+  });
+}
+async function defaultRunCommand(command, args) {
+  await new Promise((resolvePromise, rejectPromise) => {
+    const child = spawn(command, args, {
+      stdio: "ignore",
+      windowsHide: true
+    });
+    child.on("error", rejectPromise);
+    child.on("exit", () => resolvePromise());
+  });
+}
+function waitForProcessExit(process, timeoutMs) {
+  if (process.killed) {
+    return Promise.resolve(true);
+  }
+  return new Promise((resolvePromise) => {
+    let settled = false;
+    let timeout;
+    const settle = (value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timeout);
+      resolvePromise(value);
+    };
+    process.on("exit", () => settle(true));
+    timeout = setTimeout(() => {
+      settle(false);
+    }, timeoutMs);
+  });
+}
+async function stopSpawnedProcessTree(process, options = {}) {
+  const {
+    platform = globalThis.process?.platform ?? "linux",
+    timeoutMs = 3000,
+    runCommand = defaultRunCommand
+  } = options;
+  if (platform === "win32" && process.pid) {
+    try {
+      await runCommand("taskkill", ["/pid", String(process.pid), "/t", "/f"]);
+    } catch {
+      try {
+        process.kill("SIGTERM");
+      } catch {
+        return;
+      }
+    }
+    await waitForProcessExit(process, timeoutMs);
+    return;
+  }
+  try {
+    process.kill("SIGTERM");
+  } catch {
+    return;
+  }
+  const exited = await waitForProcessExit(process, timeoutMs);
+  if (exited) {
+    return;
+  }
+  try {
+    process.kill("SIGKILL");
+  } catch {
+    return;
+  }
+  await waitForProcessExit(process, timeoutMs);
+}
+
+export { detectViteProject, waitForViteReady, stopSpawnedProcessTree };

package/dist/index.js

@@ -129,7 +129,7 @@ Usage:
 
 Commands:
   init [name]     Create a new devflare project
-  dev             Start unified development server
+	dev             Start development server
   build           Build for production
   deploy          Deploy to Cloudflare
   types           Generate TypeScript types
@@ -145,23 +145,23 @@ Global Options:
   --debug         Enable debug mode
 
 Dev Command Options:
-  --port <port>   Vite dev server port (default: 5173)
+	--port <port>   Preferred Vite dev server port (default: 5173)
   --persist       Persist Miniflare storage data
   --verbose       Enable verbose logging
   --log           Log all output to .log-{datetime} file AND terminal
   --log-temp      Log all output to .log file (overwritten) AND terminal
 
 Dev Server Features:
-  • Vite HMR for frontend (instant updates)
   • Miniflare for ALL Cloudflare bindings (KV, D1, R2, DOs, Queues, AI)
+	• Optional Vite HMR when a local vite.config.* is present
   • Rolldown for fast DO bundling with watch mode
   • DO hot reload when files change (no restart needed)
   • WebSocket bridge for seamless Node.js ↔ Miniflare communication
 
 Examples:
   devflare init my-app
-  devflare dev                  # Start unified dev server
-  devflare dev --port 3000      # Custom Vite port
+	devflare dev                  # Start worker-only or unified dev server
+	devflare dev --port 3000      # Custom Vite port when Vite is enabled
   devflare dev --persist        # Persist storage between restarts
   devflare dev --log-temp       # Log output to .log file
   devflare build
@@ -216,7 +216,7 @@ async function runInit(parsed, logger, options) {
   return runInitCommand(parsed, logger, options);
 }
 async function runDev(parsed, logger, options) {
-  const { runDevCommand } = await import("./dev-qnxet3j9.js");
+  const { runDevCommand } = await import("./dev-pa8dhm20.js");
   return runDevCommand(parsed, logger, options);
 }
 async function runBuild(parsed, logger, options) {
@@ -232,7 +232,7 @@ async function runTypes(parsed, logger, options) {
   return runTypesCommand(parsed, logger, options);
 }
 async function runDoctor(parsed, logger, options) {
-  const { runDoctorCommand } = await import("./doctor-e8fy6fj5.js");
+  const { runDoctorCommand } = await import("./doctor-fmgb3d28.js");
   return runDoctorCommand(parsed, logger, options);
 }
 async function runAccount(parsed, logger, options) {

package/dist/test/bridge-context.d.ts

@@ -30,7 +30,10 @@ export interface BridgeTestContext {
  *
  * @example
  * ```ts
- * import { createBridgeTestContext, bridgeEnv } from 'devflare'
+ * import { createBridgeTestContext } from 'devflare'
+ * import { createEnvProxy } from 'devflare'
+ *
+ * const bridgeEnv = createEnvProxy({ lazy: true })
  *
  * beforeAll(async () => {
  *   await createBridgeTestContext({ configPath: './devflare.config.ts' })

package/dist/test/bridge-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-context.d.ts","sourceRoot":"","sources":["../../src/test/bridge-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAA2D,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG5I,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAMnD,MAAM,WAAW,wBAAwB;IACxC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,6BAA6B;IAC7B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,4BAA4B;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,8CAA8C;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAYD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAmF5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAOxD;AAMD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAM1C,CAAA;AAqBF,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"bridge-context.d.ts","sourceRoot":"","sources":["../../src/test/bridge-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAA2D,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG5I,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAMnD,MAAM,WAAW,wBAAwB;IACxC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,6BAA6B;IAC7B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,4BAA4B;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,8CAA8C;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAYD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAmF5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAOxD;AAMD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAM1C,CAAA;AAqBF,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "devflare",
-	"version": "1.0.0-next.2",
+	"version": "1.0.0-next.3",
 	"description": "Devflare is a developer-first toolkit for Cloudflare Workers that sits on top of Miniflare and Wrangler-compatible config",
 	"type": "module",
 	"main": "./dist/index.js",