@webjsdev/cli 0.10.34 → 0.10.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webjsdev/cli",
-  "version": "0.10.34",
+  "version": "0.10.35",
   "type": "module",
   "description": "webjs CLI - dev, start, create, db",
   "bin": {

package/templates/AGENTS.md

@@ -351,7 +351,11 @@ app/                     ROUTING ONLY: thin route adapters (import from modules/
   layout.ts              root layout, wraps every page
   error.ts               error boundary (render failures → user-friendly)
   loading.ts             Suspense fallback for sibling page
-  not-found.ts           custom 404 page
+  not-found.ts           custom 404 page (nearest wins on notFound())
+  forbidden.ts           403 page (nearest wins on forbidden())
+  unauthorized.ts        401 page (nearest wins on unauthorized())
+  global-error.ts        root-only app-wide error boundary (owns its <html>)
+  global-not-found.ts    root-only 404 for an unmatched-anywhere URL
   middleware.ts          global request middleware
   [slug]/page.ts         dynamic route segment
   [...rest]/page.ts      catch-all
@@ -392,6 +396,8 @@ test/<feature>/                feature-scoped tests, one folder per concern
   e2e/<name>.test.ts            end-to-end test (full app boot, opt in via WEBJS_E2E=1)
   smoke/<name>.test.ts          fast post-deploy sanity check
 middleware.ts            root middleware (optional, outermost)
+instrumentation.ts       optional boot hook: register() runs once; wire APM via setOnError
+instrumentation-client.ts  optional client boot hook, runs first before app modules
 ```
 
 ### The gallery (reference content, prune it)

package/templates/CONVENTIONS.md

@@ -495,11 +495,17 @@ Routes live under `app/` and follow NextJs App Router conventions:
 - `app/**/layout.ts`: Layout wrapper
 - `app/**/error.ts`: Error boundary
 - `app/**/middleware.ts`: Per-segment middleware
+- `instrumentation.ts` (app root): optional boot hook. `register()` runs once at startup; call `setOnError()` (from `@webjsdev/server`) inside it to wire an APM error sink (composes with `createRequestHandler({ onError })`).
+- `instrumentation-client.ts` (app root): optional client boot hook, imported first in the browser boot so it runs before app modules.
 
 **Special route files:**
 - `app/**/error.ts`: Error boundary. Default export receives `{ error }`, returns `TemplateResult`. Nearest boundary catches errors from pages below it.
 - `app/**/loading.ts`: Loading state. Auto-wraps the sibling page in a `Suspense` boundary. Shown while async page functions resolve.
 - `app/**/not-found.ts`: 404 page. Nearest wins when `notFound()` is thrown.
+- `app/**/forbidden.ts`: 403 page. Nearest wins when `forbidden()` is thrown (an authenticated user who lacks permission).
+- `app/**/unauthorized.ts`: 401 page. Nearest wins when `unauthorized()` is thrown (a request that is not authenticated).
+- `app/global-error.ts` (root only): app-wide error boundary, tried after nested `error.ts` boundaries. Renders its OWN `<!doctype><html><body>` document.
+- `app/global-not-found.ts` (root only): 404 for a URL that matches nothing anywhere.
 - `app/sitemap.ts`: Dynamic sitemap at `/sitemap.xml`. Export a function returning an array of `{ url, lastModified }`.
 - `app/robots.ts`: Dynamic robots.txt at `/robots.txt`.
 - `app/manifest.ts`: Web app manifest at `/manifest.json`.

package/templates/gallery/app/features/routing/[id]/page.ts

@@ -2,6 +2,10 @@
 // (possibly async) function receiving { params, searchParams, url }; it runs
 // ONLY on the server. Throw notFound() / redirect() to short-circuit.
 //
+// params / searchParams are BOTH synchronously readable AND awaitable: read
+// `params.id` directly, or `const { id } = await params` (the Next 15/16
+// pattern, supported so that muscle memory transfers). Either form is correct.
+//
 // Type-safe routes: instead of hand-typing `{ params: { id: string } }`, type
 // the props with PageProps<'<route>'>. `webjs types` (run automatically by
 // `webjs dev`) generates .webjs/routes.d.ts with a Route union and per-route
@@ -11,14 +15,18 @@
 import { html } from '@webjsdev/core';
 import type { PageProps } from '@webjsdev/core';
 
-export default function RoutingParam({ params }: PageProps<'/features/routing/[id]'>) {
+export default async function RoutingParam({ params }: PageProps<'/features/routing/[id]'>) {
+  // The Next-style await also works; `params.id` sync would be identical.
+  const { id } = await params;
   return html`
     <h1 class="text-h2 font-bold mb-4">Route param</h1>
-    <p>The <code>[id]</code> segment is: <strong>${params.id}</strong></p>
+    <p>The <code>[id]</code> segment is: <strong>${id}</strong></p>
     <p class="text-muted-foreground text-sm mt-3">
       Typed with <code class="font-mono">PageProps&lt;'/features/routing/[id]'&gt;</code>,
       so <code class="font-mono">params.id</code> is a checked
       <code class="font-mono">string</code> from the generated route union.
+      <code class="font-mono">params</code> is awaitable too:
+      <code class="font-mono">const { id } = await params</code> works, same value.
     </p>
     <p class="mt-3"><a class="text-primary" href="/features/routing">Back</a></p>
   `;