feat: 添加 ApiMethod 枚举及其 JSON Schema 定义，更新相关类型以支持 API 操作

Author: hotlong

content/docs/references/data/object.mdx

@@ -12,15 +12,36 @@ description: Object protocol schemas
 ## TypeScript Usage
 
 ```typescript
-import { CDCConfigSchema, IndexSchema, ObjectSchema, ObjectCapabilitiesSchema, PartitioningConfigSchema, SoftDeleteConfigSchema, TenancyConfigSchema, VersioningConfigSchema } from '@objectstack/spec/data';
-import type { CDCConfig, Index, Object, ObjectCapabilities, PartitioningConfig, SoftDeleteConfig, TenancyConfig, VersioningConfig } from '@objectstack/spec/data';
+import { ApiMethodSchema, CDCConfigSchema, IndexSchema, ObjectSchema, ObjectCapabilitiesSchema, PartitioningConfigSchema, SoftDeleteConfigSchema, TenancyConfigSchema, VersioningConfigSchema } from '@objectstack/spec/data';
+import type { ApiMethod, CDCConfig, Index, Object, ObjectCapabilities, PartitioningConfig, SoftDeleteConfig, TenancyConfig, VersioningConfig } from '@objectstack/spec/data';
 
 // Validate data
-const result = CDCConfigSchema.parse(data);
+const result = ApiMethodSchema.parse(data);
 ```
 
 ---
 
+## ApiMethod
+
+### Allowed Values
+
+* `get`
+* `list`
+* `create`
+* `update`
+* `delete`
+* `upsert`
+* `bulk`
+* `aggregate`
+* `history`
+* `search`
+* `restore`
+* `purge`
+* `import`
+* `export`
+
+---
+
 ## CDCConfig
 
 ### Properties

packages/spec/json-schema/data/ApiMethod.json

@@ -0,0 +1,25 @@
+{
+  "$ref": "#/definitions/ApiMethod",
+  "definitions": {
+    "ApiMethod": {
+      "type": "string",
+      "enum": [
+        "get",
+        "list",
+        "create",
+        "update",
+        "delete",
+        "upsert",
+        "bulk",
+        "aggregate",
+        "history",
+        "search",
+        "restore",
+        "purge",
+        "import",
+        "export"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

packages/spec/src/data/object.zod.ts

@@ -2,6 +2,22 @@ import { z } from 'zod';
 import { FieldSchema } from './field.zod';
 import { ValidationRuleSchema } from './validation.zod';
 
+/**
+ * API Operations Enum
+ */
+export const ApiMethod = z.enum([
+  'get', 'list',          // Read
+  'create', 'update', 'delete', // Write
+  'upsert',               // Idempotent Write
+  'bulk',                 // Batch operations
+  'aggregate',            // Analytics (count, sum)
+  'history',              // Audit access
+  'search',               // Search access
+  'restore', 'purge',     // Trash management
+  'import', 'export',     // Data portability
+]);
+export type ApiMethod = z.infer<typeof ApiMethod>;
+
 /**
  * Capability Flags
  * Defines what system features are enabled for this object.
@@ -26,17 +42,7 @@ export const ObjectCapabilities = z.object({
    * API Supported Operations
    * Granular control over API exposure.
    */
-  apiMethods: z.array(z.enum([
-    'get', 'list',          // Read
-    'create', 'update', 'delete', // Write
-    'upsert',               // Idempotent Write
-    'bulk',                 // Batch operations
-    'aggregate',            // Analytics (count, sum)
-    'history',              // Audit access
-    'search',               // Search access
-    'restore', 'purge',     // Trash management
-    'import', 'export',     // Data portability
-  ])).optional().describe('Whitelist of allowed API operations'),
+  apiMethods: z.array(ApiMethod).optional().describe('Whitelist of allowed API operations'),
 
   /** Enable standard attachments/files engine */
   files: z.boolean().default(false).describe('Enable file attachments and document management'),