@objectstack/nextjs 3.0.1 → 3.0.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/nextjs@3.0.1 build /home/runner/work/spec/spec/packages/adapters/nextjs
+> @objectstack/nextjs@3.0.3 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     5.39 KB
-CJS dist/index.js.map 9.17 KB
-CJS ⚡️ Build success in 57ms
-ESM dist/index.mjs     4.21 KB
-ESM dist/index.mjs.map 9.13 KB
-ESM ⚡️ Build success in 58ms
+ESM dist/index.mjs     7.70 KB
+ESM dist/index.mjs.map 16.53 KB
+ESM ⚡️ Build success in 66ms
+CJS dist/index.js     8.94 KB
+CJS dist/index.js.map 16.58 KB
+CJS ⚡️ Build success in 81ms
 DTS Build start
-DTS ⚡️ Build success in 8405ms
-DTS dist/index.d.mts 764.00 B
-DTS dist/index.d.ts  764.00 B
+DTS ⚡️ Build success in 12738ms
+DTS dist/index.d.mts 2.48 KB
+DTS dist/index.d.ts  2.48 KB

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @objectstack/nextjs
 
+## 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

package/dist/index.d.mts

@@ -19,5 +19,67 @@ declare function createRouteHandler(options: NextAdapterOptions): (req: NextRequ
  * Handles /.well-known/objectstack
  */
 declare function createDiscoveryHandler(options: NextAdapterOptions): (req: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Result type for server actions
+ */
+interface ServerActionResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        code: number;
+    };
+}
+/**
+ * Creates type-safe React Server Actions for ObjectStack data operations.
+ * Each action maps to a dispatcher method and can be called directly from
+ * React Server Components or client components via `"use server"`.
+ *
+ * @example
+ * ```ts
+ * // app/actions.ts
+ * "use server";
+ * import { createServerActions } from '@objectstack/nextjs';
+ * import { kernel } from '@/lib/kernel';
+ *
+ * const actions = createServerActions({ kernel });
+ *
+ * export async function getAccounts() {
+ *   return actions.query('account');
+ * }
+ *
+ * export async function createAccount(formData: FormData) {
+ *   return actions.create('account', {
+ *     name: formData.get('name') as string,
+ *   });
+ * }
+ * ```
+ */
+declare function createServerActions(options: NextAdapterOptions): {
+    /**
+     * Query records from an object
+     */
+    query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Get a single record by ID
+     */
+    getById(objectName: string, id: string): Promise<ServerActionResult>;
+    /**
+     * Create a new record
+     */
+    create(objectName: string, data: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Update a record by ID
+     */
+    update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Delete a record by ID
+     */
+    remove(objectName: string, id: string): Promise<ServerActionResult>;
+    /**
+     * Get metadata for objects
+     */
+    getMetadata(path?: string): Promise<ServerActionResult>;
+};
 
-export { type NextAdapterOptions, createDiscoveryHandler, createRouteHandler };
+export { type NextAdapterOptions, type ServerActionResult, createDiscoveryHandler, createRouteHandler, createServerActions };

package/dist/index.d.ts

@@ -19,5 +19,67 @@ declare function createRouteHandler(options: NextAdapterOptions): (req: NextRequ
  * Handles /.well-known/objectstack
  */
 declare function createDiscoveryHandler(options: NextAdapterOptions): (req: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Result type for server actions
+ */
+interface ServerActionResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        code: number;
+    };
+}
+/**
+ * Creates type-safe React Server Actions for ObjectStack data operations.
+ * Each action maps to a dispatcher method and can be called directly from
+ * React Server Components or client components via `"use server"`.
+ *
+ * @example
+ * ```ts
+ * // app/actions.ts
+ * "use server";
+ * import { createServerActions } from '@objectstack/nextjs';
+ * import { kernel } from '@/lib/kernel';
+ *
+ * const actions = createServerActions({ kernel });
+ *
+ * export async function getAccounts() {
+ *   return actions.query('account');
+ * }
+ *
+ * export async function createAccount(formData: FormData) {
+ *   return actions.create('account', {
+ *     name: formData.get('name') as string,
+ *   });
+ * }
+ * ```
+ */
+declare function createServerActions(options: NextAdapterOptions): {
+    /**
+     * Query records from an object
+     */
+    query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Get a single record by ID
+     */
+    getById(objectName: string, id: string): Promise<ServerActionResult>;
+    /**
+     * Create a new record
+     */
+    create(objectName: string, data: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Update a record by ID
+     */
+    update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult>;
+    /**
+     * Delete a record by ID
+     */
+    remove(objectName: string, id: string): Promise<ServerActionResult>;
+    /**
+     * Get metadata for objects
+     */
+    getMetadata(path?: string): Promise<ServerActionResult>;
+};
 
-export { type NextAdapterOptions, createDiscoveryHandler, createRouteHandler };
+export { type NextAdapterOptions, type ServerActionResult, createDiscoveryHandler, createRouteHandler, createServerActions };

package/dist/index.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createDiscoveryHandler: () => createDiscoveryHandler,
-  createRouteHandler: () => createRouteHandler
+  createRouteHandler: () => createRouteHandler,
+  createServerActions: () => createServerActions
 });
 module.exports = __toCommonJS(index_exports);
 var import_server = require("next/server");
