添加 @objectstack/client-sdk 包及其相关配置，包含基本客户端实现和示例；更新依赖项以支持新功能

Author: hotlong

examples/todo/package.json

@@ -7,7 +7,8 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@objectstack/spec": "workspace:*"
+    "@objectstack/spec": "workspace:*",
+    "@objectstack/client-sdk": "workspace:*"
   },
   "devDependencies": {
     "typescript": "^5.0.0"

examples/todo/src/client-test.ts

@@ -0,0 +1,36 @@
+import { ObjectStackClient } from '@objectstack/client-sdk';
+
+async function main() {
+  console.log('🚀 Starting Client SDK Test...');
+
+  // 1. Initialize Client
+  const client = new ObjectStackClient({
+    baseUrl: 'http://localhost:3004'
+  });
+
+  try {
+    // 2. Connect (Auto-Discovery)
+    console.log('🔌 Connecting to server...');
+    await client.connect();
+    console.log('✅ Connected! Discovery complete.');
+
+    // 3. Get Metadata
+    console.log('🔍 Fetching Object Metadata for "todo_task"...');
+    const objectMeta = await client.meta.getObject('todo_task');
+    console.log(`📋 Object Label: ${objectMeta.label}`);
+
+    // 4. Query Data
+    console.log('💾 Querying Data...');
+    const result = await client.data.find('todo_task', {});
+    
+    console.log(`🎉 Found ${result.data.length} tasks:`);
+    result.data.forEach((task: any) => {
+      console.log(` - [${task.status}] ${task.title}`);
+    });
+
+  } catch (error) {
+    console.error('❌ Error during test:', error);
+  }
+}
+
+main();

packages/client-sdk/README.md

@@ -0,0 +1,62 @@
+# @objectstack/client-sdk
+
+The official TypeScript client for ObjectStack.
+
+## Features
+
+- **Auto-Discovery**: Connects to your ObjectStack server and automatically configures API endpoints.
+- **Typed Metadata**: Retrieve Object and View definitions with full type support.
+- **Unified Data Access**: Simple CRUD operations for any object in your schema.
+
+## Installation
+
+```bash
+pnpm add @objectstack/client-sdk
+```
+
+## Usage
+
+```typescript
+import { ObjectStackClient } from '@objectstack/client-sdk';
+
+// 1. Initialize
+const client = new ObjectStackClient({
+  baseUrl: 'http://localhost:3004' // Your ObjectStack Server URL
+});
+
+async function main() {
+  // 2. Connect (Fetches system capabilities)
+  await client.connect();
+
+  // 3. Metadata Access
+  const todoSchema = await client.meta.getObject('todo_task');
+  console.log('Fields:', todoSchema.fields);
+
+  // 4. Data Access
+  const tasks = await client.data.find('todo_task', {
+    status: 'pending' // Simple filtering
+  });
+  
+  // 5. Create Data
+  await client.data.create('todo_task', {
+    title: 'New Task',
+    status: 'todo'
+  });
+}
+```
+
+## API Reference
+
+### `client.connect()`
+Initializes the client by fetching the system discovery manifest from `/api/v1`.
+
+### `client.meta`
+- `getObject(name: string)`: Get object schema.
+- `getView(name: string)`: Get view configuration.
+
+### `client.data`
+- `find(object: string, query?: Record<string, any>)`: List records.
+- `get(object: string, id: string)`: Get single record.
+- `create(object: string, data: any)`: Create record.
+- `update(object: string, id: string, data: any)`: Update record.
+- `delete(object: string, id: string)`: Delete record.

packages/client-sdk/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@objectstack/client-sdk",
+  "version": "0.1.0",
+  "description": "Official Client SDK for ObjectStack Protocol",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@objectstack/spec": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

packages/client-sdk/src/index.ts

@@ -0,0 +1,131 @@
+export interface ClientConfig {
+  baseUrl: string;
+  token?: string;
+}
+
+export interface DiscoveryResult {
+  routes: {
+    discovery: string;
+    metadata: string;
+    data: string;
+    auth: string;
+  };
+  capabilities?: Record<string, boolean>;
+}
+
+export class ObjectStackClient {
+  private baseUrl: string;
+  private token?: string;
+  private routes?: DiscoveryResult['routes'];
+
+  constructor(config: ClientConfig) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+    this.token = config.token;
+  }
+
+  /**
+   * Initialize the client by discovering server capabilities and routes.
+   */
+  async connect() {
+    try {
+      const res = await this.fetch(`${this.baseUrl}/api/v1`);
+      const data = await res.json();
+      this.routes = data.routes;
+      return data;
+    } catch (e) {
+      console.error('Failed to connect to ObjectStack Server', e);
+      throw e;
+    }
+  }
+
+  /**
+   * Metadata Operations
+   */
+  meta = {
+    getObject: async (name: string) => {
+        const route = this.getRoute('metadata');
+        const res = await this.fetch(`${this.baseUrl}${route}/object/${name}`);
+        return res.json();
+    },
+    
+    getView: async (object: string, type: 'list' | 'form' = 'list') => {
+        // UI routes might not be in discovery map yet, assume convention or add to server
+        // Convention from server/src/index.ts: /api/v1/ui/view/:object
+        const res = await this.fetch(`${this.baseUrl}/api/v1/ui/view/${object}?type=${type}`);
+        return res.json();
+    }
+  };
+
+  /**
+   * Data Operations
+   */
+  data = {
+    find: async (object: string, query: any = {}) => {
+        const route = this.getRoute('data');
+        const queryString = new URLSearchParams(query).toString();
+        const res = await this.fetch(`${this.baseUrl}${route}/${object}?${queryString}`);
+        return res.json();
+    },
+
+    get: async (object: string, id: string) => {
+        const route = this.getRoute('data');
+        const res = await this.fetch(`${this.baseUrl}${route}/${object}/${id}`);
+        return res.json();
+    },
+
+    create: async (object: string, data: any) => {
+        const route = this.getRoute('data');
+        const res = await this.fetch(`${this.baseUrl}${route}/${object}`, {
+            method: 'POST',
+            body: JSON.stringify(data)
+        });
+        return res.json();
+    },
+
+    update: async (object: string, id: string, data: any) => {
+        const route = this.getRoute('data');
+        const res = await this.fetch(`${this.baseUrl}${route}/${object}/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data)
+        });
+        return res.json();
+    },
+
+    delete: async (object: string, id: string) => {
+        const route = this.getRoute('data');
+        const res = await this.fetch(`${this.baseUrl}${route}/${object}/${id}`, {
+            method: 'DELETE'
+        });
+        return res.json();
+    }
+  };
+
+  private getRoute(key: keyof DiscoveryResult['routes']): string {
+    if (!this.routes) {
+        throw new Error('Client not connected. Call client.connect() first.');
+    }
+    return this.routes[key];
+  }
+
+  private async fetch(url: string, options: RequestInit = {}) {
+    const headers: Record<string, string> = {
+        'Content-Type': 'application/json',
+        ...(options.headers as any || {})
+    };
+
+    if (this.token) {
+        headers['Authorization'] = `Bearer ${this.token}`;
+    }
+
+    const res = await fetch(url, {
+        ...options,
+        headers
+    });
+
+    if (res.status >= 400) {
+        throw new Error(`API Error ${res.status}: ${res.statusText}`);
+    }
+
+    return res;
+  }
+}

packages/client-sdk/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}