@junejs/server 0.1.0-dev.4 → 0.1.0-dev.7

package/dist/rsc-build.js

@@ -0,0 +1,68 @@
+import { walk } from "./island-registry.js";
+import { RSC_CLIENT_MANIFEST_FILE, generateRscManifests } from "./rsc-manifest.js";
+import { bundleServerGraph, bundleSsrGraph } from "./rsc-bundle.js";
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+//#region src/rsc-build.ts
+const RSC_ROUTES_FILE = "_rsc-routes.gen.tsx";
+const RSC_PAGE_RE = /(?:^|\/)page\.rsc\.(tsx|jsx)$/;
+function findRscRoutes(appDir) {
+	if (!existsSync(appDir)) return [];
+	return walk(appDir).filter((f) => RSC_PAGE_RE.test(f)).map((file) => {
+		const dir = dirname(relative(appDir, file));
+		return {
+			path: "/" + (dir === "." ? [] : dir.split("/").filter((s) => !/^\(.*\)$/.test(s))).join("/"),
+			file
+		};
+	}).map((r) => ({
+		...r,
+		path: r.path === "/" ? "/" : r.path.replace(/\/$/, "")
+	})).sort((a, b) => a.path.localeCompare(b.path));
+}
+function runtimeEntry(name) {
+	return join(dirname(new URL(import.meta.url).pathname), "rsc-runtime", name);
+}
+async function buildRsc(appRoot, outDir, docConfig) {
+	const appDir = join(appRoot, "app");
+	const routes = findRscRoutes(appDir);
+	if (routes.length === 0) return null;
+	generateRscManifests(appDir);
+	let routesGen = "// AUTO-GENERATED by June — do not edit. RSC route map.\n";
+	routesGen += "import type React from \"react\";\n";
+	routes.forEach((r, i) => {
+		const rel = "./" + relative(appDir, r.file).replace(/\.(tsx|jsx)$/, "");
+		routesGen += `import V${i} from ${JSON.stringify(rel)};\n`;
+	});
+	routesGen += "export { CLIENT_MANIFEST as clientManifest } from \"./_rsc-server.gen\";\n";
+	routesGen += "export const ROUTES: Record<string, React.ComponentType> = {\n";
+	routes.forEach((r, i) => routesGen += `  ${JSON.stringify(r.path)}: V${i},\n`);
+	routesGen += "};\n";
+	await writeFile(join(appDir, RSC_ROUTES_FILE), routesGen);
+	const configFile = join(appDir, "_rsc-config.gen.ts");
+	await writeFile(configFile, `// AUTO-GENERATED by June — do not edit. RSC document config.
+export const DOC_CONFIG = ${JSON.stringify(docConfig)} as const;\n`);
+	const dest = join(outDir, "rsc");
+	await mkdir(dest, { recursive: true });
+	const serverCode = await bundleServerGraph(runtimeEntry("flight-render-routes.tsx"), appRoot, { "june:rsc-routes": join(appDir, RSC_ROUTES_FILE) }, appDir);
+	await writeFile(join(dest, "server.js"), serverCode);
+	const workerCode = await bundleSsrGraph(runtimeEntry("rsc-worker.tsx"), appRoot, {
+		"june:rsc-client": join(appDir, RSC_CLIENT_MANIFEST_FILE),
+		"june:rsc-config": configFile
+	});
+	await writeFile(join(dest, "worker.js"), workerCode);
+	return {
+		worker: "rsc/worker.js",
+		server: "rsc/server.js",
+		paths: routes.map((r) => r.path)
+	};
+}
+function createRscDispatch(ssrFetch, rscFetch, rscPaths) {
+	const owned = new Set(rscPaths);
+	return (request) => {
+		const path = new URL(request.url).pathname;
+		return owned.has(path) ? rscFetch(request) : ssrFetch(request);
+	};
+}
+//#endregion
+export { buildRsc, createRscDispatch, findRscRoutes };

package/dist/rsc-bundle.d.ts

@@ -0,0 +1,8 @@
+//#region src/rsc-bundle.d.ts
+type RscGraph = "server" | "ssr";
+type RscAliases = Record<string, string>;
+declare function bundleServerGraph(entryFile: string, cwd: string, aliases?: RscAliases, appDir?: string): Promise<string>;
+declare function bundleSsrGraph(entryFile: string, cwd: string, aliases?: RscAliases): Promise<string>;
+declare function referencesNodeBuiltins(code: string): boolean;
+//#endregion
+export { RscAliases, RscGraph, bundleServerGraph, bundleSsrGraph, referencesNodeBuiltins };

