void 0.7.13 → 0.8.0

package/dist/index.mjs

@@ -1,26 +1,27 @@
 import { r as __toESM } from "./chunk-DJd-R1mw.mjs";
-import { a as join, n as dirname, o as relative } from "./pathe.M-eThtNZ-D-kmWkCS.mjs";
-import { u as require_picocolors } from "./output-D3g5otMC.mjs";
-import { n as loadVoidAuthConfig, t as findVoidAuthConfig } from "./config-CvHtTM0q.mjs";
-import { c as getToken, u as isStagingMode } from "./client-C_DYiXeu.mjs";
-import { r as readProjectConfig } from "./project-DhB4A8_g.mjs";
-import { C as isSandboxEnabled, S as SANDBOX_MIGRATION_TAG, _ as normalizeWranglerCompatibilityFlags, a as prerenderPagesNode, b as resolveLiveBindingConfig, c as filterLoadedEnv, d as LIVE_MIGRATION_TAG, f as ensureWranglerCompat, g as nextDurableObjectMigrationTag, h as hasDurableObjectSqliteMigration, i as prerenderPages, l as resolveRemoteMode, m as ensureWranglerNodejsAlsFlag, n as resolveDistDir, o as DEFAULT_PROXY_URL, p as ensureWranglerCompatibilityDate, r as resolveWorkerDirName, s as STAGING_PROXY_URL, u as stripInternalEnvKeys, v as readExistingLiveBindingConfig, w as resolveSandboxConfig, x as syncWranglerBindings, y as readWranglerCompat } from "./deploy-CPAEgVQm.mjs";
-import { c as getDatabaseDialect, f as readConfig, l as isNodeTarget, p as resolveBindingNames } from "./config-CeRQg3Lz.mjs";
-import { i as scanJobsSync, n as scanWebSocketRoutesSync, r as scanQueuesSync, t as scanRoutes } from "./scan-CkK1Hzpa.mjs";
-import { a as SSR_CLIENT_ENTRY_RELATIVE_PATHS, c as validateSsrEntries, f as isIdentifier, g as walk, i as inferProjectBindings, l as validateSsrEntry, m as isMemberExpression, n as FRAMEWORK_SCAN_DIRS, o as SSR_SERVER_ENTRY_RELATIVE_PATHS, p as isLiteral, r as detectFramework, t as DEFAULT_SCAN_DIRS, u as inferBindingsFromSource } from "./plugin-inference-BexV6LL3.mjs";
-import { i as voidWarn, n as voidError, r as voidLog, t as setShowTimestamp } from "./log-7ChR5Fbc.mjs";
-import { r as parseDotenvFile } from "./dotenv-HQNhRalS.mjs";
-import { i as generateDbDts, n as generateQueueTypes, r as DRIZZLE_OPERATORS, t as generateRouteTypes } from "./route-types-qVL-v-CB.mjs";
-import { n as ensureProjectTsconfig } from "./project-tsconfig-Bfy55qvs.mjs";
-import { t as discoverSchema } from "./discover-CKGQpis8.mjs";
-import { t as MagicString } from "./magic-string.es-DS_lmuBe.mjs";
-import { n as generateEnvTypes, t as findEnvFile } from "./env-types-BSQghXbx.mjs";
-import { a as loadUserEnvFile } from "./env-validation-Buy5pe3u.mjs";
-import { i as resolveLayoutIds } from "./scan-CKpylFj9.mjs";
-import { n as lintDuplicateSources, r as mergeRoutingRules, t as lintDestinationSplats } from "./headers-CuVHn6Kl.mjs";
-import { n as generateVoidAuthDrizzleSchema, t as generateVoidAuthDatabaseModule } from "./drizzle-Cx7cVwrE.mjs";
-import { t as INTERNAL_BINDING_PREFIXES } from "./env-raw-DtfQ9E31.mjs";
-import { n as defer } from "./defer-2ARBu8Et.mjs";
+import { a as join, n as dirname, s as relative } from "./pathe.M-eThtNZ-BrPhGF_K.mjs";
+import { u as require_picocolors } from "./output-DeiS4oEX.mjs";
+import { C as isSandboxEnabled, E as resolveAssetRoutingPolicy, S as SANDBOX_MIGRATION_TAG, T as hasDocumentRoutes, _ as normalizeWranglerCompatibilityFlags, a as prerenderPagesNode, b as resolveLiveBindingConfig, c as filterLoadedEnv, d as LIVE_MIGRATION_TAG, f as ensureWranglerCompat, g as nextDurableObjectMigrationTag, h as hasDurableObjectSqliteMigration, i as prerenderPages, l as resolveRemoteMode, m as ensureWranglerNodejsAlsFlag, n as resolveDistDir, o as DEFAULT_PROXY_URL, p as ensureWranglerCompatibilityDate, r as resolveWorkerDirName, s as STAGING_PROXY_URL, u as stripInternalEnvKeys, v as readExistingLiveBindingConfig, w as resolveSandboxConfig, x as syncWranglerBindings, y as readWranglerCompat } from "./deploy-7EA_lKq9.mjs";
+import { i as resolveProjectPaths, n as readProjectPaths, t as assertNoRootSourceConventionConflicts } from "./project-paths-CCMrHYQm.mjs";
+import { n as loadVoidAuthConfig, t as findVoidAuthConfig } from "./config-hhMYPVRT.mjs";
+import { c as getToken, u as isStagingMode } from "./client-C-nH6yz3.mjs";
+import { r as readProjectConfig } from "./project-CH9pdo16.mjs";
+import { c as getDatabaseDialect, f as readConfig, l as isNodeTarget, p as resolveBindingNames } from "./config-BVEC0lti.mjs";
+import { a as scanQueuesSync, i as scanWebSocketRoutesSync, n as scanRoutePatternsSync, o as scanJobsSync, r as scanRoutes, t as scanMiddlewareSync } from "./scan-DzzHqtiT.mjs";
+import { a as SSR_CLIENT_ENTRY_RELATIVE_PATHS, c as validateSsrEntries, f as isIdentifier, g as walk, i as inferProjectBindings, l as validateSsrEntry, m as isMemberExpression, n as FRAMEWORK_SCAN_DIRS, o as SSR_SERVER_ENTRY_RELATIVE_PATHS, p as isLiteral, r as detectFramework, t as DEFAULT_SCAN_DIRS, u as inferBindingsFromSource } from "./plugin-inference-Ba1uGdIy.mjs";
+import { i as voidWarn, n as voidError, r as voidLog, t as setShowTimestamp } from "./log-CWWZV4V1.mjs";
+import { r as parseDotenvFile } from "./dotenv-Bkoqyq9r.mjs";
+import { i as generateDbDts, n as generateQueueTypes, r as DRIZZLE_OPERATORS, t as generateRouteTypes } from "./route-types-jxRfWuCb.mjs";
+import { n as ensureProjectTsconfig } from "./project-tsconfig-HAGjfY6w.mjs";
+import { t as discoverSchema } from "./discover-C8N1I4tK.mjs";
+import { t as MagicString } from "./magic-string.es-C1Fb0uxq.mjs";
+import { n as findEnvFileForPaths, r as generateEnvTypes, t as findEnvFile } from "./env-types-D6qI1ThV.mjs";
+import { a as loadUserEnvFile } from "./env-validation-DBJsxZLz.mjs";
+import { i as resolveLayoutIds } from "./scan-2YmJkYAf.mjs";
+import { n as lintDuplicateSources, r as mergeRoutingRules, t as lintDestinationSplats } from "./headers-wAPJigtE.mjs";
+import { n as generateVoidAuthDrizzleSchema, t as generateVoidAuthDatabaseModule } from "./drizzle-DmaANP4-.mjs";
+import { t as INTERNAL_BINDING_PREFIXES } from "./env-raw-zk5JQKZe.mjs";
+import { n as defer } from "./defer-DkoEwda-.mjs";
 import { VoidAssetRewriteError, defineHandler, defineHead, defineMiddleware, defineQueue, defineRender, defineScheduled } from "./runtime/handler.mjs";
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, writeFileSync, writeSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -432,8 +433,9 @@ function devTriggersHintPlugin(root, options) {
 		name: "void:dev-triggers-hint",
 		apply: "serve",
 		configureServer(server) {
-			const jobs = scanJobsSync(root);
-			const queues = scanQueuesSync(root);
+			const paths = readProjectPaths(root);
+			const jobs = scanJobsSync(root, paths.cronsDir);
+			const queues = scanQueuesSync(root, paths.queuesDir);
 			if (jobs.length === 0 && queues.length === 0) return;
 			const afterReady = (fn) => {
 				if (server.httpServer) server.httpServer.once("listening", () => setTimeout(fn, 100));
@@ -484,9 +486,13 @@ const VIRTUAL_SCHEMA_DB_ID = "\0virtual:void-db-schema";
 */
 function drizzlePlugin(root, hasRouteTypes, dialect = "sqlite", options = {}) {
 	const outDir = join(root, ".void");
-	const schema = discoverSchema(root);
+	const paths = readProjectPaths(root);
+	const schema = discoverSchema(root, paths);
 	const hasDbRuntime = schema != null || options.forceVirtualDb === true;
-	ensureProjectTsconfig(root, hasRouteTypes, hasDbRuntime, schema != null, { redirectDbModule: options.redirectDbTypePaths });
+	ensureProjectTsconfig(root, hasRouteTypes, hasDbRuntime, schema != null, {
+		redirectDbModule: options.redirectDbTypePaths,
+		paths
+	});
 	if (hasDbRuntime) generateDbDts(outDir, schema ?? null, dialect);
 	let isBuild = false;
 	return {
@@ -591,13 +597,14 @@ export function createDb(d1) {
 		},
 		async configureServer(server) {
 			if (!schema) return;
-			const migrationsDir = join(root, "db", "migrations");
+			const migrationsDir = paths.migrationsDir;
 			if (!(existsSync(migrationsDir) && readdirSync(migrationsDir).some((f) => f.endsWith(".sql")))) {
 				if (dialect === "sqlite") {
-					const { getApplicationTables, getMiniflareDatabasePath } = await import("./runner-C0d3lJo1.mjs");
+					const { getApplicationTables, getMiniflareDatabasePath } = await import("./runner-BkGBfr4e.mjs");
 					if ((await getApplicationTables(getMiniflareDatabasePath(options.localD1PersistRoot ?? join(root, ".void"), options.localD1DatabaseId ?? "local")).catch(() => [])).length > 0) return;
 				}
-				voidWarn("Schema found but no migrations in db/migrations/.\n         `void db push` syncs the schema to your local DB without creating migration files.\n         Run `void db generate` to create migration files for dev startup and deploy.");
+				voidWarn(`Schema found but no migrations in ${paths.sourceRelative("db/migrations")}/.\n         \`void db push\` syncs the schema to your local DB without creating migration files.
+         Run \`void db generate\` to create migration files for dev startup and deploy.`);
 			}
 			const watchPath = schema.path;
 			const regenerate = (path) => {
@@ -1083,11 +1090,12 @@ function frameworkTriggersDispatchPath(root) {
 * without depending on `configResolved` ordering.
 */
 function writeFrameworkTriggersDispatch(root, devTriggerToken) {
-	const jobs = scanJobsSync(root);
-	const queues = scanQueuesSync(root);
+	const paths = readProjectPaths(root);
+	const jobs = scanJobsSync(root, paths.cronsDir);
+	const queues = scanQueuesSync(root, paths.queuesDir);
 	const target = frameworkTriggersDispatchPath(root);
 	mkdirSync(dirname(target), { recursive: true });
-	writeFileSync(target, generateModule(root, jobs, queues, devTriggerToken));
+	writeFileSync(target, generateModule(paths.cronsDir, paths.queuesDir, jobs, queues, devTriggerToken));
 }
 /**
 * Writes a real file at `<root>/.void/dev-triggers.ts` exporting
@@ -1107,8 +1115,9 @@ function frameworkTriggersPlugin(root, options) {
 			writeDispatch();
 		},
 		configureServer(server) {
-			const cronsPrefix = normalizePath(join(root, "crons"));
-			const queuesPrefix = normalizePath(join(root, "queues"));
+			const paths = readProjectPaths(root);
+			const cronsPrefix = normalizePath(paths.cronsDir);
+			const queuesPrefix = normalizePath(paths.queuesDir);
 			const isInteresting = (file) => {
 				const normalized = normalizePath(file);
 				return normalized.startsWith(cronsPrefix) || normalized.startsWith(queuesPrefix);
@@ -1127,9 +1136,9 @@ function frameworkTriggersPlugin(root, options) {
 		}
 	};
 }
-function generateModule(root, jobs, queues, devTriggerToken) {
-	const jobImports = jobs.map((job, jobIndex) => `import __job${jobIndex} from ${JSON.stringify(join(root, "crons", job.filePath))};`).join("\n");
-	const queueImports = queues.map((queue, queueIndex) => `import __queue${queueIndex} from ${JSON.stringify(join(root, "queues", queue.filePath))};`).join("\n");
+function generateModule(cronsDir, queuesDir, jobs, queues, devTriggerToken) {
+	const jobImports = jobs.map((job, jobIndex) => `import __job${jobIndex} from ${JSON.stringify(join(cronsDir, job.filePath))};`).join("\n");
+	const queueImports = queues.map((queue, queueIndex) => `import __queue${queueIndex} from ${JSON.stringify(join(queuesDir, queue.filePath))};`).join("\n");
 	const jobTable = jobs.map((job, jobIndex) => `  { crons: ${JSON.stringify(job.crons)}, handler: __job${jobIndex} }`).join(",\n");
 	const queueTable = queues.map((queue, queueIndex) => `  { name: ${JSON.stringify(queue.name)}, handler: __queue${queueIndex} }`).join(",\n");
 	return `// @ts-nocheck — Auto-generated by Void in dev. Do NOT edit. Regenerated on every config load.
@@ -1552,7 +1561,7 @@ function migrationPlugin(root, dialect, databaseId = "local", persistRoot = join
 		name: "void:migrations",
 		apply: "serve",
 		async configureServer(server) {
-			const migrationsDir = join(root, "db", "migrations");
+			const migrationsDir = readProjectPaths(root).migrationsDir;
 			const hasSqlMigrations = existsSync(migrationsDir);
 			if (!hasSqlMigrations && !auth?.enabled) return;
 			try {
@@ -1567,9 +1576,9 @@ function migrationPlugin(root, dialect, databaseId = "local", persistRoot = join
 						else warn();
 						return;
 					}
-					const { runPgMigrations, getPgAppliedMigrations } = await import("./runner-pg-Bd_172vF.mjs");
-					const { collectMigrations } = await import("./collect-HqAuilH6.mjs").then((n) => n.n);
-					const { validateMigrations } = await import("./validate-DW3ViKTA.mjs").then((n) => n.i);
+					const { runPgMigrations, getPgAppliedMigrations } = await import("./runner-pg-BXP0JpHW.mjs");
+					const { collectMigrations } = await import("./collect-9rO3JFNM.mjs").then((n) => n.n);
+					const { validateMigrations } = await import("./validate-CNWm-PsL.mjs").then((n) => n.i);
 					const allMigrations = collectMigrations(migrationsDir);
 					const pgApplied = await getPgAppliedMigrations(url);
 					const pgAppliedSet = new Set(pgApplied);
@@ -1582,9 +1591,9 @@ function migrationPlugin(root, dialect, databaseId = "local", persistRoot = join
 					const applied = await runPgMigrations(migrationsDir, url);
 					if (applied.length > 0) voidLog(`Applied ${applied.length} migration(s): ${applied.join(", ")}`);
 				} else if (hasSqlMigrations) {
-					const { runMigrations, getMiniflareDatabasePath, getAppliedMigrations } = await import("./runner-C0d3lJo1.mjs");
-					const { collectMigrations } = await import("./collect-HqAuilH6.mjs").then((n) => n.n);
-					const { validateMigrations } = await import("./validate-DW3ViKTA.mjs").then((n) => n.i);
+					const { runMigrations, getMiniflareDatabasePath, getAppliedMigrations } = await import("./runner-BkGBfr4e.mjs");
+					const { collectMigrations } = await import("./collect-9rO3JFNM.mjs").then((n) => n.n);
+					const { validateMigrations } = await import("./validate-CNWm-PsL.mjs").then((n) => n.i);
 					const dbPath = getMiniflareDatabasePath(persistRoot, databaseId);
 					const allMigrations = collectMigrations(migrationsDir);
 					const appliedRows = await getAppliedMigrations(dbPath);
@@ -1599,7 +1608,7 @@ function migrationPlugin(root, dialect, databaseId = "local", persistRoot = join
 					if (applied.length > 0) voidLog(`Applied ${applied.length} migration(s): ${applied.join(", ")}`);
 				}
 				if (auth?.enabled) {
-					const { runLocalVoidAuthMigrations } = await import("./node-gxRQXIRT.mjs");
+					const { runLocalVoidAuthMigrations } = await import("./node-fpywdcbN.mjs");
 					await runLocalVoidAuthMigrations(root, dialect, persistRoot, databaseId, auth.configPath);
 					voidLog("Applied Better Auth migrations");
 				}
@@ -1705,7 +1714,7 @@ function nodeTargetPlugin(target) {
 					]
 				}
 			};
-			if (existsSync(join(root, "pages"))) return {
+			if (existsSync(readProjectPaths(root).pagesDir)) return {
 				build: { outDir: "dist/client" },
 				environments: { ssr: { build: ssrBuildOptions } },
 				builder: {}
@@ -2933,6 +2942,7 @@ window.__vite_plugin_react_preamble_installed__ = true;
 	if (options.migrationHandlerPath && (options.migrations?.length || auth)) {
 		lines.push(`import { createMigrationHandler as __createMigrationHandler } from ${JSON.stringify(options.migrationHandlerPath)};`);
 		lines.push(`const __migrations = ${JSON.stringify(options.migrations)};`);
+		lines.push(`const __migrationPlanBundle = ${JSON.stringify(options.migrationPlanBundle)};`);
 		lines.push(`const __migrationDialect = ${JSON.stringify(options.migrationDialect ?? "sqlite")};`);
 		lines.push("app.post(\"/__void/migrate\", async (c) => {");
 		lines.push("  const __voidMigrationHandler = __createMigrationHandler(");
@@ -2944,6 +2954,49 @@ window.__vite_plugin_react_preamble_installed__ = true;
 		lines.push("  );");
 		lines.push("  return __voidMigrationHandler(c.req.raw);");
 		lines.push("});");
+		lines.push("app.get(\"/__void/migrate/capabilities\", async (c) => {");
+		lines.push("  const __voidMigrationHandler = __createMigrationHandler(");
+		lines.push("    __getRawEnv(),");
+		lines.push("    __migrations,");
+		lines.push("    __migrationDialect,");
+		if (auth) lines.push(`    () => runVoidAuthMigrations(new Request(c.req.url), __getRawEnv(), __voidAuthOptions${auth.authSchemaPath ? ", __voidAuthMigrationSchema" : ""}),`);
+		else lines.push("    undefined,");
+		lines.push("    __migrationPlanBundle,");
+		lines.push("  );");
+		lines.push("  return __voidMigrationHandler(c.req.raw);");
+		lines.push("});");
+		lines.push("app.post(\"/__void/migrate/app\", async (c) => {");
+		lines.push("  const __voidMigrationHandler = __createMigrationHandler(");
+		lines.push("    __getRawEnv(),");
+		lines.push("    __migrations,");
+		lines.push("    __migrationDialect,");
+		lines.push("    undefined,");
+		lines.push("    __migrationPlanBundle,");
+		lines.push("  );");
+		lines.push("  return __voidMigrationHandler(c.req.raw);");
+		lines.push("});");
+		lines.push("app.get(\"/__void/migrate/app/attempt/:attemptId\", async (c) => {");
+		lines.push("  const __voidMigrationHandler = __createMigrationHandler(");
+		lines.push("    __getRawEnv(),");
+		lines.push("    __migrations,");
+		lines.push("    __migrationDialect,");
+		lines.push("    undefined,");
+		lines.push("    __migrationPlanBundle,");
+		lines.push("  );");
+		lines.push("  return __voidMigrationHandler(c.req.raw);");
+		lines.push("});");
+		if (auth) {
+			lines.push("app.post(\"/__void/migrate/auth\", async (c) => {");
+			lines.push("  const __voidMigrationHandler = __createMigrationHandler(");
+			lines.push("    __getRawEnv(),");
+			lines.push("    __migrations,");
+			lines.push("    __migrationDialect,");
+			lines.push(`    () => runVoidAuthMigrations(new Request(c.req.url), __getRawEnv(), __voidAuthOptions${auth.authSchemaPath ? ", __voidAuthMigrationSchema" : ""}),`);
+			lines.push("    __migrationPlanBundle,");
+			lines.push("  );");
+			lines.push("  return __voidMigrationHandler(c.req.raw);");
+			lines.push("});");
+		}
 		lines.push("");
 	}
 	if (options.bindingHandlerPath) {
@@ -3398,7 +3451,7 @@ function compileWorkerEntry(hasQueues = false, remote, assetsDir = "assets", web
 	const sandboxClassName = typeof sandbox === "object" ? sandbox.className ?? "Sandbox" : "Sandbox";
 	const sandboxBindingName = typeof sandbox === "object" ? sandbox.bindingName ?? "SANDBOX" : "SANDBOX";
 	const sandboxRuntimePath = typeof sandbox === "object" ? sandbox.runtimePath ?? "void/sandbox" : "void/sandbox";
-	const sandboxImport = hasSandbox ? `import { Sandbox as __VoidSandbox } from "@cloudflare/sandbox";\nimport { __setSandboxBindingName } from ${JSON.stringify(sandboxRuntimePath)};\n` : "";
+	const sandboxImport = hasSandbox ? `import { VoidPlatformSandbox as __VoidSandbox, __setSandboxBindingName } from ${JSON.stringify(sandboxRuntimePath)};\n` : "";
 	const sandboxExport = hasSandbox ? sandboxClassName === "Sandbox" ? `export { __VoidSandbox as Sandbox };\n__setSandboxBindingName(${JSON.stringify(sandboxBindingName)});\n` : `export class ${sandboxClassName} extends __VoidSandbox {}\n__setSandboxBindingName(${JSON.stringify(sandboxBindingName)});\n` : "";
 	const hasLive = live === true || typeof live === "object";
 	const liveBindingName = typeof live === "object" ? live.bindingName ?? "VOID_LIVE" : "VOID_LIVE";
@@ -3434,10 +3487,10 @@ function __filterInternalBindings(env) {
   });
 }
 `;
-	const spaFallbackCode = serveSpaFallback ? `  // SPA fallback: when routes/middleware make assetConfig.not_found_handling
-  // = 'none', the asset binding returns 404 instead of falling back to
-  // index.html itself. Do that fallback here, after user routes/middleware
-  // have run, so auth gates and OAuth callbacks see the request first.
+	const spaFallbackCode = serveSpaFallback ? `  // SPA fallback: when HTML-owning features make
+  // assetConfig.not_found_handling = 'none', the asset binding returns 404
+  // instead of falling back to index.html itself. Do that fallback here, after
+  // user routes/middleware have run, so auth gates and OAuth callbacks see the request first.
   // Pages and SSR apps leave this disabled so intentional HTML 404s stay 404.
   const accept = request.headers.get("accept") ?? "";
   if (accept.includes("text/html")) {
@@ -4013,20 +4066,37 @@ export async function fetch(path, options) {
 const VIRTUAL_ROUTES_ID = "virtual:void-routes";
 const VIRTUAL_CLIENT_WORKER_ID = "virtual:void-client-worker";
 const VIRTUAL_CLIENT_BROWSER_ID = "virtual:void-client-browser";
+const PAGE_VIRTUAL_MODULE_IDS = [
+	"\0virtual:void-pages-renderer",
+	"\0virtual:void-pages-client",
+	"\0virtual:void-islands-renderer",
+	"\0virtual:void-islands-client"
+];
 const RESOLVE_ID_FILTER = /^(virtual:void-(routes|client-worker|client-browser)|void(\/client|\/queues)?)$/;
 const LOAD_ID_FILTER = /^virtual:void-(routes|client-worker|client-browser)$/;
 function routingPlugin(root, options) {
 	let scan = null;
 	let ssr = null;
 	let authConfigPath = null;
-	const routesDir = join(root, "routes");
-	const middlewareDir = join(root, "middleware");
-	const jobsDir = join(root, "crons");
-	const queuesDir = join(root, "queues");
-	const pagesDir = join(root, "pages");
-	const srcDir = join(root, "src");
-	const authConfigDir = root;
-	const ssrEntryAbsPaths = new Set([...SSR_SERVER_ENTRY_RELATIVE_PATHS, ...SSR_CLIENT_ENTRY_RELATIVE_PATHS].map((path) => join(root, path)));
+	const paths = readProjectPaths(root);
+	const routesDir = paths.routesDir;
+	const middlewareDir = paths.middlewareDir;
+	const jobsDir = paths.cronsDir;
+	const queuesDir = paths.queuesDir;
+	const pagesDir = paths.pagesDir;
+	const ssrDir = paths.ssrDir;
+	const authConfigPaths = new Set(paths.authConfigCandidates.map((path) => normalizePath(path)));
+	const envFilePaths = new Set(paths.envFileCandidates.map((path) => normalizePath(path)));
+	const normalizedRoutesDir = normalizePath(routesDir);
+	const normalizedMiddlewareDir = normalizePath(middlewareDir);
+	const normalizedJobsDir = normalizePath(jobsDir);
+	const normalizedQueuesDir = normalizePath(queuesDir);
+	const normalizedPagesDir = normalizePath(pagesDir);
+	const normalizedSsrDir = normalizePath(ssrDir);
+	const ssrEntryAbsPaths = new Set([...SSR_SERVER_ENTRY_RELATIVE_PATHS, ...SSR_CLIENT_ENTRY_RELATIVE_PATHS].map((path) => normalizePath(join(ssrDir, path.split("/").pop()))));
+	function isInDirectory(path, directory) {
+		return path === directory || path.startsWith(directory + "/");
+	}
 	function writeRouteTypes() {
 		if (!scan) return;
 		const { dts } = generateRouteTypes(scan, routesDir, outDir, pagesDir);
@@ -4038,9 +4108,12 @@ function routingPlugin(root, options) {
 		writeFileSync(join(outDir, "queues.d.ts"), dts);
 	}
 	async function rescan() {
-		scan = await scanRoutes(root, { output: options.output });
-		authConfigPath = findVoidAuthConfig(root);
-		const entries = validateSsrEntries(root);
+		scan = await scanRoutes(root, {
+			output: options.output,
+			paths
+		});
+		authConfigPath = findVoidAuthConfig(root, paths);
+		const entries = validateSsrEntries(root, paths);
 		ssr = entries ? {
 			serverEntryPath: entries.server.absolutePath,
 			clientEntryRelativePath: entries.client.relativePath
@@ -4059,7 +4132,7 @@ function routingPlugin(root, options) {
 		envPath: resolveFile("#self/_env")
 	} : void 0;
 	function getEnvSchemaModule() {
-		const envFile = findEnvFile(root);
+		const envFile = findEnvFileForPaths(root, paths);
 		if (!envFile) return;
 		return {
 			importPath: envFile,
@@ -4143,9 +4216,10 @@ function routingPlugin(root, options) {
 		return join(runtimeDir, "auth-client.mjs");
 	}
 	function isPotentialAuthConfigPath(path) {
-		if (!path.startsWith(authConfigDir + "/")) return false;
-		const rel = path.slice(authConfigDir.length + 1);
-		return /^auth\.(c|m)?[jt]s$/.test(rel);
+		return authConfigPaths.has(normalizePath(path));
+	}
+	function isPotentialEnvFilePath(path) {
+		return envFilePaths.has(normalizePath(path));
 	}
 	function getPagesCompileOptions() {
 		if (!scan || scan.pages.pages.length === 0) return null;
@@ -4164,7 +4238,28 @@ function routingPlugin(root, options) {
 		};
 	}
 	function shouldServeSpaFallback() {
-		return !!scan && scan.pages.pages.length === 0 && !ssr && (scan.routes.length > 0 || (scan.websockets?.length ?? 0) > 0 || scan.middleware.length > 0 || compileOptions.auth !== null);
+		if (!scan) return false;
+		return resolveCurrentAssetRoutingPolicy().workerSpaFallback;
+	}
+	function resolveCurrentAssetRoutingPolicy() {
+		if (!scan) return resolveAssetRoutingPolicy({
+			isSsr: Boolean(ssr),
+			hasPages: false,
+			hasDocumentRoutes: false,
+			hasMiddleware: false,
+			hasWebSockets: false,
+			authEnabled: compileOptions.auth !== null,
+			liveEnabled: options.live !== void 0
+		});
+		return resolveAssetRoutingPolicy({
+			isSsr: Boolean(ssr),
+			hasPages: scan.pages.pages.length > 0,
+			hasDocumentRoutes: hasDocumentRoutes(scan.routes),
+			hasMiddleware: scan.middleware.length > 0,
+			hasWebSockets: (scan.websockets?.length ?? 0) > 0,
+			authEnabled: compileOptions.auth !== null,
+			liveEnabled: options.live !== void 0
+		});
 	}
 	const outDir = join(root, ".void");
 	mkdirSync(outDir, { recursive: true });
@@ -4207,7 +4302,7 @@ function routingPlugin(root, options) {
 					return [];
 				}
 			}) } };
-			const entries = validateSsrEntries(root);
+			const entries = validateSsrEntries(root, paths);
 			if (!entries || env.command !== "build") return;
 			return { build: {
 				manifest: true,
@@ -4222,13 +4317,15 @@ function routingPlugin(root, options) {
 			writeRouteTypes();
 			writeQueueTypes();
 			if (!options.target) {
-				const migrationsDir = join(root, "db", "migrations");
+				const migrationsDir = paths.migrationsDir;
 				if (existsSync(migrationsDir) || compileOptions.auth) {
-					const { collectMigrations } = await import("./collect-HqAuilH6.mjs").then((n) => n.n);
+					const { collectMigrations } = await import("./collect-9rO3JFNM.mjs").then((n) => n.n);
+					const { buildMigrationPlanBundle } = await import("./plan-aD3wRDqF.mjs").then((n) => n.i);
 					const migrations = existsSync(migrationsDir) ? collectMigrations(migrationsDir) : [];
 					const dialect = getDatabaseDialect(readConfig(root));
 					compileOptions.migrationHandlerPath = resolveFile(dialect === "postgresql" ? "#self/runtime/migration-handler-pg" : "#self/runtime/migration-handler");
 					compileOptions.migrations = migrations;
+					compileOptions.migrationPlanBundle = dialect === "sqlite" ? buildMigrationPlanBundle(migrations) : void 0;
 					compileOptions.migrationDialect = dialect;
 				}
 			}
@@ -4268,10 +4365,16 @@ function routingPlugin(root, options) {
 		configureServer(devServer) {
 			const watcher = devServer.watcher;
 			const handleFileChange = async (path, event) => {
-				if (!path.startsWith(routesDir) && !path.startsWith(middlewareDir) && !path.startsWith(jobsDir) && !path.startsWith(queuesDir) && !path.startsWith(pagesDir) && !path.startsWith(srcDir) && !isPotentialAuthConfigPath(path)) return;
-				if (path.startsWith(srcDir) && !ssrEntryAbsPaths.has(path)) return;
+				const normalizedPath = normalizePath(path);
+				const sourceConventionChanged = isInDirectory(normalizedPath, normalizedRoutesDir) || isInDirectory(normalizedPath, normalizedMiddlewareDir) || isInDirectory(normalizedPath, normalizedJobsDir) || isInDirectory(normalizedPath, normalizedQueuesDir) || isInDirectory(normalizedPath, normalizedPagesDir) || isPotentialAuthConfigPath(normalizedPath) || isPotentialEnvFilePath(normalizedPath);
+				if (!sourceConventionChanged && !isInDirectory(normalizedPath, normalizedSsrDir) && !isPotentialEnvFilePath(normalizedPath)) return;
+				if (!sourceConventionChanged && isInDirectory(normalizedPath, normalizedSsrDir) && !ssrEntryAbsPaths.has(normalizedPath)) return;
 				await rescan();
 				resolveAuthCompileOptions();
+				if (event !== "change" && options.onDevAssetRoutingPolicyChange?.(resolveCurrentAssetRoutingPolicy()) === true) {
+					await devServer.restart();
+					return;
+				}
 				await writeAuthDatabaseFiles();
 				writeRouteTypes();
 				writeQueueTypes();
@@ -4284,14 +4387,19 @@ function routingPlugin(root, options) {
 					runtimePath: sandboxRuntimePath
 				} : false, shouldServeSpaFallback(), options.live));
 				const structural = event !== "change";
+				const pageManifestChanged = isInDirectory(normalizedPath, normalizedPagesDir) && (structural || normalizedPath.endsWith(".md"));
 				for (const env of Object.values(devServer.environments)) {
+					if (pageManifestChanged) for (const id of PAGE_VIRTUAL_MODULE_IDS) {
+						const pageMod = env.moduleGraph.getModuleById(id);
+						if (pageMod) env.moduleGraph.invalidateModule(pageMod);
+					}
 					const mod = env.moduleGraph.getModuleById(VIRTUAL_ROUTES_ID);
 					if (mod) {
 						env.moduleGraph.invalidateModule(mod);
 						if (structural) env.hot.send({ type: "full-reload" });
 					}
 				}
-				if (/\.island\./.test(path) || path.endsWith(".md")) devServer.environments.client?.hot.send({ type: "full-reload" });
+				if (/\.island\./.test(normalizedPath) || normalizedPath.endsWith(".md")) devServer.environments.client?.hot.send({ type: "full-reload" });
 			};
 			watcher.on("add", (path) => handleFileChange(path, "add"));
 			watcher.on("change", (path) => handleFileChange(path, "change"));
@@ -4565,6 +4673,19 @@ function createDefaultWorkerEnvironmentPlugin() {
 		}
 	};
 }
+function createWorkerEnvironmentSanitizerPlugin(environmentNames) {
+	const names = new Set(environmentNames);
+	return {
+		name: "void:worker-environment-sanitizer",
+		enforce: "pre",
+		configResolved(config) {
+			for (const name of names) {
+				const resolve = config.environments[name]?.resolve;
+				if (resolve && "external" in resolve) resolve.external = [];
+			}
+		}
+	};
+}
 function createSandboxSdkResolvePlugin() {
 	let resolved;
 	return {
@@ -4627,10 +4748,10 @@ const STAGING_API_URL = "https://api.staging.void.cloud";
 * block the server. On completion, writes project.json and restarts the server.
 */
 async function runAiSetupPrompt(root, token, staging, server) {
-	const { select, text, isCancel, log } = await import("./dist-D2L3_KTK.mjs").then((n) => n.p);
-	const { PlatformClient } = await import("./client-C_DYiXeu.mjs").then((n) => n.r);
-	const { writeProjectConfig } = await import("./project-DhB4A8_g.mjs").then((n) => n.n);
-	const { inferDefaultSlug } = await import("./resolve-project-DdjLQ2tB.mjs").then((n) => n.i);
+	const { select, text, isCancel, log } = await import("./dist-abzUneor.mjs").then((n) => n.p);
+	const { PlatformClient } = await import("./client-C-nH6yz3.mjs").then((n) => n.r);
+	const { writeProjectConfig } = await import("./project-CH9pdo16.mjs").then((n) => n.n);
+	const { inferDefaultSlug } = await import("./resolve-project-CNpUbUHd.mjs").then((n) => n.i);
 	const client = new PlatformClient(token, staging ? STAGING_API_URL : DEFAULT_API_URL);
 	let projects;
 	try {
@@ -4656,24 +4777,27 @@ async function runAiSetupPrompt(root, token, staging, server) {
 	let projectId;
 	let slug;
 	if (result === "__create__") {
-		const defaultSlug = inferDefaultSlug(root);
-		const { validateProjectSlug } = await import("./project-slug-KRvHQEQI.mjs").then((n) => n.t);
-		const slugResult = await text({
-			message: "Choose a slug for your new Void project:",
-			placeholder: "my-app",
-			initialValue: defaultSlug,
-			validate: validateProjectSlug
-		});
-		if (isCancel(slugResult)) return;
+		const { validateProjectSlug } = await import("./project-slug-De4UjtD9.mjs").then((n) => n.t);
+		const { createProjectWithSlugRetry } = await import("./create-project-BGnQMy5N.mjs").then((n) => n.t);
+		let created;
 		try {
-			const created = await client.createProject(slugResult.trim());
-			projectId = created.id;
-			slug = created.slug;
+			created = await createProjectWithSlugRetry(client, inferDefaultSlug(root), async (defaultSlug) => {
+				const slugResult = await text({
+					message: "Choose a slug for your new Void project:",
+					placeholder: "my-app",
+					initialValue: defaultSlug,
+					validate: validateProjectSlug
+				});
+				if (isCancel(slugResult)) return;
+				return slugResult.trim();
+			});
 		} catch (err) {
 			voidError(`project: Failed to create project: '${err instanceof Error ? err.message : String(err)}'.`);
 			return;
 		}
-		log.success(`Project created: ${import_picocolors.default.blue(slug)}`);
+		if (!created) return;
+		projectId = created.id;
+		slug = created.slug;
 	} else {
 		const project = projects.find((p) => p.id === result);
 		projectId = project.id;
@@ -4709,18 +4833,23 @@ function voidPlugin(options) {
 	warnIfPackageJsonIsNotEsm(root);
 	const devTriggerToken = isViteBuildOrPreview() ? crypto.randomUUID() : getOrCreateDevTriggerToken(root);
 	const config = readConfig(root);
+	const paths = resolveProjectPaths(root, config);
+	assertNoRootSourceConventionConflicts(paths);
 	const dialect = getDatabaseDialect(config);
 	const detected = detectFramework(root);
 	const framework = detected?.class === "a" ? detected.name : void 0;
 	const scanDirs = config.inference?.scanDirs ?? (detected ? FRAMEWORK_SCAN_DIRS : void 0);
 	const inferenceOptions = config.inference?.bindings ? { bindings: config.inference.bindings } : void 0;
-	const inferredBindings = inferProjectBindings(root, inferenceOptions, scanDirs);
+	const inferredBindings = inferProjectBindings(root, {
+		...inferenceOptions,
+		paths
+	}, scanDirs);
 	const bindings = isSandboxEnabled(config) ? {
 		...inferredBindings,
 		needsSandbox: true
 	} : inferredBindings;
 	const sandboxConfig = bindings.needsSandbox ? resolveSandboxConfig(config, root) : void 0;
-	const authConfigPath = findVoidAuthConfig(root);
+	const authConfigPath = findVoidAuthConfig(root, paths);
 	const authEnabled = bindings.needsAuth || authConfigPath !== null || config.auth !== void 0;
 	if (detected && authEnabled) throw new Error("auth: Void-managed Better Auth is only supported in Void apps. Use Better Auth's official integration for this framework instead.");
 	if (detected && bindings.needsSandbox) throw new Error("sandbox: Cloudflare Sandboxes are currently supported in Void apps only.");
@@ -4733,7 +4862,19 @@ function voidPlugin(options) {
 		"void/queues": "export const queues = {};",
 		"void/storage": "export const storage = {}; export const createStorage = () => ({});",
 		"void/isr": "export const revalidate = async () => {};",
-		"void/sandbox": "export const sandbox = {}; export const getSandbox = () => ({});",
+		"void/sandbox": `
+      export class SandboxLimitError extends Error {
+        constructor(reason = 'concurrency', message) {
+          super(message ?? 'Sandbox limit reached: ' + reason);
+          this.name = 'SandboxLimitError';
+          this.reason = reason;
+        }
+      }
+      export async function getSandbox() {
+        throw new Error('void/sandbox is server-only and cannot be imported by browser code.');
+      }
+      export const sandbox = { get: getSandbox };
+    `,
 		"void/live": ""
 	};
 	const STUB_RESOLVE_FILTER = new RegExp(`^(${Object.keys(SERVER_ONLY_STUBS).join("|").replaceAll("/", "\\/")})$`);
@@ -4757,8 +4898,8 @@ function voidPlugin(options) {
 			}
 		}
 	};
-	const queues = framework ? [] : scanQueuesSync(root);
-	const websocketRoutes = framework ? [] : scanWebSocketRoutesSync(root);
+	const queues = framework ? [] : scanQueuesSync(root, paths.queuesDir);
+	const websocketRoutes = framework ? [] : scanWebSocketRoutesSync(root, paths);
 	const liveConfig = !isNodeTarget(config.target) ? bindings.needsLive ? resolveLiveBindingConfig(root, {
 		reservedBindings: websocketRoutes.map((route) => route.bindingName),
 		reservedClasses: [...websocketRoutes.map((route) => route.className), sandboxConfig?.className]
@@ -4833,6 +4974,7 @@ function voidPlugin(options) {
 	}
 	const remoteMode = resolveRemoteMode(config.remote);
 	const workerConfig = {};
+	if (config.worker?.vars) workerConfig.vars = { ...config.worker.vars };
 	let viteCommand = "build";
 	const wranglerCompat = isNodeTarget(config.target) ? void 0 : readWranglerCompat(root, config);
 	if (wranglerCompat) {
@@ -4846,6 +4988,10 @@ function voidPlugin(options) {
 	mkdirSync(outDir, { recursive: true });
 	function mergeBindings(resolved) {
 		const result = { ...workerConfig };
+		if (workerConfig.assets && resolved.assets) {
+			delete resolved.assets.not_found_handling;
+			delete resolved.assets.run_worker_first;
+		}
 		const d1 = [];
 		if ((bindings.needsD1 || authEnabled && dialect === "sqlite") && !hasBinding(resolved.d1_databases, "DB")) d1.push({
 			binding: "DB",
@@ -5085,6 +5231,7 @@ function voidPlugin(options) {
 		} : void 0;
 		return [
 			createCloudflareBuiltinsExternalPlugin(),
+			createWorkerEnvironmentSanitizerPlugin([viteEnvironment.name, ...viteEnvironment.childEnvironments ?? []]),
 			createWranglerCompatPersistPlugin(root, config),
 			restartPlugin(),
 			bindingWatchPlugin,
@@ -5144,19 +5291,40 @@ function voidPlugin(options) {
 	const existingFlags = workerConfig.compatibility_flags ?? [];
 	const normalizedFlags = normalizeWranglerCompatibilityFlags(existingFlags, { needsNodejsCompat: authEnabled || dialect === "postgresql" || bindings.needsSandbox });
 	if (normalizedFlags && normalizedFlags !== existingFlags) workerConfig.compatibility_flags = normalizedFlags;
-	const jobs = scanJobsSync(root);
-	const ssrEntry = validateSsrEntry(root);
-	const hasPages = existsSync(join(root, "pages"));
+	const jobs = scanJobsSync(root, paths.cronsDir);
+	const ssrEntry = validateSsrEntry(root, paths);
+	const hasPages = existsSync(paths.pagesDir);
+	const hasMiddleware = scanMiddlewareSync(root, paths).length > 0;
+	const hasDocumentRoutes$1 = hasDocumentRoutes(scanRoutePatternsSync(root, paths));
+	let assetRouting = resolveAssetRoutingPolicy({
+		isSsr: Boolean(ssrEntry),
+		hasPages,
+		hasDocumentRoutes: hasDocumentRoutes$1,
+		hasMiddleware,
+		hasWebSockets: websocketRoutes.length > 0,
+		authEnabled,
+		liveEnabled: liveConfig !== void 0
+	});
 	workerConfig.main = join(root, ".void", "entry.ts");
 	if (jobs.length > 0) workerConfig.triggers = { crons: jobs.flatMap((job) => job.crons) };
-	if (ssrEntry || hasPages) workerConfig.assets = {
-		binding: "ASSETS",
-		not_found_handling: "none",
-		run_worker_first: ["/**"]
-	};
+	function applyAssetRoutingPolicy(policy) {
+		workerConfig.assets = {
+			binding: "ASSETS",
+			...policy.assetConfig
+		};
+	}
+	function updateDevAssetRoutingPolicy(next) {
+		const previous = assetRouting;
+		const requiresRestart = previous.workerFirst !== next.workerFirst || previous.assetConfig.not_found_handling !== next.assetConfig.not_found_handling;
+		assetRouting = next;
+		if (requiresRestart) applyAssetRoutingPolicy(next);
+		return requiresRestart;
+	}
+	applyAssetRoutingPolicy(assetRouting);
 	return [
 		createCloudflareBuiltinsExternalPlugin(),
 		createDefaultWorkerEnvironmentPlugin(),
+		createWorkerEnvironmentSanitizerPlugin([DEFAULT_WORKER_ENVIRONMENT_NAME]),
 		createWranglerCompatPersistPlugin(root, config),
 		restartPlugin(),
 		bindingWatchPlugin,
@@ -5178,7 +5346,8 @@ function voidPlugin(options) {
 			hasSandbox: bindings.needsSandbox,
 			sandboxBindingName: sandboxConfig?.binding,
 			sandboxClassName: sandboxConfig?.className,
-			live: liveConfig
+			live: liveConfig,
+			onDevAssetRoutingPolicyChange: updateDevAssetRoutingPolicy
 		}),
 		drizzlePlugin(root, true, dialect, {
 			forceVirtualDb: authEnabled,