@objectstack/nextjs 4.0.4 → 4.1.0

package/README.md

@@ -1,13 +1,21 @@
 # @objectstack/nextjs
 
-The official Next.js adapter for ObjectStack.
+> Next.js adapter for ObjectStack — App Router route handlers and server actions for the generated REST API.
 
-## Features
-- Works with App Router (`app/api/...`)
-- Server Actions support (Planned)
-- Type-safe integration
+[![npm](https://img.shields.io/npm/v/@objectstack/nextjs.svg)](https://www.npmjs.com/package/@objectstack/nextjs)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-## Usage
+## Overview
+
+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.
+
+## Installation
+
+```bash
+pnpm add @objectstack/nextjs next
+```
+
+## Quick Start
 
 ```typescript
 // app/api/[...objectstack]/route.ts
@@ -16,5 +24,62 @@ import { kernel } from '@/lib/kernel';
 
 const handler = createRouteHandler({ kernel });
 
-export { handler as GET, handler as POST };
+export { handler as GET, handler as POST, handler as PUT, handler as PATCH, handler as DELETE };
+```
+
+```typescript
+// app/api/v1/discovery/route.ts
+import { createDiscoveryHandler } from '@objectstack/nextjs';
+import { kernel } from '@/lib/kernel';
+
+export const GET = createDiscoveryHandler({ kernel });
+```
+
+### Server actions
+
+```typescript
+// app/actions.ts
+'use server';
+import { createServerActions } from '@objectstack/nextjs';
+import { kernel } from '@/lib/kernel';
+
+export const { find, findOne, create, update, remove } = createServerActions({ kernel });
 ```
+
+## Key Exports
+
+| 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. |
+
+## Edge vs Node
+
+- Default runtime is Node.js. To use Edge, export `runtime = 'edge'` from the route file and pair with an edge-compatible driver ([`@objectstack/driver-turso`](../../plugins/driver-turso)).
+- `HttpDispatcher` is isomorphic; the adapter emits `NextResponse` which works in both runtimes.
+
+## When to use
+
+- ✅ Next.js App Router projects.
+- ✅ React Server Components that need type-safe data mutations via server actions.
+
+## When not to use
+
+- ❌ Pages Router projects — use [`@objectstack/express`](../express) with `next-connect` or migrate to App Router.
+
+## Related Packages
+
+- [`@objectstack/client-react`](../../client-react) — client-side hooks.
+- [`@objectstack/runtime`](../../runtime), [`@objectstack/rest`](../../rest).
+
+## Links
+
+- 📖 Docs: <https://objectstack.ai/docs>
+- 📚 API Reference: <https://objectstack.ai/docs/references>
+
+## License
+
+Apache-2.0 © ObjectStack

package/package.json

@@ -1,22 +1,48 @@
 {
   "name": "@objectstack/nextjs",
-  "version": "4.0.4",
+  "version": "4.1.0",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "peerDependencies": {
-    "next": "^16.2.3",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
-    "@objectstack/runtime": "^4.0.4"
+    "@objectstack/runtime": "^4.1.0"
   },
   "devDependencies": {
-    "next": "^16.2.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4",
-    "@objectstack/runtime": "4.0.4"
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7",
+    "@objectstack/runtime": "4.1.0"
+  },
+  "description": "Next.js adapter for ObjectStack — App Router route handlers for the ObjectStack REST API.",
+  "keywords": [
+    "objectstack",
+    "nextjs",
+    "adapter",
+    "app-router",
+    "rest"
+  ],
+  "author": "ObjectStack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/objectstack-ai/framework.git",
+    "directory": "packages/adapters/nextjs"
+  },
+  "homepage": "https://objectstack.ai/docs",
+  "bugs": "https://github.com/objectstack-ai/framework/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @objectstack/nextjs@4.0.4 build /home/runner/work/framework/framework/packages/adapters/nextjs
-> tsup --config ../../../tsup.config.ts
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
-CLI Target: es2020
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-ESM dist/index.mjs     7.73 KB
-ESM dist/index.mjs.map 16.92 KB
-ESM ⚡️ Build success in 68ms
-CJS dist/index.js     8.99 KB
-CJS dist/index.js.map 16.97 KB
-CJS ⚡️ Build success in 75ms
-DTS Build start
-DTS ⚡️ Build success in 14090ms
-DTS dist/index.d.mts 2.63 KB
-DTS dist/index.d.ts  2.63 KB

package/CHANGELOG.md

@@ -1,377 +0,0 @@
-# @objectstack/nextjs
-
-## 4.0.4
-
-### Patch Changes
-
-- @objectstack/runtime@4.0.4
-
-## 4.0.3
-
-### Patch Changes
-
-- @objectstack/runtime@4.0.3
-
-## 4.0.2
-
-### Patch Changes
-
-- 5f659e9: fix ai
-  - @objectstack/runtime@4.0.2
-
-## 4.0.0
-
-### Patch Changes
-
-- f08ffc3: Fix discovery API endpoint routing and protocol consistency.
-
-  **Discovery route standardization:**
-
-  - All adapters (Express, Fastify, Hono, NestJS, Next.js, Nuxt, SvelteKit) now mount the discovery endpoint at `{prefix}/discovery` instead of `{prefix}` root.
-  - `.well-known/objectstack` redirects now point to `{prefix}/discovery`.
-  - Client `connect()` fallback URL changed from `/api/v1` to `/api/v1/discovery`.
-  - Runtime dispatcher handles both `/discovery` (standard) and `/` (legacy) for backward compatibility.
-
-  **Schema & route alignment:**
-
-  - Added `storage` (service: `file-storage`) and `feed` (service: `data`) routes to `DEFAULT_DISPATCHER_ROUTES`.
-  - Added `feed` and `discovery` fields to `ApiRoutesSchema`.
-  - Unified `GetDiscoveryResponseSchema` with `DiscoverySchema` as single source of truth.
-  - Client `getRoute('feed')` fallback updated from `/api/v1/data` to `/api/v1/feed`.
-
-  **Type safety:**
-
-  - Extracted `ApiRouteType` from `ApiRoutes` keys for type-safe client route resolution.
-  - Removed `as any` type casting in client route access.
-
-- Updated dependencies [f08ffc3]
-- Updated dependencies [e0b0a78]
-  - @objectstack/runtime@4.0.0
-
-## 3.3.1
-
-### Patch Changes
-
-- @objectstack/runtime@3.3.1
-
-## 3.3.0
-
-### Patch Changes
-
-- @objectstack/runtime@3.3.0
-
-## 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
-
-- @objectstack/runtime@3.2.7
-
-## 3.2.6
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.6
-
-## 3.2.5
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.5
-
-## 3.2.4
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.4
-
-## 3.2.3
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.3
-
-## 3.2.2
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.2
-
-## 3.2.1
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.1
-
-## 3.2.0
-
-### Patch Changes
-
-- @objectstack/runtime@3.2.0
-
-## 3.1.1
-
-### Patch Changes
-
-- @objectstack/runtime@3.1.1
-
-## 3.1.0
-
-### Patch Changes
-
-- @objectstack/runtime@3.1.0
-
-## 3.0.11
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.11
-
-## 3.0.10
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.10
-
-## 3.0.9
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.9
-
-## 3.0.8
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.8
-
-## 3.0.7
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.7
-
-## 3.0.6
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.6
-
-## 3.0.5
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.5
-
-## 3.0.4
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.4
-
-## 3.0.3
-
-### Patch Changes
-
-- c7267f6: Patch release for maintenance updates and improvements.
-- Updated dependencies [c7267f6]
-  - @objectstack/runtime@3.0.3
-
-## 3.0.2
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.2
-
-## 3.0.1
-
-### Patch Changes
-
-- @objectstack/runtime@3.0.1
-
-## 3.0.0
-
-### Major Changes
-
-- Release v3.0.0 — unified version bump for all ObjectStack packages.
-
-### Patch Changes
-
-- Updated dependencies
-  - @objectstack/runtime@3.0.0
-
-## 2.0.7
-
-### Patch Changes
-
-- @objectstack/runtime@2.0.7
-
-## 2.0.6
-
-### Patch Changes
-
-- Patch release for maintenance and stability improvements
-- Updated dependencies
-  - @objectstack/runtime@2.0.6
-
-## 2.0.5
-
-### Patch Changes
-
-- @objectstack/runtime@2.0.5
-
-## 2.0.4
-
-### Patch Changes
-
-- Patch release for maintenance and stability improvements
-- Updated dependencies
-  - @objectstack/runtime@2.0.4
-
-## 2.0.3
-
-### Patch Changes
-
-- Patch release for maintenance and stability improvements
-- Updated dependencies
-  - @objectstack/runtime@2.0.3
-
-## 2.0.2
-
-### Patch Changes
-
-- @objectstack/runtime@2.0.2
-
-## 2.0.1
-
-### Patch Changes
-
-- Patch release for maintenance and stability improvements
-- Updated dependencies
-  - @objectstack/runtime@2.0.1
-
-## 2.0.0
-
-### Patch Changes
-
-- @objectstack/runtime@2.0.0
-
-## 1.0.12
-
-### Patch Changes
-
-- Updated dependencies
-  - @objectstack/runtime@1.0.12
-
-## 1.0.11
-
-### Patch Changes
-
-- @objectstack/runtime@1.0.11
-
-## 1.0.10
-
-### Patch Changes
-
-- @objectstack/runtime@1.0.10
-
-## 1.0.9
-
-### Patch Changes
-
-- @objectstack/runtime@1.0.9
-
-## 1.0.8
-
-### Patch Changes
-
-- 8f2a3a2: fix: standardize discovery endpoint response to include 'data' wrapper
-  - @objectstack/runtime@1.0.8
-
-## 1.0.7
-
-### Patch Changes
-
-- ebdf787: feat: implement standard service discovery via `/.well-known/objectstack`
-- Updated dependencies [ebdf787]
-  - @objectstack/runtime@1.0.7
-
-## 1.0.6
-
-### Patch Changes
-
-- @objectstack/runtime@1.0.6
-
-## 1.0.5
-
-### Patch Changes
-
-- b1d24bd: refactor: migrate build system from tsc to tsup for faster builds
-  - Replaced `tsc` with `tsup` (using esbuild) across all packages
-  - Added shared `tsup.config.ts` in workspace root
-  - Added `tsup` as workspace dev dependency
-  - significantly improved build performance
-- Updated dependencies [b1d24bd]
-- Updated dependencies [877b864]
-  - @objectstack/runtime@1.0.5
-
-## 1.0.4
-
-### Patch Changes
-
-- @objectstack/runtime@1.0.4
-
-## 1.0.3
-
-### Patch Changes
-
-- Updated dependencies [fb2eabd]
-  - @objectstack/runtime@1.0.3
-
-## 1.0.2
-
-### Patch Changes
-
-- 109fc5b: Unified patch release to align all package versions.
-- Updated dependencies [a0a6c85]
-- Updated dependencies [109fc5b]
-  - @objectstack/runtime@1.0.2
-
-## 1.0.1
-
-### Patch Changes
-
-- Updated dependencies
-  - @objectstack/runtime@1.0.1
-
-## 1.0.0
-
-### Major Changes
-
-- Major version release for ObjectStack Protocol v1.0.
-  - Stabilized Protocol Definitions
-  - Enhanced Runtime Plugin Support
-  - Fixed Type Compliance across Monorepo
-
-### Patch Changes
-
-- Updated dependencies
-  - @objectstack/runtime@1.0.0

package/src/__mocks__/runtime.ts

@@ -1,4 +0,0 @@
-// Stub for @objectstack/runtime - replaced by vi.mock in tests
-export const HttpDispatcher = class {};
-export type ObjectKernel = any;
-export type HttpDispatcherResult = any;