polen 0.11.0-next.14 → 0.11.0-next.15

package/build/vite/plugins/serve.js

@@ -0,0 +1,160 @@
+import { reportError } from '#api/server/report-error';
+import { createHtmlTransformer } from '#lib/html-utils/html-transformer';
+import { ResponseInternalServerError } from '#lib/kit-temp';
+import { debugPolen } from '#singletons/debug';
+import * as HonoNodeServer from '@hono/node-server';
+import { Err, Null } from '@wollybeard/kit';
+import * as NodePath from 'node:path';
+export const Serve = (config) => {
+    const PLUGIN_SCOPE = {};
+    const debug = debugPolen.sub(`serve`);
+    const appModulePath = config.paths.framework.template.absolute.server.app;
+    let appPromise;
+    const isNeedAppLoadOrReload = (server) => {
+        const appModule = server.moduleGraph.getModuleById(appModulePath);
+        if (!appModule)
+            return true; // Not loaded yet
+        // Check if the module or any of its dependencies are invalidated
+        const checkInvalidated = (mod, visited = new Set()) => {
+            if (!mod.id || visited.has(mod.id))
+                return false;
+            visited.add(mod.id);
+            // Check if this module is invalidated
+            // SSR modules use ssrInvalidationState, client modules use invalidationState
+            if (mod.ssrInvalidationState === `HARD_INVALIDATED` || mod.invalidationState === `HARD_INVALIDATED`) {
+                return true;
+            }
+            // Also check if transformResult is null (indicates invalidation)
+            if (mod.ssrTransformResult === null && mod.transformResult === null) {
+                return true;
+            }
+            // Check all imported modules recursively
+            for (const imported of mod.importedModules) {
+                if (checkInvalidated(imported, visited))
+                    return true;
+            }
+            return false;
+        };
+        return checkInvalidated(appModule);
+    };
+    const reloadApp = async (server) => {
+        debug(`reloadApp`);
+        const App = await ssrLoadModule(server, config.paths.framework.template.absolute.server.app);
+        if (Err.is(App))
+            return App;
+        if (Null.is(App))
+            return App;
+        return App.createApp({
+            hooks: {
+                transformHtml: [
+                    // Inject entry client script for development
+                    createHtmlTransformer((html, ___ctx) => {
+                        const entryClientPath = `/${config.paths.framework.template.relative.client.entrypoint}`;
+                        const entryClientScript = `<script type="module" src="${entryClientPath}"></script>`;
+                        return html.replace(`</body>`, `${entryClientScript}\n</body>`);
+                    }),
+                    // Apply Vite's transformations
+                    createHtmlTransformer(async (html, ctx) => {
+                        return await server.transformIndexHtml(ctx.req.url, html);
+                    }),
+                ],
+            },
+            paths: {
+                base: config.build.base,
+                assets: {
+                    // Calculate relative path from CWD to Polen's assets
+                    // CWD is user's project directory where they run 'pnpm dev'
+                    // Assets are in Polen's dev assets directory
+                    directory: NodePath.relative(process.cwd(), config.paths.framework.devAssets.absolute),
+                    route: config.server.routes.assets,
+                },
+            },
+        });
+    };
+    return {
+        name: `polen:serve`,
+        apply: `serve`,
+        config() {
+            return {
+                server: {
+                    port: config.server.port,
+                    watch: {
+                        disableGlobbing: false,
+                    },
+                    fs: {
+                        strict: false, // bring back true, with the allow below might already work now
+                        allow: [
+                            config.paths.project.rootDir,
+                        ],
+                    },
+                },
+            };
+        },
+        handleHotUpdate({ server }) {
+            debug(`handleHotUpdate`);
+            // Reload app server immediately in the background
+            appPromise = reloadApp(server);
+        },
+        async configureServer(server) {
+            debug(`configureServer`);
+            PLUGIN_SCOPE.server = server;
+            return () => {
+                // Remove index.html serving middleware.
+                server.middlewares.stack.splice(
+                // @ts-expect-error
+                server.middlewares.stack.findIndex(m => m.handle.name === `viteHtmlFallbackMiddleware`), 1);
+                // Add middleware that runs our entry server
+                server.middlewares.use((req, res, ___next) => {
+                    // Check if app needs reloading due to module invalidation
+                    if (isNeedAppLoadOrReload(server)) {
+                        appPromise = reloadApp(server);
+                    }
+                    void HonoNodeServer.getRequestListener(async (request) => {
+                        // Always await the current app promise
+                        const app = await appPromise;
+                        if (Err.is(app)) {
+                            return ResponseInternalServerError();
+                        }
+                        if (Null.is(app)) {
+                            // todo better response type, 'not available' etc.
+                            return ResponseInternalServerError();
+                        }
+                        return await app.fetch(request);
+                    })(req, res);
+                });
+            };
+        },
+        buildStart() {
+            if (PLUGIN_SCOPE.server) {
+                appPromise = reloadApp(PLUGIN_SCOPE.server);
+            }
+        },
+    };
+};
+// Helpers
+const isServerClosing = (server) => {
+    // @ts-expect-error
+    return Boolean(server.environments.ssr._closing);
+};
+const isFetchTransportDisconnectError = (error) => {
+    const regex = /transport was disconnected.*fetchModule/;
+    return regex.test(error.message);
+};
+const ssrLoadModule = async (server, appModulePath) => {
+    return await server
+        // .ssrLoadModule(config.paths.framework.template.absolute.server.app)
+        .ssrLoadModule(appModulePath)
+        .then(module => module)
+        .catch(async (error) => {
+        if (isFetchTransportDisconnectError(error) && isServerClosing(server))
+            return null;
+        if (Err.is(error)) {
+            // ━ Clean Stack Trace
+            server.ssrFixStacktrace(error);
+            reportError(error);
+            return error;
+        }
+        throw error;
+    });
+};
+//# sourceMappingURL=serve.js.map

