@junejs/server 0.1.0-dev.5 → 0.1.0

package/dist/adapter.d.ts

@@ -23,6 +23,7 @@ type AdapterEmitContext = {
   config: JuneConfig;
   plan: ResourcePlan;
   defaultName: string;
+  publicFiles?: string[];
 };
 interface JuneAdapter {
   readonly name: string;

package/dist/adapter.js

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import { copyFile, cp, mkdir, readdir, rm, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 //#region src/adapter.ts
 function workers(opts) {
 	return {
@@ -78,7 +78,7 @@ function vercel(opts) {
 				wrap: (pipelineVar) => isEdge ? env + `export default (request) => ${pipelineVar}.fetch(request, __env);` : env + `export default { fetch: (request) => ${pipelineVar}.fetch(request, __env) };`
 			};
 		},
-		async emit({ appRoot, outDir, hasAssets }) {
+		async emit({ appRoot, outDir, hasAssets, publicFiles }) {
 			const out = join(appRoot, ".vercel", "output");
 			const fnDir = join(out, "functions", `${VERCEL_FUNCTION}.func`);
 			await rm(out, {
@@ -106,6 +106,13 @@ function vercel(opts) {
 				const src = join(outDir, "assets", "_june");
 				if (existsSync(src)) await cp(src, join(out, "static", "_june"), { recursive: true });
 			}
+			for (const rel of publicFiles ?? []) {
+				const from = join(outDir, "assets", rel);
+				if (!existsSync(from)) continue;
+				const to = join(out, "static", rel);
+				await mkdir(dirname(to), { recursive: true });
+				await copyFile(from, to);
+			}
 			await writeFile(join(out, "config.json"), JSON.stringify({
 				version: 3,
 				routes: [

package/dist/agent-discover.js

@@ -2,7 +2,7 @@ import { existsSync } from "node:fs";
 import { readFile, readdir } from "node:fs/promises";
 import { basename, extname, join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { defineAgent } from "@junejs/core/agent-config";
+import { defineAgent, resolveChannel } from "@junejs/core/agent-config";
 import { connectAll } from "@junejs/core/connections";
 //#region src/agent-discover.ts
 async function scan(dir, ext) {
@@ -48,7 +48,7 @@ async function discoverAgent(dir) {
 	const channels = [];
 	for (const f of await scan(join(dir, "channels"), ".ts")) {
 		const mod = await import(pathToFileURL(f).href);
-		if (mod.default) channels.push(mod.default);
+		if (mod.default) channels.push(resolveChannel(mod.default, process.env));
 	}
 	const connectionDefs = [];
 	for (const f of await scan(join(dir, "connections"), ".ts")) {

package/dist/agent-durable.d.ts

@@ -1,4 +1,6 @@
+import { Channel, ChannelFactory } from "@junejs/core/agent-config";
 import { Model, Msg, SessionStore, Tool } from "@junejs/core/agent-runtime";
+import { Resources } from "@junejs/core/resources";
 //#region src/agent-durable.d.ts
 interface SqlStorageCursor<T = Record<string, unknown>> {
   toArray(): T[];
@@ -40,9 +42,13 @@ type DoAgentDef = {
   model: Model;
   tools: Tool[];
   instructions?: string;
+  resources?: Resources;
+  services?: unknown;
 };
 declare class AgentDurableObject {
   private session;
+  private readonly resources;
+  private readonly services;
   constructor(state: DurableObjectState, def: DoAgentDef);
   turn(input: {
     turnId?: string;
@@ -56,5 +62,11 @@ declare function durableAgentSurface(getNamespace: () => DurableObjectNamespace
   agentName: string;
   chatPath?: string;
 }): (req: Request) => Promise<Response | null>;
+declare function durableChannelSurface(getNamespace: () => DurableObjectNamespace | undefined, opts: {
+  agentName: string;
+  channels: (Channel | ChannelFactory)[];
+  env: unknown;
+  waitUntil?: (p: Promise<unknown>) => void;
+}): (req: Request) => Promise<Response | null>;
 //#endregion
-export { AgentDurableObject, DoAgentDef, DoSessionStore, DurableObjectNamespace, DurableObjectState, DurableObjectStub, DurableStorage, SqlStorage, SqlStorageCursor, durableAgentSurface, durableFetch };
+export { AgentDurableObject, DoAgentDef, DoSessionStore, DurableObjectNamespace, DurableObjectState, DurableObjectStub, DurableStorage, SqlStorage, SqlStorageCursor, durableAgentSurface, durableChannelSurface, durableFetch };

package/dist/agent-durable.js

@@ -1,4 +1,6 @@
+import { channelDispatch, resolveChannel } from "@junejs/core/agent-config";
 import { AgentSession, withSystem } from "@junejs/core/agent-runtime";
+import { ensureScope, runInScope } from "@junejs/db";
 //#region src/agent-durable.ts
 var DoSessionStore = class {
 	storage;
@@ -61,13 +63,21 @@ const crossDoUnsupported = { session() {
 } };
 var AgentDurableObject = class {
 	session;
+	resources;
+	services;
 	constructor(state, def) {
 		const store = new DoSessionStore(state.storage);
 		const model = def.instructions ? withSystem(def.model, def.instructions) : def.model;
+		this.resources = def.resources ?? {};
+		this.services = def.services;
 		this.session = new AgentSession(def.name ?? "agent", "self", store, new InProcBroadcaster(), model, def.tools, crossDoUnsupported);
 	}
-	turn(input) {
-		return this.session.turn(input);
+	async turn(input) {
+		await ensureScope();
+		return runInScope({
+			resources: this.resources,
+			services: this.services
+		}, () => this.session.turn(input));
 	}
 	transcript() {
 		return this.session.transcript();
@@ -102,5 +112,30 @@ function durableAgentSurface(getNamespace, opts) {
 		}));
 	};
 }
+function durableChannelSurface(getNamespace, opts) {
+	return channelDispatch(opts.channels.map((c) => resolveChannel(c, opts.env)), {
+		agent: {
+			name: opts.agentName,
+			instructions: "",
+			tools: [],
+			skills: [],
+			channels: [],
+			connections: []
+		},
+		waitUntil: opts.waitUntil,
+		run: async (message, o) => {
+			const namespace = getNamespace();
+			if (!namespace) throw new Error("durableChannelSurface: no Durable Object namespace bound (env.AGENT)");
+			const { text } = await (await durableFetch(namespace, opts.agentName, o?.session ?? "default", new Request("https://do/turn", {
+				method: "POST",
+				body: JSON.stringify({
+					userText: message,
+					turnId: o?.turnId
+				})
+			}))).json();
+			return text;
+		}
+	});
+}
 //#endregion
-export { AgentDurableObject, DoSessionStore, durableAgentSurface, durableFetch };
+export { AgentDurableObject, DoSessionStore, durableAgentSurface, durableChannelSurface, durableFetch };

package/dist/app.js

@@ -8,7 +8,9 @@ import { MODULE_STYLES_URL, buildModuleCss, registerCssModules } from "./css-mod
 import { CLIENT_SCRIPT_URL, bundleClientSplit, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
 import { STYLES_URL, findGlobalCss, globalCssUsesTailwind, processCssCached } from "./css.js";
-import { existsSync } from "node:fs";
+import { contentTypeFor, safeRelativePath } from "./static-files.js";
+import { existsSync, lstatSync, realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { buildSystemPrompt } from "@junejs/core/agent-config";
@@ -62,6 +64,11 @@ function createApp({ appDir: appDirInput, config = {} }) {
 	const appDir = resolve(appDirInput);
 	const juneRoutesDir = join(dirname(appDir), ".june", "routes");
 	const hasJuneRoutes = existsSync(juneRoutesDir);
+	const publicDir = join(dirname(appDir), "public");
+	let publicRoot = null;
+	try {
+		if (lstatSync(publicDir).isDirectory()) publicRoot = realpathSync(publicDir);
+	} catch {}
 	const agent = resolveAgent(config.agent);
 	const speculation = config.speculation;
 	const clientEntry = findClientEntry(appDir) ?? findClientEntry(join(dirname(appDir), ".june", "routes"));
@@ -91,6 +98,8 @@ function createApp({ appDir: appDirInput, config = {} }) {
 		return [...own, ...gen].sort();
 	};
 	const resources = memoizeResources(config.resources);
+	let servicesCache;
+	const services = config.services ? () => (servicesCache ??= { v: config.services.make(process.env) }).v : void 0;
 	config.dataLayer?.install();
 	let pipelinePromise;
 	const getPipeline = () => pipelinePromise ??= buildPipeline();
@@ -136,6 +145,7 @@ function createApp({ appDir: appDirInput, config = {} }) {
 			routeList: routePaths,
 			earlyHints: config.earlyHints,
 			resources,
+			services,
 			notFoundComponent,
 			resolve: async (pathname) => {
 				const match = await matchRouteTree(appDir, pathname, { pageConvention: true }) ?? (hasJuneRoutes ? await matchRouteTree(juneRoutesDir, pathname, { pageConvention: true }) : null);
@@ -201,7 +211,34 @@ function createApp({ appDir: appDirInput, config = {} }) {
 					});
 				}
 			}
-			return runWithTrace(newTrace(), async () => (await getPipeline()).fetch(request));
+			const toPipeline = () => runWithTrace(newTrace(), async () => (await getPipeline()).fetch(request));
+			if (publicRoot !== null && (request.method === "GET" || request.method === "HEAD")) {
+				const rel = safeRelativePath(new URL(request.url).pathname);
+				if (rel !== null && rel.split("/")[0] !== "_june") {
+					const segments = rel.split("/");
+					const file = join(publicRoot, ...segments);
+					let stat;
+					try {
+						stat = lstatSync(file);
+					} catch {}
+					let real = null;
+					if (stat?.isFile()) try {
+						real = realpathSync(file);
+					} catch {}
+					if (real === file) {
+						const headers = {
+							"content-type": contentTypeFor(rel),
+							"cache-control": "public, max-age=0, must-revalidate"
+						};
+						if (request.method === "HEAD") return Promise.resolve(new Response(null, { headers: {
+							...headers,
+							"content-length": String(stat.size)
+						} }));
+						return readFile(file).then((buf) => new Response(buf, { headers }), () => toPipeline());
+					}
+				}
+			}
+			return toPipeline();
 		},
 		async warmup() {
 			const files = await routeFiles(appDir, { pageConvention: true });

package/dist/build.js

@@ -6,12 +6,13 @@ import { jsxTransform } from "./tsconfig-jsx.js";
 import { CLIENT_SCRIPT_URL, bundleClientToFile, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
 import { STYLES_URL, cssTargets, findGlobalCss, globalCssUsesTailwind, minifyCss, processCss } from "./css.js";
+import { RESERVED_PREFIX } from "./static-files.js";
 import { findJuneConfigPath, loadJuneConfig } from "./config-loader.js";
 import { generateContentModule } from "./content.js";
 import { createWorker } from "./worker.js";
 import { buildRsc, findRscRoutes } from "./rsc-build.js";
-import { existsSync } from "node:fs";
-import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { existsSync, lstatSync } from "node:fs";
+import { copyFile, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 import { routeFromModule } from "@junejs/core/route";
@@ -279,6 +280,15 @@ function importPath(fromDir, file) {
 	const p = relative(fromDir, file).split(sep).join("/").replace(/\.[^.]+$/, "");
 	return p.startsWith(".") ? p : `./${p}`;
 }
+async function collectFiles(dir, base = dir) {
+	const out = [];
+	for (const entry of await readdir(dir, { withFileTypes: true })) {
+		const abs = join(dir, entry.name);
+		if (entry.isDirectory()) out.push(...await collectFiles(abs, base));
+		else if (entry.isFile()) out.push(relative(base, abs).split(sep).join("/"));
+	}
+	return out;
+}
 async function juneBuild(appRoot, options = {}) {
 	const appDir = join(appRoot, "app");
 	if (!existsSync(appDir)) throw new Error(`no app/ directory in ${appRoot} — is this a June app?`);
@@ -401,6 +411,12 @@ async function juneBuild(appRoot, options = {}) {
 	const dataLayerModule = fullConfig.dataLayer?.module;
 	if (dataLayerModule) imports.push(`import { installDataLayer } from ${JSON.stringify(dataLayerModule)};`);
 	const dataLayerBoot = dataLayerModule ? "\ninstallDataLayer();\n" : "";
+	const servicesModule = fullConfig.services?.module;
+	if (servicesModule) {
+		const spec = /^[./]/.test(servicesModule) ? importPath(genDir, resolve(appRoot, servicesModule)) : servicesModule;
+		imports.push(`import { services as __appServices } from ${JSON.stringify(spec)};`);
+	}
+	const servicesField = servicesModule ? `\n  services: __appServices,` : "";
 	const entry = `// AUTO-GENERATED by \`june build\` — do not edit. Regenerate: june build .
 ${adapterEntry.imports.join("\n")}
 ${imports.join("\n")}
@@ -420,7 +436,7 @@ ${loadings.join("\n")}
   },
   document: ${JSON.stringify(frozen.document, null, 2).replace(/\n/g, "\n  ")},
   agent: ${JSON.stringify(frozen.agent)},${frozen.i18n ? `\n  i18n: ${JSON.stringify(frozen.i18n)},` : ""}
-  earlyHints: ${JSON.stringify(frozen.earlyHints)},${builtExtraFile ? "\n  extra," : ""}${resourcesField}
+  earlyHints: ${JSON.stringify(frozen.earlyHints)},${builtExtraFile ? "\n  extra," : ""}${resourcesField}${servicesField}
 });
 
 ${adapterEntry.wrap("pipeline")}
@@ -459,6 +475,26 @@ ${adapterEntry.wrap("pipeline")}
 	if (moduleCssAsset) manifest.document.moduleStyles = `/${moduleCssAsset}`;
 	const worker = createWorker(manifest);
 	let hasAssets = false;
+	const publicDir = join(appRoot, "public");
+	const publicFiles = [];
+	let publicIsDir = false;
+	try {
+		publicIsDir = lstatSync(publicDir).isDirectory();
+	} catch {}
+	if (existsSync(publicDir) && !publicIsDir) console.warn(`[june] public/ is not a real directory (symlink?) — skipped`);
+	if (publicIsDir) {
+		for (const rel of await collectFiles(publicDir)) {
+			if (rel.split("/")[0] === "_june") {
+				console.warn(`[june] public/${rel} ignored — ${RESERVED_PREFIX}/ is reserved for framework assets`);
+				continue;
+			}
+			const dest = join(assetsDir, rel);
+			await mkdir(dirname(dest), { recursive: true });
+			await copyFile(join(publicDir, ...rel.split("/")), dest);
+			publicFiles.push(rel);
+		}
+		if (publicFiles.length) hasAssets = true;
+	}
 	const isStatic = adapter.capabilities.runtime === "static";
 	const i18n = frozen.i18n;
 	const prerenderOne = async (reqPath, def) => {
@@ -536,7 +572,8 @@ ${adapterEntry.wrap("pipeline")}
 		linkHeader,
 		config: fullConfig,
 		plan,
-		defaultName
+		defaultName,
+		publicFiles
 	});
 	if (plan.db) console.log(`  ↳ d1 binding "${plan.db.binding}" emitted — set database_id in wrangler.jsonc (wrangler d1 create ${plan.db.databaseName})`);
 	return {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AdapterCapabilities, AdapterEmitContext, AdapterEntry, JuneAdapter, ResourcePlan, deno, staticSite, vercel, workers } from "./adapter.js";
 import { CreateAppOptions, JuneApp, createApp } from "./app.js";
 import { R2Bucket, localBlob, r2 } from "./blob.js";
-import { a as Pipeline, d as createPipeline, n as LayoutComponent, o as PipelineConfig, s as Resolved, u as RouteResolver } from "./pipeline-B2V6tKfO.js";
+import { a as Pipeline, d as createPipeline, n as LayoutComponent, o as PipelineConfig, s as Resolved, u as RouteResolver } from "./pipeline-CCp9idQ4.js";
 import { WorkerManifest, createWorker } from "./worker.js";
 import { BuildResult, buildManifest, freezeConfig, generateContent, juneBuild, scanRoutes } from "./build.js";
 import { loadJuneConfig } from "./config-loader.js";
@@ -21,6 +21,7 @@ import { ResourceFlags, WorkerEnv, bindWorkerResources, memoizeResources } from
 import { MatchOptions, RouteMatch, RouteTreeMatch, SegmentMatch, listRoutes, matchRoute, matchRouteTree, resolveNotFound } from "./router.js";
 import { installAsyncContext } from "./instrumentation.js";
 import { Negotiated, negotiate } from "./negotiate.js";
-import { blob, db, kv } from "@junejs/db";
+import { blob, currentServices, db, kv } from "@junejs/db";
+import { ServicesConfig, defineServices } from "@junejs/core/config";
 import { I18nConfig, LOCALE_COOKIE, LocaleConfig, LocaleMatch, dirForLang, localeDir, localeHref, matchPinnedLocale, negotiateLocale, parseAcceptLanguage, resolveRequestLocale } from "@junejs/core/i18n";
-export { type AdapterCapabilities, type AdapterEmitContext, type AdapterEntry, type BuildResult, type ContentEntry, type CreateAppOptions, type D1Database, type D1Exec, type DeployResult, type DevServer, type DevServerOptions, type I18nConfig, type JuneAdapter, type JuneApp, type JuneDb, type JuneHost, LOCALE_COOKIE, type LayoutComponent, type LocaleConfig, type LocaleMatch, type MatchOptions, type MigrateResult, type Migration, type Negotiated, type Pipeline, type PipelineConfig, type R2Bucket, type Resolved, type ResourceFlags, type ResourcePlan, type RouteMatch, type RouteResolver, type RouteTreeMatch, type RunResult, type SegmentMatch, type ServeHandle, type SpawnedModule, type WorkerEnv, type WorkerManifest, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, d1, db, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };
+export { type AdapterCapabilities, type AdapterEmitContext, type AdapterEntry, type BuildResult, type ContentEntry, type CreateAppOptions, type D1Database, type D1Exec, type DeployResult, type DevServer, type DevServerOptions, type I18nConfig, type JuneAdapter, type JuneApp, type JuneDb, type JuneHost, LOCALE_COOKIE, type LayoutComponent, type LocaleConfig, type LocaleMatch, type MatchOptions, type MigrateResult, type Migration, type Negotiated, type Pipeline, type PipelineConfig, type R2Bucket, type Resolved, type ResourceFlags, type ResourcePlan, type RouteMatch, type RouteResolver, type RouteTreeMatch, type RunResult, type SegmentMatch, type ServeHandle, type ServicesConfig, type SpawnedModule, type WorkerEnv, type WorkerManifest, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };

package/dist/index.js

@@ -21,6 +21,7 @@ import { installAsyncContext } from "./instrumentation.js";
 import { host } from "./host.js";
 import { startDevServer } from "./dev.js";
 import { memoryKv, redisKv } from "./kv.js";
-import { blob, db, kv } from "@junejs/db";
+import { blob, currentServices, db, kv } from "@junejs/db";
+import { defineServices } from "@junejs/core/config";
 import { LOCALE_COOKIE, dirForLang, localeDir, localeHref, matchPinnedLocale, negotiateLocale, parseAcceptLanguage, resolveRequestLocale } from "@junejs/core/i18n";
-export { LOCALE_COOKIE, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, d1, db, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };
+export { LOCALE_COOKIE, bindWorkerResources, blob, blockedMessage, buildManifest, classify, collection, createApp, createPipeline, createWorker, currentServices, d1, db, defineServices, deno, dirForLang, entry, freezeConfig, generateContent, host, installAsyncContext, juneBuild, juneDeploy, kv, listRoutes, loadJuneConfig, localBlob, localeDir, localeHref, matchPinnedLocale, matchRoute, matchRouteTree, memoizeResources, memoryKv, migrate, migrateApp, migrateD1, mysql, negotiate, negotiateLocale, parseAcceptLanguage, postgres, r2, readMigrations, redisKv, resolveD1Database, resolveNotFound, resolveRequestLocale, scanRoutes, sqlite, startDevServer, staticSite, turso, typesApp, vercel, workers, wranglerD1 };

package/dist/{pipeline-B2V6tKfO.d.ts → pipeline-CCp9idQ4.d.ts}

@@ -31,6 +31,7 @@ type PipelineConfig = {
   routeList: () => Promise<string[]> | string[];
   resolve: RouteResolver;
   resources?: () => Promise<Resources> | Resources;
+  services?: () => Promise<unknown> | unknown;
   earlyHints?: string[];
   htmlCacheControl?: string;
   notFoundComponent?: React.ComponentType<{

package/dist/pipeline.d.ts

@@ -1,2 +1,2 @@
-import { a as Pipeline, c as ResolvedResource, d as createPipeline, i as MiddlewareHandler, l as ResourceHandler, n as LayoutComponent, o as PipelineConfig, r as LoadingComponent, s as Resolved, t as ExtraHandler, u as RouteResolver } from "./pipeline-B2V6tKfO.js";
+import { a as Pipeline, c as ResolvedResource, d as createPipeline, i as MiddlewareHandler, l as ResourceHandler, n as LayoutComponent, o as PipelineConfig, r as LoadingComponent, s as Resolved, t as ExtraHandler, u as RouteResolver } from "./pipeline-CCp9idQ4.js";
 export { ExtraHandler, LayoutComponent, LoadingComponent, MiddlewareHandler, Pipeline, PipelineConfig, Resolved, ResolvedResource, ResourceHandler, RouteResolver, createPipeline };

package/dist/pipeline.js

@@ -1,11 +1,11 @@
 import { SEGMENT_HEADER, TITLE_HEADER, encodeTitle, negotiate } from "./negotiate.js";
+import { ensureScope, runInScope, setRequestLocale } from "@junejs/db";
 import { LoaderDataContext } from "@junejs/core/route";
 import React, { Suspense, use } from "react";
 import { renderToReadableStream } from "react-dom/server";
 import { Document } from "@junejs/core/document";
 import { apiCatalog, buildLinkHeader, llmsTxt, mcpServerCard, robotsTxt, sitemapXml } from "@junejs/core/discovery";
 import { mcpHandler, mcpTools } from "@junejs/core/mcp";
-import { ensureScope, runInScope, setRequestLocale } from "@junejs/db";
 import { LOCALE_COOKIE, localeAlternates, localeDir, matchPinnedLocale, negotiateLocale } from "@junejs/core/i18n";
 //#region src/pipeline.ts
 function readCookie(request, name) {
@@ -228,7 +228,10 @@ function createPipeline(cfg) {
 	}
 	return { async fetch(request) {
 		await ensureScope();
-		return runInScope({ resources: cfg.resources ? await cfg.resources() : {} }, () => handleRequest(request));
+		return runInScope({
+			resources: cfg.resources ? await cfg.resources() : {},
+			services: cfg.services ? await cfg.services() : void 0
+		}, () => handleRequest(request));
 	} };
 }
 //#endregion

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/worker.d.ts

@@ -1,4 +1,4 @@
-import { l as ResourceHandler, n as LayoutComponent, r as LoadingComponent, t as ExtraHandler } from "./pipeline-B2V6tKfO.js";
+import { l as ResourceHandler, n as LayoutComponent, r as LoadingComponent, t as ExtraHandler } from "./pipeline-CCp9idQ4.js";
 import { BrandedRoute } from "@junejs/core/route";
 import { AgentConfig } from "@junejs/core/config";
 import React from "react";
@@ -33,6 +33,7 @@ type WorkerManifest = {
   }>;
   extra?: ExtraHandler;
   resources?: (env?: unknown) => Promise<Resources> | Resources;
+  services?: (env?: unknown) => unknown;
 };
 declare function createWorker(manifest: WorkerManifest): {
   fetch(request: Request, env?: unknown): Promise<Response>;

package/dist/worker.js

@@ -1,5 +1,6 @@
 import { durableAgentSurface } from "./agent-durable.js";
 import { createPipeline } from "./pipeline.js";
+import { RESERVED_PREFIX, contentTypeFor, safeRelativePath } from "./static-files.js";
 //#region src/worker.ts
 function compilePattern(pattern) {
 	const names = [];
@@ -61,6 +62,8 @@ function createWorker(manifest) {
 	const boundaryFor = (key) => manifest.layoutBoundaries?.[key] ?? null;
 	let currentEnv;
 	const provider = manifest.resources;
+	const servicesProvider = manifest.services;
+	let servicesCache;
 	const agentSurface = manifest.agent.runtime.enabled && manifest.agentName ? (() => {
 		const route = durableAgentSurface(() => currentEnv?.AGENT, {
 			agentName: manifest.agentName,
@@ -79,6 +82,7 @@ function createWorker(manifest) {
 		notFoundComponent: manifest.notFound,
 		extra: manifest.extra,
 		resources: provider ? () => provider(currentEnv) : void 0,
+		services: servicesProvider ? () => (servicesCache ??= { v: servicesProvider(currentEnv) }).v : void 0,
 		resolve: async (pathname) => {
 			const staticDef = manifest.routes[pathname];
 			if (staticDef) {
@@ -176,32 +180,33 @@ function withAssets(pipeline, opts = {}) {
 		return pipeline.fetch(request, env);
 	} };
 }
-const ASSET_CONTENT_TYPES = {
-	css: "text/css; charset=utf-8",
-	js: "text/javascript; charset=utf-8",
-	json: "application/json; charset=utf-8",
-	map: "application/json; charset=utf-8",
-	svg: "image/svg+xml",
-	png: "image/png",
-	jpg: "image/jpeg",
-	jpeg: "image/jpeg",
-	webp: "image/webp",
-	avif: "image/avif",
-	ico: "image/x-icon",
-	woff2: "font/woff2",
-	woff: "font/woff"
-};
 function withDenoAssets(pipeline) {
 	return async (request) => {
-		const url = new URL(request.url);
-		if (request.method === "GET" && url.pathname.startsWith("/_june/")) try {
-			const file = await Deno.readFile(new URL(`./assets${url.pathname}`, import.meta.url));
-			const ext = url.pathname.split(".").pop()?.toLowerCase() ?? "";
-			return new Response(file, { headers: {
-				"content-type": ASSET_CONTENT_TYPES[ext] ?? "application/octet-stream",
-				"cache-control": "public, max-age=31536000, immutable"
-			} });
-		} catch {}
+		const method = request.method;
+		if (method === "GET" || method === "HEAD") {
+			const url = new URL(request.url);
+			{
+				const rel = safeRelativePath(url.pathname);
+				if (rel !== null) try {
+					const assetUrl = new URL(`./assets/${rel.split("/").map(encodeURIComponent).join("/")}`, import.meta.url);
+					const immutable = rel.startsWith(`${RESERVED_PREFIX}/`);
+					const headers = {
+						"content-type": contentTypeFor(rel),
+						"cache-control": immutable ? "public, max-age=31536000, immutable" : "public, max-age=0, must-revalidate"
+					};
+					if (method === "HEAD") {
+						const info = await Deno.stat(assetUrl);
+						if (!info.isFile) throw new Error("not a file");
+						return new Response(null, { headers: {
+							...headers,
+							"content-length": String(info.size)
+						} });
+					}
+					const file = await Deno.readFile(assetUrl);
+					return new Response(file, { headers });
+				} catch {}
+			}
+		}
 		return pipeline.fetch(request);
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/server",
-  "version": "0.1.0-dev.5",
+  "version": "0.1.0",
   "description": "June host adapters + dev server. Host-coupled; depends on the pure @junejs/core contract layer.",
   "type": "module",
   "license": "MIT",
@@ -125,8 +125,8 @@
     "build": "tsdown"
   },
   "dependencies": {
-    "@junejs/core": ">=0.1.0-dev.4",
-    "@junejs/db": ">=0.0.33-dev.1",
+    "@junejs/core": ">=0.1.0",
+    "@junejs/db": ">=0.0.33",
     "@momiji-rs/sparkdown": "^0.0.4",
     "lightningcss": "^1.27.0",
     "oxc-parser": "^0.137.0",

package/src/adapter.ts

@@ -8,7 +8,7 @@
 // are explicit `deploy: { adapter: vercel() }` from their own package.
 import { existsSync } from "node:fs";
 import { cp, copyFile, mkdir, readdir, rm, writeFile } from "node:fs/promises";
-import { basename, join } from "node:path";
+import { basename, dirname, join } from "node:path";
 
 import type { JuneConfig } from "@junejs/core/config";
 
@@ -49,6 +49,10 @@ export type AdapterEmitContext = {
   plan: ResourcePlan;
   // package.json name (or sanitized dir name) — the fallback worker/app name.
   defaultName: string;
+  // Verbatim public/ files (forward-slash paths relative to assets/), already
+  // copied into outDir/assets. Adapters that build a separate static tier (vercel)
+  // place these there; whole-assets targets (workers/static/deno) ignore it.
+  publicFiles?: string[];
 };
 
 export interface JuneAdapter {
@@ -214,7 +218,7 @@ export function vercel(opts?: { runtime?: "node" | "edge"; regions?: string[] })
       };
     },
 
-    async emit({ appRoot, outDir, hasAssets }) {
+    async emit({ appRoot, outDir, hasAssets, publicFiles }) {
       const out = join(appRoot, ".vercel", "output");
       const fnDir = join(out, "functions", `${VERCEL_FUNCTION}.func`);
       await rm(out, { recursive: true, force: true }); // clean — no stale outputs
@@ -249,11 +253,20 @@ export function vercel(opts?: { runtime?: "node" | "edge"; regions?: string[] })
         await writeFile(join(fnDir, "package.json"), JSON.stringify({ type: "module" }, null, 2) + "\n");
       }
 
-      // static: only the hashed framework assets under /_june/ (exact-path URLs)
+      // static: the hashed framework assets under /_june/ (exact-path URLs)...
       if (hasAssets) {
         const src = join(outDir, "assets", "_june");
         if (existsSync(src)) await cp(src, join(out, "static", "_june"), { recursive: true });
       }
+      // ...plus verbatim public/ files, served by the `filesystem` route handle
+      // below. Only these — prerendered page HTML stays on the SSR function.
+      for (const rel of publicFiles ?? []) {
+        const from = join(outDir, "assets", rel);
+        if (!existsSync(from)) continue;
+        const to = join(out, "static", rel);
+        await mkdir(dirname(to), { recursive: true });
+        await copyFile(from, to);
+      }
 
       await writeFile(
         join(out, "config.json"),

package/src/agent-discover.ts

@@ -21,7 +21,7 @@ import { basename, extname, join } from "node:path";
 import { pathToFileURL } from "node:url";
 
 import type { AnyAction } from "@junejs/core/agent";
-import { defineAgent, type AgentConfigFile, type AgentDefinition, type Channel, type Skill } from "@junejs/core/agent-config";
+import { defineAgent, resolveChannel, type AgentConfigFile, type AgentDefinition, type Channel, type ChannelFactory, type Skill } from "@junejs/core/agent-config";
 import { connectAll, type Connection } from "@junejs/core/connections";
 
 async function scan(dir: string, ext: string): Promise<string[]> {
@@ -79,10 +79,13 @@ export async function discoverAgent(dir: string): Promise<AgentDefinition> {
     skills.push(parseSkill(basename(f, ".md"), await readFile(f, "utf8")));
   }
 
+  // A channel module default-exports a Channel OR a `(env) => Channel` factory (the
+  // form workerd needs — secrets live in env, not at module scope). On native, env is
+  // process.env (present at load), so resolve here; the plain form stays supported.
   const channels: Channel[] = [];
   for (const f of await scan(join(dir, "channels"), ".ts")) {
     const mod = await import(pathToFileURL(f).href);
-    if (mod.default) channels.push(mod.default as Channel);
+    if (mod.default) channels.push(resolveChannel(mod.default as Channel | ChannelFactory, process.env));
   }
 
   // connections/*.ts — outbound: wire external MCP/OpenAPI servers, turning their