@lark-apaas/nestjs-capability 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -331,6 +331,7 @@ declare class TemplateEngineService {
 interface PluginManifest {
     name: string;
     version?: string;
+    displayName?: string;
     form?: {
         refType?: 'config' | 'action';
         schema?: unknown;
@@ -527,6 +528,8 @@ declare class CapabilityService implements OnModuleInit, OnModuleDestroy {
     /**
      * 从错误对象提取错误信息
      * 支持 PluginError 和 RateLimitError
+     * @param error - 捕获到的错误
+     * @param pluginKey - 插件 key，用于获取 displayName 格式化 PluginError 消息
      */
     private extractErrorInfo;
     private buildActionContext;

package/dist/index.js

@@ -532,6 +532,100 @@ async function migrationAdaptor(promise) {
 }
 __name(migrationAdaptor, "migrationAdaptor");
 
+// src/utils/plugin-error-format.ts
+var PLUGIN_ERROR_CODES = /* @__PURE__ */ new Set([
+  "INVALID_INPUT",
+  "EXECUTION_ERROR",
+  "INVALID_OUTPUT",
+  "INVALID_CONFIG",
+  "ACTION_NOT_FOUND"
+]);
+function isPluginError(error) {
+  if (!error || typeof error !== "object") return false;
+  const code = error.code;
+  return typeof code === "string" && PLUGIN_ERROR_CODES.has(code);
+}
+__name(isPluginError, "isPluginError");
+function formatPluginError(error, displayName) {
+  if (!isPluginError(error)) return null;
+  const err = error;
+  const label = displayName ? `\u300C${displayName}\u300D` : "";
+  switch (err.code) {
+    case "INVALID_INPUT":
+      return `${label}\u63D2\u4EF6\u8F93\u5165\u6821\u9A8C\u5931\u8D25: ${formatZodIssuesChinese(err.details)}`;
+    case "INVALID_OUTPUT":
+      return `${label}\u63D2\u4EF6\u8F93\u51FA\u6821\u9A8C\u5931\u8D25: ${formatZodIssuesChinese(err.details)}`;
+    case "INVALID_CONFIG":
+      return `${label}\u63D2\u4EF6\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: ${formatZodIssuesChinese(err.details)}`;
+    case "ACTION_NOT_FOUND":
+      return `${label}\u63D2\u4EF6\u64CD\u4F5C\u4E0D\u5B58\u5728`;
+    case "EXECUTION_ERROR": {
+      const inner = err.originalError instanceof Error ? err.originalError.message : "";
+      return inner ? `${label}\u63D2\u4EF6\u6267\u884C\u5931\u8D25: ${inner}` : `${label}\u63D2\u4EF6\u6267\u884C\u5931\u8D25`;
+    }
+    default:
+      return `${label}\u63D2\u4EF6\u6267\u884C\u5931\u8D25`;
+  }
+}
+__name(formatPluginError, "formatPluginError");
+function formatZodIssuesChinese(details) {
+  if (!Array.isArray(details) || details.length === 0) return "\u53C2\u6570\u683C\u5F0F\u6821\u9A8C\u51FA\u9519";
+  return details.map(translateZodIssue).join("\uFF1B");
+}
+__name(formatZodIssuesChinese, "formatZodIssuesChinese");
+function translateZodIssue(issue) {
+  const field = issue.path?.length > 0 ? `\u300C${issue.path.join(".")}\u300D` : "";
+  switch (issue.code) {
+    case "invalid_type": {
+      const received = issue.received;
+      if (received === "undefined" || received === "null") {
+        return `${field}\u5B57\u6BB5\u662F\u5FC5\u586B\u7684`;
+      }
+      return `${field}\u5B57\u6BB5\u7C7B\u578B\u9519\u8BEF\uFF0C\u671F\u671B${translateType(issue.expected)}`;
+    }
+    case "too_small": {
+      if (issue.type === "string") {
+        if (issue.minimum === 1) return `${field}\u5B57\u6BB5\u4E0D\u80FD\u4E3A\u7A7A`;
+        return `${field}\u5B57\u6BB5\u957F\u5EA6\u4E0D\u80FD\u5C11\u4E8E ${issue.minimum} \u4E2A\u5B57\u7B26`;
+      }
+      if (issue.type === "number") return `${field}\u5B57\u6BB5\u4E0D\u80FD\u5C0F\u4E8E ${issue.minimum}`;
+      if (issue.type === "array") return `${field}\u5B57\u6BB5\u81F3\u5C11\u9700\u8981 ${issue.minimum} \u9879`;
+      return `${field}\u5B57\u6BB5\u503C\u8FC7\u5C0F`;
+    }
+    case "too_big": {
+      if (issue.type === "string") return `${field}\u5B57\u6BB5\u957F\u5EA6\u4E0D\u80FD\u8D85\u8FC7 ${issue.maximum} \u4E2A\u5B57\u7B26`;
+      if (issue.type === "number") return `${field}\u5B57\u6BB5\u4E0D\u80FD\u5927\u4E8E ${issue.maximum}`;
+      if (issue.type === "array") return `${field}\u5B57\u6BB5\u6700\u591A ${issue.maximum} \u9879`;
+      return `${field}\u5B57\u6BB5\u503C\u8FC7\u5927`;
+    }
+    case "invalid_string": {
+      if (issue.validation === "email") return `${field}\u5B57\u6BB5\u4E0D\u662F\u6709\u6548\u7684\u90AE\u7BB1\u5730\u5740`;
+      if (issue.validation === "url") return `${field}\u5B57\u6BB5\u4E0D\u662F\u6709\u6548\u7684 URL`;
+      if (issue.validation === "regex") return `${field}\u5B57\u6BB5\u683C\u5F0F\u4E0D\u6B63\u786E`;
+      return `${field}\u5B57\u6BB5\u683C\u5F0F\u6821\u9A8C\u51FA\u9519`;
+    }
+    case "invalid_enum_value":
+      return `${field}\u5B57\u6BB5\u503C\u4E0D\u5728\u5141\u8BB8\u7684\u8303\u56F4\u5185`;
+    case "unrecognized_keys":
+      return `\u5305\u542B\u672A\u77E5\u5B57\u6BB5: ${issue.keys?.join(", ")}`;
+    default:
+      return field ? `${field}\u5B57\u6BB5\u683C\u5F0F\u6821\u9A8C\u51FA\u9519` : "\u8F93\u5165\u683C\u5F0F\u6821\u9A8C\u51FA\u9519";
+  }
+}
+__name(translateZodIssue, "translateZodIssue");
+function translateType(type) {
+  const map = {
+    string: "\u6587\u672C",
+    number: "\u6570\u5B57",
+    boolean: "\u5E03\u5C14\u503C",
+    array: "\u6570\u7EC4",
+    object: "\u5BF9\u8C61",
+    integer: "\u6574\u6570"
+  };
+  return map[type] || type;
+}
+__name(translateType, "translateType");
+
 // src/services/capability.service.ts
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -867,6 +961,11 @@ var CapabilityService = class _CapabilityService {
       });
       const errorCode = String(error?.code ?? "EXECUTION_ERROR");
       this.reportCallEvent(config.pluginKey, false, durationMs, isStream, contextOverride, errorCode);
+      const displayName = this.pluginLoaderService.getManifest(config.pluginKey)?.displayName;
+      const formattedMessage = formatPluginError(error, displayName);
+      if (formattedMessage && error instanceof Error) {
+        error.message = formattedMessage;
+      }
       throw error;
     }
   }
@@ -922,6 +1021,11 @@ var CapabilityService = class _CapabilityService {
       });
       const errorCode = String(error?.code ?? "EXECUTION_ERROR");
       this.reportCallEvent(config.pluginKey, false, durationMs, true, contextOverride, errorCode);
