fix: enrich MSW object metadata with listViews from stack config

The ObjectStack runtime protocol strips listViews from object metadata
during Zod validation in defineStack(). The MSW handlers now re-attach
listViews from the pre-defineStack sharedConfig so the console can
resolve named views (calendar, kanban, etc.) for each object.

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

apps/console/src/mocks/browser.ts

@@ -10,7 +10,7 @@
 import { ObjectKernel } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import { setupWorker } from 'msw/browser';
-import appConfig from '../../objectstack.shared';
+import appConfig, { sharedConfig } from '../../objectstack.shared';
 import { createKernel } from './createKernel';
 import { createHandlers } from './handlers';
 
@@ -42,8 +42,10 @@ export async function startMockServer() {
   // Create MSW handlers that match the response format of HonoServerPlugin
   // Include both /api/v1 and legacy /api paths so the ObjectStackClient can
   // reach the mock server regardless of which base URL it probes.
-  const v1Handlers = createHandlers('/api/v1', kernel, driver);
-  const legacyHandlers = createHandlers('/api', kernel, driver);
+  // Pass sharedConfig (pre-defineStack) so handlers can enrich object metadata
+  // with listViews that defineStack's Zod parse strips.
+  const v1Handlers = createHandlers('/api/v1', kernel, driver, sharedConfig);
+  const legacyHandlers = createHandlers('/api', kernel, driver, sharedConfig);
   const handlers = [...v1Handlers, ...legacyHandlers];
 
   // Start MSW service worker

apps/console/src/mocks/handlers.ts

@@ -15,13 +15,26 @@ import { http, HttpResponse } from 'msw';
 /**
  * Create MSW request handlers for a given base URL.
  *
- * @param baseUrl - URL prefix, e.g. '/api/v1' (browser) or 'http://localhost:3000/api/v1' (node)
- * @param kernel  - Bootstrapped ObjectKernel with protocol service
- * @param driver  - InMemoryDriver for direct data access
+ * @param baseUrl   - URL prefix, e.g. '/api/v1' (browser) or 'http://localhost:3000/api/v1' (node)
+ * @param kernel    - Bootstrapped ObjectKernel with protocol service
+ * @param driver    - InMemoryDriver for direct data access
+ * @param appConfig - Original stack config (used to enrich protocol responses with listViews)
  */
-export function createHandlers(baseUrl: string, kernel: ObjectKernel, driver: InMemoryDriver) {
+export function createHandlers(baseUrl: string, kernel: ObjectKernel, driver: InMemoryDriver, appConfig?: any) {
   const protocol = kernel.getService('protocol') as any;
 
+  // Build a lookup of listViews by object name from the original config.
+  // The runtime protocol strips listViews from object metadata, so we
+  // re-attach them here to ensure the console can resolve named views.
+  const listViewsByObject: Record<string, Record<string, any>> = {};
+  if (appConfig?.objects) {
+    for (const obj of appConfig.objects) {
+      if (obj.listViews && Object.keys(obj.listViews).length > 0) {
+        listViewsByObject[obj.name] = obj.listViews;
+      }
+    }
+  }
+
   // Determine whether we're in a browser (relative paths, wildcard prefix)
   // or in Node.js tests (absolute URLs)
   const isBrowser = !baseUrl.startsWith('http');
@@ -56,11 +69,25 @@ export function createHandlers(baseUrl: string, kernel: ObjectKernel, driver: In
     http.get(`${prefix}${baseUrl}/meta/:type`, async ({ params }) => {
       const metadataType = params.type as string;
       const response = await protocol.getMetaItems({ type: metadataType });
+      // Enrich object metadata with listViews from stack config
+      if ((metadataType === 'object' || metadataType === 'objects') && response?.items) {
+        response.items = response.items.map((obj: any) => {
+          const views = listViewsByObject[obj.name];
+          return views ? { ...obj, listViews: { ...(obj.listViews || {}), ...views } } : obj;
+        });
+      }
       return HttpResponse.json(response, { status: 200 });
     }),
     http.get(`${prefix}${baseUrl}/metadata/:type`, async ({ params }) => {
       const metadataType = params.type as string;
       const response = await protocol.getMetaItems({ type: metadataType });
+      // Enrich object metadata with listViews from stack config
+      if ((metadataType === 'object' || metadataType === 'objects') && response?.items) {
+        response.items = response.items.map((obj: any) => {
+          const views = listViewsByObject[obj.name];
+          return views ? { ...obj, listViews: { ...(obj.listViews || {}), ...views } } : obj;
+        });
+      }
       return HttpResponse.json(response, { status: 200 });
     }),
 
@@ -71,7 +98,14 @@ export function createHandlers(baseUrl: string, kernel: ObjectKernel, driver: In
           type: params.type as string,
           name: params.name as string
         });
-        const payload = (response && response.item) ? response.item : response;
+        let payload = (response && response.item) ? response.item : response;
+        // Enrich single object with listViews from stack config
+        if ((params.type === 'object' || params.type === 'objects') && payload && payload.name) {
+          const views = listViewsByObject[payload.name];
+          if (views) {
+            payload = { ...payload, listViews: { ...(payload.listViews || {}), ...views } };
+          }
+        }
         return HttpResponse.json(payload || { error: 'Not found' }, { status: payload ? 200 : 404 });
       } catch (e) {
         return HttpResponse.json({ error: String(e) }, { status: 500 });
@@ -83,7 +117,14 @@ export function createHandlers(baseUrl: string, kernel: ObjectKernel, driver: In
           type: params.type as string,
           name: params.name as string
         });
-        const payload = (response && response.item) ? response.item : response;
+        let payload = (response && response.item) ? response.item : response;
+        // Enrich single object with listViews from stack config
+        if ((params.type === 'object' || params.type === 'objects') && payload && payload.name) {
+          const views = listViewsByObject[payload.name];
+          if (views) {
+            payload = { ...payload, listViews: { ...(payload.listViews || {}), ...views } };
+          }
+        }
         return HttpResponse.json(payload || { error: 'Not found' }, { status: payload ? 200 : 404 });
       } catch (e) {
         return HttpResponse.json({ error: String(e) }, { status: 500 });

apps/console/src/mocks/server.ts

@@ -10,7 +10,7 @@
 import { ObjectKernel } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import { setupServer } from 'msw/node';
-import appConfig from '../../objectstack.shared';
+import appConfig, { sharedConfig } from '../../objectstack.shared';
 import { createKernel } from './createKernel';
 import { createHandlers } from './handlers';
 
@@ -31,8 +31,10 @@ export async function startMockServer() {
   driver = result.driver;
 
   // Create MSW handlers for both paths to ensure compatibility with client defaults
-  const v1Handlers = createHandlers('http://localhost:3000/api/v1', kernel, driver);
-  const legacyHandlers = createHandlers('http://localhost:3000/api', kernel, driver);
+  // Pass sharedConfig (pre-defineStack) so handlers can enrich object metadata
+  // with listViews that defineStack's Zod parse strips.
+  const v1Handlers = createHandlers('http://localhost:3000/api/v1', kernel, driver, sharedConfig);
+  const legacyHandlers = createHandlers('http://localhost:3000/api', kernel, driver, sharedConfig);
   const handlers = [...v1Handlers, ...legacyHandlers];
 
   // Setup MSW server for Node.js environment