@share-crm/sharedev-cli 0.0.4-rc.20 → 0.0.4-rc.21

package/dist/sharedev.js

@@ -10098,7 +10098,7 @@ function registerFlowNamespace(program, runtimeContext) {
     flowDef
         .command('get-link-app')
         .description('查询互联应用')
-        .option('--linkAppId <linkAppId>', '关联应用ID')
+        .option('--flowType <flowType>', '流程类型')
         .action((0, command_ts_1.createCommandAction)('flow def', 'get-link-app', runtimeContext, async ({ options, context }) => {
         await (0, flow_def_command_ts_1.flowDefGetLinkAppCommand)(context, options);
     }));
@@ -13362,11 +13362,10 @@ const rules_ts_1 = __webpack_require__(5330);
 ;
 let instance = null;
 class XmlMetadataManager {
-    static getInstance() {
-        if (!instance) {
-            instance = new XmlMetadataManager();
-        }
-        return instance;
+    constructor() {
+        if (instance)
+            return instance;
+        instance = this;
     }
     async writeXml(headerName, apiName, content, options = {}) {
         const rule = (0, rules_ts_1.getXmlMetadataRule)(headerName);
@@ -20695,6 +20694,7 @@ exports.buttonCreateService = void 0;
 const normalize_ts_1 = __importDefault(__webpack_require__(9268));
 const index_ts_1 = __webpack_require__(9985);
 const button_service_ts_1 = __webpack_require__(7580);
+const button_metadata_ts_1 = __webpack_require__(3506);
 const xmlMetadataManager = new index_ts_1.XmlMetadataManager();
 const buttonCreateService = async (objectApiName, data, force) => {
     // Validate objectApiName
@@ -20707,18 +20707,11 @@ const buttonCreateService = async (objectApiName, data, force) => {
     if (!raw) {
         throw new Error('Invalid arguments: data is required.');
     }
-    const buttonData = JSON.parse(raw);
-    if (!buttonData || typeof buttonData !== 'object' || Array.isArray(buttonData)) {
-        throw new Error('data must be a JSON object.');
-    }
-    // Extract buttonApiName from data
-    const buttonApiName = normalize_ts_1.default.normalizeString(buttonData.api_name);
-    if (!buttonApiName) {
-        throw new Error('data.api_name is required.');
-    }
+    const buttonContent = (0, button_metadata_ts_1.assertCompleteButtonMetaContent)(JSON.parse(raw), checkedObjectApiName);
+    const buttonApiName = (0, button_metadata_ts_1.getButtonApiName)(buttonContent);
     // Check remote existence: error if button already exists remotely
     const remoteButtons = await (0, button_service_ts_1.fetchButtonList)(checkedObjectApiName, null);
-    if (remoteButtons.some((item) => normalize_ts_1.default.normalizeString(item.api_name) === buttonApiName)) {
+    if (remoteButtons.some((item) => (0, button_metadata_ts_1.getButtonApiName)(item) === buttonApiName)) {
         throw new Error('Button already exists remotely: ' + checkedObjectApiName + '.' + buttonApiName);
     }
     // Check if local file already exists
@@ -20732,7 +20725,7 @@ const buttonCreateService = async (objectApiName, data, force) => {
         }
     }
     // Write local Button XML, mark as new
-    const filePath = await xmlMetadataManager.writeXml('ObjectButton', buttonApiName, buttonData, {
+    const filePath = await xmlMetadataManager.writeXml('ObjectButton', buttonApiName, buttonContent, {
         objectApiName: checkedObjectApiName,
         status: 'new',
     });
@@ -20780,14 +20773,17 @@ const buttonListService = async (objectApiName, buttonApiNamesRaw) => {
         errorMessages.push(`${checkedObjectApiName}: ${error instanceof Error ? error.message : String(error)}`);
         return { objectApiName: checkedObjectApiName, buttons: [], found: 0, errorMessages };
     }
-    const buttonItems = buttons.map((item) => ({
-        apiName: normalize_ts_1.default.normalizeText(item.api_name),
-        label: normalize_ts_1.default.normalizeText(item.label),
-        buttonType: normalize_ts_1.default.normalizeText(item.button_type),
-        usePages: Array.isArray(item.use_pages) ? item.use_pages.join(', ') : normalize_ts_1.default.normalizeText(item.use_pages),
-        isActive: normalize_ts_1.default.normalizeText(item.is_active),
-        content: item,
-    })).filter((item) => item.apiName);
+    const buttonItems = buttons.map((item) => {
+        const button = item.button;
+        return {
+            apiName: normalize_ts_1.default.normalizeText(button.api_name),
+            label: normalize_ts_1.default.normalizeText(button.label),
+            buttonType: normalize_ts_1.default.normalizeText(button.button_type),
+            usePages: Array.isArray(button.use_pages) ? button.use_pages.join(', ') : normalize_ts_1.default.normalizeText(button.use_pages),
+            isActive: normalize_ts_1.default.normalizeText(button.is_active),
+            content: item,
+        };
+    }).filter((item) => item.apiName);
     return {
         objectApiName: checkedObjectApiName,
         buttons: buttonItems,
@@ -20798,6 +20794,222 @@ const buttonListService = async (objectApiName, buttonApiNamesRaw) => {
 exports.buttonListService = buttonListService;
 
 
+/***/ },
+
+/***/ 3506
+(__unused_webpack_module, exports, __webpack_require__) {
+
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.normalizePulledButtonMetaContent = normalizePulledButtonMetaContent;
+exports.assertCompleteButtonMetaContent = assertCompleteButtonMetaContent;
+exports.getButtonApiName = getButtonApiName;
+exports.toButtonExecutePayload = toButtonExecutePayload;
+const normalize_ts_1 = __importDefault(__webpack_require__(9268));
+function normalizePulledButtonMetaContent(record, objectApiName) {
+    const button = normalize_ts_1.default.isRecord(record.button) ? record.button : pickFlatButtonRecord(record);
+    const content = {
+        button: {
+            ...button,
+            describe_api_name: normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(button.describe_api_name)) ?? objectApiName,
+        },
+        post_actions: readRecordArray(record.post_actions, 'post_actions', true),
+        roles: readArray(record.roles, 'roles', true),
+        ignore_default_role: readBoolean(record.ignore_default_role, 'ignore_default_role', true) ?? false,
+        i18nInfoList: readRecordArray(record.i18nInfoList, 'i18nInfoList', true),
+        handler_list: readRecordArray(record.handler_list, 'handler_list', true),
+        sourceInfo: normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(record.sourceInfo)),
+    };
+    assertButtonMetaContent(content, objectApiName, { requireComplete: false });
+    return content;
+}
+function pickFlatButtonRecord(record) {
+    const { post_actions: _postActions, roles: _roles, ignore_default_role: _ignoreDefaultRole, i18nInfoList: _i18nInfoList, handler_list: _handlerList, sourceInfo: _sourceInfo, button_config: _buttonConfig, ...button } = record;
+    void _postActions;
+    void _roles;
+    void _ignoreDefaultRole;
+    void _i18nInfoList;
+    void _handlerList;
+    void _sourceInfo;
+    void _buttonConfig;
+    return button;
+}
+function assertCompleteButtonMetaContent(input, objectApiName) {
+    return assertButtonMetaContent(input, objectApiName, { requireComplete: true });
+}
+function getButtonApiName(content) {
+    const buttonApiName = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(content.button.api_name));
+    if (!buttonApiName) {
+        throw new Error('button.button.api_name is required.');
+    }
+    return buttonApiName;
+}
+function toButtonExecutePayload(content, options) {
+    const buttonPayload = {
+        ...content.button,
+        api_name: options.buttonApiName,
+        describe_api_name: options.objectApiName,
+    };
+    const payload = {
+        button: JSON.stringify(buttonPayload),
+        post_actions: content.post_actions,
+        roles: content.roles,
+        i18nInfoList: content.i18nInfoList,
+    };
+    if (options.isCreate) {
+        payload.ignore_default_role = content.ignore_default_role;
+    }
+    else {
+        payload.handler_list = content.handler_list ?? [];
+        payload.sourceInfo = content.sourceInfo ?? 'object_management';
+    }
+    return payload;
+}
+function assertButtonMetaContent(input, objectApiName, options) {
+    if (!normalize_ts_1.default.isRecord(input)) {
+        throw new Error('button content must be a JSON object.');
+    }
+    if (!normalize_ts_1.default.isRecord(input.button)) {
+        throw new Error('button content must include button object.');
+    }
+    const button = { ...input.button };
+    const buttonApiName = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(button.api_name));
+    if (!buttonApiName) {
+        throw new Error('button.button.api_name is required.');
+    }
+    const describeApiName = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(button.describe_api_name));
+    if (!describeApiName) {
+        if (options.requireComplete) {
+            throw new Error('button.button.describe_api_name is required.');
+        }
+        button.describe_api_name = objectApiName;
+    }
+    else if (describeApiName !== objectApiName) {
+        throw new Error('button.button.describe_api_name must be ' + objectApiName + '.');
+    }
+    requireString(button.label, 'button.button.label', options.requireComplete);
+    requireString(button.button_type, 'button.button_type', options.requireComplete);
+    const usePages = readStringArray(button.use_pages, 'button.use_pages', !options.requireComplete);
+    if (options.requireComplete && usePages.length === 0) {
+        throw new Error('button.use_pages must be a non-empty string array.');
+    }
+    button.use_pages = usePages;
+    button.wheres = readRecordArray(button.wheres, 'button.wheres', !options.requireComplete);
+    button.param_form = readRecordArray(button.param_form, 'button.param_form', !options.requireComplete);
+    button.actions = readStringArray(button.actions, 'button.actions', !options.requireComplete);
+    const postActions = readRecordArray(input.post_actions, 'post_actions', !options.requireComplete);
+    const roles = readArray(input.roles, 'roles', !options.requireComplete);
+    const ignoreDefaultRole = readBoolean(input.ignore_default_role, 'ignore_default_role', !options.requireComplete);
+    const i18nInfoList = readRecordArray(input.i18nInfoList, 'i18nInfoList', !options.requireComplete);
+    const handlerList = readRecordArray(input.handler_list, 'handler_list', true);
+    const sourceInfo = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(input.sourceInfo));
+    if (options.requireComplete && i18nInfoList.length === 0) {
+        throw new Error('i18nInfoList must be a non-empty array.');
+    }
+    const content = {
+        button,
+        post_actions: postActions,
+        roles,
+        ignore_default_role: ignoreDefaultRole ?? false,
+        i18nInfoList,
+        handler_list: handlerList,
+        sourceInfo,
+    };
+    assertButtonTypeRules(content);
+    return content;
+}
+function requireString(value, fieldName, required) {
+    if (!required && value === undefined) {
+        return;
+    }
+    if (!normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(value))) {
+        throw new Error(fieldName + ' is required.');
+    }
+}
+function readBoolean(value, fieldName, optional) {
+    if (value === undefined || value === null) {
+        if (optional) {
+            return undefined;
+        }
+        throw new Error(fieldName + ' is required.');
+    }
+    if (typeof value !== 'boolean') {
+        throw new Error(fieldName + ' must be a boolean.');
+    }
+    return value;
+}
+function readRecordArray(value, fieldName, optional) {
+    if (value === undefined || value === null) {
+        if (optional) {
+            return [];
+        }
+        throw new Error(fieldName + ' is required.');
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(fieldName + ' must be an array.');
+    }
+    return value.map((item, index) => {
+        if (!normalize_ts_1.default.isRecord(item)) {
+            throw new Error(fieldName + '[' + index + '] must be an object.');
+        }
+        return item;
+    });
+}
+function readArray(value, fieldName, optional) {
+    if (value === undefined || value === null) {
+        if (optional) {
+            return [];
+        }
+        throw new Error(fieldName + ' is required.');
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(fieldName + ' must be an array.');
+    }
+    return value;
+}
+function readStringArray(value, fieldName, optional) {
+    if (value === undefined || value === null) {
+        if (optional) {
+            return [];
+        }
+        throw new Error(fieldName + ' is required.');
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(fieldName + ' must be an array.');
+    }
+    return value.map((item, index) => {
+        const text = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(item));
+        if (!text) {
+            throw new Error(fieldName + '[' + index + '] must be a non-empty string.');
+        }
+        return text;
+    });
+}
+function assertButtonTypeRules(content) {
+    const buttonType = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(content.button.button_type));
+    const redirectType = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(content.button.redirect_type));
+    const jumpUrl = normalize_ts_1.default.normalizeString(normalize_ts_1.default.asString(content.button.jump_url));
+    const paramForm = Array.isArray(content.button.param_form) ? content.button.param_form : [];
+    const actions = Array.isArray(content.button.actions) ? content.button.actions : [];
+    if (redirectType) {
+        if (!jumpUrl) {
+            throw new Error('button.jump_url is required when button.redirect_type is set.');
+        }
+        if (actions.length > 0 || content.post_actions.length > 0) {
+            throw new Error('redirect button cannot include button.actions or post_actions.');
+        }
+    }
+    if (buttonType === 'mapping') {
+        if (paramForm.length > 0 || actions.length > 0 || content.post_actions.length > 0) {
+            throw new Error('mapping button cannot include button.param_form, button.actions or post_actions.');
+        }
+    }
+}
+
+
 /***/ },
 
 /***/ 6884
