@objectstack/nextjs 3.2.7 → 3.2.9

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/nextjs@3.2.7 build /home/runner/work/spec/spec/packages/adapters/nextjs
+> @objectstack/nextjs@3.2.9 build /home/runner/work/spec/spec/packages/adapters/nextjs
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.js     9.21 KB
-CJS dist/index.js.map 17.15 KB
-CJS ⚡️ Build success in 75ms
-ESM dist/index.mjs     7.97 KB
-ESM dist/index.mjs.map 17.10 KB
-ESM ⚡️ Build success in 81ms
+ESM dist/index.mjs     7.52 KB
+ESM dist/index.mjs.map 16.55 KB
+ESM ⚡️ Build success in 60ms
+CJS dist/index.js     8.76 KB
+CJS dist/index.js.map 16.60 KB
+CJS ⚡️ Build success in 71ms
 DTS Build start
-DTS ⚡️ Build success in 13930ms
-DTS dist/index.d.mts 2.48 KB
-DTS dist/index.d.ts  2.48 KB
+DTS ⚡️ Build success in 13961ms
+DTS dist/index.d.mts 2.63 KB
+DTS dist/index.d.ts  2.63 KB

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @objectstack/nextjs
 
+## 3.2.9
+
+### Patch Changes
+
+- @objectstack/runtime@3.2.9
+
+## 3.2.8
+
+### Patch Changes
+
+- @objectstack/runtime@3.2.8
+
+## 3.2.8
+
+### Patch Changes
+
+- fix: unified catch-all dispatch pattern — `createRouteHandler()` now delegates all non-framework-specific routes to `HttpDispatcher.dispatch()`, automatically supporting packages, analytics, automation, i18n, ui, openapi, custom endpoints, and any future routes
+- Only auth (service check), storage (formData), GraphQL (raw result), and discovery (response wrapper) remain as explicit routes
+
 ## 3.2.7
 
 ### Patch Changes

package/dist/index.d.mts

