@djvlc/contracts-types 1.0.0

package/dist/index.js

@@ -0,0 +1,697 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ACTION_SPEC_VERSION: () => ACTION_SPEC_VERSION,
+  ALLOWED_ROOT_VARIABLES: () => ALLOWED_ROOT_VARIABLES,
+  BUILTIN_FUNCTIONS: () => BUILTIN_FUNCTIONS,
+  BUILTIN_FUNCTION_NAMES: () => BUILTIN_FUNCTION_NAMES,
+  COMPONENT_CATEGORIES: () => COMPONENT_CATEGORIES,
+  COMPONENT_META_SCHEMA_VERSION: () => COMPONENT_META_SCHEMA_VERSION,
+  CURRENT_SCHEMA_VERSION: () => CURRENT_SCHEMA_VERSION,
+  DATA_QUERY_SPEC_VERSION: () => DATA_QUERY_SPEC_VERSION,
+  ErrorCode: () => ErrorCode,
+  ErrorCodeCategory: () => ErrorCodeCategory,
+  ErrorMessages: () => ErrorMessages,
+  PAGE_SCHEMA_VERSION: () => PAGE_SCHEMA_VERSION,
+  PublishStatus: () => PublishStatus,
+  SCHEMA_VERSIONS: () => SCHEMA_VERSIONS,
+  compareVersions: () => compareVersions,
+  createDjvlcError: () => createDjvlcError,
+  createExpressionBinding: () => createExpressionBinding,
+  findMigrationPath: () => findMigrationPath,
+  getAllMigrations: () => getAllMigrations,
+  getContractsVersion: () => getContractsVersion,
+  getHttpStatusFromErrorCode: () => getHttpStatusFromErrorCode,
+  getVersionInfo: () => getVersionInfo,
+  isExpressionBinding: () => isExpressionBinding,
+  isRetryableError: () => isRetryableError,
+  isVersionCompatible: () => isVersionCompatible,
+  migratePageSchema: () => migratePageSchema,
+  needsMigration: () => needsMigration,
+  registerMigration: () => registerMigration
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/version.ts
+var PAGE_SCHEMA_VERSION = "1.0.0";
+var COMPONENT_META_SCHEMA_VERSION = "1.0.0";
+var ACTION_SPEC_VERSION = "1.0.0";
+var DATA_QUERY_SPEC_VERSION = "1.0.0";
+function getContractsVersion() {
+  return {
+    pageSchema: PAGE_SCHEMA_VERSION,
+    componentMeta: COMPONENT_META_SCHEMA_VERSION,
+    actionSpec: ACTION_SPEC_VERSION,
+    dataQuerySpec: DATA_QUERY_SPEC_VERSION
+  };
+}
+function isVersionCompatible(required, current) {
+  const [reqMajor, reqMinor] = required.split(".").map(Number);
+  const [curMajor, curMinor] = current.split(".").map(Number);
+  return curMajor === reqMajor && curMinor >= reqMinor;
+}
+
+// src/errors/index.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2[ErrorCode2["UNKNOWN"] = 1e3] = "UNKNOWN";
+  ErrorCode2[ErrorCode2["INVALID_REQUEST"] = 1001] = "INVALID_REQUEST";
+  ErrorCode2[ErrorCode2["UNAUTHORIZED"] = 1002] = "UNAUTHORIZED";
+  ErrorCode2[ErrorCode2["FORBIDDEN"] = 1003] = "FORBIDDEN";
+  ErrorCode2[ErrorCode2["NOT_FOUND"] = 1004] = "NOT_FOUND";
+  ErrorCode2[ErrorCode2["RATE_LIMITED"] = 1005] = "RATE_LIMITED";
+  ErrorCode2[ErrorCode2["VALIDATION_ERROR"] = 1006] = "VALIDATION_ERROR";
+  ErrorCode2[ErrorCode2["INTERNAL_ERROR"] = 1007] = "INTERNAL_ERROR";
+  ErrorCode2[ErrorCode2["SERVICE_UNAVAILABLE"] = 1008] = "SERVICE_UNAVAILABLE";
+  ErrorCode2[ErrorCode2["TIMEOUT"] = 1009] = "TIMEOUT";
+  ErrorCode2[ErrorCode2["ACTION_NOT_FOUND"] = 2001] = "ACTION_NOT_FOUND";
+  ErrorCode2[ErrorCode2["ACTION_INVALID_PARAMS"] = 2002] = "ACTION_INVALID_PARAMS";
+  ErrorCode2[ErrorCode2["ACTION_EXECUTION_FAILED"] = 2003] = "ACTION_EXECUTION_FAILED";
+  ErrorCode2[ErrorCode2["ACTION_IDEMPOTENCY_CONFLICT"] = 2004] = "ACTION_IDEMPOTENCY_CONFLICT";
+  ErrorCode2[ErrorCode2["ACTION_BLOCKED"] = 2005] = "ACTION_BLOCKED";
+  ErrorCode2[ErrorCode2["ACTION_RISK_REJECTED"] = 2006] = "ACTION_RISK_REJECTED";
+  ErrorCode2[ErrorCode2["ACTION_EXPIRED"] = 2007] = "ACTION_EXPIRED";
+  ErrorCode2[ErrorCode2["ACTION_QUOTA_EXCEEDED"] = 2008] = "ACTION_QUOTA_EXCEEDED";
+  ErrorCode2[ErrorCode2["QUERY_NOT_FOUND"] = 3001] = "QUERY_NOT_FOUND";
+  ErrorCode2[ErrorCode2["QUERY_INVALID_PARAMS"] = 3002] = "QUERY_INVALID_PARAMS";
+  ErrorCode2[ErrorCode2["QUERY_EXECUTION_FAILED"] = 3003] = "QUERY_EXECUTION_FAILED";
+  ErrorCode2[ErrorCode2["QUERY_FIELD_NOT_ALLOWED"] = 3004] = "QUERY_FIELD_NOT_ALLOWED";
+  ErrorCode2[ErrorCode2["QUERY_TIMEOUT"] = 3005] = "QUERY_TIMEOUT";
+  ErrorCode2[ErrorCode2["QUERY_DISABLED"] = 3006] = "QUERY_DISABLED";
+  ErrorCode2[ErrorCode2["COMPONENT_NOT_FOUND"] = 4001] = "COMPONENT_NOT_FOUND";
+  ErrorCode2[ErrorCode2["COMPONENT_VERSION_NOT_FOUND"] = 4002] = "COMPONENT_VERSION_NOT_FOUND";
+  ErrorCode2[ErrorCode2["COMPONENT_BLOCKED"] = 4003] = "COMPONENT_BLOCKED";
+  ErrorCode2[ErrorCode2["COMPONENT_INTEGRITY_MISMATCH"] = 4004] = "COMPONENT_INTEGRITY_MISMATCH";
+  ErrorCode2[ErrorCode2["COMPONENT_INCOMPATIBLE"] = 4005] = "COMPONENT_INCOMPATIBLE";
+  ErrorCode2[ErrorCode2["COMPONENT_LOAD_FAILED"] = 4006] = "COMPONENT_LOAD_FAILED";
+  ErrorCode2[ErrorCode2["COMPONENT_RENDER_ERROR"] = 4007] = "COMPONENT_RENDER_ERROR";
+  ErrorCode2[ErrorCode2["PAGE_NOT_FOUND"] = 5001] = "PAGE_NOT_FOUND";
+  ErrorCode2[ErrorCode2["PAGE_VERSION_NOT_FOUND"] = 5002] = "PAGE_VERSION_NOT_FOUND";
+  ErrorCode2[ErrorCode2["PAGE_SCHEMA_INVALID"] = 5003] = "PAGE_SCHEMA_INVALID";
+  ErrorCode2[ErrorCode2["PAGE_MANIFEST_INVALID"] = 5004] = "PAGE_MANIFEST_INVALID";
+  ErrorCode2[ErrorCode2["PAGE_PUBLISH_FAILED"] = 5005] = "PAGE_PUBLISH_FAILED";
+  ErrorCode2[ErrorCode2["PAGE_ROLLBACK_FAILED"] = 5006] = "PAGE_ROLLBACK_FAILED";
+  ErrorCode2[ErrorCode2["ACTIVITY_NOT_FOUND"] = 6001] = "ACTIVITY_NOT_FOUND";
+  ErrorCode2[ErrorCode2["ACTIVITY_NOT_STARTED"] = 6002] = "ACTIVITY_NOT_STARTED";
+  ErrorCode2[ErrorCode2["ACTIVITY_ENDED"] = 6003] = "ACTIVITY_ENDED";
+  ErrorCode2[ErrorCode2["ACTIVITY_ALREADY_CLAIMED"] = 6004] = "ACTIVITY_ALREADY_CLAIMED";
+  ErrorCode2[ErrorCode2["ACTIVITY_ALREADY_SIGNED"] = 6005] = "ACTIVITY_ALREADY_SIGNED";
+  ErrorCode2[ErrorCode2["ACTIVITY_LIMIT_EXCEEDED"] = 6006] = "ACTIVITY_LIMIT_EXCEEDED";
+  ErrorCode2[ErrorCode2["ACTIVITY_DISABLED"] = 6007] = "ACTIVITY_DISABLED";
+  ErrorCode2[ErrorCode2["EXPRESSION_SYNTAX_ERROR"] = 7001] = "EXPRESSION_SYNTAX_ERROR";
+  ErrorCode2[ErrorCode2["EXPRESSION_UNKNOWN_FUNCTION"] = 7002] = "EXPRESSION_UNKNOWN_FUNCTION";
+  ErrorCode2[ErrorCode2["EXPRESSION_INVALID_ARGUMENT"] = 7003] = "EXPRESSION_INVALID_ARGUMENT";
+  ErrorCode2[ErrorCode2["EXPRESSION_UNKNOWN_VARIABLE"] = 7004] = "EXPRESSION_UNKNOWN_VARIABLE";
+  ErrorCode2[ErrorCode2["EXPRESSION_TYPE_MISMATCH"] = 7005] = "EXPRESSION_TYPE_MISMATCH";
+  ErrorCode2[ErrorCode2["EXPRESSION_ACCESS_DENIED"] = 7006] = "EXPRESSION_ACCESS_DENIED";
+  ErrorCode2[ErrorCode2["SCHEMA_VERSION_MISMATCH"] = 8001] = "SCHEMA_VERSION_MISMATCH";
+  ErrorCode2[ErrorCode2["MIGRATION_FAILED"] = 8002] = "MIGRATION_FAILED";
+  ErrorCode2[ErrorCode2["MIGRATION_NOT_FOUND"] = 8003] = "MIGRATION_NOT_FOUND";
+  ErrorCode2[ErrorCode2["VERSION_INCOMPATIBLE"] = 8004] = "VERSION_INCOMPATIBLE";
+  return ErrorCode2;
+})(ErrorCode || {});
+var ErrorCodeCategory = {
+  GENERAL: [1e3, 1999],
+  ACTION: [2e3, 2999],
+  QUERY: [3e3, 3999],
+  COMPONENT: [4e3, 4999],
+  PAGE: [5e3, 5999],
+  ACTIVITY: [6e3, 6999],
+  EXPRESSION: [7e3, 7999],
+  VERSION: [8e3, 8999]
+};
+var ErrorMessages = {
+  // 通用错误
+  [1e3 /* UNKNOWN */]: "\u672A\u77E5\u9519\u8BEF",
+  [1001 /* INVALID_REQUEST */]: "\u8BF7\u6C42\u53C2\u6570\u65E0\u6548",
+  [1002 /* UNAUTHORIZED */]: "\u672A\u6388\u6743\u8BBF\u95EE",
+  [1003 /* FORBIDDEN */]: "\u7981\u6B62\u8BBF\u95EE",
+  [1004 /* NOT_FOUND */]: "\u8D44\u6E90\u4E0D\u5B58\u5728",
+  [1005 /* RATE_LIMITED */]: "\u8BF7\u6C42\u9891\u7387\u8D85\u9650",
+  [1006 /* VALIDATION_ERROR */]: "\u6570\u636E\u6821\u9A8C\u5931\u8D25",
+  [1007 /* INTERNAL_ERROR */]: "\u670D\u52A1\u5185\u90E8\u9519\u8BEF",
+  [1008 /* SERVICE_UNAVAILABLE */]: "\u670D\u52A1\u6682\u4E0D\u53EF\u7528",
+  [1009 /* TIMEOUT */]: "\u8BF7\u6C42\u8D85\u65F6",
+  // Action 错误
+  [2001 /* ACTION_NOT_FOUND */]: "\u52A8\u4F5C\u4E0D\u5B58\u5728",
+  [2002 /* ACTION_INVALID_PARAMS */]: "\u52A8\u4F5C\u53C2\u6570\u65E0\u6548",
+  [2003 /* ACTION_EXECUTION_FAILED */]: "\u52A8\u4F5C\u6267\u884C\u5931\u8D25",
+  [2004 /* ACTION_IDEMPOTENCY_CONFLICT */]: "\u91CD\u590D\u8BF7\u6C42",
+  [2005 /* ACTION_BLOCKED */]: "\u52A8\u4F5C\u5DF2\u88AB\u7981\u7528",
+  [2006 /* ACTION_RISK_REJECTED */]: "\u98CE\u63A7\u62D2\u7EDD",
+  [2007 /* ACTION_EXPIRED */]: "\u52A8\u4F5C\u5DF2\u8FC7\u671F",
+  [2008 /* ACTION_QUOTA_EXCEEDED */]: "\u914D\u989D\u5DF2\u7528\u5C3D",
+  // Data Query 错误
+  [3001 /* QUERY_NOT_FOUND */]: "\u67E5\u8BE2\u4E0D\u5B58\u5728",
+  [3002 /* QUERY_INVALID_PARAMS */]: "\u67E5\u8BE2\u53C2\u6570\u65E0\u6548",
+  [3003 /* QUERY_EXECUTION_FAILED */]: "\u67E5\u8BE2\u6267\u884C\u5931\u8D25",
+  [3004 /* QUERY_FIELD_NOT_ALLOWED */]: "\u5B57\u6BB5\u8BBF\u95EE\u88AB\u62D2\u7EDD",
+  [3005 /* QUERY_TIMEOUT */]: "\u67E5\u8BE2\u8D85\u65F6",
+  [3006 /* QUERY_DISABLED */]: "\u67E5\u8BE2\u5DF2\u7981\u7528",
+  // 组件错误
+  [4001 /* COMPONENT_NOT_FOUND */]: "\u7EC4\u4EF6\u4E0D\u5B58\u5728",
+  [4002 /* COMPONENT_VERSION_NOT_FOUND */]: "\u7EC4\u4EF6\u7248\u672C\u4E0D\u5B58\u5728",
+  [4003 /* COMPONENT_BLOCKED */]: "\u7EC4\u4EF6\u5DF2\u88AB\u7981\u7528",
+  [4004 /* COMPONENT_INTEGRITY_MISMATCH */]: "\u7EC4\u4EF6\u5B8C\u6574\u6027\u6821\u9A8C\u5931\u8D25",
+  [4005 /* COMPONENT_INCOMPATIBLE */]: "\u7EC4\u4EF6\u7248\u672C\u4E0D\u517C\u5BB9",
+  [4006 /* COMPONENT_LOAD_FAILED */]: "\u7EC4\u4EF6\u52A0\u8F7D\u5931\u8D25",
+  [4007 /* COMPONENT_RENDER_ERROR */]: "\u7EC4\u4EF6\u6E32\u67D3\u9519\u8BEF",
+  // 页面错误
+  [5001 /* PAGE_NOT_FOUND */]: "\u9875\u9762\u4E0D\u5B58\u5728",
+  [5002 /* PAGE_VERSION_NOT_FOUND */]: "\u9875\u9762\u7248\u672C\u4E0D\u5B58\u5728",
+  [5003 /* PAGE_SCHEMA_INVALID */]: "\u9875\u9762 Schema \u65E0\u6548",
+  [5004 /* PAGE_MANIFEST_INVALID */]: "\u9875\u9762 Manifest \u65E0\u6548",
+  [5005 /* PAGE_PUBLISH_FAILED */]: "\u9875\u9762\u53D1\u5E03\u5931\u8D25",
+  [5006 /* PAGE_ROLLBACK_FAILED */]: "\u9875\u9762\u56DE\u6EDA\u5931\u8D25",
+  // 活动错误
+  [6001 /* ACTIVITY_NOT_FOUND */]: "\u6D3B\u52A8\u4E0D\u5B58\u5728",
+  [6002 /* ACTIVITY_NOT_STARTED */]: "\u6D3B\u52A8\u672A\u5F00\u59CB",
+  [6003 /* ACTIVITY_ENDED */]: "\u6D3B\u52A8\u5DF2\u7ED3\u675F",
+  [6004 /* ACTIVITY_ALREADY_CLAIMED */]: "\u5DF2\u9886\u53D6\u8FC7",
+  [6005 /* ACTIVITY_ALREADY_SIGNED */]: "\u4ECA\u65E5\u5DF2\u7B7E\u5230",
+  [6006 /* ACTIVITY_LIMIT_EXCEEDED */]: "\u8D85\u51FA\u9886\u53D6\u9650\u5236",
+  [6007 /* ACTIVITY_DISABLED */]: "\u6D3B\u52A8\u5DF2\u7981\u7528",
+  // 表达式错误
+  [7001 /* EXPRESSION_SYNTAX_ERROR */]: "\u8868\u8FBE\u5F0F\u8BED\u6CD5\u9519\u8BEF",
+  [7002 /* EXPRESSION_UNKNOWN_FUNCTION */]: "\u672A\u77E5\u51FD\u6570",
+  [7003 /* EXPRESSION_INVALID_ARGUMENT */]: "\u65E0\u6548\u53C2\u6570",
+  [7004 /* EXPRESSION_UNKNOWN_VARIABLE */]: "\u672A\u77E5\u53D8\u91CF",
+  [7005 /* EXPRESSION_TYPE_MISMATCH */]: "\u7C7B\u578B\u4E0D\u5339\u914D",
+  [7006 /* EXPRESSION_ACCESS_DENIED */]: "\u8BBF\u95EE\u88AB\u62D2\u7EDD",
+  // 版本/迁移错误
+  [8001 /* SCHEMA_VERSION_MISMATCH */]: "Schema \u7248\u672C\u4E0D\u5339\u914D",
+  [8002 /* MIGRATION_FAILED */]: "\u8FC1\u79FB\u5931\u8D25",
+  [8003 /* MIGRATION_NOT_FOUND */]: "\u8FC1\u79FB\u811A\u672C\u4E0D\u5B58\u5728",
+  [8004 /* VERSION_INCOMPATIBLE */]: "\u7248\u672C\u4E0D\u517C\u5BB9"
+};
+function createDjvlcError(code, details, traceId) {
+  return {
+    code,
+    message: ErrorMessages[code] || "\u672A\u77E5\u9519\u8BEF",
+    details,
+    traceId,
+    timestamp: Date.now()
+  };
+}
+function getHttpStatusFromErrorCode(code) {
+  if (code === 1002 /* UNAUTHORIZED */) return 401;
+  if (code === 1003 /* FORBIDDEN */) return 403;
+  if (code === 1004 /* NOT_FOUND */) return 404;
+  if (code === 1005 /* RATE_LIMITED */) return 429;
+  if (code === 1009 /* TIMEOUT */) return 408;
+  if (code === 1008 /* SERVICE_UNAVAILABLE */) return 503;
+  const numericCode = Number(code);
+  if (numericCode >= 1e3 && numericCode < 2e3) return 400;
+  if (numericCode >= 2e3 && numericCode < 3e3) return 400;
+  if (numericCode >= 3e3 && numericCode < 4e3) return 400;
+  if (numericCode >= 4e3 && numericCode < 5e3) return 404;
+  if (numericCode >= 5e3 && numericCode < 6e3) return 404;
+  if (numericCode >= 6e3 && numericCode < 7e3) return 400;
+  if (numericCode >= 7e3 && numericCode < 8e3) return 400;
+  if (numericCode >= 8e3 && numericCode < 9e3) return 400;
+  return 500;
+}
+function isRetryableError(code) {
+  return [
+    1009 /* TIMEOUT */,
+    1008 /* SERVICE_UNAVAILABLE */,
+    3005 /* QUERY_TIMEOUT */,
+    4006 /* COMPONENT_LOAD_FAILED */
+  ].includes(code);
+}
+
+// src/page/index.ts
+var PublishStatus = /* @__PURE__ */ ((PublishStatus2) => {
+  PublishStatus2["PENDING"] = "pending";
+  PublishStatus2["PUBLISHING"] = "publishing";
+  PublishStatus2["SUCCESS"] = "success";
+  PublishStatus2["FAILED"] = "failed";
+  PublishStatus2["ROLLBACK"] = "rollback";
+  return PublishStatus2;
+})(PublishStatus || {});
+
+// src/component/index.ts
+var COMPONENT_CATEGORIES = [
+  "basic",
+  "form",
+  "layout",
+  "navigation",
+  "feedback",
+  "display",
+  "data",
+  "business",
+  "chart",
+  "other"
+];
+
+// src/expression/index.ts
+var BUILTIN_FUNCTIONS = [
+  // 字符串函数
+  {
+    name: "len",
+    description: "\u83B7\u53D6\u5B57\u7B26\u4E32\u6216\u6570\u7EC4\u957F\u5EA6",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "number",
+    examples: ['len("hello")', "len([1,2,3])"]
+  },
+  {
+    name: "trim",
+    description: "\u53BB\u9664\u5B57\u7B26\u4E32\u9996\u5C3E\u7A7A\u683C",
+    params: [{ name: "str", type: "string", required: true }],
+    returnType: "string",
+    examples: ['trim("  hello  ")']
+  },
+  {
+    name: "upper",
+    description: "\u8F6C\u4E3A\u5927\u5199",
+    params: [{ name: "str", type: "string", required: true }],
+    returnType: "string",
+    examples: ['upper("hello")']
+  },
+  {
+    name: "lower",
+    description: "\u8F6C\u4E3A\u5C0F\u5199",
+    params: [{ name: "str", type: "string", required: true }],
+    returnType: "string",
+    examples: ['lower("HELLO")']
+  },
+  {
+    name: "substr",
+    description: "\u622A\u53D6\u5B50\u5B57\u7B26\u4E32",
+    params: [
+      { name: "str", type: "string", required: true },
+      { name: "start", type: "number", required: true },
+      { name: "length", type: "number", required: false }
+    ],
+    returnType: "string",
+    examples: ['substr("hello", 0, 2)']
+  },
+  {
+    name: "concat",
+    description: "\u8FDE\u63A5\u5B57\u7B26\u4E32",
+    params: [
+      { name: "values", type: "any", required: true, description: "\u53EF\u53D8\u53C2\u6570" }
+    ],
+    returnType: "string",
+    examples: ['concat("a", "b", "c")']
+  },
+  {
+    name: "replace",
+    description: "\u66FF\u6362\u5B57\u7B26\u4E32",
+    params: [
+      { name: "str", type: "string", required: true },
+      { name: "search", type: "string", required: true },
+      { name: "replacement", type: "string", required: true }
+    ],
+    returnType: "string",
+    examples: ['replace("hello", "l", "x")']
+  },
+  {
+    name: "split",
+    description: "\u5206\u5272\u5B57\u7B26\u4E32",
+    params: [
+      { name: "str", type: "string", required: true },
+      { name: "separator", type: "string", required: true }
+    ],
+    returnType: "array",
+    examples: ['split("a,b,c", ",")']
+  },
+  {
+    name: "join",
+    description: "\u8FDE\u63A5\u6570\u7EC4\u4E3A\u5B57\u7B26\u4E32",
+    params: [
+      { name: "arr", type: "array", required: true },
+      { name: "separator", type: "string", required: false, defaultValue: "," }
+    ],
+    returnType: "string",
+    examples: ['join(["a","b","c"], "-")']
+  },
+  // 数字函数
+  {
+    name: "toNumber",
+    description: "\u8F6C\u4E3A\u6570\u5B57",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "number",
+    examples: ['toNumber("123")']
+  },
+  {
+    name: "toString",
+    description: "\u8F6C\u4E3A\u5B57\u7B26\u4E32",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "string",
+    examples: ["toString(123)"]
+  },
+  {
+    name: "round",
+    description: "\u56DB\u820D\u4E94\u5165",
+    params: [
+      { name: "value", type: "number", required: true },
+      { name: "decimals", type: "number", required: false, defaultValue: 0 }
+    ],
+    returnType: "number",
+    examples: ["round(3.14159, 2)"]
+  },
+  {
+    name: "floor",
+    description: "\u5411\u4E0B\u53D6\u6574",
+    params: [{ name: "value", type: "number", required: true }],
+    returnType: "number",
+    examples: ["floor(3.7)"]
+  },
+  {
+    name: "ceil",
+    description: "\u5411\u4E0A\u53D6\u6574",
+    params: [{ name: "value", type: "number", required: true }],
+    returnType: "number",
+    examples: ["ceil(3.2)"]
+  },
+  {
+    name: "abs",
+    description: "\u7EDD\u5BF9\u503C",
+    params: [{ name: "value", type: "number", required: true }],
+    returnType: "number",
+    examples: ["abs(-5)"]
+  },
+  {
+    name: "min",
+    description: "\u6700\u5C0F\u503C",
+    params: [
+      { name: "values", type: "number", required: true, description: "\u53EF\u53D8\u53C2\u6570" }
+    ],
+    returnType: "number",
+    examples: ["min(1, 2, 3)"]
+  },
+  {
+    name: "max",
+    description: "\u6700\u5927\u503C",
+    params: [
+      { name: "values", type: "number", required: true, description: "\u53EF\u53D8\u53C2\u6570" }
+    ],
+    returnType: "number",
+    examples: ["max(1, 2, 3)"]
+  },
+  // 日期函数
+  {
+    name: "now",
+    description: "\u5F53\u524D\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09",
+    params: [],
+    returnType: "number",
+    examples: ["now()"]
+  },
+  {
+    name: "dateFormat",
+    description: "\u683C\u5F0F\u5316\u65E5\u671F",
+    params: [
+      { name: "timestamp", type: "number", required: true },
+      { name: "format", type: "string", required: false, defaultValue: "YYYY-MM-DD" }
+    ],
+    returnType: "string",
+    examples: ['dateFormat(now(), "YYYY-MM-DD HH:mm:ss")']
+  },
+  {
+    name: "dateParse",
+    description: "\u89E3\u6790\u65E5\u671F\u5B57\u7B26\u4E32",
+    params: [
+      { name: "dateStr", type: "string", required: true },
+      { name: "format", type: "string", required: false }
+    ],
+    returnType: "number",
+    examples: ['dateParse("2024-01-01")']
+  },
+  // 数组函数
+  {
+    name: "first",
+    description: "\u83B7\u53D6\u6570\u7EC4\u7B2C\u4E00\u4E2A\u5143\u7D20",
+    params: [{ name: "arr", type: "array", required: true }],
+    returnType: "any",
+    examples: ["first([1,2,3])"]
+  },
+  {
+    name: "last",
+    description: "\u83B7\u53D6\u6570\u7EC4\u6700\u540E\u4E00\u4E2A\u5143\u7D20",
+    params: [{ name: "arr", type: "array", required: true }],
+    returnType: "any",
+    examples: ["last([1,2,3])"]
+  },
+  {
+    name: "includes",
+    description: "\u68C0\u67E5\u6570\u7EC4\u662F\u5426\u5305\u542B\u5143\u7D20",
+    params: [
+      { name: "arr", type: "array", required: true },
+      { name: "value", type: "any", required: true }
+    ],
+    returnType: "boolean",
+    examples: ["includes([1,2,3], 2)"]
+  },
+  {
+    name: "slice",
+    description: "\u622A\u53D6\u6570\u7EC4",
+    params: [
+      { name: "arr", type: "array", required: true },
+      { name: "start", type: "number", required: true },
+      { name: "end", type: "number", required: false }
+    ],
+    returnType: "array",
+    examples: ["slice([1,2,3,4], 1, 3)"]
+  },
+  // 条件函数
+  {
+    name: "default",
+    description: "\u63D0\u4F9B\u9ED8\u8BA4\u503C",
+    params: [
+      { name: "value", type: "any", required: true },
+      { name: "defaultValue", type: "any", required: true }
+    ],
+    returnType: "any",
+    examples: ['default(null, "fallback")']
+  },
+  {
+    name: "ifElse",
+    description: "\u6761\u4EF6\u5224\u65AD",
+    params: [
+      { name: "condition", type: "boolean", required: true },
+      { name: "trueValue", type: "any", required: true },
+      { name: "falseValue", type: "any", required: true }
+    ],
+    returnType: "any",
+    examples: ['ifElse(age > 18, "\u6210\u5E74", "\u672A\u6210\u5E74")']
+  },
+  {
+    name: "isEmpty",
+    description: "\u68C0\u67E5\u662F\u5426\u4E3A\u7A7A",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "boolean",
+    examples: ['isEmpty("")', "isEmpty([])"]
+  },
+  {
+    name: "isNull",
+    description: "\u68C0\u67E5\u662F\u5426\u4E3A null \u6216 undefined",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "boolean",
+    examples: ["isNull(null)"]
+  },
+  // JSON 函数
+  {
+    name: "jsonParse",
+    description: "\u89E3\u6790 JSON \u5B57\u7B26\u4E32",
+    params: [{ name: "str", type: "string", required: true }],
+    returnType: "any",
+    examples: [`jsonParse('{"a":1}')`]
+  },
+  {
+    name: "jsonStringify",
+    description: "\u5E8F\u5217\u5316\u4E3A JSON",
+    params: [{ name: "value", type: "any", required: true }],
+    returnType: "string",
+    examples: ["jsonStringify({a:1})"]
+  }
+];
+var BUILTIN_FUNCTION_NAMES = new Set(BUILTIN_FUNCTIONS.map((f) => f.name));
+var ALLOWED_ROOT_VARIABLES = [
+  "state",
+  "query",
+  "context",
+  "event",
+  "item",
+  "index"
+];
+function isExpressionBinding(value) {
+  return value !== null && typeof value === "object" && value.__isExpression === true && typeof value.expression === "string";
+}
+function createExpressionBinding(expression, fallback) {
+  return {
+    __isExpression: true,
+    expression,
+    fallback
+  };
+}
+
+// src/migrations/index.ts
+var SCHEMA_VERSIONS = ["1.0.0", "1.1.0", "2.0.0"];
+var CURRENT_SCHEMA_VERSION = "1.0.0";
+var migrations = [];
+function registerMigration(migration) {
+  const exists = migrations.some(
+    (m) => m.from === migration.from && m.to === migration.to
+  );
+  if (exists) {
+    throw new Error(`Migration from ${migration.from} to ${migration.to} already exists`);
+  }
+  migrations.push(migration);
+}
+function getAllMigrations() {
+  return [...migrations];
+}
+function findMigrationPath(from, to) {
+  const path = [];
+  let current = from;
+  while (current !== to) {
+    const nextMigration = migrations.find((m) => m.from === current);
+    if (!nextMigration) {
+      throw new Error(`No migration path from ${current} to ${to}`);
+    }
+    path.push(nextMigration);
+    current = nextMigration.to;
+    if (path.length > 100) {
+      throw new Error("Migration path too long, possible circular dependency");
+    }
+  }
+  return path;
+}
+function migratePageSchema(data, targetVersion) {
+  const fromVersion = data.schemaVersion || "1.0.0";
+  const toVersion = targetVersion || CURRENT_SCHEMA_VERSION;
+  if (fromVersion === toVersion) {
+    return {
+      success: true,
+      data,
+      fromVersion,
+      toVersion,
+      appliedMigrations: []
+    };
+  }
+  try {
+    const path = findMigrationPath(fromVersion, toVersion);
+    let result = { ...data };
+    const appliedMigrations = [];
+    for (const migration of path) {
+      result = migration.migrate(result);
+      result.schemaVersion = migration.to;
+      appliedMigrations.push(`${migration.from} -> ${migration.to}`);
+    }
+    return {
+      success: true,
+      data: result,
+      fromVersion,
+      toVersion,
+      appliedMigrations
+    };
+  } catch (error) {
+    return {
+      success: false,
+      fromVersion,
+      toVersion,
+      appliedMigrations: [],
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
+  }
+}
+function needsMigration(data, targetVersion) {
+  const currentVersion = data.schemaVersion || "1.0.0";
+  const target = targetVersion || CURRENT_SCHEMA_VERSION;
+  return currentVersion !== target;
+}
+function getVersionInfo(version) {
+  const [major, minor, patch] = version.split(".").map(Number);
+  return { major, minor, patch };
+}
+function compareVersions(a, b) {
+  const va = getVersionInfo(a);
+  const vb = getVersionInfo(b);
+  if (va.major !== vb.major) return va.major < vb.major ? -1 : 1;
+  if (va.minor !== vb.minor) return va.minor < vb.minor ? -1 : 1;
+  if (va.patch !== vb.patch) return va.patch < vb.patch ? -1 : 1;
+  return 0;
+}
+registerMigration({
+  from: "1.0.0",
+  to: "1.1.0",
+  description: "\u6DFB\u52A0 Definition \u7248\u672C\u7ED1\u5B9A\u5B57\u6BB5",
+  migrate: (data) => {
+    return {
+      ...data,
+      actionDefVersionIds: data.actionDefVersionIds || [],
+      dataQueryVersionIds: data.dataQueryVersionIds || []
+    };
+  }
+});
+registerMigration({
+  from: "1.1.0",
+  to: "2.0.0",
+  description: "\u91CD\u6784\u7EC4\u4EF6\u4E8B\u4EF6\u7ED3\u6784",
+  breaking: true,
+  migrate: (data) => {
+    return {
+      ...data,
+      components: data.components.map((component) => ({
+        ...component,
+        // 示例：将 events 数组中的 actions 结构标准化
+        events: component.events?.map((event) => ({
+          ...event,
+          // 确保 enabled 字段存在
+          enabled: event.enabled ?? true
+        }))
+      }))
+    };
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACTION_SPEC_VERSION,
+  ALLOWED_ROOT_VARIABLES,
+  BUILTIN_FUNCTIONS,
+  BUILTIN_FUNCTION_NAMES,
+  COMPONENT_CATEGORIES,
+  COMPONENT_META_SCHEMA_VERSION,
+  CURRENT_SCHEMA_VERSION,
+  DATA_QUERY_SPEC_VERSION,
+  ErrorCode,
+  ErrorCodeCategory,
+  ErrorMessages,
+  PAGE_SCHEMA_VERSION,
+  PublishStatus,
+  SCHEMA_VERSIONS,
+  compareVersions,
+  createDjvlcError,
+  createExpressionBinding,
+  findMigrationPath,
+  getAllMigrations,
+  getContractsVersion,
+  getHttpStatusFromErrorCode,
+  getVersionInfo,
+  isExpressionBinding,
+  isRetryableError,
+  isVersionCompatible,
+  migratePageSchema,
+  needsMigration,
+  registerMigration
+});
+//# sourceMappingURL=index.js.map