package/dist/rsc-bundle.js

@@ -0,0 +1,39 @@
+import { rscClientReferencesPlugin } from "./rsc-manifest.js";
+//#region src/rsc-bundle.ts
+const EDGE_CONDITIONS = [
+	"source",
+	"workerd",
+	"edge-light",
+	"import",
+	"default"
+];
+async function bundleGraph(entryFile, cwd, graph, aliases = {}, plugins = []) {
+	const { rolldown } = await import("rolldown");
+	const conditionNames = graph === "server" ? ["react-server", ...EDGE_CONDITIONS] : EDGE_CONDITIONS;
+	const bundle = await rolldown({
+		input: entryFile,
+		cwd,
+		platform: "neutral",
+		plugins,
+		transform: { define: { "process.env.NODE_ENV": JSON.stringify("production") } },
+		resolve: {
+			conditionNames,
+			...Object.keys(aliases).length ? { alias: aliases } : {}
+		}
+	});
+	const { output } = await bundle.generate({ format: "esm" });
+	await bundle.close();
+	const entry = output.find((o) => o.type === "chunk" && o.isEntry);
+	return entry && entry.type === "chunk" ? entry.code : "";
+}
+function bundleServerGraph(entryFile, cwd, aliases, appDir) {
+	return bundleGraph(entryFile, cwd, "server", aliases, appDir ? [rscClientReferencesPlugin(appDir)] : []);
+}
+function bundleSsrGraph(entryFile, cwd, aliases) {
+	return bundleGraph(entryFile, cwd, "ssr", aliases);
+}
+function referencesNodeBuiltins(code) {
+	return /from\s*["']node:|require\(\s*["']node:/.test(code);
+}
+//#endregion
+export { bundleServerGraph, bundleSsrGraph, referencesNodeBuiltins };

package/dist/rsc-manifest.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from "rolldown";
+//#region src/rsc-manifest.d.ts
+declare const RSC_SERVER_MANIFEST_FILE = "_rsc-server.gen.ts";
+declare const RSC_CLIENT_MANIFEST_FILE = "_rsc-client.gen.ts";
+declare function rscClientReferencesPlugin(appDir: string): Plugin;
+declare function generateRscManifests(appDir: string): number;
+//#endregion
+export { RSC_CLIENT_MANIFEST_FILE, RSC_SERVER_MANIFEST_FILE, generateRscManifests, rscClientReferencesPlugin };

package/dist/rsc-manifest.js

@@ -0,0 +1,67 @@
+import { exportNames, firstStatementIsDirective, walk } from "./island-registry.js";
+import { readFileSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+//#region src/rsc-manifest.ts
+const RSC_SERVER_MANIFEST_FILE = "_rsc-server.gen.ts";
+const RSC_CLIENT_MANIFEST_FILE = "_rsc-client.gen.ts";
+function refId(appDir, absPath, name) {
+	return `${relative(appDir, absPath).replace(/\.(tsx|ts|jsx)$/, "")}#${name}`;
+}
+function clientModules(appDir) {
+	return walk(appDir).filter((f) => /\.(tsx|ts|jsx)$/.test(f) && !f.endsWith("_rsc-server.gen.ts") && !f.endsWith("_rsc-client.gen.ts")).map((abs) => ({
+		abs,
+		src: readFileSync(abs, "utf8")
+	})).filter(({ src }) => firstStatementIsDirective(src, "use client")).map(({ abs, src }) => ({
+		abs,
+		rel: "./" + relative(appDir, abs).replace(/\.(tsx|ts|jsx)$/, ""),
+		names: exportNames(src).filter((n) => n !== "default")
+	})).filter((m) => m.names.length > 0).sort((a, b) => a.rel.localeCompare(b.rel));
+}
+function rscClientReferencesPlugin(appDir) {
+	return {
+		name: "june:rsc-client-references",
+		transform(code, id) {
+			if (!id.startsWith(appDir)) return null;
+			if (!firstStatementIsDirective(code, "use client")) return null;
+			const names = exportNames(code).filter((n) => n !== "default");
+			let out = `import { registerClientReference } from "react-server-dom-webpack/server";\n`;
+			for (const name of names) {
+				const rid = refId(appDir, id, name);
+				out += `export const ${name} = registerClientReference({}, ${JSON.stringify(rid)}, ${JSON.stringify(name)});\n`;
+			}
+			return {
+				code: out,
+				map: null
+			};
+		}
+	};
+}
+function generateRscManifests(appDir) {
+	const mods = clientModules(appDir);
+	let server = "// AUTO-GENERATED by June — do not edit. RSC render manifest.\n";
+	server += "export const CLIENT_MANIFEST: Record<string, { id: string; chunks: string[]; name: string }> = {\n";
+	for (const m of mods) for (const name of m.names) {
+		const rid = `${m.rel.slice(2)}#${name}`;
+		server += `  ${JSON.stringify(rid)}: { id: ${JSON.stringify(rid)}, chunks: [], name: ${JSON.stringify(name)} },\n`;
+	}
+	server += "};\n";
+	writeFileSync(join(appDir, RSC_SERVER_MANIFEST_FILE), server);
+	let client = "// AUTO-GENERATED by June — do not edit. RSC consumer manifest.\n";
+	mods.forEach((m, i) => client += `import * as m${i} from ${JSON.stringify(m.rel)};\n`);
+	client += "\nconst CLIENT_MODULES: Record<string, unknown> = {\n";
+	mods.forEach((m, i) => {
+		for (const name of m.names) client += `  ${JSON.stringify(`${m.rel.slice(2)}#${name}`)}: m${i},\n`;
+	});
+	client += "};\n";
+	client += "export const MODULE_MAP: Record<string, Record<string, { id: string; chunks: string[]; name: string }>> = {\n";
+	for (const m of mods) for (const name of m.names) {
+		const rid = `${m.rel.slice(2)}#${name}`;
+		client += `  ${JSON.stringify(rid)}: { ${JSON.stringify(name)}: { id: ${JSON.stringify(rid)}, chunks: [], name: ${JSON.stringify(name)} } },\n`;
+	}
+	client += "};\n\n";
+	client += "const g = globalThis as Record<string, unknown>;\ng.__webpack_require__ = (id: string) => CLIENT_MODULES[id];\ng.__webpack_chunk_load__ = () => Promise.resolve();\nexport { CLIENT_MODULES };\n";
+	writeFileSync(join(appDir, RSC_CLIENT_MANIFEST_FILE), client);
+	return mods.length;
+}
+//#endregion
+export { RSC_CLIENT_MANIFEST_FILE, RSC_SERVER_MANIFEST_FILE, generateRscManifests, rscClientReferencesPlugin };

package/dist/rsc-runtime/flight-render-routes.d.ts

@@ -0,0 +1,5 @@
+//#region src/rsc-runtime/flight-render-routes.d.ts
+declare function renderFlight(path: string): Promise<string | null>;
+declare function rscPaths(): string[];
+//#endregion
+export { renderFlight, rscPaths };

package/dist/rsc-runtime/flight-render-routes.js

@@ -0,0 +1,26 @@
+import { renderToReadableStream } from "react-server-dom-webpack/server";
+import { ROUTES, clientManifest } from "june:rsc-routes";
+import { jsx } from "@junejs/core/jsx-runtime";
+//#region src/rsc-runtime/flight-render-routes.tsx
+async function streamToString(stream) {
+	const reader = stream.getReader();
+	const dec = new TextDecoder();
+	let out = "";
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		out += dec.decode(value, { stream: true });
+	}
+	out += dec.decode();
+	return out;
+}
+async function renderFlight(path) {
+	const View = ROUTES[path];
+	if (!View) return null;
+	return streamToString(renderToReadableStream(/* @__PURE__ */ jsx(View, {}), clientManifest ?? {}));
+}
+function rscPaths() {
+	return Object.keys(ROUTES);
+}
+//#endregion
+export { renderFlight, rscPaths };

package/dist/rsc-runtime/flight-render.d.ts

@@ -0,0 +1,4 @@
+//#region src/rsc-runtime/flight-render.d.ts
+declare function renderFlight(): Promise<string>;
+//#endregion
+export { renderFlight };

package/dist/rsc-runtime/flight-render.js

@@ -0,0 +1,21 @@
+import { renderToReadableStream } from "react-server-dom-webpack/server";
+import { jsx } from "@junejs/core/jsx-runtime";
+import { App, clientManifest } from "june:app";
+//#region src/rsc-runtime/flight-render.tsx
+async function streamToString(stream) {
+	const reader = stream.getReader();
+	const dec = new TextDecoder();
+	let out = "";
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		out += dec.decode(value, { stream: true });
+	}
+	out += dec.decode();
+	return out;
+}
+async function renderFlight() {
+	return streamToString(renderToReadableStream(/* @__PURE__ */ jsx(App, {}), clientManifest ?? {}));
+}
+//#endregion
+export { renderFlight };

