@djvlc/contracts-validators 1.2.0

package/dist/index.d.mts

@@ -0,0 +1,150 @@
+import Ajv from 'ajv';
+import { PageSchema, ComponentMeta, ActionDefinition, ActionExecuteRequest, DataQueryDefinition, DataQueryRequest } from '@djvlc/contracts-types';
+
+/**
+ * @djvlc/contracts-validators - DJV 低代码平台预编译校验器包
+ *
+ * 提供预编译的 Ajv 校验器，避免各仓库自行编写校验逻辑导致分叉
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * 校验结果
+ */
+interface ValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ValidationError[];
+}
+/**
+ * 校验错误
+ */
+interface ValidationError {
+    /** 错误路径 */
+    path: string;
+    /** 错误消息 */
+    message: string;
+    /** 错误关键字 */
+    keyword?: string;
+    /** 期望值 */
+    expected?: unknown;
+    /** 实际值 */
+    actual?: unknown;
+}
+declare const ajv: Ajv;
+/**
+ * 校验 PageSchema
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validatePage(data: unknown): ValidationResult;
+/**
+ * 校验 PageSchema，返回类型安全的结果
+ */
+declare function validatePageSchema(data: unknown): ValidationResult & {
+    data?: PageSchema;
+};
+/**
+ * 断言为 PageSchema
+ */
+declare function assertPageSchema(data: unknown): asserts data is PageSchema;
+/**
+ * 校验 ComponentMeta
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateComponentMeta(data: unknown): ValidationResult;
+/**
+ * 断言为 ComponentMeta
+ */
+declare function assertComponentMeta(data: unknown): asserts data is ComponentMeta;
+/**
+ * 校验 ActionDefinition
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateActionDefinition(data: unknown): ValidationResult;
+/**
+ * 断言为 ActionDefinition
+ */
+declare function assertActionDefinition(data: unknown): asserts data is ActionDefinition;
+/**
+ * 校验 ActionExecuteRequest
+ */
+declare function validateActionRequest(data: unknown): ValidationResult;
+/**
+ * 断言为 ActionExecuteRequest
+ */
+declare function assertActionRequest(data: unknown): asserts data is ActionExecuteRequest;
+/**
+ * 校验 DataQueryDefinition
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateDataQueryDefinition(data: unknown): ValidationResult;
+/**
+ * 断言为 DataQueryDefinition
+ */
+declare function assertDataQueryDefinition(data: unknown): asserts data is DataQueryDefinition;
+/**
+ * 校验 DataQueryRequest
+ */
+declare function validateQueryRequest(data: unknown): ValidationResult;
+/**
+ * 断言为 DataQueryRequest
+ */
+declare function assertQueryRequest(data: unknown): asserts data is DataQueryRequest;
+/**
+ * 检查是否为有效的 PageSchema
+ */
+declare function isPageSchema(value: unknown): value is PageSchema;
+/**
+ * 检查是否为有效的 ComponentMeta
+ */
+declare function isComponentMeta(value: unknown): value is ComponentMeta;
+/**
+ * 检查是否为有效的 ActionDefinition
+ */
+declare function isActionDefinition(value: unknown): value is ActionDefinition;
+/**
+ * 检查是否为有效的 DataQueryDefinition
+ */
+declare function isDataQueryDefinition(value: unknown): value is DataQueryDefinition;
+/**
+ * 检查是否为有效的 ActionExecuteRequest
+ */
+declare function isActionRequest(value: unknown): value is ActionExecuteRequest;
+/**
+ * 检查是否为有效的 DataQueryRequest
+ */
+declare function isQueryRequest(value: unknown): value is DataQueryRequest;
+/**
+ * 批量校验结果
+ */
+interface BatchValidationResult<T> {
+    /** 全部有效 */
+    allValid: boolean;
+    /** 有效项数量 */
+    validCount: number;
+    /** 无效项数量 */
+    invalidCount: number;
+    /** 各项结果 */
+    results: Array<{
+        index: number;
+        valid: boolean;
+        data?: T;
+        errors: ValidationError[];
+    }>;
+}
+/**
+ * 批量校验 PageSchema
+ */
+declare function validatePages(items: unknown[]): BatchValidationResult<PageSchema>;
+/**
+ * 批量校验 ComponentMeta
+ */
+declare function validateComponentMetas(items: unknown[]): BatchValidationResult<ComponentMeta>;
+
+export { type BatchValidationResult, type ValidationError, type ValidationResult, ajv, assertActionDefinition, assertActionRequest, assertComponentMeta, assertDataQueryDefinition, assertPageSchema, assertQueryRequest, isActionDefinition, isActionRequest, isComponentMeta, isDataQueryDefinition, isPageSchema, isQueryRequest, validateActionDefinition, validateActionRequest, validateComponentMeta, validateComponentMetas, validateDataQueryDefinition, validatePage, validatePageSchema, validatePages, validateQueryRequest };

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+import Ajv from 'ajv';
+import { PageSchema, ComponentMeta, ActionDefinition, ActionExecuteRequest, DataQueryDefinition, DataQueryRequest } from '@djvlc/contracts-types';
+
+/**
+ * @djvlc/contracts-validators - DJV 低代码平台预编译校验器包
+ *
+ * 提供预编译的 Ajv 校验器，避免各仓库自行编写校验逻辑导致分叉
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * 校验结果
+ */
+interface ValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ValidationError[];
+}
+/**
+ * 校验错误
+ */
+interface ValidationError {
+    /** 错误路径 */
+    path: string;
+    /** 错误消息 */
+    message: string;
+    /** 错误关键字 */
+    keyword?: string;
+    /** 期望值 */
+    expected?: unknown;
+    /** 实际值 */
+    actual?: unknown;
+}
+declare const ajv: Ajv;
+/**
+ * 校验 PageSchema
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validatePage(data: unknown): ValidationResult;
+/**
+ * 校验 PageSchema，返回类型安全的结果
+ */
+declare function validatePageSchema(data: unknown): ValidationResult & {
+    data?: PageSchema;
+};
+/**
+ * 断言为 PageSchema
+ */
+declare function assertPageSchema(data: unknown): asserts data is PageSchema;
+/**
+ * 校验 ComponentMeta
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateComponentMeta(data: unknown): ValidationResult;
+/**
+ * 断言为 ComponentMeta
+ */
+declare function assertComponentMeta(data: unknown): asserts data is ComponentMeta;
+/**
+ * 校验 ActionDefinition
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateActionDefinition(data: unknown): ValidationResult;
+/**
+ * 断言为 ActionDefinition
+ */
+declare function assertActionDefinition(data: unknown): asserts data is ActionDefinition;
+/**
+ * 校验 ActionExecuteRequest
+ */
+declare function validateActionRequest(data: unknown): ValidationResult;
+/**
+ * 断言为 ActionExecuteRequest
+ */
+declare function assertActionRequest(data: unknown): asserts data is ActionExecuteRequest;
+/**
+ * 校验 DataQueryDefinition
+ * @param data 待校验数据
+ * @returns 校验结果
+ */
+declare function validateDataQueryDefinition(data: unknown): ValidationResult;
+/**
+ * 断言为 DataQueryDefinition
+ */
+declare function assertDataQueryDefinition(data: unknown): asserts data is DataQueryDefinition;
+/**
+ * 校验 DataQueryRequest
+ */
+declare function validateQueryRequest(data: unknown): ValidationResult;
+/**
+ * 断言为 DataQueryRequest
+ */
+declare function assertQueryRequest(data: unknown): asserts data is DataQueryRequest;
+/**
+ * 检查是否为有效的 PageSchema
+ */
+declare function isPageSchema(value: unknown): value is PageSchema;
+/**
+ * 检查是否为有效的 ComponentMeta
+ */
+declare function isComponentMeta(value: unknown): value is ComponentMeta;
+/**
+ * 检查是否为有效的 ActionDefinition
+ */
+declare function isActionDefinition(value: unknown): value is ActionDefinition;
+/**
+ * 检查是否为有效的 DataQueryDefinition
+ */
+declare function isDataQueryDefinition(value: unknown): value is DataQueryDefinition;
+/**
+ * 检查是否为有效的 ActionExecuteRequest
+ */
+declare function isActionRequest(value: unknown): value is ActionExecuteRequest;
+/**
+ * 检查是否为有效的 DataQueryRequest
+ */
+declare function isQueryRequest(value: unknown): value is DataQueryRequest;
+/**
+ * 批量校验结果
+ */
+interface BatchValidationResult<T> {
+    /** 全部有效 */
+    allValid: boolean;
+    /** 有效项数量 */
+    validCount: number;
+    /** 无效项数量 */
+    invalidCount: number;
+    /** 各项结果 */
+    results: Array<{
+        index: number;
+        valid: boolean;
+        data?: T;
+        errors: ValidationError[];
+    }>;
+}
+/**
+ * 批量校验 PageSchema
+ */
+declare function validatePages(items: unknown[]): BatchValidationResult<PageSchema>;
+/**
+ * 批量校验 ComponentMeta
+ */
+declare function validateComponentMetas(items: unknown[]): BatchValidationResult<ComponentMeta>;
+
+export { type BatchValidationResult, type ValidationError, type ValidationResult, ajv, assertActionDefinition, assertActionRequest, assertComponentMeta, assertDataQueryDefinition, assertPageSchema, assertQueryRequest, isActionDefinition, isActionRequest, isComponentMeta, isDataQueryDefinition, isPageSchema, isQueryRequest, validateActionDefinition, validateActionRequest, validateComponentMeta, validateComponentMetas, validateDataQueryDefinition, validatePage, validatePageSchema, validatePages, validateQueryRequest };

