apaas-oapi-client 0.1.35 → 0.1.37

package/src/index.ts

@@ -2,6 +2,33 @@ import dayjs from 'dayjs';
 import axios, { AxiosInstance, AxiosError } from 'axios';
 import { LoggerLevel } from './logger';
 import { functionLimiter } from './limiter';
+import {
+    FIELD_TYPES,
+    SYSTEM_FIELDS,
+    LANGUAGE_CODES,
+    SCHEMA_GUIDELINES,
+    CREATE_OBJECT_EXAMPLE,
+    UPDATE_OBJECT_ADD_FIELD_EXAMPLE,
+    UPDATE_OBJECT_REPLACE_FIELD_EXAMPLE,
+    UPDATE_OBJECT_REMOVE_FIELD_EXAMPLE,
+    UPDATE_OBJECT_SETTINGS_EXAMPLE,
+    getSystemFields,
+    getCustomFieldTypes,
+    getFieldType,
+    isSystemField,
+    createMultilingualText,
+    extractMultilingualText,
+    type FieldTypeMetadata,
+    type MultilingualText,
+    type ObjectSettings,
+    type FieldTypeDefinition,
+    type EncryptType,
+    type FieldOperator,
+    type CreateFieldDefinition,
+    type UpdateFieldDefinition,
+    type CreateObjectDefinition,
+    type UpdateObjectDefinition
+} from './field-types';
 
 /**
  * 批量操作结果
@@ -593,7 +620,7 @@ class Client {
                     if (obj.fields && obj.fields.length > 0) {
                         // 对字段进行分类和排序
                         const systemFieldOrder = ['_name', '_createdBy', '_createdAt', '_updatedBy', '_updatedAt'];
-                        const specialFieldTypes = ['formula', 'referenceField'];
+                        const specialFieldTypes = ['formula', 'referenceField', 'rollup'];
 
                         let idField: any = null;
                         const normalFields: any[] = [];
@@ -678,6 +705,41 @@ class Client {
                                 }
                             }
 
+                            // rollup 类型：汇总字段
+                            if (field.type?.name === 'rollup') {
+                                otherSettings.push(`⚙️ 系统自动维护，不需要写/更新`);
+                                
+                                // 汇总函数类型映射
+                                const functionTypeMap: { [key: string]: string } = {
+                                    'count': '计数',
+                                    'sum': '求和',
+                                    'avg': '平均值',
+                                    'max': '最大值',
+                                    'min': '最小值',
+                                    'countDistinct': '去重计数'
+                                };
+                                const functionType = functionTypeMap[settings.functionType] || settings.functionType;
+                                if (functionType) {
+                                    otherSettings.push(`📊 汇总类型: ${functionType}`);
+                                }
+                                
+                                if (settings.objectAPIName) {
+                                    otherSettings.push(`📦 汇总对象: \`${settings.objectAPIName}\``);
+                                }
+                                
+                                if (settings.lookupFieldAPIName) {
+                                    otherSettings.push(`🔗 关联字段: \`${settings.lookupFieldAPIName}\``);
+                                }
+                                
+                                if (settings.fieldAPIName) {
+                                    otherSettings.push(`📋 汇总字段: \`${settings.fieldAPIName}\``);
+                                }
+                                
+                                if (settings.rangeFilter && settings.rangeFilter.conditions && settings.rangeFilter.conditions.length > 0) {
+                                    otherSettings.push(`🔍 有过滤条件 (${settings.rangeFilter.conditions.length}个)`);
+                                }
+                            }
+
                             // 根据不同类型展示不同的设置
                             if (settings.maxLength) {
                                 otherSettings.push(`最大长度:${settings.maxLength}`);
@@ -2375,10 +2437,258 @@ class Client {
             }
         }
     };
+
+    /**
+     * 数据对象结构管理模块（Schema）
+     */
+    public schema = {
+        /**
+         * 批量创建数据对象（表）
+         * @description 批量创建一个或多个数据对象
+         * @param params 请求参数 { objects: Array }
+         * @returns 接口返回结果
+         */
+        create: async (params: {
+            objects: Array<{
+                api_name: string;
+                label: {
+                    zh_cn: string;
+                    en_us: string;
+                };
+                settings?: {
+                    allow_search_fields?: string[];
+                    display_name?: string;
+                    search_layout?: string[];
+                };
+                fields: Array<{
+                    api_name: string;
+                    label: {
+                        zh_cn: string;
+                        en_us: string;
+                    };
+                    type: {
+                        name: string;
+                        settings?: any;
+                    };
+                    encrypt_type?: string | null;
+                }>;
+            }>;
+        }): Promise<any> => {
+            const { objects } = params;
+            await this.ensureTokenValid();
+
+            const url = `/v1/namespaces/${this.namespace}/objects/batch_create`;
+
+            this.log(LoggerLevel.info, `[schema.create] Creating ${objects.length} object(s)`);
+            this.log(LoggerLevel.trace, `[schema.create] Request URL: ${this.axiosInstance.defaults.baseURL}${url}`);
+            this.log(LoggerLevel.trace, `[schema.create] Request Body: ${JSON.stringify({ objects }, null, 2)}`);
+
+            const res = await this.axiosInstance.post(
+                url,
+                { objects },
+                {
+                    headers: {
+                        Authorization: `${this.accessToken}`,
+                        'Content-Type': 'application/json'
+                    }
+                }
+            );
+
+            this.log(LoggerLevel.debug, `[schema.create] Objects created: code=${res.data.code}`);
+            this.log(LoggerLevel.trace, `[schema.create] Response: ${JSON.stringify(res.data)}`);
+
+            return res.data;
+        },
+
+        /**
+         * 批量更新数据对象（表）
+         * @description 批量更新一个或多个数据对象的配置
+         * @param params 请求参数 { objects: Array }
+         * @returns 接口返回结果
+         * @example
+         * ```typescript
+         * // 添加新字段
+         * await client.schema.update({
+         *   objects: [{
+         *     api_name: 'my_object',
+         *     fields: [{
+         *       operator: 'add',
+         *       api_name: 'new_field',
+         *       label: { zh_cn: '新字段', en_us: 'New Field' },
+         *       type: { name: 'text', settings: { required: false } },
+         *       encrypt_type: 'none'
+         *     }]
+         *   }]
+         * });
+         * 
+         * // 修改现有字段
+         * await client.schema.update({
+         *   objects: [{
+         *     api_name: 'my_object',
+         *     fields: [{
+         *       operator: 'replace',
+         *       api_name: 'existing_field',
+         *       label: { zh_cn: '新标签', en_us: 'New Label' }
+         *     }]
+         *   }]
+         * });
+         * 
+         * // 删除字段
+         * await client.schema.update({
+         *   objects: [{
+         *     api_name: 'my_object',
+         *     fields: [{
+         *       operator: 'remove',
+         *       api_name: 'field_to_delete'
+         *     }]
+         *   }]
+         * });
+         * ```
+         */
+        update: async (params: {
+            objects: Array<{
+                api_name: string;
+                label?: {
+                    zh_cn: string;
+                    en_us: string;
+                };
+                settings?: {
+                    allow_search_fields?: string[];
+                    display_name?: string;
+                    search_layout?: string[];
+                };
+                fields?: Array<{
+                    /** 操作类型：add=添加字段, replace=修改字段, remove=删除字段 */
+                    operator: 'add' | 'replace' | 'remove';
+                    /** 字段 API 名称 */
+                    api_name: string;
+                    /** 字段标签（可选，operator=add 和 replace 时使用） */
+                    label?: {
+                        zh_cn: string;
+                        en_us: string;
+                    };
+                    /** 字段类型（可选，operator=add 和 replace 时使用） */
+                    type?: {
+                        name: string;
+                        settings?: any;
+                    };
+                    /** 加密类型（可选） */
+                    encrypt_type?: string | null;
+                }>;
+            }>;
+        }): Promise<any> => {
+            const { objects } = params;
+            await this.ensureTokenValid();
+
+            const url = `/v1/namespaces/${this.namespace}/objects/batch_update`;
+
+            this.log(LoggerLevel.info, `[schema.update] Updating ${objects.length} object(s)`);
+            this.log(LoggerLevel.trace, `[schema.update] Request URL: ${this.axiosInstance.defaults.baseURL}${url}`);
+            this.log(LoggerLevel.trace, `[schema.update] Request Body: ${JSON.stringify({ objects }, null, 2)}`);
+
+            const res = await this.axiosInstance.post(
+                url,
+                { objects },
+                {
+                    headers: {
+                        Authorization: `${this.accessToken}`,
+                        'Content-Type': 'application/json'
+                    }
+                }
+            );
+
+            this.log(LoggerLevel.debug, `[schema.update] Objects updated: code=${res.data.code}`);
+            this.log(LoggerLevel.trace, `[schema.update] Response: ${JSON.stringify(res.data)}`);
+
+            return res.data;
+        },
+
+        /**
+         * 批量删除数据对象（表）
+         * @description 批量删除一个或多个数据对象
+         * @param params 请求参数 { api_names: string[] }
+         * @returns 接口返回结果
+         * @example
+         * ```typescript
+         * // 删除单个对象
+         * await client.schema.delete({ api_names: ['object_abc'] });
+         * 
+         * // 删除多个对象
+         * await client.schema.delete({ api_names: ['object_abc', 'object_def'] });
+         * ```
+         */
+        delete: async (params: { api_names: string[] }): Promise<any> => {
+            const { api_names } = params;
+            await this.ensureTokenValid();
+
+            const url = `/v1/namespaces/${this.namespace}/objects/batch_delete`;
+
+            this.log(LoggerLevel.info, `[schema.delete] Deleting ${api_names.length} object(s): ${api_names.join(', ')}`);
+
+            // 直接传递字符串数组
+            const requestBody = {
+                api_names
+            };
+
+            this.log(LoggerLevel.trace, `[schema.delete] Request URL: ${this.axiosInstance.defaults.baseURL}${url}`);
+            this.log(LoggerLevel.trace, `[schema.delete] Request Body: ${JSON.stringify(requestBody, null, 2)}`);
+
+            const res = await this.axiosInstance.post(
+                url,
+                requestBody,
+                {
+                    headers: {
+                        Authorization: `${this.accessToken}`,
+                        'Content-Type': 'application/json'
+                    }
+                }
+            );
+
+            this.log(LoggerLevel.debug, `[schema.delete] Objects deleted: code=${res.data.code}`);
+            this.log(LoggerLevel.trace, `[schema.delete] Response: ${JSON.stringify(res.data)}`);
+
+            return res.data;
+        }
+    };
 }
 
 export const apaas = {
     Client
 };
 
-export type { BatchResult, RetryOptions };
+export type { 
+    BatchResult, 
+    RetryOptions, 
+    FieldTypeMetadata,
+    // Schema operation types
+    MultilingualText,
+    ObjectSettings,
+    FieldTypeDefinition,
+    EncryptType,
+    FieldOperator,
+    CreateFieldDefinition,
+    UpdateFieldDefinition,
+    CreateObjectDefinition,
+    UpdateObjectDefinition
+};
+
+export {
+    // Field type definitions and metadata
+    FIELD_TYPES,
+    SYSTEM_FIELDS,
+    LANGUAGE_CODES,
+    // Schema guidelines and examples
+    SCHEMA_GUIDELINES,
+    CREATE_OBJECT_EXAMPLE,
+    UPDATE_OBJECT_ADD_FIELD_EXAMPLE,
+    UPDATE_OBJECT_REPLACE_FIELD_EXAMPLE,
+    UPDATE_OBJECT_REMOVE_FIELD_EXAMPLE,
+    UPDATE_OBJECT_SETTINGS_EXAMPLE,
+    // Helper functions
+    getSystemFields,
+    getCustomFieldTypes,
+    getFieldType,
+    isSystemField,
+    createMultilingualText,
+    extractMultilingualText
+};