feat: 增加发现端点和动态元数据注册功能，优化应用程序架构

Author: hotlong

examples/server/src/index.ts

@@ -20,6 +20,38 @@ console.log('--- Plugins Loaded ---');
 
 // 3. Define Unified Routes
 
+/**
+ * Discovery Endpoint
+ * Allows clients to dynamically discover API routes and capabilities.
+ */
+const discoveryHandler = (c: any) => {
+  return c.json({
+    name: "ObjectStack Example Server",
+    version: "0.1.0",
+    environment: "development",
+    routes: {
+      data: "/api/v1/data",
+      metadata: "/api/v1/meta",
+      auth: "/api/v1/auth", // Not implemented yet
+      actions: "/api/v1/actions",
+      storage: "/api/v1/storage", // Not implemented yet
+    },
+    features: {
+      graphql: false,
+      search: true,
+      files: false
+    },
+    locale: {
+      default: "en-US",
+      supported: ["en-US", "zh-CN"],
+      timezone: "UTC"
+    }
+  });
+};
+
+app.get('/.well-known/objectstack', discoveryHandler);
+app.get('/api/v1/discovery', discoveryHandler);
+
 /**
  * Unified Metadata API: List Items by Type
  * GET /api/v1/meta/objects
@@ -28,14 +60,13 @@ console.log('--- Plugins Loaded ---');
 app.get('/api/v1/meta/:type', (c) => {
   const typePlural = c.req.param('type');
 
-  // Simple singularization mapping (can be enhanced)
+  // Dynamic singularization:
+  // 1. Check hardcoded map (for exceptions like 'indexes' -> 'index' if needed)
+  // 2. Or fallback to removing trailing 's'
   const typeMap: Record<string, string> = {
-    'objects': 'object',
-    'apps': 'app',
-    'flows': 'flow',
-    'reports': 'report'
+    // Add specific exceptions here if english pluralization rules fail
   };
-  const type = typeMap[typePlural] || typePlural;
+  const type = typeMap[typePlural] || (typePlural.endsWith('s') ? typePlural.slice(0, -1) : typePlural);
 
   const items = SchemaRegistry.listItems(type);
 
@@ -62,13 +93,8 @@ app.get('/api/v1/meta/:type/:name', (c) => {
   const typePlural = c.req.param('type');
   const name = c.req.param('name');
 
-  const typeMap: Record<string, string> = {
-    'objects': 'object',
-    'apps': 'app',
-    'flows': 'flow',
-    'reports': 'report'
-  };
-  const type = typeMap[typePlural] || typePlural;
+  const typeMap: Record<string, string> = {};
+  const type = typeMap[typePlural] || (typePlural.endsWith('s') ? typePlural.slice(0, -1) : typePlural);
 
   const item = SchemaRegistry.getItem(type, name);
   if (!item) return c.json({ error: `Metadata not found: ${type}/${name}` }, 404);

examples/server/src/loader.ts

@@ -20,11 +20,25 @@ export function loadPlugins() {
     const parsedApp = AppSchema.parse(app);
     SchemaRegistry.registerApp(parsedApp);
 
-    // 1. Register Objects
-    if (app.objects) {
-      app.objects.forEach((obj: any) => {
-         SchemaRegistry.registerObject(obj);
-      });
+    // 1. Scan and Register All Metadata
+    // Known keys to exclude from metadata scanning
+    const ignoredKeys = new Set(['name', 'label', 'description', 'version', 'branding', 'active', 'isDefault', 'navigation', 'menus', 'homePageId', 'requiredPermissions', 'icon', 'id']);
+
+    for (const [key, value] of Object.entries(app)) {
+      if (ignoredKeys.has(key)) continue;
+
+      if (Array.isArray(value)) {
+        // Singularize type name: remove trailing 's' if present
+        const type = key.endsWith('s') ? key.slice(0, -1) : key;
+        
+        value.forEach((item: any) => {
+           // Ensure item has a name
+           if (item && item.name) {
+             SchemaRegistry.registerItem(type, item);
+           }
+        });
+        console.log(`[Loader] Loaded ${value.length} ${type}s from ${app.name}`);
+      }
     }
 
     console.log(`[Loader] Loaded ${app.objects?.length || 0} objects from ${app.name}`);

packages/spec/json-schema/App.json

@@ -294,7 +294,7 @@
         "name",
         "label"
       ],
-      "additionalProperties": false
+      "additionalProperties": true
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

packages/spec/src/ui/app.zod.ts

@@ -159,7 +159,7 @@ export const AppSchema = z.object({
    */
   objects: z.array(z.any()).optional().describe('Objects belonging to this app'),
   apis: z.array(z.any()).optional().describe('Custom APIs belonging to this app'),
-});
+}).passthrough();
 
 export const App = Object.assign(AppSchema, {
   create: <T extends z.input<typeof AppSchema>>(config: T) => config,