@@ -128,9 +129,100 @@ function createDiscoveryHandler(options) {
     return import_server.NextResponse.redirect(targetUrl);
   };
 }
+function createServerActions(options) {
+  const dispatcher = new import_runtime.HttpDispatcher(options.kernel);
+  const emptyContext = { request: void 0 };
+  return {
+    /**
+     * Query records from an object
+     */
+    async query(objectName, params) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, "GET", {}, params || {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Get a single record by ID
+     */
+    async getById(objectName, id) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "GET", {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Create a new record
+     */
+    async create(objectName, data) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, "POST", data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Create failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Update a record by ID
+     */
+    async update(objectName, id, data) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "PATCH", data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Update failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Delete a record by ID
+     */
+    async remove(objectName, id) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "DELETE", {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Delete failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Get metadata for objects
+     */
+    async getMetadata(path) {
+      try {
+        const result = await dispatcher.handleMetadata(path || "", emptyContext, "GET");
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createDiscoveryHandler,
-  createRouteHandler
+  createRouteHandler,
+  createServerActions
 });
 //# sourceMappingURL=index.js.map

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: 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 (preferred path)\n           const authService = typeof options.kernel.getService === 'function'\n             ? options.kernel.getService<AuthService>('auth')\n             : null;\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"],"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 */\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: 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 (preferred path)\n           const authService = typeof options.kernel.getService === 'function'\n             ? options.kernel.getService<AuthService>('auth')\n             : null;\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"]}

package/dist/index.mjs

@@ -103,8 +103,99 @@ function createDiscoveryHandler(options) {
     return NextResponse.redirect(targetUrl);
   };
 }
+function createServerActions(options) {
+  const dispatcher = new HttpDispatcher(options.kernel);
+  const emptyContext = { request: void 0 };
+  return {
+    /**
+     * Query records from an object
+     */
+    async query(objectName, params) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, "GET", {}, params || {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Get a single record by ID
+     */
+    async getById(objectName, id) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "GET", {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Create a new record
+     */
+    async create(objectName, data) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, "POST", data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Create failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Update a record by ID
+     */
+    async update(objectName, id, data) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "PATCH", data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Update failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Delete a record by ID
+     */
+    async remove(objectName, id) {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, "DELETE", {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Delete failed", code: 500 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    },
+    /**
+     * Get metadata for objects
+     */
+    async getMetadata(path) {
+      try {
+        const result = await dispatcher.handleMetadata(path || "", emptyContext, "GET");
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: "Not found", code: 404 } };
+      } catch (err) {
+        return { success: false, error: { message: err.message || "Internal Server Error", code: err.statusCode || 500 } };
+      }
+    }
+  };
+}
 export {
   createDiscoveryHandler,
-  createRouteHandler
+  createRouteHandler,
+  createServerActions
 };
 //# sourceMappingURL=index.mjs.map

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: 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 (preferred path)\n           const authService = typeof options.kernel.getService === 'function'\n             ? options.kernel.getService<AuthService>('auth')\n             : null;\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"],"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 */\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: 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 (preferred path)\n           const authService = typeof options.kernel.getService === 'function'\n             ? options.kernel.getService<AuthService>('auth')\n             : null;\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/nextjs",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,7 @@
     "next": "^16.1.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "@objectstack/runtime": "3.0.1"
+    "@objectstack/runtime": "3.0.3"
   },
   "devDependencies": {
     "next": "^16.1.6",
@@ -16,7 +16,7 @@
     "react-dom": "^19.2.4",
     "typescript": "^5.0.0",
     "vitest": "^4.0.18",
-    "@objectstack/runtime": "3.0.1"
+    "@objectstack/runtime": "3.0.3"
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",

package/src/index.ts

@@ -160,3 +160,136 @@ export function createDiscoveryHandler(options: NextAdapterOptions) {
       return NextResponse.redirect(targetUrl);
   }
 }
+
+// ─── Server Actions ──────────────────────────────────────────────────────────
+
+/**
+ * Result type for server actions
+ */
+export interface ServerActionResult<T = any> {
+  success: boolean;
+  data?: T;
+  error?: { message: string; code: number };
+}
+
+/**
+ * Creates type-safe React Server Actions for ObjectStack data operations.
+ * Each action maps to a dispatcher method and can be called directly from
+ * React Server Components or client components via `"use server"`.
+ *
+ * @example
+ * ```ts
+ * // app/actions.ts
+ * "use server";
+ * import { createServerActions } from '@objectstack/nextjs';
+ * import { kernel } from '@/lib/kernel';
+ *
+ * const actions = createServerActions({ kernel });
+ *
+ * export async function getAccounts() {
+ *   return actions.query('account');
+ * }
+ *
+ * export async function createAccount(formData: FormData) {
+ *   return actions.create('account', {
+ *     name: formData.get('name') as string,
+ *   });
+ * }
+ * ```
+ */
+export function createServerActions(options: NextAdapterOptions) {
+  const dispatcher = new HttpDispatcher(options.kernel);
+  const emptyContext = { request: undefined };
+
+  return {
+    /**
+     * Query records from an object
+     */
+    async query(objectName: string, params?: Record<string, any>): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, 'GET', {}, params || {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Not found', code: 404 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+
+    /**
+     * Get a single record by ID
+     */
+    async getById(objectName: string, id: string): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'GET', {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Not found', code: 404 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+
+    /**
+     * Create a new record
+     */
+    async create(objectName: string, data: Record<string, any>): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}`, 'POST', data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Create failed', code: 500 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+
+    /**
+     * Update a record by ID
+     */
+    async update(objectName: string, id: string, data: Record<string, any>): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'PATCH', data, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Update failed', code: 500 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+
+    /**
+     * Delete a record by ID
+     */
+    async remove(objectName: string, id: string): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleData(`/${objectName}/${id}`, 'DELETE', {}, {}, emptyContext);
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Delete failed', code: 500 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+
+    /**
+     * Get metadata for objects
+     */
+    async getMetadata(path?: string): Promise<ServerActionResult> {
+      try {
+        const result = await dispatcher.handleMetadata(path || '', emptyContext, 'GET');
+        if (result.handled && result.response) {
+          return { success: true, data: result.response.body };
+        }
+        return { success: false, error: { message: 'Not found', code: 404 } };
+      } catch (err: any) {
+        return { success: false, error: { message: err.message || 'Internal Server Error', code: err.statusCode || 500 } };
+      }
+    },
+  };
+}

package/src/nextjs.test.ts

@@ -453,3 +453,97 @@ describe('createDiscoveryHandler', () => {
     expect((res as any).redirectUrl).toBe('http://localhost/v2/api');
   });
 });
+
+// --- Server Actions Tests ---
+import { createServerActions } from './index';
+
+describe('createServerActions', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('query returns data on success', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.query('account');
+    expect(result.success).toBe(true);
+    expect(result.data).toEqual({ records: [] });
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account', 'GET', {}, {},
+      expect.anything(),
+    );
+  });
+
+  it('query passes params', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    await actions.query('account', { limit: 10 });
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account', 'GET', {}, { limit: 10 },
+      expect.anything(),
+    );
+  });
+
+  it('getById returns single record', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.getById('account', '123');
+    expect(result.success).toBe(true);
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account/123', 'GET', {}, {},
+      expect.anything(),
+    );
+  });
+
+  it('create sends data', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.create('account', { name: 'Acme' });
+    expect(result.success).toBe(true);
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account', 'POST', { name: 'Acme' }, {},
+      expect.anything(),
+    );
+  });
+
+  it('update sends data with id', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.update('account', '123', { name: 'Updated' });
+    expect(result.success).toBe(true);
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account/123', 'PATCH', { name: 'Updated' }, {},
+      expect.anything(),
+    );
+  });
+
+  it('remove deletes record', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.remove('account', '123');
+    expect(result.success).toBe(true);
+    expect(mockDispatcher.handleData).toHaveBeenCalledWith(
+      '/account/123', 'DELETE', {}, {},
+      expect.anything(),
+    );
+  });
+
+  it('getMetadata returns metadata', async () => {
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.getMetadata('/objects');
+    expect(result.success).toBe(true);
+    expect(mockDispatcher.handleMetadata).toHaveBeenCalledWith(
+      '/objects', expect.anything(), 'GET',
+    );
+  });
+
+  it('returns error on exception', async () => {
+    mockDispatcher.handleData.mockRejectedValueOnce(new Error('Server down'));
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.query('account');
+    expect(result.success).toBe(false);
+    expect(result.error?.message).toBe('Server down');
+  });
+
+  it('returns error when not handled', async () => {
+    mockDispatcher.handleData.mockResolvedValueOnce({ handled: false });
+    const actions = createServerActions({ kernel: mockKernel });
+    const result = await actions.query('missing');
+    expect(result.success).toBe(false);
+    expect(result.error?.code).toBe(404);
+  });
+});