@zhama/a2ui-core 0.1.0

package/dist/validators/index.js

@@ -0,0 +1,308 @@
+// src/validators/message-validator.ts
+var STANDARD_COMPONENT_TYPES = [
+  "Text",
+  "Image",
+  "Icon",
+  "Video",
+  "AudioPlayer",
+  "Row",
+  "Column",
+  "List",
+  "Card",
+  "Tabs",
+  "Divider",
+  "Modal",
+  "Button",
+  "CheckBox",
+  "TextField",
+  "DateTimeInput",
+  "ChoicePicker",
+  "Slider"
+];
+function validateV09Message(message, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if ("createSurface" in message) {
+    const { createSurface } = message;
+    if (!createSurface.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "createSurface.surfaceId is required",
+        path: "createSurface.surfaceId"
+      });
+    }
+    if (!createSurface.catalogId) {
+      errors.push({
+        code: "MISSING_CATALOG_ID",
+        message: "createSurface.catalogId is required",
+        path: "createSurface.catalogId"
+      });
+    }
+  } else if ("updateComponents" in message) {
+    const { updateComponents } = message;
+    if (!updateComponents.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "updateComponents.surfaceId is required",
+        path: "updateComponents.surfaceId"
+      });
+    }
+    if (!updateComponents.components || !Array.isArray(updateComponents.components)) {
+      errors.push({
+        code: "INVALID_COMPONENTS",
+        message: "updateComponents.components must be an array",
+        path: "updateComponents.components"
+      });
+    } else {
+      validateComponentsV09(updateComponents.components, errors, warnings, options);
+    }
+  } else if ("updateDataModel" in message) {
+    const { updateDataModel } = message;
+    if (!updateDataModel.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "updateDataModel.surfaceId is required",
+        path: "updateDataModel.surfaceId"
+      });
+    }
+  } else if ("deleteSurface" in message) {
+    const { deleteSurface } = message;
+    if (!deleteSurface.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "deleteSurface.surfaceId is required",
+        path: "deleteSurface.surfaceId"
+      });
+    }
+  } else {
+    errors.push({
+      code: "INVALID_MESSAGE_TYPE",
+      message: "Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateV08Message(message, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if ("beginRendering" in message) {
+    const { beginRendering } = message;
+    if (!beginRendering.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "beginRendering.surfaceId is required",
+        path: "beginRendering.surfaceId"
+      });
+    }
+    if (!beginRendering.root) {
+      errors.push({
+        code: "MISSING_ROOT",
+        message: "beginRendering.root is required",
+        path: "beginRendering.root"
+      });
+    }
+  } else if ("surfaceUpdate" in message) {
+    const { surfaceUpdate } = message;
+    if (!surfaceUpdate.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "surfaceUpdate.surfaceId is required",
+        path: "surfaceUpdate.surfaceId"
+      });
+    }
+    if (!surfaceUpdate.components || !Array.isArray(surfaceUpdate.components)) {
+      errors.push({
+        code: "INVALID_COMPONENTS",
+        message: "surfaceUpdate.components must be an array",
+        path: "surfaceUpdate.components"
+      });
+    } else {
+      validateComponentsV08(surfaceUpdate.components, errors, warnings, options);
+    }
+  } else if ("dataModelUpdate" in message) {
+    const { dataModelUpdate } = message;
+    if (!dataModelUpdate.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "dataModelUpdate.surfaceId is required",
+        path: "dataModelUpdate.surfaceId"
+      });
+    }
+    if (!dataModelUpdate.contents || !Array.isArray(dataModelUpdate.contents)) {
+      errors.push({
+        code: "INVALID_CONTENTS",
+        message: "dataModelUpdate.contents must be an array",
+        path: "dataModelUpdate.contents"
+      });
+    }
+  } else if ("deleteSurface" in message) {
+    const { deleteSurface } = message;
+    if (!deleteSurface.surfaceId) {
+      errors.push({
+        code: "MISSING_SURFACE_ID",
+        message: "deleteSurface.surfaceId is required",
+        path: "deleteSurface.surfaceId"
+      });
+    }
+  } else {
+    errors.push({
+      code: "INVALID_MESSAGE_TYPE",
+      message: "Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateMessage(message, options = {}) {
+  if ("createSurface" in message || "updateComponents" in message || "updateDataModel" in message) {
+    return validateV09Message(message, options);
+  }
+  if ("beginRendering" in message || "surfaceUpdate" in message || "dataModelUpdate" in message) {
+    return validateV08Message(message, options);
+  }
+  if ("deleteSurface" in message) {
+    if (!message.deleteSurface.surfaceId) {
+      return {
+        valid: false,
+        errors: [{
+          code: "MISSING_SURFACE_ID",
+          message: "deleteSurface.surfaceId is required",
+          path: "deleteSurface.surfaceId"
+        }],
+        warnings: []
+      };
+    }
+    return { valid: true, errors: [], warnings: [] };
+  }
+  return {
+    valid: false,
+    errors: [{
+      code: "UNKNOWN_MESSAGE_TYPE",
+      message: "Unknown message type"
+    }],
+    warnings: []
+  };
+}
+function validateMessages(messages, options = {}) {
+  const errors = [];
+  const warnings = [];
+  for (let i = 0; i < messages.length; i++) {
+    const result = validateMessage(messages[i], options);
+    for (const error of result.errors) {
+      errors.push({
+        ...error,
+        path: `messages[${i}].${error.path || ""}`
+      });
+    }
+    for (const warning of result.warnings) {
+      warnings.push({
+        ...warning,
+        path: `messages[${i}].${warning.path || ""}`
+      });
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateComponentsV09(components, errors, warnings, options) {
+  const componentIds = /* @__PURE__ */ new Set();
+  let hasRoot = false;
+  for (let i = 0; i < components.length; i++) {
+    const comp = components[i];
+    const path = `updateComponents.components[${i}]`;
+    if (!comp.id) {
+      errors.push({
+        code: "MISSING_COMPONENT_ID",
+        message: "Component id is required",
+        path: `${path}.id`
+      });
+    } else {
+      if (componentIds.has(comp.id)) {
+        errors.push({
+          code: "DUPLICATE_COMPONENT_ID",
+          message: `Duplicate component id: ${comp.id}`,
+          path: `${path}.id`
+        });
+      }
+      componentIds.add(comp.id);
+      if (comp.id === "root") {
+        hasRoot = true;
+      }
+    }
+    if (!comp.component) {
+      errors.push({
+        code: "MISSING_COMPONENT_TYPE",
+        message: "Component type is required",
+        path: `${path}.component`
+      });
+    } else if (options.strict && options.allowedComponents) {
+      if (!options.allowedComponents.includes(comp.component)) {
+        warnings.push({
+          code: "UNKNOWN_COMPONENT_TYPE",
+          message: `Unknown component type: ${comp.component}`,
+          path: `${path}.component`
+        });
+      }
+    }
+  }
+  if (!hasRoot && options.strict) {
+    warnings.push({
+      code: "MISSING_ROOT_COMPONENT",
+      message: 'No component with id "root" found',
+      path: "updateComponents.components"
+    });
+  }
+}
+function validateComponentsV08(components, errors, warnings, options) {
+  const componentIds = /* @__PURE__ */ new Set();
+  for (let i = 0; i < components.length; i++) {
+    const comp = components[i];
+    const path = `surfaceUpdate.components[${i}]`;
+    if (!comp.id) {
+      errors.push({
+        code: "MISSING_COMPONENT_ID",
+        message: "Component id is required",
+        path: `${path}.id`
+      });
+    } else {
+      if (componentIds.has(comp.id)) {
+        errors.push({
+          code: "DUPLICATE_COMPONENT_ID",
+          message: `Duplicate component id: ${comp.id}`,
+          path: `${path}.id`
+        });
+      }
+      componentIds.add(comp.id);
+    }
+    if (!comp.component || typeof comp.component !== "object") {
+      errors.push({
+        code: "MISSING_COMPONENT",
+        message: "Component definition is required",
+        path: `${path}.component`
+      });
+    } else {
+      const componentType = Object.keys(comp.component)[0];
+      if (options.strict && !STANDARD_COMPONENT_TYPES.includes(componentType)) {
+        warnings.push({
+          code: "UNKNOWN_COMPONENT_TYPE",
+          message: `Unknown component type: ${componentType}`,
+          path: `${path}.component`
+        });
+      }
+    }
+  }
+}
+
+export { validateMessage, validateMessages, validateV08Message, validateV09Message };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validators/message-validator.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Message Validator\n *\n * 提供 A2UI 消息验证功能\n */\n\nimport type {\n  ServerToClientMessage,\n  ServerToClientMessageV08,\n  ServerToClientMessageV09,\n  ComponentInstance,\n  ComponentInstanceV08,\n} from '../types';\n\n/**\n * 验证结果\n */\nexport interface ValidationResult {\n  /** 是否有效 */\n  valid: boolean;\n  /** 错误信息列表 */\n  errors: ValidationError[];\n  /** 警告信息列表 */\n  warnings: ValidationWarning[];\n}\n\n/**\n * 验证错误\n */\nexport interface ValidationError {\n  /** 错误代码 */\n  code: string;\n  /** 错误消息 */\n  message: string;\n  /** 错误路径（如 'components[0].id'） */\n  path?: string;\n}\n\n/**\n * 验证警告\n */\nexport interface ValidationWarning {\n  /** 警告代码 */\n  code: string;\n  /** 警告消息 */\n  message: string;\n  /** 警告路径 */\n  path?: string;\n}\n\n/**\n * 验证选项\n */\nexport interface ValidationOptions {\n  /** 是否严格模式（报告更多问题） */\n  strict?: boolean;\n  /** 允许的组件类型（为空表示允许所有） */\n  allowedComponents?: string[];\n}\n\n/**\n * 标准组件类型列表\n */\nconst STANDARD_COMPONENT_TYPES = [\n  'Text',\n  'Image',\n  'Icon',\n  'Video',\n  'AudioPlayer',\n  'Row',\n  'Column',\n  'List',\n  'Card',\n  'Tabs',\n  'Divider',\n  'Modal',\n  'Button',\n  'CheckBox',\n  'TextField',\n  'DateTimeInput',\n  'ChoicePicker',\n  'Slider',\n];\n\n/**\n * 验证 v0.9 消息\n */\nexport function validateV09Message(\n  message: ServerToClientMessageV09,\n  options: ValidationOptions = {}\n): ValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: ValidationWarning[] = [];\n\n  if ('createSurface' in message) {\n    const { createSurface } = message;\n    if (!createSurface.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'createSurface.surfaceId is required',\n        path: 'createSurface.surfaceId',\n      });\n    }\n    if (!createSurface.catalogId) {\n      errors.push({\n        code: 'MISSING_CATALOG_ID',\n        message: 'createSurface.catalogId is required',\n        path: 'createSurface.catalogId',\n      });\n    }\n  } else if ('updateComponents' in message) {\n    const { updateComponents } = message;\n    if (!updateComponents.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'updateComponents.surfaceId is required',\n        path: 'updateComponents.surfaceId',\n      });\n    }\n    if (!updateComponents.components || !Array.isArray(updateComponents.components)) {\n      errors.push({\n        code: 'INVALID_COMPONENTS',\n        message: 'updateComponents.components must be an array',\n        path: 'updateComponents.components',\n      });\n    } else {\n      // 验证组件\n      validateComponentsV09(updateComponents.components, errors, warnings, options);\n    }\n  } else if ('updateDataModel' in message) {\n    const { updateDataModel } = message;\n    if (!updateDataModel.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'updateDataModel.surfaceId is required',\n        path: 'updateDataModel.surfaceId',\n      });\n    }\n  } else if ('deleteSurface' in message) {\n    const { deleteSurface } = message;\n    if (!deleteSurface.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'deleteSurface.surfaceId is required',\n        path: 'deleteSurface.surfaceId',\n      });\n    }\n  } else {\n    errors.push({\n      code: 'INVALID_MESSAGE_TYPE',\n      message: 'Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface',\n    });\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * 验证 v0.8 消息\n */\nexport function validateV08Message(\n  message: ServerToClientMessageV08,\n  options: ValidationOptions = {}\n): ValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: ValidationWarning[] = [];\n\n  if ('beginRendering' in message) {\n    const { beginRendering } = message;\n    if (!beginRendering.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'beginRendering.surfaceId is required',\n        path: 'beginRendering.surfaceId',\n      });\n    }\n    if (!beginRendering.root) {\n      errors.push({\n        code: 'MISSING_ROOT',\n        message: 'beginRendering.root is required',\n        path: 'beginRendering.root',\n      });\n    }\n  } else if ('surfaceUpdate' in message) {\n    const { surfaceUpdate } = message;\n    if (!surfaceUpdate.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'surfaceUpdate.surfaceId is required',\n        path: 'surfaceUpdate.surfaceId',\n      });\n    }\n    if (!surfaceUpdate.components || !Array.isArray(surfaceUpdate.components)) {\n      errors.push({\n        code: 'INVALID_COMPONENTS',\n        message: 'surfaceUpdate.components must be an array',\n        path: 'surfaceUpdate.components',\n      });\n    } else {\n      validateComponentsV08(surfaceUpdate.components, errors, warnings, options);\n    }\n  } else if ('dataModelUpdate' in message) {\n    const { dataModelUpdate } = message;\n    if (!dataModelUpdate.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'dataModelUpdate.surfaceId is required',\n        path: 'dataModelUpdate.surfaceId',\n      });\n    }\n    if (!dataModelUpdate.contents || !Array.isArray(dataModelUpdate.contents)) {\n      errors.push({\n        code: 'INVALID_CONTENTS',\n        message: 'dataModelUpdate.contents must be an array',\n        path: 'dataModelUpdate.contents',\n      });\n    }\n  } else if ('deleteSurface' in message) {\n    const { deleteSurface } = message;\n    if (!deleteSurface.surfaceId) {\n      errors.push({\n        code: 'MISSING_SURFACE_ID',\n        message: 'deleteSurface.surfaceId is required',\n        path: 'deleteSurface.surfaceId',\n      });\n    }\n  } else {\n    errors.push({\n      code: 'INVALID_MESSAGE_TYPE',\n      message: 'Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface',\n    });\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * 验证消息（自动检测版本）\n */\nexport function validateMessage(\n  message: ServerToClientMessage,\n  options: ValidationOptions = {}\n): ValidationResult {\n  // 检测消息版本\n  if ('createSurface' in message || 'updateComponents' in message || 'updateDataModel' in message) {\n    return validateV09Message(message as ServerToClientMessageV09, options);\n  }\n  \n  if ('beginRendering' in message || 'surfaceUpdate' in message || 'dataModelUpdate' in message) {\n    return validateV08Message(message as ServerToClientMessageV08, options);\n  }\n\n  if ('deleteSurface' in message) {\n    // deleteSurface 在两个版本中格式相同\n    if (!message.deleteSurface.surfaceId) {\n      return {\n        valid: false,\n        errors: [{\n          code: 'MISSING_SURFACE_ID',\n          message: 'deleteSurface.surfaceId is required',\n          path: 'deleteSurface.surfaceId',\n        }],\n        warnings: [],\n      };\n    }\n    return { valid: true, errors: [], warnings: [] };\n  }\n\n  return {\n    valid: false,\n    errors: [{\n      code: 'UNKNOWN_MESSAGE_TYPE',\n      message: 'Unknown message type',\n    }],\n    warnings: [],\n  };\n}\n\n/**\n * 验证消息数组\n */\nexport function validateMessages(\n  messages: ServerToClientMessage[],\n  options: ValidationOptions = {}\n): ValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: ValidationWarning[] = [];\n\n  for (let i = 0; i < messages.length; i++) {\n    const result = validateMessage(messages[i], options);\n    for (const error of result.errors) {\n      errors.push({\n        ...error,\n        path: `messages[${i}].${error.path || ''}`,\n      });\n    }\n    for (const warning of result.warnings) {\n      warnings.push({\n        ...warning,\n        path: `messages[${i}].${warning.path || ''}`,\n      });\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n// ============================================================================\n// 内部辅助函数\n// ============================================================================\n\nfunction validateComponentsV09(\n  components: ComponentInstance[],\n  errors: ValidationError[],\n  warnings: ValidationWarning[],\n  options: ValidationOptions\n): void {\n  const componentIds = new Set<string>();\n  let hasRoot = false;\n\n  for (let i = 0; i < components.length; i++) {\n    const comp = components[i];\n    const path = `updateComponents.components[${i}]`;\n\n    // 验证 ID\n    if (!comp.id) {\n      errors.push({\n        code: 'MISSING_COMPONENT_ID',\n        message: 'Component id is required',\n        path: `${path}.id`,\n      });\n    } else {\n      if (componentIds.has(comp.id)) {\n        errors.push({\n          code: 'DUPLICATE_COMPONENT_ID',\n          message: `Duplicate component id: ${comp.id}`,\n          path: `${path}.id`,\n        });\n      }\n      componentIds.add(comp.id);\n\n      if (comp.id === 'root') {\n        hasRoot = true;\n      }\n    }\n\n    // 验证组件类型\n    if (!comp.component) {\n      errors.push({\n        code: 'MISSING_COMPONENT_TYPE',\n        message: 'Component type is required',\n        path: `${path}.component`,\n      });\n    } else if (options.strict && options.allowedComponents) {\n      if (!options.allowedComponents.includes(comp.component)) {\n        warnings.push({\n          code: 'UNKNOWN_COMPONENT_TYPE',\n          message: `Unknown component type: ${comp.component}`,\n          path: `${path}.component`,\n        });\n      }\n    }\n  }\n\n  // 检查是否有 root 组件\n  if (!hasRoot && options.strict) {\n    warnings.push({\n      code: 'MISSING_ROOT_COMPONENT',\n      message: 'No component with id \"root\" found',\n      path: 'updateComponents.components',\n    });\n  }\n}\n\nfunction validateComponentsV08(\n  components: ComponentInstanceV08[],\n  errors: ValidationError[],\n  warnings: ValidationWarning[],\n  options: ValidationOptions\n): void {\n  const componentIds = new Set<string>();\n\n  for (let i = 0; i < components.length; i++) {\n    const comp = components[i];\n    const path = `surfaceUpdate.components[${i}]`;\n\n    // 验证 ID\n    if (!comp.id) {\n      errors.push({\n        code: 'MISSING_COMPONENT_ID',\n        message: 'Component id is required',\n        path: `${path}.id`,\n      });\n    } else {\n      if (componentIds.has(comp.id)) {\n        errors.push({\n          code: 'DUPLICATE_COMPONENT_ID',\n          message: `Duplicate component id: ${comp.id}`,\n          path: `${path}.id`,\n        });\n      }\n      componentIds.add(comp.id);\n    }\n\n    // 验证组件类型\n    if (!comp.component || typeof comp.component !== 'object') {\n      errors.push({\n        code: 'MISSING_COMPONENT',\n        message: 'Component definition is required',\n        path: `${path}.component`,\n      });\n    } else {\n      const componentType = Object.keys(comp.component)[0];\n      if (options.strict && !STANDARD_COMPONENT_TYPES.includes(componentType)) {\n        warnings.push({\n          code: 'UNKNOWN_COMPONENT_TYPE',\n          message: `Unknown component type: ${componentType}`,\n          path: `${path}.component`,\n        });\n      }\n    }\n  }\n}\n\n"]}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@zhama/a2ui-core",
+  "version": "0.1.0",
+  "description": "A2UI Protocol Core Library - Framework-agnostic TypeScript types and builders for A2UI protocol",
+  "author": "Zhama",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/types/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.cts",
+        "default": "./dist/types/index.cjs"
+      }
+    },
+    "./builders": {
+      "import": {
+        "types": "./dist/builders/index.d.ts",
+        "default": "./dist/builders/index.js"
+      },
+      "require": {
+        "types": "./dist/builders/index.d.cts",
+        "default": "./dist/builders/index.cjs"
+      }
+    },
+    "./validators": {
+      "import": {
+        "types": "./dist/validators/index.d.ts",
+        "default": "./dist/validators/index.js"
+      },
+      "require": {
+        "types": "./dist/validators/index.d.cts",
+        "default": "./dist/validators/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "eslint": "^9.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "keywords": [
+    "a2ui",
+    "agent-to-ui",
+    "protocol",
+    "typescript",
+    "ui-protocol",
+    "streaming-ui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zhama/a2ui-core"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+