feat: implement saveMetaItem method and register PUT route for saving metadata items in RestServer

Author: hotlong

packages/metadata/src/index.ts

@@ -7,6 +7,9 @@
 // Main Manager
 export { MetadataManager, type WatchCallback, type MetadataManagerOptions } from './metadata-manager.js';
 
+// Plugin
+export { MetadataPlugin } from './plugin.js';
+
 // Loaders
 export { type MetadataLoader } from './loaders/loader-interface.js';
 export { MemoryLoader } from './loaders/memory-loader.js';

packages/objectql/src/protocol.ts

@@ -271,4 +271,15 @@ export class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         });
     }
 
+    async saveMetaItem(request: { type: string, name: string, item?: any }) {
+        if (!request.item) {
+            throw new Error('Item data is required');
+        }
+        // Default implementation saves to Memory Registry
+        SchemaRegistry.registerItem(request.type, request.item, 'name');
+        return {
+            success: true,
+            message: 'Saved to memory registry'
+        };
+    }
 }

packages/runtime/src/rest-server.ts

@@ -333,6 +333,35 @@ export class RestServer {
                 },
             });
         }
+
+        // PUT /meta/:type/:name - Save metadata item
+        // We always register this route, but return 501 if protocol doesn't support it
+        // This makes it discoverable even if not implemented
+        this.routeManager.register({
+            method: 'PUT',
+            path: `${metaPath}/:type/:name`,
+            handler: async (req: any, res: any) => {
+                try {
+                    if (!this.protocol.saveMetaItem) {
+                        res.status(501).json({ error: 'Save operation not supported by protocol implementation' });
+                        return;
+                    }
+
+                    const result = await this.protocol.saveMetaItem({
+                        type: req.params.type,
+                        name: req.params.name,
+                        item: req.body
+                    });
+                    res.json(result);
+                } catch (error: any) {
+                    res.status(400).json({ error: error.message });
+                }
+            },
+            metadata: {
+                summary: 'Save specific metadata item',
+                tags: ['metadata'],
+            },
+        });
     }
 
     /**