gorsee 0.2.11 → 0.2.12

package/dist-pkg/cli/cmd-build.js

@@ -1,11 +1,11 @@
 import { join } from "node:path";
-import { mkdir, rm, writeFile, readdir, stat, watch } from "node:fs/promises";
+import { mkdir, rm, writeFile, readdir, stat, watch, readFile } from "node:fs/promises";
 import { createRouter } from "../router/scanner.js";
 import { buildClientBundles } from "../build/client.js";
 import { configureClientBuildBackend } from "../build/client-backend.js";
 import { initializeBuildBackends } from "../build/init.js";
 import { generateStaticPages } from "../build/ssg.js";
-import { createBuildManifest } from "../build/manifest.js";
+import { createBuildManifest, createReleaseArtifact } from "../build/manifest.js";
 import { createHash } from "node:crypto";
 import { wrapHTML } from "../server/html-shell.js";
 import { createProjectContext } from "../runtime/project.js";
@@ -17,7 +17,7 @@ import {
   resolveAIObservabilityConfig,
   runWithAITrace
 } from "../ai/index.js";
-import { loadAppConfig, resolveAIConfig } from "../runtime/app-config.js";
+import { loadAppConfig, resolveAIConfig, resolveAppMode } from "../runtime/app-config.js";
 import { initializeCompilerBackends } from "../compiler/init.js";
 async function hashFile(path) {
   const content = await Bun.file(path).arrayBuffer();
@@ -41,7 +41,7 @@ export async function buildProject(options = {}) {
   const { cwd, paths } = createProjectContext(options);
   initializeCompilerBackends(options.env ?? process.env);
   initializeBuildBackends(options.env ?? process.env);
-  const appConfig = await loadAppConfig(cwd);
+  const appConfig = await loadAppConfig(cwd), appMode = resolveAppMode(appConfig);
   configureAIObservability(resolveAIConfig(cwd, appConfig, options.ai) ?? resolveAIObservabilityConfig(cwd));
   try {
     await runWithAITrace({
@@ -50,7 +50,7 @@ export async function buildProject(options = {}) {
       source: "build",
       message: "production build",
       phase: "build",
-      data: { cwd, minify: options.minify ?? !0, sourcemap: options.sourcemap ?? !0 }
+      data: { cwd, appMode, minify: options.minify ?? !0, sourcemap: options.sourcemap ?? !0 }
     }, async () => {
       const startTime = performance.now();
       console.log(`
@@ -58,50 +58,59 @@ export async function buildProject(options = {}) {
 `);
       await rm(paths.distDir, { recursive: !0, force: !0 });
       await mkdir(paths.clientDir, { recursive: !0 });
-      await mkdir(paths.serverDir, { recursive: !0 });
+      if (appMode !== "frontend")
+        await mkdir(paths.serverDir, { recursive: !0 });
       const routes = await createRouter(paths.routesDir);
-      console.log(`  [1/5] Found ${routes.length} route(s)`);
+      console.log(`  [1/5] Found ${routes.length} route(s) (${appMode})`);
       await emitAIEvent({
         kind: "build.phase",
         severity: "info",
         source: "build",
         message: "routes scanned",
         phase: "scan-routes",
-        data: { routes: routes.length }
+        data: { routes: routes.length, appMode }
       });
-      const build = await buildClientBundles(routes, cwd, {
+      const shouldBuildClient = appMode !== "server", build = shouldBuildClient ? await buildClientBundles(routes, cwd, {
         minify: options.minify ?? !0,
         sourcemap: options.sourcemap ?? !0,
         backend: options.clientBuildBackend ?? configureClientBuildBackend(options.env ?? process.env)
-      });
-      console.log(`  [2/5] Client bundles built (${build.entryMap.size} entries)`);
+      }) : { entryMap: new Map };
+      console.log(`  [2/5] ${shouldBuildClient ? `Client bundles built (${build.entryMap.size} entries)` : "Client bundle phase skipped for server mode"}`);
       await emitAIEvent({
         kind: "build.phase",
         severity: "info",
         source: "build",
-        message: "client bundles built",
+        message: shouldBuildClient ? "client bundles built" : "client bundle phase skipped",
         phase: "client-bundles",
-        data: { entries: build.entryMap.size }
+        data: { entries: build.entryMap.size, skipped: !shouldBuildClient, appMode }
       });
-      const clientSrc = join(paths.gorseeDir, "client"), clientFiles = await getAllFiles(clientSrc), hashMap = new Map;
-      for (const file of clientFiles) {
-        const rel = file.slice(clientSrc.length + 1), preserveRuntimePath = rel.startsWith("chunks/") || rel.endsWith(".map"), hash = preserveRuntimePath ? null : await hashFile(file), ext = rel.lastIndexOf("."), hashed = preserveRuntimePath ? rel : ext > 0 ? `${rel.slice(0, ext)}.${hash}${rel.slice(ext)}` : `${rel}.${hash}`, dest = join(paths.clientDir, hashed);
-        await mkdir(join(dest, ".."), { recursive: !0 });
-        await Bun.write(dest, Bun.file(file));
-        hashMap.set(rel, hashed);
+      const clientSrc = join(paths.gorseeDir, "client"), hashMap = new Map;
+      if (shouldBuildClient) {
+        const clientFiles = await getAllFiles(clientSrc);
+        for (const file of clientFiles) {
+          const rel = file.slice(clientSrc.length + 1), preserveRuntimePath = rel.startsWith("chunks/") || rel.endsWith(".map"), hash = preserveRuntimePath ? null : await hashFile(file), ext = rel.lastIndexOf("."), hashed = preserveRuntimePath ? rel : ext > 0 ? `${rel.slice(0, ext)}.${hash}${rel.slice(ext)}` : `${rel}.${hash}`, dest = join(paths.clientDir, hashed);
+          await mkdir(join(dest, ".."), { recursive: !0 });
+          await Bun.write(dest, Bun.file(file));
+          hashMap.set(rel, hashed);
+        }
       }
       console.log(`  [3/5] Assets hashed (${hashMap.size} files)`);
-      const manifest = await createBuildManifest(routes, build.entryMap, hashMap);
+      const manifest = await createBuildManifest(routes, build.entryMap, hashMap, [], appMode);
       await writeFile(join(paths.distDir, "manifest.json"), JSON.stringify(manifest, null, 2));
-      const serverArtifacts = await buildServerArtifacts(cwd, paths.distDir);
-      console.log("  [4/5] Manifest + server entries generated");
-      const ssgResult = await generateStaticPages({
+      const serverArtifacts = appMode === "frontend" ? { serverEntries: [] } : await buildServerArtifacts(cwd, paths.distDir);
+      console.log(`  [4/5] ${appMode === "frontend" ? "Manifest generated for frontend mode" : "Manifest + server entries generated"}`);
+      const ssgResult = shouldBuildClient ? await generateStaticPages({
         routesDir: paths.routesDir,
         outDir: join(paths.distDir, "static"),
         wrapHTML: (body, htmlOptions = {}) => wrapHTML(body, void 0, htmlOptions)
-      }), finalManifest = ssgResult.pages.size > 0 ? await createBuildManifest(routes, build.entryMap, hashMap, ssgResult.pages.keys()) : manifest;
-      if (ssgResult.pages.size > 0)
-        await writeFile(join(paths.distDir, "manifest.json"), JSON.stringify(finalManifest, null, 2));
+      }) : { pages: new Map, errors: [] };
+      if (appMode === "frontend")
+        await assertFrontendBuildContract(routes);
+      else if (appMode === "server")
+        await assertServerBuildContract(routes);
+      const finalManifest = ssgResult.pages.size > 0 ? await createBuildManifest(routes, build.entryMap, hashMap, ssgResult.pages.keys(), appMode) : manifest, releaseArtifact = createReleaseArtifact(finalManifest, hashMap.values(), serverArtifacts.serverEntries);
+      await writeFile(join(paths.distDir, "manifest.json"), JSON.stringify(finalManifest, null, 2));
+      await writeFile(join(paths.distDir, "release.json"), JSON.stringify(releaseArtifact, null, 2));
       if (ssgResult.errors.length > 0) {
         for (const err of ssgResult.errors)
           console.error(`  SSG error: ${err}`);
@@ -135,10 +144,12 @@ export async function buildProject(options = {}) {
         phase: "summary",
         data: {
           artifact: "dist/",
+          appMode,
           routes: routes.length,
           entries: build.entryMap.size,
           assets: hashMap.size,
           serverEntries: serverArtifacts.serverEntries,
+          releaseArtifact: "release.json",
           prerenderedPages: ssgResult.pages.size,
           ssgErrors: ssgResult.errors.length,
           clientKb: Number((totalSize / 1024).toFixed(1)),
@@ -196,3 +207,38 @@ export async function runBuild(args, options = {}) {
     return watchBuildProject(options);
   return buildProject(options);
 }
+async function assertFrontendBuildContract(routes) {
+  const apiRoutes = routes.filter((route) => route.filePath.includes("/api/")), pageRoutes = routes.filter((route) => !route.filePath.includes("/api/"));
+  if (pageRoutes.length === 0)
+    return;
+  const missingPrerender = [], serverOnlyViolations = [], errors = [];
+  if (apiRoutes.length > 0)
+    errors.push(`frontend mode does not allow API routes: ${apiRoutes.map((route) => route.path).join(", ")}`);
+  for (const route of pageRoutes) {
+    const source = await readFile(route.filePath, "utf-8");
+    if (!/export\s+const\s+prerender\s*=\s*true\b/.test(source))
+      missingPrerender.push(route.path);
+    if (source.includes('"gorsee/server"') || source.includes('"gorsee/auth"') || source.includes('"gorsee/db"') || source.includes("server(") || /\bexport\s+async\s+function\s+(load|action)\b/.test(source) || /\bexport\s+function\s+(GET|POST|PUT|PATCH|DELETE)\b/.test(source))
+      serverOnlyViolations.push(route.path);
+  }
+  if (missingPrerender.length > 0 || serverOnlyViolations.length > 0 || errors.length > 0) {
+    if (missingPrerender.length > 0)
+      errors.push(`frontend mode requires export const prerender = true for every page route: ${missingPrerender.join(", ")}`);
+    if (serverOnlyViolations.length > 0)
+      errors.push(`frontend mode page routes must stay browser-safe and avoid server exports/imports: ${serverOnlyViolations.join(", ")}`);
+    throw Error(errors.join(". "));
+  }
+}
+async function assertServerBuildContract(routes) {
+  const serviceRoutes = routes.filter((route) => !route.filePath.includes("/api/"));
+  if (serviceRoutes.length === 0)
+    return;
+  const errors = [];
+  for (const route of serviceRoutes) {
+    const source = await readFile(route.filePath, "utf-8");
+    if (source.includes('"gorsee/client"') || source.includes('"gorsee/forms"') || source.includes('"gorsee/routes"') || source.includes("export default function") || source.includes("export default async function"))
+      errors.push(route.path);
+  }
+  if (errors.length > 0)
+    throw Error(`server mode does not allow page/UI route behavior: ${errors.join(", ")}`);
+}

package/dist-pkg/cli/cmd-check.js

@@ -11,7 +11,7 @@ import {
   emitAIDiagnostic,
   emitAIEvent
 } from "../ai/index.js";
-import { loadAppConfig, resolveAIConfig, resolveRuntimeTopology } from "../runtime/app-config.js";
+import { loadAppConfig, resolveAIConfig, resolveAppMode, resolveRuntimeTopology } from "../runtime/app-config.js";
 const MAX_FILE_LINES = 500;
 async function getAllTsFiles(dir) {
   const files = [];
@@ -130,17 +130,18 @@ async function collectASTFacts(files, cwd) {
   }
   return facts;
 }
-async function checkProjectStructure(cwd) {
+async function checkProjectStructure(cwd, appMode) {
   const issues = [];
   try {
     await stat(join(cwd, "routes"));
   } catch {
-    issues.push({
-      code: "E902",
-      file: ".",
-      message: "Missing routes/ directory",
-      fix: "Create routes/ directory with at least routes/index.ts"
-    });
+    if (appMode !== "server")
+      issues.push({
+        code: "E902",
+        file: ".",
+        message: "Missing routes/ directory",
+        fix: "Create routes/ directory with at least routes/index.ts"
+      });
   }
   try {
     await stat(join(cwd, "app.config.ts"));
@@ -241,6 +242,93 @@ async function checkDistributedContracts(cwd, files, astFacts) {
     });
   return issues;
 }
+async function checkAppModeContracts(cwd, files, astFacts, appMode) {
+  const issues = [];
+  if (appMode === "fullstack")
+    return issues;
+  for (const file of files) {
+    const rel = relative(cwd, file), facts = astFacts.get(file), source = await tryReadFile(file), imports = facts?.imports ?? [];
+    if (appMode === "frontend") {
+      const serverImport = imports.find((entry) => [
+        "gorsee/server",
+        "gorsee/auth",
+        "gorsee/db",
+        "gorsee/env",
+        "gorsee/log"
+      ].includes(entry.specifier)) ?? (source && [
+        "gorsee/server",
+        "gorsee/auth",
+        "gorsee/db",
+        "gorsee/env",
+        "gorsee/log"
+      ].find((specifier) => source.includes(`"${specifier}"`) || source.includes(`'${specifier}'`)) ? { specifier: [
+        "gorsee/server",
+        "gorsee/auth",
+        "gorsee/db",
+        "gorsee/env",
+        "gorsee/log"
+      ].find((specifier) => source.includes(`"${specifier}"`) || source.includes(`'${specifier}'`)) } : void 0);
+      if (serverImport)
+        issues.push({
+          code: "W922",
+          file: rel,
+          message: `frontend app imports server-oriented surface "${serverImport.specifier}"`,
+          fix: 'Keep frontend mode browser-safe; move server logic to another service or switch app.mode to "fullstack"'
+        });
+      const hasApiRoute = rel.startsWith("routes/api/"), hasServerUsage = facts ? facts.hasServerCall || facts.hasRouteCacheCall || facts.hasCreateAuthCall : Boolean(source && (source.includes("server(") || source.includes("routeCache(") || source.includes("createAuth(") || source.includes('from "gorsee/server"')));
+      if (hasApiRoute || hasServerUsage)
+        issues.push({
+          code: "W923",
+          file: rel,
+          message: "frontend app contains server/runtime-only route behavior",
+          fix: 'Keep frontend mode to prerendered browser-safe routes only, or switch app.mode to "fullstack"'
+        });
+      if (rel.startsWith("routes/") && !rel.startsWith("routes/api/") && (rel.endsWith(".ts") || rel.endsWith(".tsx"))) {
+        const content = source ?? await readFile(file, "utf-8");
+        if (!/export\s+const\s+prerender\s*=\s*true\b/.test(content))
+          issues.push({
+            code: "W924",
+            file: rel,
+            message: "frontend mode page route is missing export const prerender = true",
+            fix: "Mark every frontend page route with `export const prerender = true` so the app stays static/browser-first"
+          });
+      }
+    }
+    if (appMode === "server") {
+      const clientImport = imports.find((entry) => [
+        "gorsee/client",
+        "gorsee/forms",
+        "gorsee/routes"
+      ].includes(entry.specifier)) ?? (source && [
+        "gorsee/client",
+        "gorsee/forms",
+        "gorsee/routes"
+      ].find((specifier) => source.includes(`"${specifier}"`) || source.includes(`'${specifier}'`)) ? { specifier: [
+        "gorsee/client",
+        "gorsee/forms",
+        "gorsee/routes"
+      ].find((specifier) => source.includes(`"${specifier}"`) || source.includes(`'${specifier}'`)) } : void 0);
+      if (clientImport)
+        issues.push({
+          code: "W925",
+          file: rel,
+          message: `server app imports browser-oriented surface "${clientImport.specifier}"`,
+          fix: 'Keep server mode UI-free; remove browser imports or switch app.mode to "fullstack"'
+        });
+      if (rel.startsWith("routes/") && !rel.startsWith("routes/api/") && (rel.endsWith(".ts") || rel.endsWith(".tsx"))) {
+        const content = source ?? await readFile(file, "utf-8");
+        if (content.includes('from "gorsee/client"') || /\bexport\s+default\s+function\b/.test(content))
+          issues.push({
+            code: "W926",
+            file: rel,
+            message: "server mode route tree should stay API/service-oriented and avoid page UI exports",
+            fix: 'Move browser routes out of server mode, or switch app.mode to "fullstack"'
+          });
+      }
+    }
+  }
+  return issues;
+}
 function checkImportContracts(cwd, astFacts) {
   const issues = [];
   for (const [file, facts] of astFacts) {
@@ -485,7 +573,7 @@ async function tryReadFile(path) {
 export async function checkProject(options = {}) {
   const { cwd, paths } = createProjectContext(options);
   initializeCompilerBackends(options.env ?? process.env);
-  const runTypeScript = options.runTypeScript ?? !0, strictSecurity = options.strictSecurity ?? !1, rewriteImports = options.rewriteImports ?? !1, rewriteLoaders = options.rewriteLoaders ?? !1, result = { errors: [], warnings: [], info: [] }, appConfig = await loadAppConfig(cwd);
+  const runTypeScript = options.runTypeScript ?? !0, strictSecurity = options.strictSecurity ?? !1, rewriteImports = options.rewriteImports ?? !1, rewriteLoaders = options.rewriteLoaders ?? !1, result = { errors: [], warnings: [], info: [] }, appConfig = await loadAppConfig(cwd), appMode = resolveAppMode(appConfig);
   configureAIObservability(resolveAIConfig(cwd, appConfig, options.ai));
   await emitAIEvent({
     kind: "check.start",
@@ -493,7 +581,7 @@ export async function checkProject(options = {}) {
     source: "check",
     message: "project check started",
     phase: "check",
-    data: { cwd, runTypeScript, strictSecurity, rewriteImports, rewriteLoaders }
+    data: { cwd, appMode, runTypeScript, strictSecurity, rewriteImports, rewriteLoaders }
   });
   if (rewriteImports) {
     const rewrite = await rewriteCanonicalImportsInProject(cwd);
@@ -503,7 +591,7 @@ export async function checkProject(options = {}) {
     const rewrite = await rewriteLegacyLoadersInProject(cwd);
     result.info.push(rewrite.changedFiles.length > 0 ? `Rewrote legacy loader exports in ${rewrite.changedFiles.length} file(s)` : "Legacy loader rewrite found no changes");
   }
-  const structIssues = await checkProjectStructure(cwd);
+  const structIssues = await checkProjectStructure(cwd, appMode);
   for (const issue of structIssues)
     if (issue.code.startsWith("E"))
       result.errors.push(issue);
@@ -512,6 +600,7 @@ export async function checkProject(options = {}) {
   try {
     const routes = await createRouter(paths.routesDir);
     result.info.push(`Found ${routes.length} route(s)`);
+    result.info.push(`App mode: ${appMode}`);
   } catch {
     result.info.push("Could not scan routes");
   }
@@ -534,6 +623,9 @@ export async function checkProject(options = {}) {
   const distributedIssues = await checkDistributedContracts(cwd, files, astFacts);
   for (const issue of distributedIssues)
     pushIssue(result, issue, strictSecurity);
+  const appModeIssues = await checkAppModeContracts(cwd, files, astFacts, appMode);
+  for (const issue of appModeIssues)
+    pushIssue(result, issue, strictSecurity);
   const dependencyIssues = await checkDependencyPolicy(cwd);
   for (const issue of dependencyIssues)
     pushIssue(result, issue, strictSecurity);
@@ -591,6 +683,7 @@ ${details}`
       errors: result.errors.length,
       warnings: result.warnings.length,
       info: result.info.length,
+      appMode,
       strictSecurity,
       runTypeScript,
       rewriteImports,