@lark-apaas/nestjs-capability 0.1.1 → 0.1.2-alpha.0

package/dist/index.d.cts

@@ -216,15 +216,46 @@ type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
  * 求值规则：
  * - 如果整个字符串是单个表达式，保留原始类型
  * - 如果是字符串插值（多个表达式或混合内容），返回字符串
- * - 如果变量不存在，返回原始表达式
+ * - 如果变量不存在：
+ *   - 未传 schema：返回原始表达式
+ *   - 传了 schema（整串表达式）：按 schema 返回默认值
+ *   - 传了 schema（字符串插值）：保留原始表达式
  */
 declare class TemplateEngineService {
     private readonly EXPR_REGEX;
     private readonly WHOLE_STRING_EXPR_REGEX;
-    resolve(template: unknown, input: Record<string, unknown>): unknown;
+    /**
+     * 解析 formValue 模板
+     * @param template - formValue 模板对象
+     * @param input - 用户输入参数
+     * @param paramsSchema - 可选，输入参数的 JSON Schema，用于推断默认值
+     * @returns 解析后的参数对象
+     */
+    resolve(template: unknown, input: Record<string, unknown>, paramsSchema?: JSONSchema): unknown;
     private resolveString;
     private resolveObject;
     private getValueByPath;
+    /**
+     * 根据路径从 schema 获取默认值
+     * @param path - 变量路径，如 "a.b.c"
+     * @param schema - JSON Schema
+     * @returns 默认值，如果无法确定则返回 undefined
+     */
+    private getDefaultValueForPath;
+    /**
+     * 根据路径查找对应的 schema 定义
+     * @param path - 变量路径，如 "a.b.c"
+     * @param schema - 根 JSON Schema
+     * @returns 路径对应的 schema，如果不存在则返回 undefined
+     */
+    private getSchemaForPath;
+    /**
+     * 从 schema 获取默认值
+     * 优先级：default > type > undefined
+     * @param schema - 字段的 JSON Schema
+     * @returns 默认值
+     */
+    private getDefaultValueFromSchema;
 }
 
 declare class PluginNotFoundError extends Error {

package/dist/index.d.ts

@@ -216,15 +216,46 @@ type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
  * 求值规则：
  * - 如果整个字符串是单个表达式，保留原始类型
  * - 如果是字符串插值（多个表达式或混合内容），返回字符串
- * - 如果变量不存在，返回原始表达式
+ * - 如果变量不存在：
+ *   - 未传 schema：返回原始表达式
+ *   - 传了 schema（整串表达式）：按 schema 返回默认值
+ *   - 传了 schema（字符串插值）：保留原始表达式
  */
 declare class TemplateEngineService {
     private readonly EXPR_REGEX;
     private readonly WHOLE_STRING_EXPR_REGEX;
-    resolve(template: unknown, input: Record<string, unknown>): unknown;
+    /**
+     * 解析 formValue 模板
+     * @param template - formValue 模板对象
+     * @param input - 用户输入参数
+     * @param paramsSchema - 可选，输入参数的 JSON Schema，用于推断默认值
+     * @returns 解析后的参数对象
+     */
+    resolve(template: unknown, input: Record<string, unknown>, paramsSchema?: JSONSchema): unknown;
     private resolveString;
     private resolveObject;
     private getValueByPath;
+    /**
+     * 根据路径从 schema 获取默认值
+     * @param path - 变量路径，如 "a.b.c"
+     * @param schema - JSON Schema
+     * @returns 默认值，如果无法确定则返回 undefined
+     */
+    private getDefaultValueForPath;
+    /**
+     * 根据路径查找对应的 schema 定义
+     * @param path - 变量路径，如 "a.b.c"
+     * @param schema - 根 JSON Schema
+     * @returns 路径对应的 schema，如果不存在则返回 undefined
+     */
+    private getSchemaForPath;
+    /**
+     * 从 schema 获取默认值
+     * 优先级：default > type > undefined
+     * @param schema - 字段的 JSON Schema
+     * @returns 默认值
+     */
+    private getDefaultValueFromSchema;
 }
 
 declare class PluginNotFoundError extends Error {

package/dist/index.js

@@ -26,6 +26,15 @@ function _ts_decorate(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate, "_ts_decorate");
+var TYPE_DEFAULT_VALUES = {
+  array: [],
+  object: {},
+  string: "",
+  number: 0,
+  integer: 0,
+  boolean: false,
+  null: null
+};
 var TemplateEngineService = class {
   static {
     __name(this, "TemplateEngineService");
@@ -34,24 +43,40 @@ var TemplateEngineService = class {
   EXPR_REGEX = /\{\{\s*input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*\s*)\}\}/g;
   // 匹配整串单个表达式
   WHOLE_STRING_EXPR_REGEX = /^\{\{\s*input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*)\s*\}\}$/;
-  resolve(template, input) {
+  /**
+  * 解析 formValue 模板
+  * @param template - formValue 模板对象
+  * @param input - 用户输入参数
+  * @param paramsSchema - 可选，输入参数的 JSON Schema，用于推断默认值
+  * @returns 解析后的参数对象
+  */
+  resolve(template, input, paramsSchema) {
     if (typeof template === "string") {
-      return this.resolveString(template, input);
+      return this.resolveString(template, input, paramsSchema);
     }
     if (Array.isArray(template)) {
-      return template.map((item) => this.resolve(item, input));
+      return template.map((item) => this.resolve(item, input, paramsSchema));
     }
     if (template !== null && typeof template === "object") {
-      return this.resolveObject(template, input);
+      return this.resolveObject(template, input, paramsSchema);
     }
     return template;
   }
-  resolveString(template, input) {
+  resolveString(template, input, paramsSchema) {
     const wholeMatch = template.match(this.WHOLE_STRING_EXPR_REGEX);
     if (wholeMatch) {
       const path2 = wholeMatch[1];
       const value = this.getValueByPath(input, path2);
-      return value !== void 0 ? value : template;
+      if (value !== void 0) {
+        return value;
+      }
+      if (paramsSchema) {
+        const defaultValue = this.getDefaultValueForPath(path2, paramsSchema);
+        if (defaultValue !== void 0) {
+          return defaultValue;
+        }
+      }
+      return template;
     }
     this.EXPR_REGEX.lastIndex = 0;
     if (!this.EXPR_REGEX.test(template)) {
@@ -67,10 +92,10 @@ var TemplateEngineService = class {
     });
     return result;
   }
-  resolveObject(template, input) {
+  resolveObject(template, input, paramsSchema) {
     const result = {};
     for (const [key, value] of Object.entries(template)) {
-      result[key] = this.resolve(value, input);
+      result[key] = this.resolve(value, input, paramsSchema);
     }
     return result;
   }
@@ -85,6 +110,66 @@ var TemplateEngineService = class {
     }
     return current;
   }
+  /**
+  * 根据路径从 schema 获取默认值
+  * @param path - 变量路径，如 "a.b.c"
+  * @param schema - JSON Schema
+  * @returns 默认值，如果无法确定则返回 undefined
+  */
+  getDefaultValueForPath(path2, schema) {
+    const fieldSchema = this.getSchemaForPath(path2, schema);
+    if (!fieldSchema) {
+      return void 0;
+    }
+    return this.getDefaultValueFromSchema(fieldSchema);
+  }
+  /**
+  * 根据路径查找对应的 schema 定义
+  * @param path - 变量路径，如 "a.b.c"
+  * @param schema - 根 JSON Schema
+  * @returns 路径对应的 schema，如果不存在则返回 undefined
+  */
+  getSchemaForPath(path2, schema) {
+    const keys = path2.split(".");
+    let currentSchema = schema;
+    for (const key of keys) {
+      if (!currentSchema?.properties) {
+        return void 0;
+      }
+      currentSchema = currentSchema.properties[key];
+      if (!currentSchema) {
+        return void 0;
+      }
+    }
+    return currentSchema;
+  }
+  /**
+  * 从 schema 获取默认值
+  * 优先级：default > type > undefined
+  * @param schema - 字段的 JSON Schema
+  * @returns 默认值
+  */
+  getDefaultValueFromSchema(schema) {
+    if (schema.default !== void 0) {
+      return schema.default;
+    }
+    if (schema.oneOf || schema.anyOf) {
+      return void 0;
+    }
+    const type = schema.type;
+    if (!type) {
+      return void 0;
+    }
+    if (Array.isArray(type)) {
+      for (const t of type) {
+        if (t in TYPE_DEFAULT_VALUES) {
+          return TYPE_DEFAULT_VALUES[t];
+        }
+      }
+      return void 0;
+    }
+    return TYPE_DEFAULT_VALUES[type];
+  }
 };
 TemplateEngineService = _ts_decorate([
   Injectable()
@@ -570,7 +655,7 @@ var CapabilityService = class _CapabilityService {
       if (!pluginInstance.hasAction(actionName)) {
         throw new ActionNotFoundError(config.pluginKey, actionName);
       }
-      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input) : input;
+      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input, config.paramsSchema) : input;
       const context = this.buildActionContext(contextOverride);
       const isStream = pluginInstance.isStreamAction?.(actionName) ?? false;
       this.logger.log("Executing capability (call)", {
@@ -621,7 +706,7 @@ var CapabilityService = class _CapabilityService {
       if (!pluginInstance.hasAction(actionName)) {
         throw new ActionNotFoundError(config.pluginKey, actionName);
       }
-      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input) : input;
+      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input, config.paramsSchema) : input;
       const context = this.buildActionContext(contextOverride);
       const isStream = pluginInstance.isStreamAction?.(actionName) ?? false;
       this.logger.log("Executing capability (stream)", {
@@ -672,7 +757,7 @@ var CapabilityService = class _CapabilityService {
       if (!pluginInstance.hasAction(actionName)) {
         throw new ActionNotFoundError(config.pluginKey, actionName);
       }
-      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input) : input;
+      const resolvedParams = config.formValue ? this.templateEngineService.resolve(config.formValue, input, config.paramsSchema) : input;
       const context = this.buildActionContext(contextOverride);
       const isStream = pluginInstance.isStreamAction?.(actionName) ?? false;
       this.logger.log("Executing capability (streamWithEvents)", {