package/dist/rsc-runtime/flight-to-html.d.ts

@@ -0,0 +1,4 @@
+//#region src/rsc-runtime/flight-to-html.d.ts
+declare function flightToHtml(flight: string, moduleMap?: Record<string, unknown>): Promise<string>;
+//#endregion
+export { flightToHtml };

package/dist/rsc-runtime/flight-to-html.js

@@ -0,0 +1,32 @@
+import { use } from "react";
+import { jsx } from "@junejs/core/jsx-runtime";
+import { createFromReadableStream } from "react-server-dom-webpack/client";
+import { renderToReadableStream } from "react-dom/server.edge";
+//#region src/rsc-runtime/flight-to-html.tsx
+function Root({ tree }) {
+	return use(tree);
+}
+async function streamToString(stream) {
+	const reader = stream.getReader();
+	const dec = new TextDecoder();
+	let out = "";
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		out += dec.decode(value, { stream: true });
+	}
+	out += dec.decode();
+	return out;
+}
+async function flightToHtml(flight, moduleMap = {}) {
+	const flightStream = new Response(flight).body;
+	const html = await renderToReadableStream(/* @__PURE__ */ jsx(Root, { tree: createFromReadableStream(flightStream, { serverConsumerManifest: {
+		moduleMap,
+		serverModuleMap: null,
+		moduleLoading: null
+	} }) }));
+	if (typeof html.allReady?.then === "function") await html.allReady;
+	return streamToString(html);
+}
+//#endregion
+export { flightToHtml };