package/build/vite/plugins/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/vite/plugins/serve.ts"],"names":[],"mappings":"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"}

package/build/vite/vi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi.d.ts","sourceRoot":"","sources":["../../src/vite/vi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,eAAO,MAAM,YAAY,gCAEvB,CAAA"}

package/build/vite/vi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi.js","sourceRoot":"","sources":["../../src/vite/vi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC;IAC/D,SAAS,EAAE,OAAO;CACnB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.11.0-next.14",
+  "version": "0.11.0-next.15",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -24,13 +24,6 @@
     "type": "git",
     "url": "git+https://github.com/the-guild-org/polen.git"
   },
-  "devEngines": {
-    "runtime": {
-      "name": "node",
-      "version": ">=24.0.0",
-      "onFail": "error"
-    }
-  },
   "imports": {
     "#*": {
       "default": "./build/*.js"
@@ -38,6 +31,9 @@
     "#api/iso": {
       "default": "./build/api/iso/$.js"
     },
+    "#vite": {
+      "default": "./build/vite/index.js"
+    },
     "#lib/apple-touch-icon": {
       "default": "./build/lib/apple-touch-icon/$.js"
     },
@@ -68,15 +64,6 @@
     "#lib/grafaid-old": {
       "default": "./build/lib/grafaid-old/$.js"
     },
-    "#lib/graphql-change": {
-      "default": "./build/lib/graphql-change/$.js"
-    },
-    "#lib/graphql-change/graphql-change": {
-      "default": "./build/lib/graphql-change/$$.js"
-    },
-    "#lib/graphql-changeset": {
-      "default": "./build/lib/graphql-changeset/$.js"
-    },
     "#lib/graphql-path": {
       "default": "./build/lib/graphql-path/$.js"
     },
@@ -92,6 +79,48 @@
     "#lib/html-utils": {
       "default": "./build/lib/html-utils/$.js"
     },
+    "#lib/catalog": {
+      "default": "./build/lib/catalog/$.js"
+    },
+    "#lib/catalog/catalog": {
+      "default": "./build/lib/catalog/catalog.js"
+    },
+    "#lib/change": {
+      "default": "./build/lib/change/$.js"
+    },
+    "#lib/change/change": {
+      "default": "./build/lib/change/$$.js"
+    },
+    "#lib/lifecycles": {
+      "default": "./build/lib/lifecycles/$.js"
+    },
+    "#lib/lifecycles/lifecycles": {
+      "default": "./build/lib/lifecycles/$$.js"
+    },
+    "#lib/revision": {
+      "default": "./build/lib/revision/$.js"
+    },
+    "#lib/revision/revision": {
+      "default": "./build/lib/revision/revision.js"
+    },
+    "#lib/schema": {
+      "default": "./build/lib/schema/$.js"
+    },
+    "#lib/schema/schema": {
+      "default": "./build/lib/schema/schema.js"
+    },
+    "#lib/schema-definition": {
+      "default": "./build/lib/schema-definition/$.js"
+    },
+    "#lib/schema-definition/schema-definition": {
+      "default": "./build/lib/schema-definition/schema-definition.js"
+    },
+    "#lib/semver": {
+      "default": "./build/lib/semver/$.js"
+    },
+    "#lib/semver/semver": {
+      "default": "./build/lib/semver/$$.js"
+    },
     "#lib/mask": {
       "default": "./build/lib/mask/$.js"
     },
@@ -104,33 +133,24 @@
     "#lib/path-map/path-map": {
       "default": "./build/lib/path-map/$$.js"
     },
-    "#lib/react-router-aid": {
-      "default": "./build/lib/react-router-aid/$.js"
-    },
-    "#lib/react-router-aid/react-router-aid": {
-      "default": "./build/lib/react-router-aid/$$.js"
+    "#lib/react-router-effect": {
+      "default": "./build/lib/react-router-effect/$.js"
     },
-    "#lib/react-router-loader": {
-      "default": "./build/lib/react-router-loader/$.js"
+    "#lib/react-router-effect/react-router-effect": {
+      "default": "./build/lib/react-router-effect/$$.js"
     },
-    "#lib/react-router-loader/react-router-loader": {
-      "default": "./build/lib/react-router-loader/$$.js"
+    "#lib/kit-temp": {
+      "default": "./build/lib/kit-temp/$.js"
     },
-    "#lib/schema-lifecycle": {
-      "default": "./build/lib/schema-lifecycle/$.js"
+    "#lib/file-path": {
+      "default": "./build/lib/file-path/$.js"
     },
-    "#lib/schema-lifecycle/schema-lifecycle": {
-      "default": "./build/lib/schema-lifecycle/$$.js"
+    "#lib/file-path/file-path": {
+      "default": "./build/lib/file-path/$$.js"
     },
     "#lib/stack-processor": {
       "default": "./build/lib/stack-processor/$.js"
     },
-    "#lib/superjson-codec": {
-      "default": "./build/lib/superjson-codec/$.js"
-    },
-    "#lib/superjson-codec/superjson-codec": {
-      "default": "./build/lib/superjson-codec/$$.js"
-    },
     "#lib/task": {
       "default": "./build/lib/task/$.js"
     },
@@ -169,6 +189,12 @@
     },
     "#template/components/content/$$": {
       "default": "./build/template/components/content/$$.js"
+    },
+    "#lib/memory-filesystem": {
+      "default": "./build/lib/memory-filesystem/$.js"
+    },
+    "#lib/memory-filesystem/memory-filesystem": {
+      "default": "./build/lib/memory-filesystem/$$.js"
     }
   },
   "exports": {
@@ -207,21 +233,24 @@
   ],
   "dependencies": {
     "@0no-co/graphql.web": "^1.1.2",
+    "@effect/cli": "^0.63.0",
+    "@effect/platform": "^0.90.0",
+    "@effect/platform-node": "^0.94.0",
     "@graphql-inspector/core": "^6.2.1",
-    "@graphql-tools/load": "^8.1.0",
+    "@graphql-tools/load": "^8.1.2",
     "@hiogawa/vite-plugin-ssr-css": "^0.0.1",
-    "@hono/node-server": "^1.16.0",
+    "@hono/node-server": "^1.17.1",
     "@mdx-js/mdx": "^3.1.0",
     "@mdx-js/react": "^3.1.0",
     "@mdx-js/rollup": "^3.1.0",
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/themes": "^3.2.1",
-    "@rolldown/pluginutils": "1.0.0-beta.27",
+    "@rolldown/pluginutils": "1.0.0-beta.29",
     "@rollup/pluginutils": "^5.2.0",
     "@types/jsesc": "^3.0.3",
-    "@vitejs/plugin-react": "^4.6.0",
-    "@vitejs/plugin-react-oxc": "^0.2.3",
-    "@vltpkg/semver": "0.0.0-17",
+    "@vitejs/plugin-react": "^4.7.0",
+    "@vitejs/plugin-react-oxc": "^0.3.0",
+    "@vltpkg/semver": "0.0.0-18",
     "@vue/reactivity": "^3.5.17",
     "@wollybeard/kit": "^0.41.0",
     "@wollybeard/projector": "^0.3.0",
@@ -230,8 +259,10 @@
     "codehike": "^1.0.7",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
+    "effect": "^3.17.0",
     "es-toolkit": "^1.39.7",
     "fuse.js": "^7.1.0",
+    "get-port": "^7.1.0",
     "graffle": "8.0.0-next.163",
     "graphql": "^16.11.0",
     "gray-matter": "^4.0.3",
@@ -240,7 +271,7 @@
     "jsonc-parser": "^3.3.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
-    "react-router": "^7.6.3",
+    "react-router": "^7.7.0",
     "rehype-stringify": "^10.0.1",
     "remark": "^15.0.1",
     "remark-frontmatter": "^5.0.0",
@@ -249,18 +280,19 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "resolve.imports": "^2.0.3",
-    "rolldown": "1.0.0-beta.27",
+    "rolldown": "1.0.0-beta.29",
     "simple-git": "^3.28.0",
     "source-map": "^0.7.4",
     "superjson": "^2.2.2",
     "tinyglobby": "^0.2.14",
     "tree-sitter-graphql-grammar-wasm": "^1.1.0",
     "tsx": "^4.20.3",
-    "typescript": "^5.8.3",
+    "type-fest": "^4.41.0",
+    "typescript": "^5.9.2",
     "unified": "^11.0.5",
     "valtio": "^2.1.5",
     "vfile": "^6.0.3",
-    "vite": "npm:rolldown-vite@^7.0.9",
+    "vite": "npm:rolldown-vite@^7.0.10",
     "vite-plugin-inspect": "^11.3.0",
     "web-tree-sitter": "^0.25.8",
     "youch-core": "^0.3.3",
@@ -273,6 +305,7 @@
     "@actions/glob": "^0.5.0",
     "@actions/io": "^1.1.3",
     "@changesets/cli": "^2.29.5",
+    "@effect/vitest": "^0.25.0",
     "@molt/command": "^0.9.0",
     "@octokit/core": "^7.0.3",
     "@octokit/types": "^14.1.0",
@@ -282,7 +315,7 @@
     "@tsconfig/node22": "^22.0.2",
     "@tsconfig/strictest": "^2.0.5",
     "@types/jsdom": "^21.1.7",
-    "@types/node": "^24.0.14",
+    "@types/node": "^24.1.0",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "@types/semver": "^7.7.0",
@@ -297,7 +330,6 @@
     "publint": "^0.3.12",
     "semver": "^7.7.2",
     "strip-ansi": "^7.1.0",
-    "type-fest": "^4.41.0",
     "typescript": "^5.8.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4",
@@ -310,9 +342,11 @@
     "sb": "pnpm sandbox",
     "sb:w": "pnpm sandbox:watch",
     "polen": "tsx ./src/cli/index.ts",
+    "polen-effect": "tsx ./src/cli-effect/index.ts",
     "test:examples": "playwright test --config 'tests/playwright.config.ts' --project=examples",
     "test:integration": "playwright test --config 'tests/playwright.config.ts' --project=integration",
     "test:unit": "vitest",
+    "test:e2e": "vitest tests/e2e",
     "dev": "pnpm build:watch:emit",
     "dev:hive": "pnpm polen dev --project examples/hive",
     "dev:pokemon": "pnpm polen dev --project examples/pokemon",
@@ -337,7 +371,8 @@
     "fix": "pnpm run '/^fix:.+/'",
     "f": "pnpm run '/^fix:.+/'",
     "fc": "pnpm run '/^fix:.+/' && pnpm run '/^check:(?!pedantic:).+/'",
-    "release": "dripip stable"
+    "release": "dripip stable",
+    "refresh:serena-prompt": "serena print-system-prompt > .claude/prompt.md"
   },
   "bin": "./build/cli/index.js"
 }

package/src/api/api.ts

@@ -1,13 +1,8 @@
-// Re-export everything from isomorphic layer
-export * from './iso/$$.js'
-
-// Server-only exports
 export * from './builder/index.js'
 export * from './cache/$.js'
 export * from './config-resolver/index.js'
-export * from './config/index.js'
+export * from './config/$.js'
 export * as Project from './project/index.js'
+export * from './routes/$.js'
+export { Schema } from './schema/$.js'
 export * from './static/index.js'
-
-// Re-export schema with server-only extensions
-export { Schema } from './schema/index.js'

package/src/api/builder/builder.ts

@@ -1,35 +1,53 @@
 import { ConfigResolver } from '#api/config-resolver/index'
-import type { ConfigInput } from '#api/config/configurator'
-import { Config } from '#api/config/index'
 import { Vite } from '#dep/vite/index'
-import { Fs } from '@wollybeard/kit'
+import { toViteUserConfig } from '#vite/config'
+import { FileSystem } from '@effect/platform/FileSystem'
 import consola from 'consola'
+import { Effect } from 'effect'
+import type { Config } from '../config/$.js'
+import { generate } from './ssg/generate.js'
 
 interface BuildInput {
   dir: string
-  overrides?: Partial<ConfigInput>
+  overrides?: Partial<Config.ConfigInput>
 }
 
-export const build = async (input: BuildInput) => {
-  const viteUserConfig = await ConfigResolver.fromFile({
-    dir: input.dir,
-    overrides: input.overrides,
-  })
+export const build = (input: BuildInput): Effect.Effect<void, Error, FileSystem> =>
+  Effect.gen(function*() {
+    const polenConfig = yield* ConfigResolver.fromFile({
+      dir: input.dir,
+      overrides: input.overrides,
+    })
 
-  const builder = await Vite.createBuilder(viteUserConfig)
-  await builder.buildApp()
-
-  const architecture = viteUserConfig._polen.build.architecture
-  if (architecture === `ssg`) {
-    consola.info(`Generating static site...`)
-    await import(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint)
-    // Clean up server file which should now be done being used for SSG geneation.
-    await Fs.remove(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint)
-    // todo: there is also some kind of prompt js asset that we probably need to clean up or review...
-    consola.success(`Done`)
-    consola.info(`try it: npx serve ${viteUserConfig._polen.paths.project.relative.build.root} -p 4000`)
-  } else if (architecture === `ssr`) {
-    consola.info(`try it: node ${viteUserConfig._polen.paths.project.relative.build.root}/app.js`)
-    consola.info(`Then visit http://localhost:${viteUserConfig._polen.server.port}`)
-  }
-}
+    const viteUserConfig = toViteUserConfig(polenConfig)
+
+    const builder = yield* Effect.tryPromise({
+      try: () => Vite.createBuilder(viteUserConfig),
+      catch: (error) => new Error(`Failed to create Vite builder: ${error}`),
+    })
+
+    yield* Effect.tryPromise({
+      try: () => builder.buildApp(),
+      catch: (error) => new Error(`Failed to build app: ${error}`),
+    })
+
+    const architecture = viteUserConfig._polen.build.architecture
+    if (architecture === `ssg`) {
+      // Run SSG generation directly from the builder
+      yield* generate(viteUserConfig._polen)
+
+      // Clean up server file which is not needed for static sites
+      const fs = yield* FileSystem
+      const serverEntrypoint = viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint
+      const exists = yield* fs.exists(serverEntrypoint)
+      if (exists) {
+        yield* fs.remove(serverEntrypoint)
+      }
+
+      // todo: there is also some kind of prompt js asset that we probably need to clean up or review...
+      consola.info(`try it: npx serve ${viteUserConfig._polen.paths.project.relative.build.root} -p 4000`)
+    } else if (architecture === `ssr`) {
+      consola.info(`try it: node ${viteUserConfig._polen.paths.project.relative.build.root}/app.js`)
+      consola.info(`Then visit http://localhost:${viteUserConfig._polen.server.port}`)
+    }
+  })