@decocms/nextjs 7.2.3 → 7.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/nextjs",
-  "version": "7.2.3",
+  "version": "7.3.1",
   "type": "module",
   "description": "Deco framework binding for Next.js App Router",
   "repository": {
@@ -10,7 +10,8 @@
   },
   "main": "./src/index.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./routeHandlers": "./src/routeHandlers.ts"
   },
   "scripts": {
     "build": "tsc",
@@ -19,8 +20,8 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "7.2.3",
-    "@decocms/blocks-admin": "7.2.3"
+    "@decocms/blocks": "7.3.1",
+    "@decocms/blocks-admin": "7.3.1"
   },
   "peerDependencies": {
     "next": ">=15.0.0",

package/src/routeHandlers.ts

@@ -1,3 +1,20 @@
+/**
+ * Admin Route Handlers for Next.js App Router.
+ *
+ * IMPORT THESE FROM `@decocms/nextjs/routeHandlers` IN ROUTE FILES — never
+ * from the `@decocms/nextjs` root barrel. Route handlers (app router
+ * route.ts files) evaluate their whole module graph against React's
+ * react-server build and IGNORE `"use client"` directives (there is no
+ * client graph to move a module into). The root barrel also exports the
+ * render components (SectionRenderer, DecoRootLayout, ...), whose graph
+ * reaches `@decocms/blocks/hooks` — files with module-scope client-React
+ * usage (e.g. `class ... extends Component`) that the react-server build
+ * does not export. Importing the root barrel from a route file therefore
+ * crashes at module evaluation ("...createContext is not a function" /
+ * "Class extends value undefined is not a constructor") before the handler
+ * ever runs. This subpath keeps the route-handler graph free of all
+ * component code.
+ */
 import {
   handleDecofileRead,
   handleDecofileReload,
@@ -6,7 +23,7 @@ import {
   handleRender,
 } from "@decocms/blocks-admin";
 
-/** For app/live/_meta/route.ts: `export { metaGET as GET } from "@decocms/nextjs"` */
+/** For app/live/_meta/route.ts: `export { metaGET as GET } from "@decocms/nextjs/routeHandlers"` */
 export async function metaGET(request: Request): Promise<Response> {
   return handleMeta(request);
 }