package/dist/index.js

@@ -0,0 +1,257 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ajv: () => ajv,
+  assertActionDefinition: () => assertActionDefinition,
+  assertActionRequest: () => assertActionRequest,
+  assertComponentMeta: () => assertComponentMeta,
+  assertDataQueryDefinition: () => assertDataQueryDefinition,
+  assertPageSchema: () => assertPageSchema,
+  assertQueryRequest: () => assertQueryRequest,
+  isActionDefinition: () => isActionDefinition,
+  isActionRequest: () => isActionRequest,
+  isComponentMeta: () => isComponentMeta,
+  isDataQueryDefinition: () => isDataQueryDefinition,
+  isPageSchema: () => isPageSchema,
+  isQueryRequest: () => isQueryRequest,
+  validateActionDefinition: () => validateActionDefinition,
+  validateActionRequest: () => validateActionRequest,
+  validateComponentMeta: () => validateComponentMeta,
+  validateComponentMetas: () => validateComponentMetas,
+  validateDataQueryDefinition: () => validateDataQueryDefinition,
+  validatePage: () => validatePage,
+  validatePageSchema: () => validatePageSchema,
+  validatePages: () => validatePages,
+  validateQueryRequest: () => validateQueryRequest
+});
+module.exports = __toCommonJS(index_exports);
+var import_ajv = __toESM(require("ajv"));
+var import_ajv_formats = __toESM(require("ajv-formats"));
+var import_contracts_schemas = require("@djvlc/contracts-schemas");
+var ajv = new import_ajv.default({
+  allErrors: true,
+  verbose: true,
+  strict: false
+});
+(0, import_ajv_formats.default)(ajv);
+var pageValidator = ajv.compile(import_contracts_schemas.pageSchema);
+var componentMetaValidator = ajv.compile(import_contracts_schemas.componentMetaSchema);
+var actionSpecValidator = ajv.compile(import_contracts_schemas.actionSpecSchema);
+var dataQuerySpecValidator = ajv.compile(import_contracts_schemas.dataQuerySpecSchema);
+function convertAjvErrors(errors) {
+  if (!errors) return [];
+  return errors.map((error) => ({
+    path: error.instancePath || "/",
+    message: error.message || "Unknown error",
+    keyword: error.keyword,
+    expected: error.params,
+    actual: error.data
+  }));
+}
+function createResult(valid, errors) {
+  return {
+    valid,
+    errors: convertAjvErrors(errors)
+  };
+}
+function validatePage(data) {
+  const valid = pageValidator(data);
+  return createResult(valid, pageValidator.errors);
+}
+function validatePageSchema(data) {
+  const result = validatePage(data);
+  if (result.valid) {
+    return { ...result, data };
+  }
+  return result;
+}
+function assertPageSchema(data) {
+  const result = validatePage(data);
+  if (!result.valid) {
+    throw new Error(`Invalid PageSchema: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateComponentMeta(data) {
+  const valid = componentMetaValidator(data);
+  return createResult(valid, componentMetaValidator.errors);
+}
+function assertComponentMeta(data) {
+  const result = validateComponentMeta(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ComponentMeta: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateActionDefinition(data) {
+  const valid = actionSpecValidator(data);
+  return createResult(valid, actionSpecValidator.errors);
+}
+function assertActionDefinition(data) {
+  const result = validateActionDefinition(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ActionDefinition: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateActionRequest(data) {
+  const errors = [];
+  if (!data || typeof data !== "object") {
+    errors.push({ path: "/", message: "ActionExecuteRequest must be an object" });
+    return { valid: false, errors };
+  }
+  const obj = data;
+  if (typeof obj.actionType !== "string" || !obj.actionType) {
+    errors.push({ path: "/actionType", message: "actionType is required and must be a string" });
+  }
+  if (obj.params === void 0 || typeof obj.params !== "object") {
+    errors.push({ path: "/params", message: "params is required and must be an object" });
+  }
+  if (obj.context === void 0 || typeof obj.context !== "object") {
+    errors.push({ path: "/context", message: "context is required and must be an object" });
+  }
+  return { valid: errors.length === 0, errors };
+}
+function assertActionRequest(data) {
+  const result = validateActionRequest(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ActionExecuteRequest: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateDataQueryDefinition(data) {
+  const valid = dataQuerySpecValidator(data);
+  return createResult(valid, dataQuerySpecValidator.errors);
+}
+function assertDataQueryDefinition(data) {
+  const result = validateDataQueryDefinition(data);
+  if (!result.valid) {
+    throw new Error(`Invalid DataQueryDefinition: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateQueryRequest(data) {
+  const errors = [];
+  if (!data || typeof data !== "object") {
+    errors.push({ path: "/", message: "DataQueryRequest must be an object" });
+    return { valid: false, errors };
+  }
+  const obj = data;
+  if (typeof obj.queryVersionId !== "string" || !obj.queryVersionId) {
+    errors.push({ path: "/queryVersionId", message: "queryVersionId is required and must be a string" });
+  }
+  if (obj.params === void 0 || typeof obj.params !== "object") {
+    errors.push({ path: "/params", message: "params is required and must be an object" });
+  }
+  return { valid: errors.length === 0, errors };
+}
+function assertQueryRequest(data) {
+  const result = validateQueryRequest(data);
+  if (!result.valid) {
+    throw new Error(`Invalid DataQueryRequest: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function isPageSchema(value) {
+  return validatePage(value).valid;
+}
+function isComponentMeta(value) {
+  return validateComponentMeta(value).valid;
+}
+function isActionDefinition(value) {
+  return validateActionDefinition(value).valid;
+}
+function isDataQueryDefinition(value) {
+  return validateDataQueryDefinition(value).valid;
+}
+function isActionRequest(value) {
+  return validateActionRequest(value).valid;
+}
+function isQueryRequest(value) {
+  return validateQueryRequest(value).valid;
+}
+function validatePages(items) {
+  const results = items.map((item, index) => {
+    const result = validatePage(item);
+    return {
+      index,
+      valid: result.valid,
+      data: result.valid ? item : void 0,
+      errors: result.errors
+    };
+  });
+  const validCount = results.filter((r) => r.valid).length;
+  return {
+    allValid: validCount === items.length,
+    validCount,
+    invalidCount: items.length - validCount,
+    results
+  };
+}
+function validateComponentMetas(items) {
+  const results = items.map((item, index) => {
+    const result = validateComponentMeta(item);
+    return {
+      index,
+      valid: result.valid,
+      data: result.valid ? item : void 0,
+      errors: result.errors
+    };
+  });
+  const validCount = results.filter((r) => r.valid).length;
+  return {
+    allValid: validCount === items.length,
+    validCount,
+    invalidCount: items.length - validCount,
+    results
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ajv,
+  assertActionDefinition,
+  assertActionRequest,
+  assertComponentMeta,
+  assertDataQueryDefinition,
+  assertPageSchema,
+  assertQueryRequest,
+  isActionDefinition,
+  isActionRequest,
+  isComponentMeta,
+  isDataQueryDefinition,
+  isPageSchema,
+  isQueryRequest,
+  validateActionDefinition,
+  validateActionRequest,
+  validateComponentMeta,
+  validateComponentMetas,
+  validateDataQueryDefinition,
+  validatePage,
+  validatePageSchema,
+  validatePages,
+  validateQueryRequest
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @djvlc/contracts-validators - DJV 低代码平台预编译校验器包\n *\n * 提供预编译的 Ajv 校验器，避免各仓库自行编写校验逻辑导致分叉\n *\n * @packageDocumentation\n */\n\nimport Ajv from 'ajv';\nimport addFormats from 'ajv-formats';\nimport {\n  pageSchema,\n  componentMetaSchema,\n  actionSpecSchema,\n  dataQuerySpecSchema,\n} from '@djvlc/contracts-schemas';\nimport type {\n  PageSchema,\n  ComponentMeta,\n  ActionDefinition,\n  DataQueryDefinition,\n  ActionExecuteRequest,\n  DataQueryRequest,\n} from '@djvlc/contracts-types';\n\n// ==================== 校验结果类型 ====================\n\n/**\n * 校验结果\n */\nexport interface ValidationResult {\n  /** 是否有效 */\n  valid: boolean;\n  /** 错误列表 */\n  errors: ValidationError[];\n}\n\n/**\n * 校验错误\n */\nexport interface ValidationError {\n  /** 错误路径 */\n  path: string;\n  /** 错误消息 */\n  message: string;\n  /** 错误关键字 */\n  keyword?: string;\n  /** 期望值 */\n  expected?: unknown;\n  /** 实际值 */\n  actual?: unknown;\n}\n\n// ==================== Ajv 实例 ====================\n\nconst ajv = new Ajv({\n  allErrors: true,\n  verbose: true,\n  strict: false,\n});\n\naddFormats(ajv);\n\n// 预编译 Schema\nconst pageValidator = ajv.compile(pageSchema);\nconst componentMetaValidator = ajv.compile(componentMetaSchema);\nconst actionSpecValidator = ajv.compile(actionSpecSchema);\nconst dataQuerySpecValidator = ajv.compile(dataQuerySpecSchema);\n\n// ==================== 工具函数 ====================\n\n/**\n * 将 Ajv 错误转换为标准格式\n */\nfunction convertAjvErrors(errors: typeof ajv.errors): ValidationError[] {\n  if (!errors) return [];\n\n  return errors.map((error) => ({\n    path: error.instancePath || '/',\n    message: error.message || 'Unknown error',\n    keyword: error.keyword,\n    expected: error.params,\n    actual: error.data,\n  }));\n}\n\n/**\n * 创建校验结果\n */\nfunction createResult(valid: boolean, errors: typeof ajv.errors): ValidationResult {\n  return {\n    valid,\n    errors: convertAjvErrors(errors),\n  };\n}\n\n\n// ==================== 页面校验 ====================\n\n/**\n * 校验 PageSchema\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validatePage(data: unknown): ValidationResult {\n  const valid = pageValidator(data);\n  return createResult(valid, pageValidator.errors);\n}\n\n/**\n * 校验 PageSchema，返回类型安全的结果\n */\nexport function validatePageSchema(data: unknown): ValidationResult & { data?: PageSchema } {\n  const result = validatePage(data);\n  if (result.valid) {\n    return { ...result, data: data as PageSchema };\n  }\n  return result;\n}\n\n/**\n * 断言为 PageSchema\n */\nexport function assertPageSchema(data: unknown): asserts data is PageSchema {\n  const result = validatePage(data);\n  if (!result.valid) {\n    throw new Error(`Invalid PageSchema: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== 组件元数据校验 ====================\n\n/**\n * 校验 ComponentMeta\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateComponentMeta(data: unknown): ValidationResult {\n  const valid = componentMetaValidator(data);\n  return createResult(valid, componentMetaValidator.errors);\n}\n\n/**\n * 断言为 ComponentMeta\n */\nexport function assertComponentMeta(data: unknown): asserts data is ComponentMeta {\n  const result = validateComponentMeta(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ComponentMeta: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== Action 校验 ====================\n\n/**\n * 校验 ActionDefinition\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateActionDefinition(data: unknown): ValidationResult {\n  const valid = actionSpecValidator(data);\n  return createResult(valid, actionSpecValidator.errors);\n}\n\n/**\n * 断言为 ActionDefinition\n */\nexport function assertActionDefinition(data: unknown): asserts data is ActionDefinition {\n  const result = validateActionDefinition(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ActionDefinition: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n/**\n * 校验 ActionExecuteRequest\n */\nexport function validateActionRequest(data: unknown): ValidationResult {\n  const errors: ValidationError[] = [];\n\n  if (!data || typeof data !== 'object') {\n    errors.push({ path: '/', message: 'ActionExecuteRequest must be an object' });\n    return { valid: false, errors };\n  }\n\n  const obj = data as Record<string, unknown>;\n\n  if (typeof obj.actionType !== 'string' || !obj.actionType) {\n    errors.push({ path: '/actionType', message: 'actionType is required and must be a string' });\n  }\n\n  if (obj.params === undefined || typeof obj.params !== 'object') {\n    errors.push({ path: '/params', message: 'params is required and must be an object' });\n  }\n\n  if (obj.context === undefined || typeof obj.context !== 'object') {\n    errors.push({ path: '/context', message: 'context is required and must be an object' });\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\n/**\n * 断言为 ActionExecuteRequest\n */\nexport function assertActionRequest(data: unknown): asserts data is ActionExecuteRequest {\n  const result = validateActionRequest(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ActionExecuteRequest: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== Data Query 校验 ====================\n\n/**\n * 校验 DataQueryDefinition\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateDataQueryDefinition(data: unknown): ValidationResult {\n  const valid = dataQuerySpecValidator(data);\n  return createResult(valid, dataQuerySpecValidator.errors);\n}\n\n/**\n * 断言为 DataQueryDefinition\n */\nexport function assertDataQueryDefinition(data: unknown): asserts data is DataQueryDefinition {\n  const result = validateDataQueryDefinition(data);\n  if (!result.valid) {\n    throw new Error(`Invalid DataQueryDefinition: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n/**\n * 校验 DataQueryRequest\n */\nexport function validateQueryRequest(data: unknown): ValidationResult {\n  const errors: ValidationError[] = [];\n\n  if (!data || typeof data !== 'object') {\n    errors.push({ path: '/', message: 'DataQueryRequest must be an object' });\n    return { valid: false, errors };\n  }\n\n  const obj = data as Record<string, unknown>;\n\n  if (typeof obj.queryVersionId !== 'string' || !obj.queryVersionId) {\n    errors.push({ path: '/queryVersionId', message: 'queryVersionId is required and must be a string' });\n  }\n\n  if (obj.params === undefined || typeof obj.params !== 'object') {\n    errors.push({ path: '/params', message: 'params is required and must be an object' });\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\n/**\n * 断言为 DataQueryRequest\n */\nexport function assertQueryRequest(data: unknown): asserts data is DataQueryRequest {\n  const result = validateQueryRequest(data);\n  if (!result.valid) {\n    throw new Error(`Invalid DataQueryRequest: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== 类型保护函数 ====================\n\n/**\n * 检查是否为有效的 PageSchema\n */\nexport function isPageSchema(value: unknown): value is PageSchema {\n  return validatePage(value).valid;\n}\n\n/**\n * 检查是否为有效的 ComponentMeta\n */\nexport function isComponentMeta(value: unknown): value is ComponentMeta {\n  return validateComponentMeta(value).valid;\n}\n\n/**\n * 检查是否为有效的 ActionDefinition\n */\nexport function isActionDefinition(value: unknown): value is ActionDefinition {\n  return validateActionDefinition(value).valid;\n}\n\n/**\n * 检查是否为有效的 DataQueryDefinition\n */\nexport function isDataQueryDefinition(value: unknown): value is DataQueryDefinition {\n  return validateDataQueryDefinition(value).valid;\n}\n\n/**\n * 检查是否为有效的 ActionExecuteRequest\n */\nexport function isActionRequest(value: unknown): value is ActionExecuteRequest {\n  return validateActionRequest(value).valid;\n}\n\n/**\n * 检查是否为有效的 DataQueryRequest\n */\nexport function isQueryRequest(value: unknown): value is DataQueryRequest {\n  return validateQueryRequest(value).valid;\n}\n\n// ==================== 批量校验 ====================\n\n/**\n * 批量校验结果\n */\nexport interface BatchValidationResult<T> {\n  /** 全部有效 */\n  allValid: boolean;\n  /** 有效项数量 */\n  validCount: number;\n  /** 无效项数量 */\n  invalidCount: number;\n  /** 各项结果 */\n  results: Array<{\n    index: number;\n    valid: boolean;\n    data?: T;\n    errors: ValidationError[];\n  }>;\n}\n\n/**\n * 批量校验 PageSchema\n */\nexport function validatePages(items: unknown[]): BatchValidationResult<PageSchema> {\n  const results = items.map((item, index) => {\n    const result = validatePage(item);\n    return {\n      index,\n      valid: result.valid,\n      data: result.valid ? (item as PageSchema) : undefined,\n      errors: result.errors,\n    };\n  });\n\n  const validCount = results.filter((r) => r.valid).length;\n\n  return {\n    allValid: validCount === items.length,\n    validCount,\n    invalidCount: items.length - validCount,\n    results,\n  };\n}\n\n/**\n * 批量校验 ComponentMeta\n */\nexport function validateComponentMetas(items: unknown[]): BatchValidationResult<ComponentMeta> {\n  const results = items.map((item, index) => {\n    const result = validateComponentMeta(item);\n    return {\n      index,\n      valid: result.valid,\n      data: result.valid ? (item as ComponentMeta) : undefined,\n      errors: result.errors,\n    };\n  });\n\n  const validCount = results.filter((r) => r.valid).length;\n\n  return {\n    allValid: validCount === items.length,\n    validCount,\n    invalidCount: items.length - validCount,\n    results,\n  };\n}\n\n// ==================== 导出 Ajv 实例（供高级用法） ====================\n\nexport { ajv };\n"],"mappings":"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","names":["Ajv","addFormats"]}

package/dist/index.mjs

@@ -0,0 +1,206 @@
+// src/index.ts
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import {
+  pageSchema,
+  componentMetaSchema,
+  actionSpecSchema,
+  dataQuerySpecSchema
+} from "@djvlc/contracts-schemas";
+var ajv = new Ajv({
+  allErrors: true,
+  verbose: true,
+  strict: false
+});
+addFormats(ajv);
+var pageValidator = ajv.compile(pageSchema);
+var componentMetaValidator = ajv.compile(componentMetaSchema);
+var actionSpecValidator = ajv.compile(actionSpecSchema);
+var dataQuerySpecValidator = ajv.compile(dataQuerySpecSchema);
+function convertAjvErrors(errors) {
+  if (!errors) return [];
+  return errors.map((error) => ({
+    path: error.instancePath || "/",
+    message: error.message || "Unknown error",
+    keyword: error.keyword,
+    expected: error.params,
+    actual: error.data
+  }));
+}
+function createResult(valid, errors) {
+  return {
+    valid,
+    errors: convertAjvErrors(errors)
+  };
+}
+function validatePage(data) {
+  const valid = pageValidator(data);
+  return createResult(valid, pageValidator.errors);
+}
+function validatePageSchema(data) {
+  const result = validatePage(data);
+  if (result.valid) {
+    return { ...result, data };
+  }
+  return result;
+}
+function assertPageSchema(data) {
+  const result = validatePage(data);
+  if (!result.valid) {
+    throw new Error(`Invalid PageSchema: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateComponentMeta(data) {
+  const valid = componentMetaValidator(data);
+  return createResult(valid, componentMetaValidator.errors);
+}
+function assertComponentMeta(data) {
+  const result = validateComponentMeta(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ComponentMeta: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateActionDefinition(data) {
+  const valid = actionSpecValidator(data);
+  return createResult(valid, actionSpecValidator.errors);
+}
+function assertActionDefinition(data) {
+  const result = validateActionDefinition(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ActionDefinition: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateActionRequest(data) {
+  const errors = [];
+  if (!data || typeof data !== "object") {
+    errors.push({ path: "/", message: "ActionExecuteRequest must be an object" });
+    return { valid: false, errors };
+  }
+  const obj = data;
+  if (typeof obj.actionType !== "string" || !obj.actionType) {
+    errors.push({ path: "/actionType", message: "actionType is required and must be a string" });
+  }
+  if (obj.params === void 0 || typeof obj.params !== "object") {
+    errors.push({ path: "/params", message: "params is required and must be an object" });
+  }
+  if (obj.context === void 0 || typeof obj.context !== "object") {
+    errors.push({ path: "/context", message: "context is required and must be an object" });
+  }
+  return { valid: errors.length === 0, errors };
+}
+function assertActionRequest(data) {
+  const result = validateActionRequest(data);
+  if (!result.valid) {
+    throw new Error(`Invalid ActionExecuteRequest: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateDataQueryDefinition(data) {
+  const valid = dataQuerySpecValidator(data);
+  return createResult(valid, dataQuerySpecValidator.errors);
+}
+function assertDataQueryDefinition(data) {
+  const result = validateDataQueryDefinition(data);
+  if (!result.valid) {
+    throw new Error(`Invalid DataQueryDefinition: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function validateQueryRequest(data) {
+  const errors = [];
+  if (!data || typeof data !== "object") {
+    errors.push({ path: "/", message: "DataQueryRequest must be an object" });
+    return { valid: false, errors };
+  }
+  const obj = data;
+  if (typeof obj.queryVersionId !== "string" || !obj.queryVersionId) {
+    errors.push({ path: "/queryVersionId", message: "queryVersionId is required and must be a string" });
+  }
+  if (obj.params === void 0 || typeof obj.params !== "object") {
+    errors.push({ path: "/params", message: "params is required and must be an object" });
+  }
+  return { valid: errors.length === 0, errors };
+}
+function assertQueryRequest(data) {
+  const result = validateQueryRequest(data);
+  if (!result.valid) {
+    throw new Error(`Invalid DataQueryRequest: ${result.errors.map((e) => e.message).join(", ")}`);
+  }
+}
+function isPageSchema(value) {
+  return validatePage(value).valid;
+}
+function isComponentMeta(value) {
+  return validateComponentMeta(value).valid;
+}
+function isActionDefinition(value) {
+  return validateActionDefinition(value).valid;
+}
+function isDataQueryDefinition(value) {
+  return validateDataQueryDefinition(value).valid;
+}
+function isActionRequest(value) {
+  return validateActionRequest(value).valid;
+}
+function isQueryRequest(value) {
+  return validateQueryRequest(value).valid;
+}
+function validatePages(items) {
+  const results = items.map((item, index) => {
+    const result = validatePage(item);
+    return {
+      index,
+      valid: result.valid,
+      data: result.valid ? item : void 0,
+      errors: result.errors
+    };
+  });
+  const validCount = results.filter((r) => r.valid).length;
+  return {
+    allValid: validCount === items.length,
+    validCount,
+    invalidCount: items.length - validCount,
+    results
+  };
+}
+function validateComponentMetas(items) {
+  const results = items.map((item, index) => {
+    const result = validateComponentMeta(item);
+    return {
+      index,
+      valid: result.valid,
+      data: result.valid ? item : void 0,
+      errors: result.errors
+    };
+  });
+  const validCount = results.filter((r) => r.valid).length;
+  return {
+    allValid: validCount === items.length,
+    validCount,
+    invalidCount: items.length - validCount,
+    results
+  };
+}
+export {
+  ajv,
+  assertActionDefinition,
+  assertActionRequest,
+  assertComponentMeta,
+  assertDataQueryDefinition,
+  assertPageSchema,
+  assertQueryRequest,
+  isActionDefinition,
+  isActionRequest,
+  isComponentMeta,
+  isDataQueryDefinition,
+  isPageSchema,
+  isQueryRequest,
+  validateActionDefinition,
+  validateActionRequest,
+  validateComponentMeta,
+  validateComponentMetas,
+  validateDataQueryDefinition,
+  validatePage,
+  validatePageSchema,
+  validatePages,
+  validateQueryRequest
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @djvlc/contracts-validators - DJV 低代码平台预编译校验器包\n *\n * 提供预编译的 Ajv 校验器，避免各仓库自行编写校验逻辑导致分叉\n *\n * @packageDocumentation\n */\n\nimport Ajv from 'ajv';\nimport addFormats from 'ajv-formats';\nimport {\n  pageSchema,\n  componentMetaSchema,\n  actionSpecSchema,\n  dataQuerySpecSchema,\n} from '@djvlc/contracts-schemas';\nimport type {\n  PageSchema,\n  ComponentMeta,\n  ActionDefinition,\n  DataQueryDefinition,\n  ActionExecuteRequest,\n  DataQueryRequest,\n} from '@djvlc/contracts-types';\n\n// ==================== 校验结果类型 ====================\n\n/**\n * 校验结果\n */\nexport interface ValidationResult {\n  /** 是否有效 */\n  valid: boolean;\n  /** 错误列表 */\n  errors: ValidationError[];\n}\n\n/**\n * 校验错误\n */\nexport interface ValidationError {\n  /** 错误路径 */\n  path: string;\n  /** 错误消息 */\n  message: string;\n  /** 错误关键字 */\n  keyword?: string;\n  /** 期望值 */\n  expected?: unknown;\n  /** 实际值 */\n  actual?: unknown;\n}\n\n// ==================== Ajv 实例 ====================\n\nconst ajv = new Ajv({\n  allErrors: true,\n  verbose: true,\n  strict: false,\n});\n\naddFormats(ajv);\n\n// 预编译 Schema\nconst pageValidator = ajv.compile(pageSchema);\nconst componentMetaValidator = ajv.compile(componentMetaSchema);\nconst actionSpecValidator = ajv.compile(actionSpecSchema);\nconst dataQuerySpecValidator = ajv.compile(dataQuerySpecSchema);\n\n// ==================== 工具函数 ====================\n\n/**\n * 将 Ajv 错误转换为标准格式\n */\nfunction convertAjvErrors(errors: typeof ajv.errors): ValidationError[] {\n  if (!errors) return [];\n\n  return errors.map((error) => ({\n    path: error.instancePath || '/',\n    message: error.message || 'Unknown error',\n    keyword: error.keyword,\n    expected: error.params,\n    actual: error.data,\n  }));\n}\n\n/**\n * 创建校验结果\n */\nfunction createResult(valid: boolean, errors: typeof ajv.errors): ValidationResult {\n  return {\n    valid,\n    errors: convertAjvErrors(errors),\n  };\n}\n\n\n// ==================== 页面校验 ====================\n\n/**\n * 校验 PageSchema\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validatePage(data: unknown): ValidationResult {\n  const valid = pageValidator(data);\n  return createResult(valid, pageValidator.errors);\n}\n\n/**\n * 校验 PageSchema，返回类型安全的结果\n */\nexport function validatePageSchema(data: unknown): ValidationResult & { data?: PageSchema } {\n  const result = validatePage(data);\n  if (result.valid) {\n    return { ...result, data: data as PageSchema };\n  }\n  return result;\n}\n\n/**\n * 断言为 PageSchema\n */\nexport function assertPageSchema(data: unknown): asserts data is PageSchema {\n  const result = validatePage(data);\n  if (!result.valid) {\n    throw new Error(`Invalid PageSchema: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== 组件元数据校验 ====================\n\n/**\n * 校验 ComponentMeta\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateComponentMeta(data: unknown): ValidationResult {\n  const valid = componentMetaValidator(data);\n  return createResult(valid, componentMetaValidator.errors);\n}\n\n/**\n * 断言为 ComponentMeta\n */\nexport function assertComponentMeta(data: unknown): asserts data is ComponentMeta {\n  const result = validateComponentMeta(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ComponentMeta: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== Action 校验 ====================\n\n/**\n * 校验 ActionDefinition\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateActionDefinition(data: unknown): ValidationResult {\n  const valid = actionSpecValidator(data);\n  return createResult(valid, actionSpecValidator.errors);\n}\n\n/**\n * 断言为 ActionDefinition\n */\nexport function assertActionDefinition(data: unknown): asserts data is ActionDefinition {\n  const result = validateActionDefinition(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ActionDefinition: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n/**\n * 校验 ActionExecuteRequest\n */\nexport function validateActionRequest(data: unknown): ValidationResult {\n  const errors: ValidationError[] = [];\n\n  if (!data || typeof data !== 'object') {\n    errors.push({ path: '/', message: 'ActionExecuteRequest must be an object' });\n    return { valid: false, errors };\n  }\n\n  const obj = data as Record<string, unknown>;\n\n  if (typeof obj.actionType !== 'string' || !obj.actionType) {\n    errors.push({ path: '/actionType', message: 'actionType is required and must be a string' });\n  }\n\n  if (obj.params === undefined || typeof obj.params !== 'object') {\n    errors.push({ path: '/params', message: 'params is required and must be an object' });\n  }\n\n  if (obj.context === undefined || typeof obj.context !== 'object') {\n    errors.push({ path: '/context', message: 'context is required and must be an object' });\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\n/**\n * 断言为 ActionExecuteRequest\n */\nexport function assertActionRequest(data: unknown): asserts data is ActionExecuteRequest {\n  const result = validateActionRequest(data);\n  if (!result.valid) {\n    throw new Error(`Invalid ActionExecuteRequest: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== Data Query 校验 ====================\n\n/**\n * 校验 DataQueryDefinition\n * @param data 待校验数据\n * @returns 校验结果\n */\nexport function validateDataQueryDefinition(data: unknown): ValidationResult {\n  const valid = dataQuerySpecValidator(data);\n  return createResult(valid, dataQuerySpecValidator.errors);\n}\n\n/**\n * 断言为 DataQueryDefinition\n */\nexport function assertDataQueryDefinition(data: unknown): asserts data is DataQueryDefinition {\n  const result = validateDataQueryDefinition(data);\n  if (!result.valid) {\n    throw new Error(`Invalid DataQueryDefinition: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n/**\n * 校验 DataQueryRequest\n */\nexport function validateQueryRequest(data: unknown): ValidationResult {\n  const errors: ValidationError[] = [];\n\n  if (!data || typeof data !== 'object') {\n    errors.push({ path: '/', message: 'DataQueryRequest must be an object' });\n    return { valid: false, errors };\n  }\n\n  const obj = data as Record<string, unknown>;\n\n  if (typeof obj.queryVersionId !== 'string' || !obj.queryVersionId) {\n    errors.push({ path: '/queryVersionId', message: 'queryVersionId is required and must be a string' });\n  }\n\n  if (obj.params === undefined || typeof obj.params !== 'object') {\n    errors.push({ path: '/params', message: 'params is required and must be an object' });\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\n/**\n * 断言为 DataQueryRequest\n */\nexport function assertQueryRequest(data: unknown): asserts data is DataQueryRequest {\n  const result = validateQueryRequest(data);\n  if (!result.valid) {\n    throw new Error(`Invalid DataQueryRequest: ${result.errors.map((e) => e.message).join(', ')}`);\n  }\n}\n\n// ==================== 类型保护函数 ====================\n\n/**\n * 检查是否为有效的 PageSchema\n */\nexport function isPageSchema(value: unknown): value is PageSchema {\n  return validatePage(value).valid;\n}\n\n/**\n * 检查是否为有效的 ComponentMeta\n */\nexport function isComponentMeta(value: unknown): value is ComponentMeta {\n  return validateComponentMeta(value).valid;\n}\n\n/**\n * 检查是否为有效的 ActionDefinition\n */\nexport function isActionDefinition(value: unknown): value is ActionDefinition {\n  return validateActionDefinition(value).valid;\n}\n\n/**\n * 检查是否为有效的 DataQueryDefinition\n */\nexport function isDataQueryDefinition(value: unknown): value is DataQueryDefinition {\n  return validateDataQueryDefinition(value).valid;\n}\n\n/**\n * 检查是否为有效的 ActionExecuteRequest\n */\nexport function isActionRequest(value: unknown): value is ActionExecuteRequest {\n  return validateActionRequest(value).valid;\n}\n\n/**\n * 检查是否为有效的 DataQueryRequest\n */\nexport function isQueryRequest(value: unknown): value is DataQueryRequest {\n  return validateQueryRequest(value).valid;\n}\n\n// ==================== 批量校验 ====================\n\n/**\n * 批量校验结果\n */\nexport interface BatchValidationResult<T> {\n  /** 全部有效 */\n  allValid: boolean;\n  /** 有效项数量 */\n  validCount: number;\n  /** 无效项数量 */\n  invalidCount: number;\n  /** 各项结果 */\n  results: Array<{\n    index: number;\n    valid: boolean;\n    data?: T;\n    errors: ValidationError[];\n  }>;\n}\n\n/**\n * 批量校验 PageSchema\n */\nexport function validatePages(items: unknown[]): BatchValidationResult<PageSchema> {\n  const results = items.map((item, index) => {\n    const result = validatePage(item);\n    return {\n      index,\n      valid: result.valid,\n      data: result.valid ? (item as PageSchema) : undefined,\n      errors: result.errors,\n    };\n  });\n\n  const validCount = results.filter((r) => r.valid).length;\n\n  return {\n    allValid: validCount === items.length,\n    validCount,\n    invalidCount: items.length - validCount,\n    results,\n  };\n}\n\n/**\n * 批量校验 ComponentMeta\n */\nexport function validateComponentMetas(items: unknown[]): BatchValidationResult<ComponentMeta> {\n  const results = items.map((item, index) => {\n    const result = validateComponentMeta(item);\n    return {\n      index,\n      valid: result.valid,\n      data: result.valid ? (item as ComponentMeta) : undefined,\n      errors: result.errors,\n    };\n  });\n\n  const validCount = results.filter((r) => r.valid).length;\n\n  return {\n    allValid: validCount === items.length,\n    validCount,\n    invalidCount: items.length - validCount,\n    results,\n  };\n}\n\n// ==================== 导出 Ajv 实例（供高级用法） ====================\n\nexport { ajv };\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@djvlc/contracts-validators",
+  "version": "1.2.0",
+  "description": "DJV Low-code Platform - 预编译的 Ajv 校验器包",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@djvlc/contracts-types": "1.2.0",
+    "@djvlc/contracts-schemas": "1.2.0",
+    "ajv": "^8.12.0",
+    "ajv-formats": "^3.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.56.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "keywords": [
+    "lowcode",
+    "contracts",
+    "validators",
+    "ajv",
+    "djvlc"
+  ],
+  "author": "DJV Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/djvlc/contracts.git",
+    "directory": "packages/contracts-validators"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}