package/dist/rsc-runtime/rsc-worker.d.ts

@@ -0,0 +1,6 @@
+//#region src/rsc-runtime/rsc-worker.d.ts
+declare const _default: {
+  fetch(request: Request): Promise<Response>;
+};
+//#endregion
+export { _default as default };

package/dist/rsc-runtime/rsc-worker.js

@@ -0,0 +1,46 @@
+import { use } from "react";
+import { Document } from "@junejs/core/document";
+import { jsx } from "@junejs/core/jsx-runtime";
+import { createFromReadableStream } from "react-server-dom-webpack/client";
+import { renderToReadableStream } from "react-dom/server.edge";
+import { MODULE_MAP } from "june:rsc-client";
+import { DOC_CONFIG } from "june:rsc-config";
+//#region src/rsc-runtime/rsc-worker.tsx
+function Root({ tree }) {
+	return use(tree);
+}
+async function streamToString(stream) {
+	const reader = stream.getReader();
+	const dec = new TextDecoder();
+	let out = "";
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		out += dec.decode(value, { stream: true });
+	}
+	out += dec.decode();
+	return out;
+}
+async function renderDocument(path) {
+	const flight = await (await import(new URL("./server.js", import.meta.url).href)).renderFlight(path);
+	if (flight === null) return null;
+	const flightStream = new Response(flight).body;
+	const html = await renderToReadableStream(/* @__PURE__ */ jsx(Document, {
+		config: DOC_CONFIG,
+		children: /* @__PURE__ */ jsx(Root, { tree: createFromReadableStream(flightStream, { serverConsumerManifest: {
+			moduleMap: MODULE_MAP,
+			serverModuleMap: null,
+			moduleLoading: null
+		} }) })
+	}));
+	if (typeof html.allReady?.then === "function") await html.allReady;
+	return "<!DOCTYPE html>" + await streamToString(html);
+}
+var rsc_worker_default = { async fetch(request) {
+	const path = new URL(request.url).pathname;
+	const body = await renderDocument(path);
+	if (body === null) return new Response("Not Found", { status: 404 });
+	return new Response(body, { headers: { "content-type": "text/html; charset=utf-8" } });
+} };
+//#endregion
+export { rsc_worker_default as default };

