Next.js adapter for ObjectStack — App Router route handlers and server actions for the generated REST API.
Bridges Next.js App Router to HttpDispatcher. Provides one catch-all route handler that supports /api/[...objectstack], a dedicated /api/v1/discovery handler, and typed server actions for CRUD and batch operations from React Server Components.
pnpm add @objectstack/nextjs next// app/api/[...objectstack]/route.ts
import { createRouteHandler } from '@objectstack/nextjs';
import { kernel } from '@/lib/kernel';
const handler = createRouteHandler({ kernel });
export { handler as GET, handler as POST, handler as PUT, handler as PATCH, handler as DELETE };// app/api/v1/discovery/route.ts
import { createDiscoveryHandler } from '@objectstack/nextjs';
import { kernel } from '@/lib/kernel';
export const GET = createDiscoveryHandler({ kernel });// app/actions.ts
'use server';
import { createServerActions } from '@objectstack/nextjs';
import { kernel } from '@/lib/kernel';
export const { find, findOne, create, update, remove } = createServerActions({ kernel });| Export | Kind | Description |
|---|---|---|
createRouteHandler(options) |
function | Catch-all App Router handler. |
createDiscoveryHandler(options) |
function | /api/v1/discovery handler. |
createServerActions(options) |
function | Returns typed server actions. |
NextAdapterOptions |
interface | { kernel, prefix? }. |
ServerActionResult<T> |
type | { success: boolean; data?: T; error?: string } envelope. |
- Default runtime is Node.js. Edge runtimes need an edge-compatible driver (ObjectStack Cloud ships
@objectstack/driver-tursofor that case). HttpDispatcheris isomorphic; the adapter emitsNextResponsewhich works in both runtimes.
- ✅ Next.js App Router projects.
- ✅ React Server Components that need type-safe data mutations via server actions.
- ❌ Pages Router projects — use
@objectstack/expresswithnext-connector migrate to App Router.
@objectstack/client-react— client-side hooks.@objectstack/runtime,@objectstack/rest.
- 📖 Docs: https://objectstack.ai/docs
- 📚 API Reference: https://objectstack.ai/docs/references
Apache-2.0 © ObjectStack