fix windoes build

chore(nextjs): update configuration for fs-safe package handling in Cloudflare and Vercel examples

- Added `@openclaw/fs-safe` to `serverExternalPackages` in Cloudflare example to prevent build failures with Turbopack.
- Updated Vercel example to include `@openclaw/fs-safe` in the external packages list, with comments explaining its native helper loading issue.
- Documented deployment examples in the registry for clarity on CI typechecking and build processes.

Author: heavy-d

examples/nextjs-cloudflare/next.config.mjs

@@ -5,6 +5,14 @@ const nextConfig = {
   // Unlike the Vercel example, we do NOT mark the @nodetool-ai/* packages as
   // external: OpenNext bundles everything into the Worker, and `nodejs_compat`
   // (wrangler.jsonc) supplies the Node built-ins the runtime stack lazy-loads.
+  //
+  // The one exception is fs-safe (a @nodetool-ai/storage dependency). It loads
+  // its native helper with `new URL("../dist/native/", import.meta.url)` +
+  // `require`, which Turbopack cannot resolve statically and fails the build
+  // on. Kept external here; OpenNext copies it into the Worker bundle from the
+  // route trace, and the missing `.node` binary there makes fs-safe fall back
+  // to its JS path (its native mode defaults to "auto").
+  serverExternalPackages: ["@openclaw/fs-safe"]
 };
 
 // Enable Cloudflare bindings (R2, KV, secrets, etc.) during `next dev`.

examples/nextjs-vercel/next.config.mjs

@@ -10,7 +10,13 @@ const nextConfig = {
     "@nodetool-ai/node-sdk",
     "@nodetool-ai/nodes-utils",
     "@nodetool-ai/core-nodes",
-    "@nodetool-ai/llm-nodes"
+    "@nodetool-ai/llm-nodes",
+    // fs-safe (a @nodetool-ai/storage dependency) loads its native helper with
+    // `new URL("../dist/native/", import.meta.url)` + `require`, which
+    // Turbopack cannot resolve statically. Inside the monorepo the
+    // @nodetool-ai/* entries above are symlinked workspaces, not
+    // node_modules, so Next bundles them anyway and reaches this import.
+    "@openclaw/fs-safe"
   ]
 };
 

packages/cli/src/harness/registry.ts

@@ -1515,6 +1515,13 @@ export const SURFACES: SurfaceEntry[] = [
  * one that is in neither.
  */
 export const UNCLAIMED_PATHS: Record<string, string> = {
+  "examples/nextjs-vercel/":
+    "Deployment example app. CI typechecks it (`npm run typecheck:examples`); " +
+    "its `next build` costs minutes and belongs to deploys, not the PR gate. " +
+    "No harness drives it headlessly.",
+  "examples/nextjs-cloudflare/":
+    "Deployment example app, same standing as examples/nextjs-vercel/: " +
+    "typechecked in CI, built only on deploy, no headless harness.",
   "packages/compute/":
     "Provisions and reaps real RunPod/Vast.ai GPU workers; only its hermetic " +
     "unit tests run headlessly today. A harness needs a recorded-fixture " +