feat(api): update discovery endpoints to return data objects

Author: hotlong

content/docs/objectos/http-protocol.mdx

@@ -31,7 +31,7 @@ Host: api.acme.com
 
 **Alternative endpoint:**
 ```http
-GET /api/v1/discovery HTTP/1.1
+GET /api/v1 HTTP/1.1
 ```
 
 **Response:**

packages/adapters/hono/src/index.ts

@@ -44,7 +44,7 @@ export function createHonoApp(options: ObjectStackHonoOptions) {
 
   // --- 0. Discovery Endpoint ---
   app.get(prefix, (c) => {
-    return c.json(dispatcher.getDiscoveryInfo(prefix));
+    return c.json({ data: dispatcher.getDiscoveryInfo(prefix) });
   });
 
   // --- 1. Auth ---

packages/adapters/nestjs/src/index.ts

@@ -87,7 +87,7 @@ export class ObjectStackController {
   // --- Discovery Endpoint ---
   @Get()
   discovery() {
-    return this.service.dispatcher.getDiscoveryInfo('/api');
+    return { data: this.service.dispatcher.getDiscoveryInfo('/api') };
   }
 
   @Post('graphql')

packages/adapters/nextjs/src/index.ts

@@ -51,7 +51,7 @@ export function createRouteHandler(options: NextAdapterOptions) {
 
     // --- 0. Discovery Endpoint ---
     if (segments.length === 0 && method === 'GET') {
-      return NextResponse.json(dispatcher.getDiscoveryInfo(options.prefix || '/api'));
+      return NextResponse.json({ data: dispatcher.getDiscoveryInfo(options.prefix || '/api') });
     }
 
     try {

packages/plugins/plugin-hono-server/src/hono-plugin.ts

@@ -7,6 +7,7 @@ import {
 } from '@objectstack/spec/api';
 import { HonoHttpServer } from './adapter';
 import { createHonoApp } from '@objectstack/hono';
+import { HttpDispatcher } from '@objectstack/runtime';
 import { serveStatic } from '@hono/node-server/serve-static';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -123,8 +124,9 @@ export class HonoServerPlugin implements Plugin {
 
             // Register Standard Discovery Endpoint
             const rawApp = this.server.getRawApp();
+            const dispatcher = new HttpDispatcher(kernel);
             rawApp.get('/.well-known/objectstack', (c) => {
-                return c.redirect(apiPath);
+                return c.json({ data: dispatcher.getDiscoveryInfo(apiPath) });
             });
             ctx.logger.debug('Registered standard discovery endpoint', { path: '/.well-known/objectstack', target: apiPath });
 

packages/plugins/plugin-msw/src/msw-plugin.ts

@@ -203,12 +203,26 @@ export class MSWPlugin implements Plugin {
         // Discovery Endpoint
         this.handlers.push(
             http.get('*/.well-known/objectstack', () => {
-                return new HttpResponse(null, {
-                    status: 302,
-                    headers: {
-                        Location: baseUrl
+                if (this.dispatcher) {
+                    return HttpResponse.json({
+                        data: this.dispatcher.getDiscoveryInfo(baseUrl)
+                    });
+                }
+                return HttpResponse.json({
+                    data: {
+                        version: 'v1',
+                        apiName: 'ObjectStack API',
+                        url: baseUrl,
+                        capabilities: {
+                            graphql: false,
+                            search: false,
+                            websockets: false,
+                            files: false,
+                            analytics: false,
+                            hub: false
+                        }
                     }
-                })
+                });
             })
         );