package/dist/rsc-runtime/rsdw-shims.d.ts

@@ -0,0 +1,42 @@
+//#region src/rsc-runtime/rsdw-shims.d.ts
+// Ambient declarations for react-server-dom-webpack (it ships no .d.ts) and the
+// "june:app" virtual the RSC runtime entries import (aliased at bundle time).
+// Minimal — only the surface the runtime entries use.
+declare module "react-server-dom-webpack/server" {
+  export function renderToReadableStream(model: unknown, webpackMap?: unknown, options?: unknown): ReadableStream<Uint8Array>;
+  export function registerClientReference(proxy: object, id: string, exportName: string): unknown;
+  // "use server" — register a server function so it serializes as a server
+  // reference and can be invoked from a decoded client request.
+  export function registerServerReference<F>(fn: F, id: string, exportName: string): F;
+  export function decodeReply(body: string | FormData, serverManifest?: unknown, options?: unknown): Promise<unknown[]>;
+}
+declare module "react-server-dom-webpack/client" {
+  export function createFromReadableStream(stream: ReadableStream<Uint8Array>, options?: unknown): Promise<React.ReactNode> & React.ReactNode;
+  // "use server" client half — encode args for a server-function POST.
+  export function encodeReply(value: unknown): Promise<string | FormData>;
+}
+// The app under render, injected by the build (resolve.alias "june:app" → app).
+declare module "june:app" {
+  import type React from "react";
+  export const App: React.ComponentType;
+  export const clientManifest: Record<string, unknown> | undefined;
+}
+// The generated per-route map (resolve.alias "june:rsc-routes" → _rsc-routes.gen.tsx).
+declare module "june:rsc-routes" {
+  import type React from "react";
+  export const ROUTES: Record<string, React.ComponentType>;
+  export const clientManifest: Record<string, unknown> | undefined;
+}
+// The generated consumer manifest (resolve.alias "june:rsc-client" → app/_rsc-client.gen.ts).
+declare module "june:rsc-client" {
+  export const MODULE_MAP: Record<string, Record<string, {
+    id: string;
+    chunks: string[];
+    name: string;
+  }>>;
+}
+// The frozen document config (resolve.alias "june:rsc-config" → generated).
+declare module "june:rsc-config" {
+  import type { DocumentConfig } from "@junejs/core/document";
+  export const DOC_CONFIG: DocumentConfig;
+}

package/dist/segment.d.ts

@@ -0,0 +1,14 @@
+//#region src/segment.d.ts
+declare const boundaryWarning: (file: string) => string;
+declare function boundaryKey(file: string): string;
+declare function resolveBoundary<C>(items: Array<{
+  file: string;
+  entry: C | null;
+  boundary: boolean;
+}>): {
+  chain: C[];
+  boundaryIndex: number | null;
+  key: string | null;
+};
+//#endregion
+export { boundaryKey, boundaryWarning, resolveBoundary };

package/dist/segment.js

@@ -0,0 +1,33 @@
+import { createHash } from "node:crypto";
+//#region src/segment.ts
+const boundaryWarning = (file) => `[june] multiple segmentBoundary layouts in one chain (${file}); using the deepest.`;
+const keyCache = /* @__PURE__ */ new Map();
+function boundaryKey(file) {
+	let key = keyCache.get(file);
+	if (key === void 0) {
+		key = createHash("sha256").update(file).digest("hex").slice(0, 16);
+		keyCache.set(file, key);
+	}
+	return key;
+}
+function resolveBoundary(items) {
+	const chain = [];
+	let boundaryIndex = null;
+	let boundaryFile = null;
+	for (const it of items) {
+		if (it.entry == null) continue;
+		if (it.boundary) {
+			if (boundaryIndex !== null) console.warn(boundaryWarning(it.file));
+			boundaryIndex = chain.length;
+			boundaryFile = it.file;
+		}
+		chain.push(it.entry);
+	}
+	return {
+		chain,
+		boundaryIndex,
+		key: boundaryFile === null ? null : boundaryKey(boundaryFile)
+	};
+}
+//#endregion
+export { boundaryKey, boundaryWarning, resolveBoundary };

package/dist/sqlite-driver.d.ts