@@ -8,6 +8,9 @@ interface NextAdapterOptions {
 /**
  * Creates a route handler for Next.js App Router
  * Handles /api/[...objectstack] pattern
+ *
+ * Only auth, GraphQL, storage, and discovery need explicit handling.
+ * All other routes delegate to `HttpDispatcher.dispatch()` automatically.
  */
 declare function createRouteHandler(options: NextAdapterOptions): (req: NextRequest, { params }: {
     params: {

package/dist/index.d.ts

@@ -8,6 +8,9 @@ interface NextAdapterOptions {
 /**
  * Creates a route handler for Next.js App Router
  * Handles /api/[...objectstack] pattern
+ *
+ * Only auth, GraphQL, storage, and discovery need explicit handling.
+ * All other routes delegate to `HttpDispatcher.dispatch()` automatically.
  */
 declare function createRouteHandler(options: NextAdapterOptions): (req: NextRequest, { params }: {
     params: {

package/dist/index.js

@@ -76,43 +76,22 @@ function createRouteHandler(options) {
         }
         if (authService && typeof authService.handleRequest === "function") {
           const response = await authService.handleRequest(req);
-          const body2 = await response.text();
+          const body3 = await response.text();
           const headers = {};
           response.headers.forEach((v, k) => {
             headers[k] = v;
           });
-          return new import_server.NextResponse(body2, { status: response.status, headers });
+          return new import_server.NextResponse(body3, { status: response.status, headers });
         }
         const subPath = segments.slice(1).join("/");
-        const body = method === "POST" ? await req.json().catch(() => ({})) : {};
-        const result = await dispatcher.handleAuth(subPath, method, body, { request: req });
-        return toResponse(result);
+        const body2 = method === "POST" ? await req.json().catch(() => ({})) : {};
+        const result2 = await dispatcher.handleAuth(subPath, method, body2, { request: req });
+        return toResponse(result2);
       }
       if (segments[0] === "graphql" && method === "POST") {
-        const body = await req.json();
-        const result = await dispatcher.handleGraphQL(body, { request: rawRequest });
-        return import_server.NextResponse.json(result);
-      }
-      if (segments[0] === "meta") {
-        const subPath = segments.slice(1).join("/");
-        let body = void 0;
-        if (method === "PUT" || method === "POST") {
-          body = await req.json().catch(() => ({}));
-        }
-        const result = await dispatcher.handleMetadata(subPath, { request: rawRequest }, method, body);
-        return toResponse(result);
-      }
-      if (segments[0] === "data") {
-        const subPath = segments.slice(1).join("/");
-        let body = {};
-        if (method === "POST" || method === "PATCH") {
-          body = await req.json().catch(() => ({}));
-        }
-        const url = new URL(req.url);
-        const queryParams = {};
-        url.searchParams.forEach((val, key) => queryParams[key] = val);
-        const result = await dispatcher.handleData(subPath, method, body, queryParams, { request: rawRequest });
-        return toResponse(result);
+        const body2 = await req.json();
+        const result2 = await dispatcher.handleGraphQL(body2, { request: rawRequest });
+        return import_server.NextResponse.json(result2);
       }
       if (segments[0] === "storage") {
         const subPath = segments.slice(1).join("/");
@@ -121,10 +100,19 @@ function createRouteHandler(options) {
           const formData = await req.formData();
           file = formData.get("file");
         }
-        const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });
-        return toResponse(result);
+        const result2 = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });
+        return toResponse(result2);
+      }
+      const path = "/" + segments.join("/");
+      let body = void 0;
+      if (method === "POST" || method === "PUT" || method === "PATCH") {
+        body = await req.json().catch(() => ({}));
       }
-      return error("Not Found", 404);
+      const url = new URL(req.url);
+      const queryParams = {};
+      url.searchParams.forEach((val, key) => queryParams[key] = val);
+      const result = await dispatcher.dispatch(method, path, body, queryParams, { request: rawRequest });
+      return toResponse(result);
     } catch (err) {
       return error(err.message || "Internal Server Error", err.statusCode || 500);
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { type ObjectKernel, HttpDispatcher, HttpDispatcherResult } from '@objectstack/runtime';\n\nexport interface NextAdapterOptions {\n  kernel: ObjectKernel;\n  prefix?: string;\n}\n\n/**\n * Auth service interface with handleRequest method\n */\ninterface AuthService {\n  handleRequest(request: Request): Promise<Response>;\n}\n\n/**\n * Creates a route handler for Next.js App Router\n * Handles /api/[...objectstack] pattern\n */\nexport function createRouteHandler(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const error = (msg: string, code: number = 500) => NextResponse.json({ success: false, error: { message: msg, code } }, { status: code });\n\n  // Helper to convert DispatchResult to NextResponse\n  const toResponse = (result: HttpDispatcherResult) => {\n      if (result.handled) {\n          if (result.response) {\n               return NextResponse.json(result.response.body, { \n                   status: result.response.status, \n                   headers: result.response.headers \n               });\n          }\n          if (result.result) {\n              const res = result.result;\n              // Redirect\n              if (res.type === 'redirect' && res.url) {\n                  return NextResponse.redirect(res.url);\n              }\n              // Stream\n              if (res.type === 'stream' && res.stream) {\n                  return new NextResponse(res.stream, {\n                      status: 200,\n                      headers: res.headers\n                  });\n              }\n              // If it's a standard response object (like from another fetch)\n              // Next.js might handle it, or we return it directly\n              return res; \n          }\n      }\n      return error('Not Found', 404);\n  }\n\n  return async function handler(req: NextRequest, { params }: { params: { objectstack: string[] } }) {\n    const resolvedParams = await Promise.resolve(params);\n    const segments = resolvedParams.objectstack || [];\n    const method = req.method;\n    \n    // --- 0. Discovery Endpoint ---\n    if (segments.length === 0 && method === 'GET') {\n      return NextResponse.json({ data: await dispatcher.getDiscoveryInfo(options.prefix || '/api') });\n    }\n\n    try {\n        const rawRequest = req;\n\n        // --- 1. Auth ---\n        if (segments[0] === 'auth') {\n           // Try AuthPlugin service first (prefer async to support factory-based services)\n           let authService: AuthService | null = null;\n           try {\n             if (typeof options.kernel.getServiceAsync === 'function') {\n               authService = await options.kernel.getServiceAsync<AuthService>('auth');\n             } else if (typeof options.kernel.getService === 'function') {\n               authService = options.kernel.getService<AuthService>('auth');\n             }\n           } catch {\n             // Service not registered — fall through to dispatcher\n             authService = null;\n           }\n\n           if (authService && typeof authService.handleRequest === 'function') {\n             const response = await authService.handleRequest(req);\n             // Convert Web Response to NextResponse\n             const body = await response.text();\n             const headers: Record<string, string> = {};\n             response.headers.forEach((v: string, k: string) => { headers[k] = v; });\n             return new NextResponse(body, { status: response.status, headers });\n           }\n\n           // Fallback to legacy dispatcher\n           const subPath = segments.slice(1).join('/');\n           const body = method === 'POST' ? await req.json().catch(() => ({})) : {};\n           const result = await dispatcher.handleAuth(subPath, method, body, { request: req });\n           return toResponse(result);\n        }\n\n        // --- 2. GraphQL ---\n        if (segments[0] === 'graphql' && method === 'POST') {\n            const body = await req.json();\n            const result = await dispatcher.handleGraphQL(body as any, { request: rawRequest } as any);\n            return NextResponse.json(result);\n        }\n\n        // --- 3. Metadata ---\n        if (segments[0] === 'meta') {\n            const subPath = segments.slice(1).join('/');\n            \n            let body: any = undefined;\n            if (method === 'PUT' || method === 'POST') {\n                body = await req.json().catch(() => ({}));\n            }\n\n            const result = await dispatcher.handleMetadata(subPath, { request: rawRequest }, method, body);\n            return toResponse(result);\n        }\n\n        // --- 4. Data ---\n        if (segments[0] === 'data') {\n            const subPath = segments.slice(1).join('/');\n            let body: any = {};\n            if (method === 'POST' || method === 'PATCH') {\n                body = await req.json().catch(() => ({}));\n            }\n            \n            // Extract query params\n            const url = new URL(req.url);\n            const queryParams: Record<string, any> = {};\n            url.searchParams.forEach((val, key) => queryParams[key] = val);\n\n            const result = await dispatcher.handleData(subPath, method, body, queryParams, { request: rawRequest } as any);\n            return toResponse(result);\n        }\n\n        // --- 5. Storage ---\n        if (segments[0] === 'storage') {\n            const subPath = segments.slice(1).join('/');\n            \n            let file: any = undefined;\n            if (method === 'POST' && subPath === 'upload') {\n                const formData = await req.formData();\n                file = formData.get('file');\n            }\n\n            const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });\n            return toResponse(result);\n        }\n        \n        return error('Not Found', 404);\n\n    } catch (err: any) {\n        return error(err.message || 'Internal Server Error', err.statusCode || 500);\n    }\n  }\n}\n\n/**\n * Creates a discovery handler for Next.js App Router\n * Handles /.well-known/objectstack\n */\nexport function createDiscoveryHandler(options: NextAdapterOptions) {\n  return async function discoveryHandler(req: NextRequest) {\n      const apiPath = options.prefix || '/api';\n      const url = new URL(req.url);\n      const targetUrl = new URL(apiPath, url.origin);\n      return NextResponse.redirect(targetUrl);\n  }\n}\n\n// ─── Server Actions ──────────────────────────────────────────────────────────\n\n/**\n * Result type for server actions\n */\nexport interface ServerActionResult<T = any> {\n  success: boolean;\n  data?: T;\n  error?: { message: string; code: number };\n}\n\n/**\n * Creates type-safe React Server Actions for ObjectStack data operations.\n * Each action maps to a dispatcher method and can be called directly from\n * React Server Components or client components via `\"use server\"`.\n *\n * @example\n * ```ts\n * // app/actions.ts\n * \"use server\";\n * import { createServerActions } from '@objectstack/nextjs';\n * import { kernel } from '@/lib/kernel';\n *\n * const actions = createServerActions({ kernel });\n *\n * export async function getAccounts() {\n *   return actions.query('account');\n * }\n *\n * export async function createAccount(formData: FormData) {\n *   return actions.create('account', {\n *     name: formData.get('name') as string,\n *   });\n * }\n * ```\n */\nexport function createServerActions(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const emptyContext = { request: undefined };\n\n  return {\n    /**\n     * Query records from an object\n     */\n    async query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'GET', {}, params || {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get a single record by ID\n     */\n    async getById(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'GET', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Create a new record\n     */\n    async create(objectName: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'POST', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Create failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Update a record by ID\n     */\n    async update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'PATCH', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Update failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Delete a record by ID\n     */\n    async remove(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'DELETE', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Delete failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get metadata for objects\n     */\n    async getMetadata(path?: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleMetadata(path || '', emptyContext, 'GET');\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["body"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { type ObjectKernel, HttpDispatcher, HttpDispatcherResult } from '@objectstack/runtime';\n\nexport interface NextAdapterOptions {\n  kernel: ObjectKernel;\n  prefix?: string;\n}\n\n/**\n * Auth service interface with handleRequest method\n */\ninterface AuthService {\n  handleRequest(request: Request): Promise<Response>;\n}\n\n/**\n * Creates a route handler for Next.js App Router\n * Handles /api/[...objectstack] pattern\n *\n * Only auth, GraphQL, storage, and discovery need explicit handling.\n * All other routes delegate to `HttpDispatcher.dispatch()` automatically.\n */\nexport function createRouteHandler(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const error = (msg: string, code: number = 500) => NextResponse.json({ success: false, error: { message: msg, code } }, { status: code });\n\n  // Helper to convert DispatchResult to NextResponse\n  const toResponse = (result: HttpDispatcherResult) => {\n      if (result.handled) {\n          if (result.response) {\n               return NextResponse.json(result.response.body, { \n                   status: result.response.status, \n                   headers: result.response.headers \n               });\n          }\n          if (result.result) {\n              const res = result.result;\n              // Redirect\n              if (res.type === 'redirect' && res.url) {\n                  return NextResponse.redirect(res.url);\n              }\n              // Stream\n              if (res.type === 'stream' && res.stream) {\n                  return new NextResponse(res.stream, {\n                      status: 200,\n                      headers: res.headers\n                  });\n              }\n              // If it's a standard response object (like from another fetch)\n              // Next.js might handle it, or we return it directly\n              return res; \n          }\n      }\n      return error('Not Found', 404);\n  }\n\n  return async function handler(req: NextRequest, { params }: { params: { objectstack: string[] } }) {\n    const resolvedParams = await Promise.resolve(params);\n    const segments = resolvedParams.objectstack || [];\n    const method = req.method;\n    \n    // --- 0. Discovery Endpoint ---\n    if (segments.length === 0 && method === 'GET') {\n      return NextResponse.json({ data: await dispatcher.getDiscoveryInfo(options.prefix || '/api') });\n    }\n\n    try {\n        const rawRequest = req;\n\n        // --- 1. Auth (needs auth service integration) ---\n        if (segments[0] === 'auth') {\n           // Try AuthPlugin service first (prefer async to support factory-based services)\n           let authService: AuthService | null = null;\n           try {\n             if (typeof options.kernel.getServiceAsync === 'function') {\n               authService = await options.kernel.getServiceAsync<AuthService>('auth');\n             } else if (typeof options.kernel.getService === 'function') {\n               authService = options.kernel.getService<AuthService>('auth');\n             }\n           } catch {\n             // Service not registered — fall through to dispatcher\n             authService = null;\n           }\n\n           if (authService && typeof authService.handleRequest === 'function') {\n             const response = await authService.handleRequest(req);\n             // Convert Web Response to NextResponse\n             const body = await response.text();\n             const headers: Record<string, string> = {};\n             response.headers.forEach((v: string, k: string) => { headers[k] = v; });\n             return new NextResponse(body, { status: response.status, headers });\n           }\n\n           // Fallback to legacy dispatcher\n           const subPath = segments.slice(1).join('/');\n           const body = method === 'POST' ? await req.json().catch(() => ({})) : {};\n           const result = await dispatcher.handleAuth(subPath, method, body, { request: req });\n           return toResponse(result);\n        }\n\n        // --- 2. GraphQL (returns raw result, not HttpDispatcherResult) ---\n        if (segments[0] === 'graphql' && method === 'POST') {\n            const body = await req.json();\n            const result = await dispatcher.handleGraphQL(body as any, { request: rawRequest } as any);\n            return NextResponse.json(result);\n        }\n\n        // --- 3. Storage (needs formData parsing) ---\n        if (segments[0] === 'storage') {\n            const subPath = segments.slice(1).join('/');\n            \n            let file: any = undefined;\n            if (method === 'POST' && subPath === 'upload') {\n                const formData = await req.formData();\n                file = formData.get('file');\n            }\n\n            const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });\n            return toResponse(result);\n        }\n\n        // --- 4. Catch-all: delegate to dispatcher.dispatch() ---\n        // Handles meta, data, packages, analytics, automation, i18n, ui,\n        // openapi, custom API endpoints, and any future routes.\n        const path = '/' + segments.join('/');\n\n        let body: any = undefined;\n        if (method === 'POST' || method === 'PUT' || method === 'PATCH') {\n            body = await req.json().catch(() => ({}));\n        }\n\n        const url = new URL(req.url);\n        const queryParams: Record<string, any> = {};\n        url.searchParams.forEach((val, key) => queryParams[key] = val);\n\n        const result = await dispatcher.dispatch(method, path, body, queryParams, { request: rawRequest });\n        return toResponse(result);\n\n    } catch (err: any) {\n        return error(err.message || 'Internal Server Error', err.statusCode || 500);\n    }\n  }\n}\n\n/**\n * Creates a discovery handler for Next.js App Router\n * Handles /.well-known/objectstack\n */\nexport function createDiscoveryHandler(options: NextAdapterOptions) {\n  return async function discoveryHandler(req: NextRequest) {\n      const apiPath = options.prefix || '/api';\n      const url = new URL(req.url);\n      const targetUrl = new URL(apiPath, url.origin);\n      return NextResponse.redirect(targetUrl);\n  }\n}\n\n// ─── Server Actions ──────────────────────────────────────────────────────────\n\n/**\n * Result type for server actions\n */\nexport interface ServerActionResult<T = any> {\n  success: boolean;\n  data?: T;\n  error?: { message: string; code: number };\n}\n\n/**\n * Creates type-safe React Server Actions for ObjectStack data operations.\n * Each action maps to a dispatcher method and can be called directly from\n * React Server Components or client components via `\"use server\"`.\n *\n * @example\n * ```ts\n * // app/actions.ts\n * \"use server\";\n * import { createServerActions } from '@objectstack/nextjs';\n * import { kernel } from '@/lib/kernel';\n *\n * const actions = createServerActions({ kernel });\n *\n * export async function getAccounts() {\n *   return actions.query('account');\n * }\n *\n * export async function createAccount(formData: FormData) {\n *   return actions.create('account', {\n *     name: formData.get('name') as string,\n *   });\n * }\n * ```\n */\nexport function createServerActions(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const emptyContext = { request: undefined };\n\n  return {\n    /**\n     * Query records from an object\n     */\n    async query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'GET', {}, params || {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get a single record by ID\n     */\n    async getById(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'GET', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Create a new record\n     */\n    async create(objectName: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'POST', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Create failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Update a record by ID\n     */\n    async update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'PATCH', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Update failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Delete a record by ID\n     */\n    async remove(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'DELETE', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Delete failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get metadata for objects\n     */\n    async getMetadata(path?: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleMetadata(path || '', emptyContext, 'GET');\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["body","result"]}

package/dist/index.mjs

@@ -50,43 +50,22 @@ function createRouteHandler(options) {
         }
         if (authService && typeof authService.handleRequest === "function") {
           const response = await authService.handleRequest(req);
-          const body2 = await response.text();
+          const body3 = await response.text();
           const headers = {};
           response.headers.forEach((v, k) => {
             headers[k] = v;
           });
-          return new NextResponse(body2, { status: response.status, headers });
+          return new NextResponse(body3, { status: response.status, headers });
         }
         const subPath = segments.slice(1).join("/");
-        const body = method === "POST" ? await req.json().catch(() => ({})) : {};
-        const result = await dispatcher.handleAuth(subPath, method, body, { request: req });
-        return toResponse(result);
+        const body2 = method === "POST" ? await req.json().catch(() => ({})) : {};
+        const result2 = await dispatcher.handleAuth(subPath, method, body2, { request: req });
+        return toResponse(result2);
       }
       if (segments[0] === "graphql" && method === "POST") {
-        const body = await req.json();
-        const result = await dispatcher.handleGraphQL(body, { request: rawRequest });
-        return NextResponse.json(result);
-      }
-      if (segments[0] === "meta") {
-        const subPath = segments.slice(1).join("/");
-        let body = void 0;
-        if (method === "PUT" || method === "POST") {
-          body = await req.json().catch(() => ({}));
-        }
-        const result = await dispatcher.handleMetadata(subPath, { request: rawRequest }, method, body);
-        return toResponse(result);
-      }
-      if (segments[0] === "data") {
-        const subPath = segments.slice(1).join("/");
-        let body = {};
-        if (method === "POST" || method === "PATCH") {
-          body = await req.json().catch(() => ({}));
-        }
-        const url = new URL(req.url);
-        const queryParams = {};
-        url.searchParams.forEach((val, key) => queryParams[key] = val);
-        const result = await dispatcher.handleData(subPath, method, body, queryParams, { request: rawRequest });
-        return toResponse(result);
+        const body2 = await req.json();
+        const result2 = await dispatcher.handleGraphQL(body2, { request: rawRequest });
+        return NextResponse.json(result2);
       }
       if (segments[0] === "storage") {
         const subPath = segments.slice(1).join("/");
@@ -95,10 +74,19 @@ function createRouteHandler(options) {
           const formData = await req.formData();
           file = formData.get("file");
         }
-        const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });
-        return toResponse(result);
+        const result2 = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });
+        return toResponse(result2);
+      }
+      const path = "/" + segments.join("/");
+      let body = void 0;
+      if (method === "POST" || method === "PUT" || method === "PATCH") {
+        body = await req.json().catch(() => ({}));
       }
