Add metadata discovery methods to client (getTypes, getItems, getItem)

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Copilot

packages/client/src/client.test.ts

@@ -31,4 +31,61 @@ describe('ObjectStackClient', () => {
         await client.connect();
         expect(fetchMock).toHaveBeenCalledWith('http://localhost:3000/api/v1', expect.any(Object));
     });
+
+    it('should get metadata types', async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            json: async () => ({ 
+                types: ['object', 'plugin', 'view']
+            })
+        });
+
+        const client = new ObjectStackClient({ 
+            baseUrl: 'http://localhost:3000',
+            fetch: fetchMock
+        });
+
+        const result = await client.meta.getTypes();
+        expect(fetchMock).toHaveBeenCalledWith('http://localhost:3000/api/v1/meta', expect.any(Object));
+        expect(result.types).toEqual(['object', 'plugin', 'view']);
+    });
+
+    it('should get metadata items by type', async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            json: async () => ({ 
+                type: 'object',
+                items: [{ name: 'customer' }, { name: 'order' }]
+            })
+        });
+
+        const client = new ObjectStackClient({ 
+            baseUrl: 'http://localhost:3000',
+            fetch: fetchMock
+        });
+
+        const result = await client.meta.getItems('object');
+        expect(fetchMock).toHaveBeenCalledWith('http://localhost:3000/api/v1/meta/object', expect.any(Object));
+        expect(result.type).toBe('object');
+        expect(result.items).toHaveLength(2);
+    });
+
+    it('should get metadata item by type and name', async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            json: async () => ({ 
+                name: 'customer',
+                fields: []
+            })
+        });
+
+        const client = new ObjectStackClient({ 
+            baseUrl: 'http://localhost:3000',
+            fetch: fetchMock
+        });
+
+        const result = await client.meta.getItem('object', 'customer');
+        expect(fetchMock).toHaveBeenCalledWith('http://localhost:3000/api/v1/meta/object/customer', expect.any(Object));
+        expect(result.name).toBe('customer');
+    });
 });

packages/client/src/index.ts

@@ -9,7 +9,9 @@ import {
   MetadataCacheResponse,
   StandardErrorCode,
   ErrorCategory,
-  GetDiscoveryResponse
+  GetDiscoveryResponse,
+  GetMetaTypesResponse,
+  GetMetaItemsResponse
 } from '@objectstack/spec/api';
 import { Logger, createLogger } from '@objectstack/core';
 
@@ -112,11 +114,46 @@ export class ObjectStackClient {
    * Metadata Operations
    */
   meta = {
+    /**
+     * Get all available metadata types
+     * Returns types like 'object', 'plugin', 'view', etc.
+     */
+    getTypes: async (): Promise<GetMetaTypesResponse> => {
+        const route = this.getRoute('metadata');
+        const res = await this.fetch(`${this.baseUrl}${route}`);
+        return res.json();
+    },
+
+    /**
+     * Get all items of a specific metadata type
+     * @param type - Metadata type name (e.g., 'object', 'plugin')
+     */
+    getItems: async (type: string): Promise<GetMetaItemsResponse> => {
+        const route = this.getRoute('metadata');
+        const res = await this.fetch(`${this.baseUrl}${route}/${type}`);
+        return res.json();
+    },
+
+    /**
+     * Get a specific object definition by name
+     * Legacy method - prefer getItem for consistency
+     */
     getObject: async (name: string) => {
         const route = this.getRoute('metadata');
         const res = await this.fetch(`${this.baseUrl}${route}/object/${name}`);
         return res.json();
     },
+
+    /**
+     * Get a specific metadata item by type and name
+     * @param type - Metadata type (e.g., 'object', 'plugin')
+     * @param name - Item name (snake_case identifier)
+     */
+    getItem: async (type: string, name: string) => {
+        const route = this.getRoute('metadata');
+        const res = await this.fetch(`${this.baseUrl}${route}/${type}/${name}`);
+        return res.json();
+    },
 
     /**
      * Get object metadata with cache support
@@ -436,5 +473,7 @@ export type {
   MetadataCacheResponse,
   StandardErrorCode,
   ErrorCategory,
-  GetDiscoveryResponse
+  GetDiscoveryResponse,
+  GetMetaTypesResponse,
+  GetMetaItemsResponse
 } from '@objectstack/spec/api';