@@ -0,0 +1,25 @@
+import { JuneDb } from "@junejs/core/resources";
+//#region src/sqlite-driver.d.ts
+type SyncStatement = {
+  all(...params: unknown[]): unknown[];
+  get(...params: unknown[]): unknown;
+  run(...params: unknown[]): {
+    changes: number | bigint;
+    lastInsertRowid?: number | bigint;
+  };
+};
+type SyncSqlite = {
+  query(sql: string): SyncStatement;
+  exec(sql: string): void;
+  close(): void;
+};
+declare const NODE_SQLITE_MIN_LTS = "22.13.0";
+declare const NODE_SQLITE_MIN_ODD = "23.4.0";
+declare function nodeSqliteHelp(nodeVersion: string): string;
+declare function isNodeSqliteExperimentalWarning(type: unknown, message: string): boolean;
+type EmitWarning = (warning: string | Error, ...rest: unknown[]) => void;
+declare function makeWarningFilter(original: EmitWarning): EmitWarning;
+declare function openLocalSqliteSync(path: string): Promise<SyncSqlite>;
+declare function openLocalSqlite(path: string): Promise<JuneDb>;
+//#endregion
+export { NODE_SQLITE_MIN_LTS, NODE_SQLITE_MIN_ODD, SyncSqlite, SyncStatement, isNodeSqliteExperimentalWarning, makeWarningFilter, nodeSqliteHelp, openLocalSqlite, openLocalSqliteSync };

package/dist/sqlite-driver.js

@@ -0,0 +1,102 @@
+//#region src/sqlite-driver.ts
+const NODE_SQLITE_MIN_LTS = "22.13.0";
+const NODE_SQLITE_MIN_ODD = "23.4.0";
+function asyncSqlite(db) {
+	const stmts = /* @__PURE__ */ new Map();
+	const prep = (sql) => {
+		let s = stmts.get(sql);
+		if (!s) {
+			s = db.query(sql);
+			stmts.set(sql, s);
+		}
+		return s;
+	};
+	const self = {
+		dialect: "sqlite",
+		async query(sql, params = []) {
+			return prep(sql).all(...params);
+		},
+		async get(sql, params = []) {
+			return prep(sql).get(...params) ?? void 0;
+		},
+		async run(sql, params = []) {
+			const r = prep(sql).run(...params);
+			return {
+				changes: Number(r.changes),
+				lastInsertRowid: r.lastInsertRowid ?? 0
+			};
+		},
+		async exec(sql) {
+			db.exec(sql);
+		},
+		async transaction(fn) {
+			db.exec("BEGIN");
+			try {
+				const out = await fn(self);
+				db.exec("COMMIT");
+				return out;
+			} catch (e) {
+				db.exec("ROLLBACK");
+				throw e;
+			}
+		},
+		async close() {
+			stmts.clear();
+			db.close();
+		}
+	};
+	return self;
+}
+function nodeSqliteHelp(nodeVersion) {
+	return [
+		`June's local database needs Node's built-in sqlite (node:sqlite), which this`,
+		`runtime can't load. You're on Node v${nodeVersion}.`,
+		``,
+		`node:sqlite is available without a flag in Node >= ${NODE_SQLITE_MIN_LTS} (LTS) or`,
+		`>= ${NODE_SQLITE_MIN_ODD}. Node 22.5–22.12 / 23.0–23.3 have it behind`,
+		`--experimental-sqlite, and older Node doesn't ship it at all.`,
+		``,
+		`Fix it one of two ways:`,
+		`  • Upgrade Node to ${NODE_SQLITE_MIN_LTS}+ (recommended), or`,
+		`  • Run June with Bun — bun:sqlite is built in, no flag, no version floor.`
+	].join("\n");
+}
+function isNodeSqliteExperimentalWarning(type, message) {
+	return type === "ExperimentalWarning" && /sqlite/i.test(message);
+}
+function makeWarningFilter(original) {
+	return (warning, ...rest) => {
+		const message = typeof warning === "string" ? warning : warning?.message ?? "";
+		const first = rest[0];
+		if (isNodeSqliteExperimentalWarning(typeof first === "string" ? first : first?.type, message)) return;
+		original(warning, ...rest);
+	};
+}
+async function openLocalSqliteSync(path) {
+	if (typeof Bun !== "undefined") {
+		const { Database } = await import("bun:sqlite");
+		return new Database(path, { create: true });
+	}
+	const specifier = "node:sqlite";
+	let mod;
+	const originalEmitWarning = process.emitWarning;
+	process.emitWarning = makeWarningFilter(originalEmitWarning.bind(process));
+	try {
+		mod = await import(specifier);
+	} catch (cause) {
+		throw new Error(nodeSqliteHelp(process.versions.node), { cause });
+	} finally {
+		process.emitWarning = originalEmitWarning;
+	}
+	const db = new mod.DatabaseSync(path);
+	return {
+		query: (sql) => db.prepare(sql),
+		exec: (sql) => db.exec(sql),
+		close: () => db.close()
+	};
+}
+async function openLocalSqlite(path) {
+	return asyncSqlite(await openLocalSqliteSync(path));
+}
+//#endregion
+export { NODE_SQLITE_MIN_LTS, NODE_SQLITE_MIN_ODD, isNodeSqliteExperimentalWarning, makeWarningFilter, nodeSqliteHelp, openLocalSqlite, openLocalSqliteSync };