+      const displayName = this.pluginLoaderService.getManifest(config.pluginKey)?.displayName;
+      const formattedMessage = formatPluginError(error, displayName);
+      if (formattedMessage && error instanceof Error) {
+        error.message = formattedMessage;
+      }
       throw error;
     }
   }
@@ -1016,7 +1120,7 @@ var CapabilityService = class _CapabilityService {
       this.reportCallEvent(config.pluginKey, false, durationMs, true, contextOverride, errorCode);
       yield {
         type: "error",
-        error: this.extractErrorInfo(error)
+        error: this.extractErrorInfo(error, config.pluginKey)
       };
     }
   }
@@ -1039,8 +1143,10 @@ var CapabilityService = class _CapabilityService {
   /**
   * 从错误对象提取错误信息
   * 支持 PluginError 和 RateLimitError
+  * @param error - 捕获到的错误
+  * @param pluginKey - 插件 key，用于获取 displayName 格式化 PluginError 消息
   */
-  extractErrorInfo(error) {
+  extractErrorInfo(error, pluginKey) {
     const err = error;
     const code = err?.code ?? "EXECUTION_ERROR";
     const message = err instanceof Error ? err.message : String(err);
@@ -1052,6 +1158,16 @@ var CapabilityService = class _CapabilityService {
         rateLimitMessage: err.rateLimitMessage
       };
     }
+    if (pluginKey) {
+      const displayName = this.pluginLoaderService.getManifest(pluginKey)?.displayName;
+      const formattedMessage = formatPluginError(error, displayName);
+      if (formattedMessage) {
+        return {
+          code,
+          message: formattedMessage
+        };
+      }
+    }
     return {
       code,
       message