@pracht/adapter-static 0.1.3 → 0.2.0

package/dist/index.d.mts

@@ -35,6 +35,11 @@ declare function createStaticServerEntryModule(options?: StaticAdapterOptions):
  * anything that needs a server: `render: "ssr"` / `"isg"` routes, SPA
  * loaders, request middleware, API routes, and network-exposed capabilities.
  * SSG loaders run at build time; static SPA routes are loaderless.
+ *
+ * The `notFound` page may use `hydration: "islands"` or `"none"` to keep the
+ * client router out of `404.html`, at the cost of the page knowing which URL
+ * was requested. Configuring `fallback` requires full hydration there, because
+ * that document is built from the not-found page's serialized route state.
  */
 declare function staticAdapter(options?: StaticAdapterOptions): PrachtAdapter;
 //#endregion

package/dist/index.mjs

@@ -42,6 +42,17 @@ function createStaticServerEntryModule(options = {}) {
 		"// convention). Returns null when the app declares none.",
 		"export async function renderStaticNotFoundHtml() {",
 		"  if (!resolvedApp.notFound) return null;",
+		"  // Work the page registers with `waitUntil()` finishes before the build",
+		"  // moves on; each task arrives guarded, so none of them reject.",
+		"  const backgroundWork = [];",
+		"  try {",
+		"    return await renderNotFoundDocument((task) => backgroundWork.push(task));",
+		"  } finally {",
+		"    while (backgroundWork.length > 0) await Promise.allSettled(backgroundWork.splice(0));",
+		"  }",
+		"}",
+		"",
+		"async function renderNotFoundDocument(waitUntil) {",
 		"  let renderError;",
 		"  const response = await handlePrachtRequest({",
 		"    app: staticNotFoundApp,",
@@ -53,7 +64,12 @@ function createStaticServerEntryModule(options = {}) {
 		"    cssManifest,",
 		"    cssContentManifest,",
 		"    jsManifest,",
-		"    onRouteError: (error) => {",
+		"    waitUntil,",
+		"    onRouteError: (error, requestPath, context) => {",
+		"      if (context?.phase === \"waitUntil\") {",
+		"        console.error(`[pracht] waitUntil error at ${requestPath}:`, error);",
+		"        return;",
+		"      }",
 		"      renderError = error;",
 		"    },",
 		"  });",
@@ -112,6 +128,11 @@ function createStaticServerEntryModule(options = {}) {
 * anything that needs a server: `render: "ssr"` / `"isg"` routes, SPA
 * loaders, request middleware, API routes, and network-exposed capabilities.
 * SSG loaders run at build time; static SPA routes are loaderless.
+*
+* The `notFound` page may use `hydration: "islands"` or `"none"` to keep the
+* client router out of `404.html`, at the cost of the page knowing which URL
+* was requested. Configuring `fallback` requires full hydration there, because
+* that document is built from the not-found page's serialized route state.
 */
 function staticAdapter(options = {}) {
 	assertValidStaticAdapterOptions(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pracht/adapter-static",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Static-export adapter for Pracht: prerender every route and deploy dist/client to any static host with zero server.",
   "keywords": [
     "pracht",
@@ -39,8 +39,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@pracht/adapter-node": "0.4.3",
-    "@pracht/core": "0.17.0"
+    "@pracht/adapter-node": "0.5.0",
+    "@pracht/core": "0.19.0"
   },
   "scripts": {
     "build": "tsdown"