package/dist/static-files.d.ts

@@ -0,0 +1,6 @@
+//#region src/static-files.d.ts
+declare const RESERVED_PREFIX = "_june";
+declare function contentTypeFor(pathname: string): string;
+declare function safeRelativePath(pathname: string): string | null;
+//#endregion
+export { RESERVED_PREFIX, contentTypeFor, safeRelativePath };

package/dist/static-files.js

@@ -0,0 +1,56 @@
+//#region src/static-files.ts
+const RESERVED_PREFIX = "_june";
+const CONTENT_TYPES = {
+	html: "text/html; charset=utf-8",
+	css: "text/css; charset=utf-8",
+	js: "text/javascript; charset=utf-8",
+	mjs: "text/javascript; charset=utf-8",
+	json: "application/json; charset=utf-8",
+	map: "application/json; charset=utf-8",
+	xml: "application/xml; charset=utf-8",
+	txt: "text/plain; charset=utf-8",
+	md: "text/markdown; charset=utf-8",
+	csv: "text/csv; charset=utf-8",
+	webmanifest: "application/manifest+json",
+	svg: "image/svg+xml",
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+	avif: "image/avif",
+	ico: "image/x-icon",
+	bmp: "image/bmp",
+	woff2: "font/woff2",
+	woff: "font/woff",
+	ttf: "font/ttf",
+	otf: "font/otf",
+	mp4: "video/mp4",
+	webm: "video/webm",
+	mp3: "audio/mpeg",
+	ogg: "audio/ogg",
+	wav: "audio/wav",
+	wasm: "application/wasm",
+	pdf: "application/pdf",
+	zip: "application/zip"
+};
+function contentTypeFor(pathname) {
+	const dot = pathname.lastIndexOf(".");
+	if (dot === -1) return "application/octet-stream";
+	return CONTENT_TYPES[pathname.slice(dot + 1).toLowerCase()] ?? "application/octet-stream";
+}
+function safeRelativePath(pathname) {
+	let decoded;
+	try {
+		decoded = decodeURIComponent(pathname);
+	} catch {
+		return null;
+	}
+	if (decoded.includes("\0") || decoded.includes("\\")) return null;
+	const segments = decoded.split("/").filter((s) => s !== "" && s !== ".");
+	if (segments.length === 0) return null;
+	if (segments.some((s) => s === "..")) return null;
+	return segments.join("/");
+}
+//#endregion
+export { RESERVED_PREFIX, contentTypeFor, safeRelativePath };

package/dist/tsconfig-jsx.d.ts

@@ -0,0 +1,15 @@
+//#region src/tsconfig-jsx.d.ts
+/** Read the app's tsconfig.json and return compilerOptions.jsxImportSource.
+ *  Follows one level of `extends` so apps that inherit from a base tsconfig
+ *  (e.g. "@kurajs/docs/tsconfig.kura.json") are handled correctly.
+ *  Returns undefined when absent or unreadable. */
+declare function appJsxImportSource(appRoot: string): Promise<string | undefined>;
+/** The transform.jsx both bundles use: June's island JSX runtime, with the explicit importSource
+ *  skipped when the app's tsconfig already declares it — rolldown then reads it from tsconfig
+ *  silently instead of warning about the (same-value) override. */
+declare function jsxTransform(appRoot: string): Promise<{
+  runtime: "automatic";
+  importSource?: string;
+}>;
+//#endregion
+export { appJsxImportSource, jsxTransform };