feat(discovery): add discovery endpoint for redirecting to API in NestJS and Next.js adapters

Author: hotlong

packages/adapters/nestjs/src/index.ts

@@ -168,6 +168,16 @@ export class ObjectStackController {
   }
 }
 
+// --- Discovery Controller ---
+
+@Controller('.well-known')
+export class DiscoveryController {
+  @Get('objectstack')
+  discover(@Res() res: any) {
+    return res.redirect('/api');
+  }
+}
+
 // --- Module ---
 
 @Global()
@@ -181,7 +191,7 @@ export class ObjectStackModule {
 
     return {
       module: ObjectStackModule,
-      controllers: [ObjectStackController],
+      controllers: [ObjectStackController, DiscoveryController],
       providers: [kernelProvider, ObjectStackService],
       exports: [kernelProvider, ObjectStackService],
     };

packages/adapters/nextjs/src/index.ts

@@ -123,3 +123,16 @@ export function createRouteHandler(options: NextAdapterOptions) {
     }
   }
 }
+
+/**
+ * Creates a discovery handler for Next.js App Router
+ * Handles /.well-known/objectstack
+ */
+export function createDiscoveryHandler(options: NextAdapterOptions) {
+  return async function discoveryHandler(req: NextRequest) {
+      const apiPath = options.prefix || '/api';
+      const url = new URL(req.url);
+      const targetUrl = new URL(apiPath, url.origin);
+      return NextResponse.redirect(targetUrl);
+  }
+}

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

@@ -200,6 +200,18 @@ export class MSWPlugin implements Plugin {
             ...(this.options.customHandlers || [])
         ];
 
+        // Discovery Endpoint
+        this.handlers.push(
+            http.get('*/.well-known/objectstack', () => {
+                return new HttpResponse(null, {
+                    status: 302,
+                    headers: {
+                        Location: baseUrl
+                    }
+                })
+            })
+        );
+
         if (this.dispatcher) {
             const dispatcher = this.dispatcher;