@@ -20813,6 +21025,7 @@ const normalize_ts_1 = __importDefault(__webpack_require__(9268));
 const logger_ts_1 = __webpack_require__(3333);
 const index_ts_1 = __webpack_require__(9985);
 const button_service_ts_1 = __webpack_require__(7580);
+const button_metadata_ts_1 = __webpack_require__(3506);
 const xmlMetadataManager = new index_ts_1.XmlMetadataManager();
 const buttonPullService = async (objectApiNamesRaw, force = false, skipOverwriteConfirm = false) => {
     const errorMessages = [];
@@ -20837,8 +21050,11 @@ const buttonPullService = async (objectApiNamesRaw, force = false, skipOverwrite
             // Write each button to local XML
             for (const buttonRecord of buttons) {
                 // Extract button api_name
-                const buttonApiName = normalize_ts_1.default.normalizeString(buttonRecord.api_name);
-                if (!buttonApiName) {
+                let buttonApiName;
+                try {
+                    buttonApiName = (0, button_metadata_ts_1.getButtonApiName)(buttonRecord);
+                }
+                catch {
                     skipped += 1;
                     continue;
                 }
@@ -20912,6 +21128,7 @@ const button_service_ts_1 = __webpack_require__(7580);
 const button_pull_ts_1 = __webpack_require__(6884);
 const request_ts_1 = __webpack_require__(3176);
 const logger_ts_1 = __webpack_require__(3333);
+const button_metadata_ts_1 = __webpack_require__(3506);
 const xmlMetadataManager = new index_ts_1.XmlMetadataManager();
 const isRecord = normalize_ts_1.default.isRecord;
 /**
@@ -20953,7 +21170,7 @@ const buttonPushService = async (objectApiName, buttonApiName, skipOverwriteConf
     let existsRemotely = false;
     try {
         const remoteButtons = await (0, button_service_ts_1.fetchButtonList)(checkedObjectApiName, null);
-        existsRemotely = remoteButtons.some((item) => normalize_ts_1.default.normalizeString(item.api_name) === checkedButtonApiName);
+        existsRemotely = remoteButtons.some((item) => (0, button_metadata_ts_1.getButtonApiName)(item) === checkedButtonApiName);
     }
     finally {
         logger_ts_1.loggerService.stopLoading();
@@ -20983,40 +21200,16 @@ const buttonPushService = async (objectApiName, buttonApiName, skipOverwriteConf
         objectApiName: checkedObjectApiName,
     });
     const isCreate = correctedMeta.status === 'new';
-    // Build push payload
-    const buttonContent = { ...(correctedMeta.content && isRecord(correctedMeta.content)
-            ? correctedMeta.content
-            : buttonMeta.content) };
-    if (!buttonContent.describe_api_name) {
-        buttonContent.describe_api_name = checkedObjectApiName;
-    }
-    if (!buttonContent.api_name) {
-        buttonContent.api_name = checkedButtonApiName;
-    }
-    const buttonPayloadContent = { ...buttonContent };
-    delete buttonPayloadContent.button_config;
-    const buttonJsonString = JSON.stringify(buttonPayloadContent);
+    const buttonContent = (0, button_metadata_ts_1.assertCompleteButtonMetaContent)(correctedMeta.content && isRecord(correctedMeta.content)
+        ? correctedMeta.content
+        : buttonMeta.content, checkedObjectApiName);
     // Build payload and call create/update
     logger_ts_1.loggerService.startLoading('button push request: ' + checkedObjectApiName + '.' + checkedButtonApiName + ' (' + (isCreate ? 'create' : 'update') + ')');
-    const payload = {
-        button: buttonJsonString,
-        post_actions: [],
-        roles: [],
-    };
-    if (!isCreate) {
-        payload.handler_list = [];
-    }
-    const i18nInfoList = buttonContent.i18nInfoList;
-    payload.i18nInfoList = i18nInfoList ?? [
-        {
-            apiName: checkedButtonApiName,
-            defaultValue: buttonContent.label ?? checkedButtonApiName,
-            type: 'buttonName',
-            languageInfo: {
-                'zh-CN': buttonContent.label ?? checkedButtonApiName,
-            },
-        },
-    ];
+    const payload = (0, button_metadata_ts_1.toButtonExecutePayload)(buttonContent, {
+        objectApiName: checkedObjectApiName,
+        buttonApiName: checkedButtonApiName,
+        isCreate,
+    });
     const raw = await (0, request_ts_1.requestObjectDevExecute)(isCreate
         ? (0, request_execute_command_paths_ts_1.getShareCliCommandPath)('button', 'create')
         : (0, request_execute_command_paths_ts_1.getShareCliCommandPath)('button', 'update'), payload);
@@ -21072,8 +21265,9 @@ exports.fetchButtonList = void 0;
 const request_execute_command_paths_ts_1 = __webpack_require__(2351);
 const request_ts_1 = __webpack_require__(3176);
 const types_ts_1 = __webpack_require__(7480);
+const button_metadata_ts_1 = __webpack_require__(3506);
 /**
- * 共享：调 list 接口获取单个对象下全部按钮（或指定按钮），返回解析后的 button 数组
+ * 共享：调 list 接口获取单个对象下全部按钮（或指定按钮），返回本地 ObjectButton XML content 结构
  */
 const fetchButtonList = async (objectApiName, buttonApiNames) => {
     const response = await (0, request_ts_1.requestObjectDevExecute)((0, request_execute_command_paths_ts_1.getShareCliCommandPath)('button', 'list'), {
@@ -21091,14 +21285,11 @@ const fetchButtonList = async (objectApiName, buttonApiNames) => {
         throw new Error(result.errorMessage);
     }
     const buttons = result.data ?? [];
-    // 提取 item.button：响应结构为 [{ button: {...}, button_config: {...}, ... }, ...]
+    // 响应结构为 [{ button, post_actions, roles, i18nInfoList, button_config, ... }]。
+    // 本地 XML 只保存完整 button metadata content，不把 button_config 混入 content.button。
     return buttons
         .filter((item) => Boolean(item) && typeof item === 'object')
-        .map((item) => {
-        const record = item;
-        const button = record.button;
-        return (button && typeof button === 'object' ? button : record);
-    });
+        .map((item) => (0, button_metadata_ts_1.normalizePulledButtonMetaContent)(item, objectApiName));
 };
 exports.fetchButtonList = fetchButtonList;
 
@@ -21116,6 +21307,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.buttonUpdateService = void 0;
 const normalize_ts_1 = __importDefault(__webpack_require__(9268));
 const index_ts_1 = __webpack_require__(9985);
+const button_metadata_ts_1 = __webpack_require__(3506);
 const xmlMetadataManager = new index_ts_1.XmlMetadataManager();
 const buttonUpdateService = async (objectApiName, data) => {
     const checkedObjectApiName = normalize_ts_1.default.normalizeString(objectApiName);
@@ -21126,32 +21318,17 @@ const buttonUpdateService = async (objectApiName, data) => {
     if (!raw) {
         throw new Error('Invalid arguments: data is required.');
     }
-    const buttonData = JSON.parse(raw);
-    if (!buttonData || typeof buttonData !== 'object' || Array.isArray(buttonData)) {
-        throw new Error('data must be a JSON object.');
-    }
-    const buttonApiName = normalize_ts_1.default.normalizeString(buttonData.api_name);
-    if (!buttonApiName) {
-        throw new Error('data.api_name is required.');
-    }
-    // Read existing data and merge with input
+    const buttonContent = (0, button_metadata_ts_1.assertCompleteButtonMetaContent)(JSON.parse(raw), checkedObjectApiName);
+    const buttonApiName = (0, button_metadata_ts_1.getButtonApiName)(buttonContent);
     const existing = await xmlMetadataManager.readXml('ObjectButton', buttonApiName, {
         objectApiName: checkedObjectApiName,
         fields: ['content', 'status'],
     });
-    const existingContent = (existing.content && normalize_ts_1.default.isRecord(existing.content)
-        ? existing.content
-        : {});
-    const inputData = buttonData;
-    const mergedData = {};
-    for (const key of Object.keys(existingContent)) {
-        mergedData[key] = existingContent[key];
-    }
-    for (const key of Object.keys(inputData)) {
-        mergedData[key] = inputData[key];
+    if (existing.content === null || existing.content === undefined) {
+        throw new Error('Button does not exist locally: ' + checkedObjectApiName + '.' + buttonApiName);
     }
     const nextStatus = existing.status === 'new' ? 'new' : 'modified';
-    const filePath = await xmlMetadataManager.writeXml('ObjectButton', buttonApiName, mergedData, {
+    const filePath = await xmlMetadataManager.writeXml('ObjectButton', buttonApiName, buttonContent, {
         objectApiName: checkedObjectApiName,
         status: nextStatus,
     });
@@ -24906,7 +25083,7 @@ const validateRuleCreateService = async (apiName, data, force = false) => {
     // 1) 校验 validate-rule apiName 参数
     const checkedValidateRuleApiName = normalize_ts_1.default.normalizeString(apiName);
     if (!checkedValidateRuleApiName || !/^[A-Za-z][A-Za-z0-9_]*$/.test(checkedValidateRuleApiName)) {
-        throw new Error('Invalid arguments: apiName is required.');
+        throw new Error('Invalid arguments: validateRuleApiName is required.');
     }
     // 2) 解析创建数据并提取所属 objectApiName
     const raw = normalize_ts_1.default.normalizeString(data);
@@ -24972,7 +25149,7 @@ const validateRuleListService = async (objectApiName) => {
     // 1) 校验参数并查询 validate-rule 列表
     const checkedObjectApiName = normalize_ts_1.default.normalizeString(objectApiName);
     if (!checkedObjectApiName || !/^[A-Za-z][A-Za-z0-9_]*$/.test(checkedObjectApiName)) {
-        throw new Error('Invalid arguments: apiName is required.');
+        throw new Error('Invalid arguments: objectApiName is required.');
     }
     const errorMessages = [];
     const validateRules = [];
@@ -25115,7 +25292,7 @@ const validateRulePushService = async (objectApiName, validateRuleApiName) => {
         throw new Error('Invalid arguments: objectApiName is required.');
     }
     if (!checkedValidateRuleApiName || !/^[A-Za-z][A-Za-z0-9_]*$/.test(checkedValidateRuleApiName)) {
-        throw new Error('Invalid arguments: apiName is required.');
+        throw new Error('Invalid arguments: validateRuleApiName is required.');
     }
     let validateRuleMeta = await xmlMetadataManager.readXml('ObjectValidateRule', checkedValidateRuleApiName, {
         objectApiName: checkedObjectApiName
@@ -25232,7 +25409,7 @@ const validateRuleUpdateService = async (apiName, data) => {
     // 1) 校验 validate-rule apiName 参数
     const checkedValidateRuleApiName = normalize_ts_1.default.normalizeString(apiName);
     if (!checkedValidateRuleApiName || !/^[A-Za-z][A-Za-z0-9_]*$/.test(checkedValidateRuleApiName)) {
-        throw new Error('Invalid arguments: apiName is required.');
+        throw new Error('Invalid arguments: validateRuleApiName is required.');
     }
     // 2) 解析更新数据并提取所属 objectApiName
     const raw = normalize_ts_1.default.normalizeString(data);
@@ -25435,18 +25612,9 @@ const file_ts_1 = __webpack_require__(5409);
 const logger_ts_1 = __webpack_require__(3333);
 const pwc_service_ts_1 = __webpack_require__(2317);
 const pwc_types_ts_1 = __webpack_require__(1851);
+const pwc_mateXml_ts_1 = __webpack_require__(240);
 const pwc_workspace_ts_1 = __webpack_require__(3047);
 const API_NAME_PATTERN = /^[a-zA-Z](?!.*__.*__c$)\w{0,46}__c$/u;
-async function assertPluginTypeValid(pluginType) {
-    const config = await (0, pwc_service_ts_1.getPwcConfig)();
-    const validValues = new Set(Object.values(config.plugins ?? {}).flatMap((items) => items.map((item) => item.value)));
-    if (!pluginType) {
-        throw new Error(`mateXml.xml is missing required <type> for plugin. Valid values: ${[...validValues].join(', ')}`);
-    }
-    if (!validValues.has(pluginType)) {
-        throw new Error(`mateXml.xml <type> value "${pluginType}" is not valid. Valid values: ${[...validValues].join(', ')}`);
-    }
-}
 const COMPONENT_DEFAULT_INDEX_VUE = `<template>
   <div>
 
@@ -25587,11 +25755,8 @@ async function pwcDeployCommand(apiNameOrPath, options, context) {
     try {
         const target = resolveDeployTarget(apiNameOrPath, options.type, context);
         logger_ts_1.loggerService.updateLoading(`Preparing local files for ${target.apiName}`);
-        const bundle = await (0, pwc_workspace_ts_1.readLocalPwcUploadBundle)(context, target.type, target.apiName);
-        if (target.type === pwc_types_ts_1.PWCType.Plugin) {
-            logger_ts_1.loggerService.updateLoading('Validating plugin type from mateXml.xml');
-            await assertPluginTypeValid(bundle.pluginType);
-        }
+        const constraints = (0, pwc_mateXml_ts_1.buildPwcTypeConstraints)(await (0, pwc_service_ts_1.getPwcConfig)());
+        const bundle = await (0, pwc_workspace_ts_1.readLocalPwcUploadBundle)(context, target.type, target.apiName, constraints);
         logger_ts_1.loggerService.updateLoading(`Uploading ${bundle.uploadFiles.length} files`);
         const uploaded = await (0, pwc_service_ts_1.uploadFileList)(bundle.uploadFiles.map((item) => ({
             fileName: item.fileName,
@@ -25657,11 +25822,8 @@ async function pwcPushCommand(apiNameOrPath, options, context) {
     try {
         const target = resolveDeployTarget(apiNameOrPath, options.type, context);
         logger_ts_1.loggerService.updateLoading(`Preparing local files for ${target.apiName}`);
-        const bundle = await (0, pwc_workspace_ts_1.readLocalPwcUploadBundle)(context, target.type, target.apiName);
-        if (target.type === pwc_types_ts_1.PWCType.Plugin) {
-            logger_ts_1.loggerService.updateLoading('Validating plugin type from mateXml.xml');
-            await assertPluginTypeValid(bundle.pluginType);
-        }
+        const constraints = (0, pwc_mateXml_ts_1.buildPwcTypeConstraints)(await (0, pwc_service_ts_1.getPwcConfig)());
+        const bundle = await (0, pwc_workspace_ts_1.readLocalPwcUploadBundle)(context, target.type, target.apiName, constraints);
         logger_ts_1.loggerService.updateLoading(`Uploading ${bundle.uploadFiles.length} files`);
         const uploaded = await (0, pwc_service_ts_1.uploadFileList)(bundle.uploadFiles.map((item) => ({
             fileName: item.fileName,
@@ -26370,6 +26532,192 @@ async function sleep(ms) {
 }
 
 
+/***/ },
+
+/***/ 240
+(__unused_webpack_module, exports, __webpack_require__) {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.buildPwcTypeConstraints = buildPwcTypeConstraints;
+exports.validatePwcLocalStructure = validatePwcLocalStructure;
+exports.validatePwcMateXmlContent = validatePwcMateXmlContent;
+const fast_xml_parser_1 = __webpack_require__(4603);
+const file_ts_1 = __webpack_require__(5409);
+function buildPwcTypeConstraints(config) {
+    const componentTypes = new Set(Object.keys(config.components ?? {}).filter(Boolean));
+    const pluginTypes = new Set(Object.values(config.plugins ?? {})
+        .flatMap((items) => items.map((item) => item.value))
+        .filter(Boolean));
+    return {
+        componentTypes,
+        pluginTypes
+    };
+}
+async function validatePwcLocalStructure(input) {
+    const { type, apiName, mateXmlPath, metaPath, sourceDir, fileTreeDir } = input;
+    if (!(await (0, file_ts_1.pathExists)(mateXmlPath))) {
+        throw new Error(`PWC ${type} ${apiName}: required file not found: ${mateXmlPath}`);
+    }
+    const mateXmlStat = await (0, file_ts_1.statPath)(mateXmlPath);
+    if (!mateXmlStat.isFile()) {
+        throw new Error(`PWC ${type} ${apiName}: required file is not a file: ${mateXmlPath}`);
+    }
+    if (!(await (0, file_ts_1.pathExists)(metaPath))) {
+        throw new Error(`PWC ${type} ${apiName}: required file not found: ${metaPath}`);
+    }
+    const metaStat = await (0, file_ts_1.statPath)(metaPath);
+    if (!metaStat.isFile()) {
+        throw new Error(`PWC ${type} ${apiName}: required file is not a file: ${metaPath}`);
+    }
+    const sourceStat = (await (0, file_ts_1.pathExists)(sourceDir)) ? await (0, file_ts_1.statPath)(sourceDir) : undefined;
+    const fileTreeStat = (await (0, file_ts_1.pathExists)(fileTreeDir)) ? await (0, file_ts_1.statPath)(fileTreeDir) : undefined;
+    const hasSourceDir = sourceStat?.isDirectory() === true;
+    const hasFileTreeDir = fileTreeStat?.isDirectory() === true;
+    if (!hasSourceDir && !hasFileTreeDir) {
+        throw new Error(`PWC ${type} ${apiName}: both source and fileTree are missing.`);
+    }
+}
+function parseXmlDocument(content, filePath) {
+    try {
+        return new fast_xml_parser_1.XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: '',
+            trimValues: false
+        }).parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid XML format in ${filePath}: ${message}`);
+    }
+}
+function toArray(value) {
+    if (value == null) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function readTextNode(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    return '';
+}
+function hasOwn(obj, key) {
+    return typeof obj === 'object' && obj !== null && Object.prototype.hasOwnProperty.call(obj, key);
+}
+function assertNonEmpty(value, message) {
+    if (!value.trim()) {
+        throw new Error(message);
+    }
+}
+function assertClientValue(value, message) {
+    if (value !== 'web' && value !== 'app') {
+        throw new Error(message);
+    }
+}
+function validateComponentMateXml(doc, input) {
+    const { apiName, constraints } = input;
+    const bundle = doc.ComponentBundle;
+    if (typeof bundle !== 'object' || bundle === null) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml root node must be <ComponentBundle>.`);
+    }
+    if (!hasOwn(bundle, 'description')) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml is missing <description>.`);
+    }
+    const type = readTextNode(bundle.type);
+    assertNonEmpty(type, `PWC component ${apiName}: mateXml.xml is missing <type>.`);
+    if (!constraints.componentTypes.has(type)) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml <type> value "${type}" is not valid.`);
+    }
+    const clientsNode = bundle.clients;
+    if (typeof clientsNode !== 'object' || clientsNode === null) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml is missing <clients>.`);
+    }
+    const clients = toArray(clientsNode.client).map(readTextNode);
+    if (!clients.length) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml is missing <clients><client>.`);
+    }
+    for (const client of clients) {
+        assertNonEmpty(client, `PWC component ${apiName}: mateXml.xml <clients><client> must have a value.`);
+        assertClientValue(client, `PWC component ${apiName}: mateXml.xml <clients><client> must be web or app.`);
+    }
+    const scopesNode = bundle.scopes;
+    if (typeof scopesNode !== 'object' || scopesNode === null) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml is missing <scopes>.`);
+    }
+    const scopes = toArray(scopesNode.scope);
+    if (!scopes.length) {
+        throw new Error(`PWC component ${apiName}: mateXml.xml is missing <scopes><scope>.`);
+    }
+    for (const scope of scopes) {
+        if (typeof scope !== 'object' || scope === null) {
+            throw new Error(`PWC component ${apiName}: mateXml.xml <scopes><scope> must contain target attribute and valid content.`);
+        }
+        const scopeObj = scope;
+        const target = readTextNode(scopeObj.target);
+        assertNonEmpty(target, `PWC component ${apiName}: mateXml.xml <scopes><scope> must contain target attribute.`);
+        const wildcardText = readTextNode(scopeObj['#text']);
+        const objectsNode = scopeObj.objects;
+        const hasWildcard = wildcardText.trim() === '*';
+        const hasObjects = typeof objectsNode === 'object' && objectsNode !== null;
+        if (hasWildcard) {
+            continue;
+        }
+        if (hasObjects) {
+            const objects = toArray(objectsNode.object).map(readTextNode).filter((item) => item.trim());
+            if (!objects.length) {
+                throw new Error(`PWC component ${apiName}: mateXml.xml historical <objects><object> structure is empty.`);
+            }
+            continue;
+        }
+        throw new Error(`PWC component ${apiName}: mateXml.xml <scopes><scope> must be "*" or nested <objects><object>...</object></objects>.`);
+    }
+}
+function validatePluginMateXml(doc, input) {
+    const { apiName, constraints } = input;
+    const bundle = doc.PluginBundle;
+    if (typeof bundle !== 'object' || bundle === null) {
+        throw new Error(`PWC plugin ${apiName}: mateXml.xml root node must be <PluginBundle>.`);
+    }
+    if (!hasOwn(bundle, 'description')) {
+        throw new Error(`PWC plugin ${apiName}: mateXml.xml is missing <description>.`);
+    }
+    const type = readTextNode(bundle.type);
+    assertNonEmpty(type, `PWC plugin ${apiName}: mateXml.xml is missing <type>.`);
+    if (!constraints.pluginTypes.has(type)) {
+        throw new Error(`PWC plugin ${apiName}: mateXml.xml <type> value "${type}" is not valid.`);
+    }
+    const client = readTextNode(bundle.client);
+    assertNonEmpty(client, `PWC plugin ${apiName}: mateXml.xml is missing <client>.`);
+    assertClientValue(client, `PWC plugin ${apiName}: mateXml.xml <client> must be web or app.`);
+    const entryFileName = readTextNode(bundle.entryFileName);
+    const requiresEntryFileName = client === 'web';
+    if (requiresEntryFileName) {
+        assertNonEmpty(entryFileName, `PWC plugin ${apiName}: mateXml.xml is missing <entryFileName>.`);
+    }
+    const scopeObjectsNode = bundle.scopeObjects;
+    if (typeof scopeObjectsNode !== 'object' || scopeObjectsNode === null) {
+        throw new Error(`PWC plugin ${apiName}: mateXml.xml is missing <scopeObjects>.`);
+    }
+    const objects = toArray(scopeObjectsNode.object).map(readTextNode).filter((item) => item.trim());
+    if (!objects.length) {
+        throw new Error(`PWC plugin ${apiName}: mateXml.xml is missing <scopeObjects><object>.`);
+    }
+}
+function validatePwcMateXmlContent(input) {
+    const doc = parseXmlDocument(input.content, input.filePath);
+    if (input.type === 'component') {
+        validateComponentMateXml(doc, input);
+        return;
+    }
+    validatePluginMateXml(doc, input);
+}
+
+
 /***/ },
 
 /***/ 2317
@@ -26611,6 +26959,7 @@ const node_path_1 = __importDefault(__webpack_require__(6760));
 const fast_xml_parser_1 = __webpack_require__(4603);
 const file_ts_1 = __webpack_require__(5409);
 const pwc_types_ts_1 = __webpack_require__(1851);
+const pwc_mateXml_ts_1 = __webpack_require__(240);
 async function writeFiles(baseDir, files) {
     if (!files?.length) {
         return;
@@ -26700,7 +27049,7 @@ function resolveMateXmlInfo(type, mateXmlContent) {
         pluginType: typeof pluginType === 'string' ? pluginType : 'edit_plugin'
     };
 }
-async function readLocalPwcUploadBundle(context, type, apiName) {
+async function readLocalPwcUploadBundle(context, type, apiName, constraints) {
     const componentRoot = resolvePwcComponentRoot(context, type, apiName);
     if (!(await (0, file_ts_1.pathExists)(componentRoot))) {
         throw new Error(`Local PWC resource directory not found: ${componentRoot}`);
@@ -26709,6 +27058,16 @@ async function readLocalPwcUploadBundle(context, type, apiName) {
     const staticDir = node_path_1.default.join(componentRoot, 'static');
     const fileTreeDir = node_path_1.default.join(componentRoot, 'fileTree');
     const mateXmlPath = node_path_1.default.join(componentRoot, 'mateXml.xml');
+    const metaPath = node_path_1.default.join(componentRoot, '.sharedev-meta.json');
+    await (0, pwc_mateXml_ts_1.validatePwcLocalStructure)({
+        type,
+        apiName,
+        componentRoot,
+        mateXmlPath,
+        metaPath,
+        sourceDir,
+        fileTreeDir
+    });
     const sourceFiles = await collectFilesRecursively(sourceDir);
     const staticFiles = await collectFilesRecursively(staticDir);
     const fileTreeFiles = await collectFilesRecursively(fileTreeDir);
@@ -26731,13 +27090,18 @@ async function readLocalPwcUploadBundle(context, type, apiName) {
     let entryFileName = '';
     let client = 'web';
     let pluginType = '';
-    if (await (0, file_ts_1.pathExists)(mateXmlPath)) {
-        const mateXmlContent = await (0, file_ts_1.readTextFile)(mateXmlPath);
-        const mateInfo = resolveMateXmlInfo(type, mateXmlContent);
-        entryFileName = mateInfo.entryFileName;
-        client = mateInfo.client;
-        pluginType = mateInfo.pluginType;
-    }
+    const mateXmlContent = await (0, file_ts_1.readTextFile)(mateXmlPath);
+    (0, pwc_mateXml_ts_1.validatePwcMateXmlContent)({
+        type,
+        apiName,
+        filePath: mateXmlPath,
+        content: mateXmlContent,
+        constraints
+    });
+    const mateInfo = resolveMateXmlInfo(type, mateXmlContent);
+    entryFileName = mateInfo.entryFileName;
+    client = mateInfo.client;
+    pluginType = mateInfo.pluginType;
     return {
         entryFileName,
         client,
@@ -26753,17 +27117,17 @@ function resolveFileTreeRelativePath(fileTreeBaseDir, absoluteFilePath) {
     return normalizeFileTreePath(fileTreeBaseDir, absoluteFilePath);
 }
 async function writePwcComponent(context, component) {
-    const componentRoot = resolvePwcComponentRoot(context, component.type, component.apiName);
+    const type = component.type;
+    const componentRoot = resolvePwcComponentRoot(context, type, component.apiName);
     const sourceDir = node_path_1.default.join(componentRoot, 'source');
     const staticDir = node_path_1.default.join(componentRoot, 'static');
     const fileTreeDir = node_path_1.default.join(componentRoot, 'fileTree');
+    const mateXmlPath = node_path_1.default.join(componentRoot, 'mateXml.xml');
     await (0, file_ts_1.ensureDir)(componentRoot);
     await (0, file_ts_1.ensureDir)(sourceDir);
     await (0, file_ts_1.ensureDir)(staticDir);
     await (0, file_ts_1.ensureDir)(fileTreeDir);
-    if (component.mateXml) {
-        await (0, file_ts_1.writeTextFile)(node_path_1.default.join(componentRoot, 'mateXml.xml'), component.mateXml);
-    }
+    await (0, file_ts_1.writeTextFile)(mateXmlPath, component.mateXml);
     await writeFiles(sourceDir, component.sourceFiles);
     await writeFiles(staticDir, component.images);
     await writeFileTree(fileTreeDir, component.fileTree);
@@ -42627,7 +42991,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ 8330
 (module) {
 
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@share-crm/sharedev-cli","version":"0.0.4-rc.20","private":false,"description":"sharedev command line tool","type":"module","main":"dist/sharedev.js","bin":{"sharedev":"./bin/cli.mjs"},"author":{"name":"sharecrm-npm"},"files":["dist","bin","README.md"],"scripts":{"build":"tsc --noEmit && webpack --config build/webpack/webpack.prod.cjs","build:debug":"tsc --noEmit && webpack --config build/webpack/webpack.debug.cjs","build:bin":"bun build --compile --target=bun-darwin-x64 src/cli.ts --outfile scripts/sharedev-darwin-x64 && bun build --compile --target=bun-darwin-arm64 src/cli.ts --outfile scripts/sharedev-darwin-arm64 && bun build --compile --target=bun-windows-x64 src/cli.ts --outfile scripts/sharedev-windows-x64.exe","build:all":"npm run build && npm run build:bin","dev":"tsc --noEmit --watch & webpack --config build/webpack/webpack.dev.cjs --watch","dev2":"node src/cli.ts","typecheck":"tsc --noEmit","prettier":"prettier --write ./src/**/*.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@clack/prompts":"^1.1.0","@mariozechner/pi-coding-agent":"^0.62.0","axios":"~1.13.0","chalk":"^5.6.2","commander":"^14.0.1","extract-zip":"^2.0.1","fast-xml-parser":"^5.2.5","fs-extra":"^11.3.2","lodash-es":"^4.18.1","ora":"^9.3.0"},"devDependencies":{"@types/extract-zip":"^2.0.3","@types/fs-extra":"^11.0.4","@types/lodash-es":"^4.17.12","@types/node":"^24.3.0","@vitest/coverage-v8":"^4.1.8","ts-loader":"^9.5.4","typescript":"^5.9.2","vitest":"^3.2.6","webpack":"^5.101.3","webpack-cli":"^6.0.1","webpack-merge":"^6.0.1"},"packageManager":"pnpm@10.17.0"}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@share-crm/sharedev-cli","version":"0.0.4-rc.21","private":false,"description":"sharedev command line tool","type":"module","main":"dist/sharedev.js","bin":{"sharedev":"./bin/cli.mjs"},"author":{"name":"sharecrm-npm"},"files":["dist","bin","README.md"],"scripts":{"build":"tsc --noEmit && webpack --config build/webpack/webpack.prod.cjs","build:debug":"tsc --noEmit && webpack --config build/webpack/webpack.debug.cjs","build:bin":"bun build --compile --target=bun-darwin-x64 src/cli.ts --outfile scripts/sharedev-darwin-x64 && bun build --compile --target=bun-darwin-arm64 src/cli.ts --outfile scripts/sharedev-darwin-arm64 && bun build --compile --target=bun-windows-x64 src/cli.ts --outfile scripts/sharedev-windows-x64.exe","build:all":"npm run build && npm run build:bin","dev":"tsc --noEmit --watch & webpack --config build/webpack/webpack.dev.cjs --watch","dev2":"node src/cli.ts","typecheck":"tsc --noEmit","prettier":"prettier --write ./src/**/*.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@clack/prompts":"^1.1.0","@mariozechner/pi-coding-agent":"^0.62.0","axios":"~1.13.0","chalk":"^5.6.2","commander":"^14.0.1","extract-zip":"^2.0.1","fast-xml-parser":"^5.2.5","fs-extra":"^11.3.2","lodash-es":"^4.18.1","ora":"^9.3.0"},"devDependencies":{"@types/extract-zip":"^2.0.3","@types/fs-extra":"^11.0.4","@types/lodash-es":"^4.17.12","@types/node":"^24.3.0","@vitest/coverage-v8":"^4.1.8","ts-loader":"^9.5.4","typescript":"^5.9.2","vitest":"^3.2.6","webpack":"^5.101.3","webpack-cli":"^6.0.1","webpack-merge":"^6.0.1"},"packageManager":"pnpm@10.17.0"}');
 
 /***/ }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@share-crm/sharedev-cli",
-  "version": "0.0.4-rc.20",
+  "version": "0.0.4-rc.21",
   "private": false,
   "description": "sharedev command line tool",
   "type": "module",