-      return error("Not Found", 404);
+      const url = new URL(req.url);
+      const queryParams = {};
+      url.searchParams.forEach((val, key) => queryParams[key] = val);
+      const result = await dispatcher.dispatch(method, path, body, queryParams, { request: rawRequest });
+      return toResponse(result);
     } catch (err) {
       return error(err.message || "Internal Server Error", err.statusCode || 500);
     }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { type ObjectKernel, HttpDispatcher, HttpDispatcherResult } from '@objectstack/runtime';\n\nexport interface NextAdapterOptions {\n  kernel: ObjectKernel;\n  prefix?: string;\n}\n\n/**\n * Auth service interface with handleRequest method\n */\ninterface AuthService {\n  handleRequest(request: Request): Promise<Response>;\n}\n\n/**\n * Creates a route handler for Next.js App Router\n * Handles /api/[...objectstack] pattern\n */\nexport function createRouteHandler(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const error = (msg: string, code: number = 500) => NextResponse.json({ success: false, error: { message: msg, code } }, { status: code });\n\n  // Helper to convert DispatchResult to NextResponse\n  const toResponse = (result: HttpDispatcherResult) => {\n      if (result.handled) {\n          if (result.response) {\n               return NextResponse.json(result.response.body, { \n                   status: result.response.status, \n                   headers: result.response.headers \n               });\n          }\n          if (result.result) {\n              const res = result.result;\n              // Redirect\n              if (res.type === 'redirect' && res.url) {\n                  return NextResponse.redirect(res.url);\n              }\n              // Stream\n              if (res.type === 'stream' && res.stream) {\n                  return new NextResponse(res.stream, {\n                      status: 200,\n                      headers: res.headers\n                  });\n              }\n              // If it's a standard response object (like from another fetch)\n              // Next.js might handle it, or we return it directly\n              return res; \n          }\n      }\n      return error('Not Found', 404);\n  }\n\n  return async function handler(req: NextRequest, { params }: { params: { objectstack: string[] } }) {\n    const resolvedParams = await Promise.resolve(params);\n    const segments = resolvedParams.objectstack || [];\n    const method = req.method;\n    \n    // --- 0. Discovery Endpoint ---\n    if (segments.length === 0 && method === 'GET') {\n      return NextResponse.json({ data: await dispatcher.getDiscoveryInfo(options.prefix || '/api') });\n    }\n\n    try {\n        const rawRequest = req;\n\n        // --- 1. Auth ---\n        if (segments[0] === 'auth') {\n           // Try AuthPlugin service first (prefer async to support factory-based services)\n           let authService: AuthService | null = null;\n           try {\n             if (typeof options.kernel.getServiceAsync === 'function') {\n               authService = await options.kernel.getServiceAsync<AuthService>('auth');\n             } else if (typeof options.kernel.getService === 'function') {\n               authService = options.kernel.getService<AuthService>('auth');\n             }\n           } catch {\n             // Service not registered — fall through to dispatcher\n             authService = null;\n           }\n\n           if (authService && typeof authService.handleRequest === 'function') {\n             const response = await authService.handleRequest(req);\n             // Convert Web Response to NextResponse\n             const body = await response.text();\n             const headers: Record<string, string> = {};\n             response.headers.forEach((v: string, k: string) => { headers[k] = v; });\n             return new NextResponse(body, { status: response.status, headers });\n           }\n\n           // Fallback to legacy dispatcher\n           const subPath = segments.slice(1).join('/');\n           const body = method === 'POST' ? await req.json().catch(() => ({})) : {};\n           const result = await dispatcher.handleAuth(subPath, method, body, { request: req });\n           return toResponse(result);\n        }\n\n        // --- 2. GraphQL ---\n        if (segments[0] === 'graphql' && method === 'POST') {\n            const body = await req.json();\n            const result = await dispatcher.handleGraphQL(body as any, { request: rawRequest } as any);\n            return NextResponse.json(result);\n        }\n\n        // --- 3. Metadata ---\n        if (segments[0] === 'meta') {\n            const subPath = segments.slice(1).join('/');\n            \n            let body: any = undefined;\n            if (method === 'PUT' || method === 'POST') {\n                body = await req.json().catch(() => ({}));\n            }\n\n            const result = await dispatcher.handleMetadata(subPath, { request: rawRequest }, method, body);\n            return toResponse(result);\n        }\n\n        // --- 4. Data ---\n        if (segments[0] === 'data') {\n            const subPath = segments.slice(1).join('/');\n            let body: any = {};\n            if (method === 'POST' || method === 'PATCH') {\n                body = await req.json().catch(() => ({}));\n            }\n            \n            // Extract query params\n            const url = new URL(req.url);\n            const queryParams: Record<string, any> = {};\n            url.searchParams.forEach((val, key) => queryParams[key] = val);\n\n            const result = await dispatcher.handleData(subPath, method, body, queryParams, { request: rawRequest } as any);\n            return toResponse(result);\n        }\n\n        // --- 5. Storage ---\n        if (segments[0] === 'storage') {\n            const subPath = segments.slice(1).join('/');\n            \n            let file: any = undefined;\n            if (method === 'POST' && subPath === 'upload') {\n                const formData = await req.formData();\n                file = formData.get('file');\n            }\n\n            const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });\n            return toResponse(result);\n        }\n        \n        return error('Not Found', 404);\n\n    } catch (err: any) {\n        return error(err.message || 'Internal Server Error', err.statusCode || 500);\n    }\n  }\n}\n\n/**\n * Creates a discovery handler for Next.js App Router\n * Handles /.well-known/objectstack\n */\nexport function createDiscoveryHandler(options: NextAdapterOptions) {\n  return async function discoveryHandler(req: NextRequest) {\n      const apiPath = options.prefix || '/api';\n      const url = new URL(req.url);\n      const targetUrl = new URL(apiPath, url.origin);\n      return NextResponse.redirect(targetUrl);\n  }\n}\n\n// ─── Server Actions ──────────────────────────────────────────────────────────\n\n/**\n * Result type for server actions\n */\nexport interface ServerActionResult<T = any> {\n  success: boolean;\n  data?: T;\n  error?: { message: string; code: number };\n}\n\n/**\n * Creates type-safe React Server Actions for ObjectStack data operations.\n * Each action maps to a dispatcher method and can be called directly from\n * React Server Components or client components via `\"use server\"`.\n *\n * @example\n * ```ts\n * // app/actions.ts\n * \"use server\";\n * import { createServerActions } from '@objectstack/nextjs';\n * import { kernel } from '@/lib/kernel';\n *\n * const actions = createServerActions({ kernel });\n *\n * export async function getAccounts() {\n *   return actions.query('account');\n * }\n *\n * export async function createAccount(formData: FormData) {\n *   return actions.create('account', {\n *     name: formData.get('name') as string,\n *   });\n * }\n * ```\n */\nexport function createServerActions(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const emptyContext = { request: undefined };\n\n  return {\n    /**\n     * Query records from an object\n     */\n    async query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'GET', {}, params || {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get a single record by ID\n     */\n    async getById(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'GET', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Create a new record\n     */\n    async create(objectName: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'POST', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Create failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Update a record by ID\n     */\n    async update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'PATCH', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Update failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Delete a record by ID\n     */\n    async remove(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'DELETE', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Delete failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get metadata for objects\n     */\n    async getMetadata(path?: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleMetadata(path || '', emptyContext, 'GET');\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["body"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { type ObjectKernel, HttpDispatcher, HttpDispatcherResult } from '@objectstack/runtime';\n\nexport interface NextAdapterOptions {\n  kernel: ObjectKernel;\n  prefix?: string;\n}\n\n/**\n * Auth service interface with handleRequest method\n */\ninterface AuthService {\n  handleRequest(request: Request): Promise<Response>;\n}\n\n/**\n * Creates a route handler for Next.js App Router\n * Handles /api/[...objectstack] pattern\n *\n * Only auth, GraphQL, storage, and discovery need explicit handling.\n * All other routes delegate to `HttpDispatcher.dispatch()` automatically.\n */\nexport function createRouteHandler(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const error = (msg: string, code: number = 500) => NextResponse.json({ success: false, error: { message: msg, code } }, { status: code });\n\n  // Helper to convert DispatchResult to NextResponse\n  const toResponse = (result: HttpDispatcherResult) => {\n      if (result.handled) {\n          if (result.response) {\n               return NextResponse.json(result.response.body, { \n                   status: result.response.status, \n                   headers: result.response.headers \n               });\n          }\n          if (result.result) {\n              const res = result.result;\n              // Redirect\n              if (res.type === 'redirect' && res.url) {\n                  return NextResponse.redirect(res.url);\n              }\n              // Stream\n              if (res.type === 'stream' && res.stream) {\n                  return new NextResponse(res.stream, {\n                      status: 200,\n                      headers: res.headers\n                  });\n              }\n              // If it's a standard response object (like from another fetch)\n              // Next.js might handle it, or we return it directly\n              return res; \n          }\n      }\n      return error('Not Found', 404);\n  }\n\n  return async function handler(req: NextRequest, { params }: { params: { objectstack: string[] } }) {\n    const resolvedParams = await Promise.resolve(params);\n    const segments = resolvedParams.objectstack || [];\n    const method = req.method;\n    \n    // --- 0. Discovery Endpoint ---\n    if (segments.length === 0 && method === 'GET') {\n      return NextResponse.json({ data: await dispatcher.getDiscoveryInfo(options.prefix || '/api') });\n    }\n\n    try {\n        const rawRequest = req;\n\n        // --- 1. Auth (needs auth service integration) ---\n        if (segments[0] === 'auth') {\n           // Try AuthPlugin service first (prefer async to support factory-based services)\n           let authService: AuthService | null = null;\n           try {\n             if (typeof options.kernel.getServiceAsync === 'function') {\n               authService = await options.kernel.getServiceAsync<AuthService>('auth');\n             } else if (typeof options.kernel.getService === 'function') {\n               authService = options.kernel.getService<AuthService>('auth');\n             }\n           } catch {\n             // Service not registered — fall through to dispatcher\n             authService = null;\n           }\n\n           if (authService && typeof authService.handleRequest === 'function') {\n             const response = await authService.handleRequest(req);\n             // Convert Web Response to NextResponse\n             const body = await response.text();\n             const headers: Record<string, string> = {};\n             response.headers.forEach((v: string, k: string) => { headers[k] = v; });\n             return new NextResponse(body, { status: response.status, headers });\n           }\n\n           // Fallback to legacy dispatcher\n           const subPath = segments.slice(1).join('/');\n           const body = method === 'POST' ? await req.json().catch(() => ({})) : {};\n           const result = await dispatcher.handleAuth(subPath, method, body, { request: req });\n           return toResponse(result);\n        }\n\n        // --- 2. GraphQL (returns raw result, not HttpDispatcherResult) ---\n        if (segments[0] === 'graphql' && method === 'POST') {\n            const body = await req.json();\n            const result = await dispatcher.handleGraphQL(body as any, { request: rawRequest } as any);\n            return NextResponse.json(result);\n        }\n\n        // --- 3. Storage (needs formData parsing) ---\n        if (segments[0] === 'storage') {\n            const subPath = segments.slice(1).join('/');\n            \n            let file: any = undefined;\n            if (method === 'POST' && subPath === 'upload') {\n                const formData = await req.formData();\n                file = formData.get('file');\n            }\n\n            const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });\n            return toResponse(result);\n        }\n\n        // --- 4. Catch-all: delegate to dispatcher.dispatch() ---\n        // Handles meta, data, packages, analytics, automation, i18n, ui,\n        // openapi, custom API endpoints, and any future routes.\n        const path = '/' + segments.join('/');\n\n        let body: any = undefined;\n        if (method === 'POST' || method === 'PUT' || method === 'PATCH') {\n            body = await req.json().catch(() => ({}));\n        }\n\n        const url = new URL(req.url);\n        const queryParams: Record<string, any> = {};\n        url.searchParams.forEach((val, key) => queryParams[key] = val);\n\n        const result = await dispatcher.dispatch(method, path, body, queryParams, { request: rawRequest });\n        return toResponse(result);\n\n    } catch (err: any) {\n        return error(err.message || 'Internal Server Error', err.statusCode || 500);\n    }\n  }\n}\n\n/**\n * Creates a discovery handler for Next.js App Router\n * Handles /.well-known/objectstack\n */\nexport function createDiscoveryHandler(options: NextAdapterOptions) {\n  return async function discoveryHandler(req: NextRequest) {\n      const apiPath = options.prefix || '/api';\n      const url = new URL(req.url);\n      const targetUrl = new URL(apiPath, url.origin);\n      return NextResponse.redirect(targetUrl);\n  }\n}\n\n// ─── Server Actions ──────────────────────────────────────────────────────────\n\n/**\n * Result type for server actions\n */\nexport interface ServerActionResult<T = any> {\n  success: boolean;\n  data?: T;\n  error?: { message: string; code: number };\n}\n\n/**\n * Creates type-safe React Server Actions for ObjectStack data operations.\n * Each action maps to a dispatcher method and can be called directly from\n * React Server Components or client components via `\"use server\"`.\n *\n * @example\n * ```ts\n * // app/actions.ts\n * \"use server\";\n * import { createServerActions } from '@objectstack/nextjs';\n * import { kernel } from '@/lib/kernel';\n *\n * const actions = createServerActions({ kernel });\n *\n * export async function getAccounts() {\n *   return actions.query('account');\n * }\n *\n * export async function createAccount(formData: FormData) {\n *   return actions.create('account', {\n *     name: formData.get('name') as string,\n *   });\n * }\n * ```\n */\nexport function createServerActions(options: NextAdapterOptions) {\n  const dispatcher = new HttpDispatcher(options.kernel);\n  const emptyContext = { request: undefined };\n\n  return {\n    /**\n     * Query records from an object\n     */\n    async query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'GET', {}, params || {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get a single record by ID\n     */\n    async getById(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'GET', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Create a new record\n     */\n    async create(objectName: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}`, 'POST', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Create failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Update a record by ID\n     */\n    async update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'PATCH', data, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Update failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Delete a record by ID\n     */\n    async remove(objectName: string, id: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'DELETE', {}, {}, emptyContext);\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Delete failed', code: 500 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n\n    /**\n     * Get metadata for objects\n     */\n    async getMetadata(path?: string): Promise<ServerActionResult> {\n      try {\n        const result = await dispatcher.handleMetadata(path || '', emptyContext, 'GET');\n        if (result.handled && result.response) {\n          return { success: true, data: result.response.body };\n        }\n        return { success: false, error: { message: 'Not found', code: 404 } };\n      } catch (err: any) {\n        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["body","result"]}

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@objectstack/nextjs",
-  "version": "3.2.7",
+  "version": "3.2.9",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "peerDependencies": {
-    "next": "^16.1.6",
+    "next": "^16.1.7",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "@objectstack/runtime": "^3.2.7"
+    "@objectstack/runtime": "^3.2.9"
   },
   "devDependencies": {
-    "next": "^16.1.6",
+    "next": "^16.1.7",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "typescript": "^5.0.0",
-    "vitest": "^4.0.18",
-    "@objectstack/runtime": "3.2.7"
+    "vitest": "^4.1.0",
+    "@objectstack/runtime": "3.2.9"
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",

package/src/index.ts

@@ -18,6 +18,9 @@ interface AuthService {
 /**
  * Creates a route handler for Next.js App Router
  * Handles /api/[...objectstack] pattern
+ *
+ * Only auth, GraphQL, storage, and discovery need explicit handling.
+ * All other routes delegate to `HttpDispatcher.dispatch()` automatically.
  */
 export function createRouteHandler(options: NextAdapterOptions) {
   const dispatcher = new HttpDispatcher(options.kernel);
@@ -66,7 +69,7 @@ export function createRouteHandler(options: NextAdapterOptions) {
     try {
         const rawRequest = req;
 
-        // --- 1. Auth ---
+        // --- 1. Auth (needs auth service integration) ---
         if (segments[0] === 'auth') {
            // Try AuthPlugin service first (prefer async to support factory-based services)
            let authService: AuthService | null = null;
@@ -97,44 +100,14 @@ export function createRouteHandler(options: NextAdapterOptions) {
            return toResponse(result);
         }
 
-        // --- 2. GraphQL ---
+        // --- 2. GraphQL (returns raw result, not HttpDispatcherResult) ---
         if (segments[0] === 'graphql' && method === 'POST') {
             const body = await req.json();
             const result = await dispatcher.handleGraphQL(body as any, { request: rawRequest } as any);
             return NextResponse.json(result);
         }
 
-        // --- 3. Metadata ---
-        if (segments[0] === 'meta') {
-            const subPath = segments.slice(1).join('/');
-            
-            let body: any = undefined;
-            if (method === 'PUT' || method === 'POST') {
-                body = await req.json().catch(() => ({}));
-            }
-
-            const result = await dispatcher.handleMetadata(subPath, { request: rawRequest }, method, body);
-            return toResponse(result);
-        }
-
-        // --- 4. Data ---
-        if (segments[0] === 'data') {
-            const subPath = segments.slice(1).join('/');
-            let body: any = {};
-            if (method === 'POST' || method === 'PATCH') {
-                body = await req.json().catch(() => ({}));
-            }
-            
-            // Extract query params
-            const url = new URL(req.url);
-            const queryParams: Record<string, any> = {};
-            url.searchParams.forEach((val, key) => queryParams[key] = val);
-
-            const result = await dispatcher.handleData(subPath, method, body, queryParams, { request: rawRequest } as any);
-            return toResponse(result);
-        }
-
-        // --- 5. Storage ---
+        // --- 3. Storage (needs formData parsing) ---
         if (segments[0] === 'storage') {
             const subPath = segments.slice(1).join('/');
             
@@ -147,8 +120,23 @@ export function createRouteHandler(options: NextAdapterOptions) {
             const result = await dispatcher.handleStorage(subPath, method, file, { request: rawRequest });
             return toResponse(result);
         }
-        
-        return error('Not Found', 404);
+
+        // --- 4. Catch-all: delegate to dispatcher.dispatch() ---
+        // Handles meta, data, packages, analytics, automation, i18n, ui,
+        // openapi, custom API endpoints, and any future routes.
+        const path = '/' + segments.join('/');
+
+        let body: any = undefined;
+        if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+            body = await req.json().catch(() => ({}));
+        }
+
+        const url = new URL(req.url);
+        const queryParams: Record<string, any> = {};
+        url.searchParams.forEach((val, key) => queryParams[key] = val);
+
+        const result = await dispatcher.dispatch(method, path, body, queryParams, { request: rawRequest });
+        return toResponse(result);
 
     } catch (err: any) {
         return error(err.message || 'Internal Server Error', err.statusCode || 500);

package/src/metadata-api.test.ts

@@ -19,6 +19,7 @@ const mockDispatcher = {
   handleMetadata: vi.fn().mockResolvedValue({ handled: true, response: { body: { success: true }, status: 200 } }),
   handleData: vi.fn().mockResolvedValue({ handled: true, response: { body: { records: [] }, status: 200 } }),
   handleStorage: vi.fn().mockResolvedValue({ handled: true, response: { body: {}, status: 200 } }),
+  dispatch: vi.fn().mockResolvedValue({ handled: true, response: { body: { success: true }, status: 200 } }),
 };
 
 vi.mock('@objectstack/runtime', () => {
@@ -106,8 +107,8 @@ describe('Next.js Metadata API Integration Tests', () => {
 
   describe('CRUD Operations', () => {
     describe('GET meta/objects — List all objects', () => {
-      it('dispatches to handleMetadata with correct path', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+      it('dispatches to dispatch with correct path', async () => {
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -125,7 +126,7 @@ describe('Next.js Metadata API Integration Tests', () => {
         const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
         expect(res.status).toBe(200);
         expect(res.body.data).toHaveLength(2);
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'objects',
           expect.objectContaining({ request: expect.anything() }),
           'GET',
@@ -135,8 +136,8 @@ describe('Next.js Metadata API Integration Tests', () => {
     });
 
     describe('GET meta/objects/account — Get single object', () => {
-      it('dispatches to handleMetadata with item-level path', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+      it('dispatches to dispatch with item-level path', async () => {
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -151,7 +152,7 @@ describe('Next.js Metadata API Integration Tests', () => {
         const res = await handler(req, { params: { objectstack: ['meta', 'objects', 'account'] } });
         expect(res.status).toBe(200);
         expect(res.body.data.name).toBe('account');
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'objects/account',
           expect.objectContaining({ request: expect.anything() }),
           'GET',
@@ -168,7 +169,7 @@ describe('Next.js Metadata API Integration Tests', () => {
           data: { label: 'Project Task', fields: {} },
         };
 
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: { body: { success: true }, status: 201 },
         });
@@ -176,7 +177,7 @@ describe('Next.js Metadata API Integration Tests', () => {
         const req = makeReq('http://localhost/api/meta/objects', 'POST', body);
         const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
         expect(res.status).toBe(201);
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'objects',
           expect.objectContaining({ request: expect.anything() }),
           'POST',
@@ -189,7 +190,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       it('dispatches PUT with JSON body', async () => {
         const body = { label: 'Updated Account' };
 
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: { body: { success: true }, status: 200 },
         });
@@ -197,7 +198,7 @@ describe('Next.js Metadata API Integration Tests', () => {
         const req = makeReq('http://localhost/api/meta/objects/account', 'PUT', body);
         const res = await handler(req, { params: { objectstack: ['meta', 'objects', 'account'] } });
         expect(res.status).toBe(200);
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'objects/account',
           expect.objectContaining({ request: expect.anything() }),
           'PUT',
@@ -207,8 +208,8 @@ describe('Next.js Metadata API Integration Tests', () => {
     });
 
     describe('DELETE meta/objects/old_entity — Delete metadata', () => {
-      it('dispatches DELETE to handleMetadata', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+      it('dispatches DELETE to dispatch', async () => {
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { type: 'object', name: 'old_entity' } },
@@ -227,7 +228,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       it('dispatches for views', async () => {
         const req = makeReq('http://localhost/api/meta/views');
         await handler(req, { params: { objectstack: ['meta', 'views'] } });
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'views',
           expect.objectContaining({ request: expect.anything() }),
           'GET',
@@ -238,7 +239,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       it('dispatches for flows', async () => {
         const req = makeReq('http://localhost/api/meta/flows');
         await handler(req, { params: { objectstack: ['meta', 'flows'] } });
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'flows',
           expect.objectContaining({ request: expect.anything() }),
           'GET',
@@ -249,7 +250,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       it('dispatches for agents', async () => {
         const req = makeReq('http://localhost/api/meta/agents');
         await handler(req, { params: { objectstack: ['meta', 'agents'] } });
-        expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+        expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
           'agents',
           expect.objectContaining({ request: expect.anything() }),
           'GET',
@@ -273,7 +274,7 @@ describe('Next.js Metadata API Integration Tests', () => {
           pageSize: 25,
         };
 
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -305,7 +306,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Bulk Operations', () => {
     describe('POST meta/bulk/register — Bulk register', () => {
       it('dispatches bulk register', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { total: 2, succeeded: 2, failed: 0 } },
@@ -328,7 +329,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('POST meta/bulk/unregister — Bulk unregister', () => {
       it('dispatches bulk unregister', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { total: 2, succeeded: 2, failed: 0 } },
@@ -348,7 +349,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('Bulk operation with partial failures', () => {
       it('returns error details', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -387,7 +388,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Overlay / Customization', () => {
     describe('GET meta/objects/account/overlay — Get overlay', () => {
       it('dispatches overlay retrieval', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -413,7 +414,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('PUT meta/objects/account/overlay — Save overlay', () => {
       it('dispatches overlay save', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: { body: { success: true }, status: 200 },
         });
@@ -431,7 +432,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('GET meta/objects/account/effective — Get effective metadata', () => {
       it('dispatches effective metadata retrieval', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -457,7 +458,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Import / Export', () => {
     describe('POST meta/export — Export metadata', () => {
       it('dispatches export request', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { version: '1.0', objects: {} } },
@@ -474,7 +475,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('POST meta/import — Import metadata', () => {
       it('dispatches import request', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { total: 3, imported: 3, skipped: 0, failed: 0 } },
@@ -500,7 +501,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Validation', () => {
     describe('POST meta/validate — Validate metadata', () => {
       it('dispatches validation', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: { valid: true } },
@@ -515,7 +516,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       });
 
       it('returns errors for invalid metadata', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -544,7 +545,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Type Registry', () => {
     describe('GET meta/types — List types', () => {
       it('returns all registered types', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: { success: true, data: ['object', 'view', 'flow', 'agent'] },
@@ -561,7 +562,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('GET meta/types/object — Get type info', () => {
       it('returns type metadata', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -593,7 +594,7 @@ describe('Next.js Metadata API Integration Tests', () => {
   describe('Dependency Tracking', () => {
     describe('GET meta/objects/account/dependencies — Get dependencies', () => {
       it('returns dependencies', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -619,7 +620,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
     describe('GET meta/objects/account/dependents — Get dependents', () => {
       it('returns dependents', async () => {
-        mockDispatcher.handleMetadata.mockResolvedValueOnce({
+        mockDispatcher.dispatch.mockResolvedValueOnce({
           handled: true,
           response: {
             body: {
@@ -647,7 +648,7 @@ describe('Next.js Metadata API Integration Tests', () => {
 
   describe('Error Handling', () => {
     it('returns 404 when metadata not found', async () => {
-      mockDispatcher.handleMetadata.mockResolvedValueOnce({ handled: false });
+      mockDispatcher.dispatch.mockResolvedValueOnce({ handled: false });
 
       const req = makeReq('http://localhost/api/meta/objects/nonexistent');
       const res = await handler(req, { params: { objectstack: ['meta', 'objects', 'nonexistent'] } });
@@ -655,7 +656,7 @@ describe('Next.js Metadata API Integration Tests', () => {
     });
 
     it('returns 500 on dispatcher exception', async () => {
-      mockDispatcher.handleMetadata.mockRejectedValueOnce(new Error('Internal error'));
+      mockDispatcher.dispatch.mockRejectedValueOnce(new Error('Internal error'));
 
       const req = makeReq('http://localhost/api/meta/objects');
       const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
@@ -664,7 +665,7 @@ describe('Next.js Metadata API Integration Tests', () => {
     });
 
     it('returns custom status code from error', async () => {
-      mockDispatcher.handleMetadata.mockRejectedValueOnce(
+      mockDispatcher.dispatch.mockRejectedValueOnce(
         Object.assign(new Error('Forbidden'), { statusCode: 403 }),
       );
 
@@ -682,7 +683,7 @@ describe('Next.js Metadata API Integration Tests', () => {
     it('correctly joins nested segments', async () => {
       const req = makeReq('http://localhost/api/meta/objects/account/fields/name');
       await handler(req, { params: { objectstack: ['meta', 'objects', 'account', 'fields', 'name'] } });
-      expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'objects/account/fields/name',
         expect.any(Object),
         'GET',
@@ -694,7 +695,7 @@ describe('Next.js Metadata API Integration Tests', () => {
       const req = makeReq('http://localhost/api/meta');
       // With just ['meta'], subPath becomes empty after slice(1)
       await handler(req, { params: { objectstack: ['meta'] } });
-      expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         '',
         expect.any(Object),
         'GET',

package/src/nextjs.test.ts

@@ -10,6 +10,7 @@ const mockDispatcher = {
   handleMetadata: vi.fn().mockResolvedValue({ handled: true, response: { body: { objects: [] }, status: 200 } }),
   handleData: vi.fn().mockResolvedValue({ handled: true, response: { body: { records: [] }, status: 200 } }),
   handleStorage: vi.fn().mockResolvedValue({ handled: true, response: { body: {}, status: 200 } }),
+  dispatch: vi.fn().mockResolvedValue({ handled: true, response: { body: { success: true }, status: 200 } }),
 };
 
 vi.mock('@objectstack/runtime', () => {
@@ -272,17 +273,17 @@ describe('createRouteHandler', () => {
   });
 
   describe('Metadata Endpoint', () => {
-    it('GET meta/objects calls handleMetadata', async () => {
+    it('GET meta/objects delegates to dispatch()', async () => {
       const handler = createRouteHandler({ kernel: mockKernel });
       const req = makeReq('http://localhost/api/meta/objects', 'GET');
       const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
       expect(res.status).toBe(200);
-      expect(res.body).toEqual({ objects: [] });
-      expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
-        'objects',
-        expect.objectContaining({ request: expect.anything() }),
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'GET',
+        '/meta/objects',
         undefined,
+        expect.any(Object),
+        expect.objectContaining({ request: expect.anything() }),
       );
     });
 
@@ -292,11 +293,12 @@ describe('createRouteHandler', () => {
       const req = makeReq('http://localhost/api/meta/objects', 'PUT', body);
       const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
       expect(res.status).toBe(200);
-      expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
-        'objects',
-        expect.objectContaining({ request: expect.anything() }),
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'PUT',
+        '/meta/objects',
         body,
+        expect.any(Object),
+        expect.objectContaining({ request: expect.anything() }),
       );
     });
 
@@ -306,26 +308,26 @@ describe('createRouteHandler', () => {
       const req = makeReq('http://localhost/api/meta/objects', 'POST', body);
       const res = await handler(req, { params: { objectstack: ['meta', 'objects'] } });
       expect(res.status).toBe(200);
-      expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
-        'objects',
-        expect.objectContaining({ request: expect.anything() }),
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'POST',
+        '/meta/objects',
         body,
+        expect.any(Object),
+        expect.objectContaining({ request: expect.anything() }),
       );
     });
   });
 
   describe('Data Endpoint', () => {
-    it('GET data/account calls handleData', async () => {
+    it('GET data/account delegates to dispatch()', async () => {
       const handler = createRouteHandler({ kernel: mockKernel });
       const req = makeReq('http://localhost/api/data/account', 'GET');
       const res = await handler(req, { params: { objectstack: ['data', 'account'] } });
       expect(res.status).toBe(200);
-      expect(res.body).toEqual({ records: [] });
-      expect(mockDispatcher.handleData).toHaveBeenCalledWith(
-        'account',
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'GET',
-        {},
+        '/data/account',
+        undefined,
         expect.any(Object),
         expect.objectContaining({ request: expect.anything() }),
       );
@@ -337,9 +339,9 @@ describe('createRouteHandler', () => {
       const req = makeReq('http://localhost/api/data/account', 'POST', body);
       const res = await handler(req, { params: { objectstack: ['data', 'account'] } });
       expect(res.status).toBe(200);
-      expect(mockDispatcher.handleData).toHaveBeenCalledWith(
-        'account',
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'POST',
+        '/data/account',
         body,
         expect.any(Object),
         expect.objectContaining({ request: expect.anything() }),
@@ -352,9 +354,9 @@ describe('createRouteHandler', () => {
       const req = makeReq('http://localhost/api/data/account', 'PATCH', body);
       const res = await handler(req, { params: { objectstack: ['data', 'account'] } });
       expect(res.status).toBe(200);
-      expect(mockDispatcher.handleData).toHaveBeenCalledWith(
-        'account',
+      expect(mockDispatcher.dispatch).toHaveBeenCalledWith(
         'PATCH',
+        '/data/account',
         body,
         expect.any(Object),
         expect.objectContaining({ request: expect.anything() }),
@@ -362,7 +364,7 @@ describe('createRouteHandler', () => {
     });
 
     it('returns 404 when result is not handled', async () => {
-      mockDispatcher.handleData.mockResolvedValueOnce({ handled: false });
+      mockDispatcher.dispatch.mockResolvedValueOnce({ handled: false });
       const handler = createRouteHandler({ kernel: mockKernel });
       const req = makeReq('http://localhost/api/data/missing', 'GET');
       const res = await handler(req, { params: { objectstack: ['data', 'missing'] } });
@@ -401,6 +403,7 @@ describe('createRouteHandler', () => {
 
   describe('Error Handling', () => {
     it('returns 404 for unknown route segments', async () => {
+      mockDispatcher.dispatch.mockResolvedValueOnce({ handled: false });
       const handler = createRouteHandler({ kernel: mockKernel });
       const req = makeReq('http://localhost/api/unknown/path', 'GET');
       const res = await handler(req, { params: { objectstack: ['unknown', 'path'] } });
@@ -410,7 +413,7 @@ describe('createRouteHandler', () => {
     });
 
     it('returns 500 with default message on generic error', async () => {
-      mockDispatcher.handleData.mockRejectedValueOnce(new Error());
+      mockDispatcher.dispatch.mockRejectedValueOnce(new Error());
       const handler = createRouteHandler({ kernel: mockKernel });
       const req = makeReq('http://localhost/api/data/account', 'GET');
       const res = await handler(req, { params: { objectstack: ['data', 'account'] } });
@@ -419,7 +422,7 @@ describe('createRouteHandler', () => {
     });
 
     it('uses custom statusCode from error', async () => {
-      mockDispatcher.handleData.mockRejectedValueOnce(
+      mockDispatcher.dispatch.mockRejectedValueOnce(
         Object.assign(new Error('Forbidden'), { statusCode: 403 }),
       );
       const handler = createRouteHandler({ kernel: mockKernel });
@@ -432,7 +435,7 @@ describe('createRouteHandler', () => {
 
   describe('toResponse', () => {
     it('handles redirect result', async () => {
-      mockDispatcher.handleData.mockResolvedValueOnce({
+      mockDispatcher.dispatch.mockResolvedValueOnce({
         handled: true,
         result: { type: 'redirect', url: 'https://example.com' },
       });
@@ -444,7 +447,7 @@ describe('createRouteHandler', () => {
 
     it('handles stream result', async () => {
       const stream = 'mock-stream';
-      mockDispatcher.handleData.mockResolvedValueOnce({
+      mockDispatcher.dispatch.mockResolvedValueOnce({
         handled: true,
         result: { type: 'stream', stream, headers: { 'Content-Type': 'text/plain' } },
       });
@@ -457,7 +460,7 @@ describe('createRouteHandler', () => {
 
     it('returns raw result when handled but no response/redirect/stream', async () => {
       const rawResult = { type: 'custom', data: 'test' };
-      mockDispatcher.handleData.mockResolvedValueOnce({
+      mockDispatcher.dispatch.mockResolvedValueOnce({
         handled: true,
         result: rawResult,
       });