@agile-team/mach-report 2.15.0 → 2.17.0

package/dist/dataset-IrlXbUvh.cjs

@@ -0,0 +1 @@
+"use strict";function u(e){throw new Error(`数据契约无效：${e}`)}function d(e){return typeof e=="string"&&e.trim().length>0&&e.length<=4096}function y(e){for(const n of["description","missingMeaning"])e[n]!==void 0&&!d(e[n])&&u(`${n} 应为 1–4096 位非空字符串`);e.aggregation!==void 0&&!["sum","avg","min","max","count","none"].includes(e.aggregation)&&u("未知字段聚合语义"),e.aggregation&&!["count","none"].includes(e.aggregation)&&!["number","decimal"].includes(e.type)&&u("数值聚合仅适用于 number/decimal"),e.format!==void 0&&l(e),e.calculation!==void 0&&(!e.calculation||!d(e.calculation.description)||!Array.isArray(e.calculation.dependsOn)||!e.calculation.dependsOn.length||e.calculation.dependsOn.length>256||e.calculation.dependsOn.some(n=>typeof n!="string"||!n.trim())||new Set(e.calculation.dependsOn).size!==e.calculation.dependsOn.length)&&u("计算说明需包含说明及 1–256 个唯一依赖字段")}function l(e){const n=e.format;if((!n||!["number","percent","date"].includes(n.kind))&&u("未知字段显示格式"),n.kind==="date"){(e.type!=="date"||n.pattern!==void 0&&(!d(n.pattern)||n.pattern.length>128))&&u("日期格式仅适用于日期，pattern 最多 128 位");return}["number","decimal"].includes(e.type)||u("数值显示格式仅适用于 number/decimal"),n.digits!==void 0&&(!Number.isSafeInteger(n.digits)||n.digits<0||n.digits>100)&&u("显示小数位应为 0–100 的整数"),n.kind==="number"&&n.thousands!==void 0&&typeof n.thousands!="boolean"&&u("thousands 应为布尔值")}function b(e){const n=new Map(e.map(i=>[i.field,i])),t=new Set;for(const i of e){const o=[{field:i.field,exit:!1}],m=new Set;for(;o.length;){const s=o.pop();if(s.exit){m.delete(s.field),t.add(s.field);continue}if(m.has(s.field)&&u("字段计算依赖存在循环"),t.has(s.field))continue;const r=n.get(s.field);r||u(`计算依赖字段未声明：${s.field}`),m.add(s.field),o.push({field:s.field,exit:!0});for(const c of r.calculation?.dependsOn??[])o.push({field:c,exit:!1})}}}const x=["text","number","boolean","date","decimal"],w=new Set(["__proto__","prototype","constructor"]);function a(e){throw new Error(`数据契约无效：${e}`)}function h(e){(!e||!Array.isArray(e.fields)||!e.fields.length||e.fields.length>2048)&&a("fields 应包含 1–2048 个字段");const n=new Set;for(const t of e.fields)(!t||typeof t.field!="string"||!t.field.trim()||w.has(t.field)||n.has(t.field))&&a("字段名应安全、非空且唯一"),n.add(t.field),x.includes(t.type)||a(`未知字段类型 ${t.type}`),k(t),$(t),y(t),v(t);L(e,n),b(e.fields)}function v(e){e.enum!==void 0&&(!Array.isArray(e.enum)||!e.enum.length||e.enum.some(n=>!f(n,e.type)))&&a("enum 应为匹配字段类型的非空标量数组")}function L(e,n){e.rowKey!==void 0&&((typeof e.rowKey!="string"||!e.rowKey.trim()||!n.has(e.rowKey))&&a("rowKey 应为引用已声明字段的非空字符串"),e.fields.find(t=>t.field===e.rowKey)?.type==="boolean"&&a("布尔字段不能作为业务主键"))}function $(e){for(const n of["label","unit"])e[n]!==void 0&&typeof e[n]!="string"&&a(`${n} 应为字符串`);for(const n of["required","nullable"])e[n]!==void 0&&typeof e[n]!="boolean"&&a(`${n} 应为布尔值`);e.semanticRole!==void 0&&!["identifier","dimension","measure","date","text"].includes(e.semanticRole)&&a("未知字段语义")}function k(e){for(const n of["min","max","minLength","maxLength"]){const t=e[n];t!==void 0&&(!Number.isFinite(t)||n.includes("Length")&&(!Number.isInteger(t)||t<0))&&a(`${n} 无效`)}e.min!==void 0&&e.max!==void 0&&e.min>e.max&&a("min 不能超过 max"),e.minLength!==void 0&&e.maxLength!==void 0&&e.minLength>e.maxLength&&a("minLength 不能超过 maxLength"),e.type!=="number"&&(e.min!==void 0||e.max!==void 0)&&a("min/max 仅适用于 number，精确小数文本需业务校验"),["number","boolean"].includes(e.type)&&(e.minLength!==void 0||e.maxLength!==void 0)&&a("长度约束仅适用于文本类型")}function S(e){const n=/^(\d{4})-(\d{2})-(\d{2})$/.exec(e);if(!n)return!1;const t=Number(n[1]),i=Number(n[2]),o=Number(n[3]),m=t%4===0&&(t%100!==0||t%400===0);return t>0&&i>=1&&i<=12&&o>=1&&o<=[31,m?29:28,31,30,31,30,31,31,30,31,30,31][i-1]}function f(e,n){return n==="number"?typeof e=="number"&&Number.isFinite(e):n==="boolean"?typeof e=="boolean":typeof e!="string"?!1:n==="date"?S(e):n==="decimal"?e.length<=1e4&&/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(e):!0}function O(e,n){if(e==null)return n.required||e===null&&n.nullable===!1?{code:"required",message:"缺少必需字段值"}:void 0;if(!f(e,n.type))return{code:"type",message:`值应为 ${n.type}，不会自动转换原始值`};if(n.enum&&!n.enum.includes(e))return{code:"enum",message:"值不在允许的枚举中"};if(typeof e=="number"&&(n.min!==void 0&&e<n.min||n.max!==void 0&&e>n.max))return{code:"range",message:"数值超出范围"};if(typeof e=="string"&&!K(e,n))return{code:"range",message:"文本长度超出范围"}}function K(e,n){if(n.minLength===void 0&&n.maxLength===void 0)return!0;let t=0;for(const i of e)t++;return(n.minLength===void 0||t>=n.minLength)&&(n.maxLength===void 0||t<=n.maxLength)}function g(e,n){const t=e??n;if(!Number.isInteger(t)||t<1)throw new Error("数据校验预算应为正整数");return t}function A(e,n,t){const i=Object.prototype.hasOwnProperty.call(e,n)?e[n]:void 0;if((typeof i!="string"||!i.trim())&&!(typeof i=="number"&&Number.isFinite(i)))return"业务主键应为非空字符串或有限数字";const o=JSON.stringify([typeof i,i]);if(t.has(o))return"业务主键重复";t.add(o)}function N(e,n,t={}){h(n);const i=t.path??"$.rows",o=[],m=g(t.maxIssues,100);if(!Array.isArray(e))return{ok:!1,issues:[{code:"row",path:i,message:"数据集应为对象数组"}]};if(e.length>g(t.maxRows,1e5)||e.length*n.fields.length>g(t.maxCells,2e6))return{ok:!1,issues:[{code:"budget",path:i,message:"数据校验超出行数或单元格预算"}]};const s=new Set;for(let r=0;r<e.length&&o.length<m;r++){const c=e[r];if(!c||typeof c!="object"||Array.isArray(c)){o.push({code:"row",path:`${i}[${r}]`,rowIndex:r,message:"行应为对象"});continue}R(c,n,r,i,s,o,m)}return{ok:o.length===0,issues:o}}function R(e,n,t,i,o,m,s){for(const r of n.fields){if(m.length>=s)return;const c=O(Object.prototype.hasOwnProperty.call(e,r.field)?e[r.field]:void 0,r);c&&m.push({...c,rowIndex:t,field:r.field,path:`${i}[${t}].${r.field}`})}if(n.rowKey&&m.length<s){const r=A(e,n.rowKey,o);r&&m.push({code:"row-key",path:`${i}[${t}].${n.rowKey}`,message:r,rowIndex:t,field:n.rowKey})}}function E(e){return h(e),{$schema:"https://json-schema.org/draft/2020-12/schema",type:"array",items:{type:"object",properties:Object.fromEntries(e.fields.map(t=>[t.field,M(t,t.field===e.rowKey)])),required:e.fields.filter(t=>t.required||t.field===e.rowKey).map(t=>t.field),additionalProperties:!0},...e.rowKey?{"x-report-rowKey":e.rowKey}:{}}}function M(e,n){const t=!n&&e.nullable!==!1&&!e.required;return{type:t?[p(e.type),"null"]:p(e.type),...e.label?{title:e.label}:{},...e.description?{description:e.description}:{},...e.type==="date"?{format:"date"}:{},...e.type==="decimal"?{pattern:"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"}:{},...e.enum?{enum:t?[...e.enum,null]:[...e.enum]}:{},...e.min===void 0?{}:{minimum:e.min},...e.max===void 0?{}:{maximum:e.max},...j(e,n),...n&&e.type==="text"?{pattern:"\\S"}:{},...e.unit?{"x-report-unit":e.unit}:{},...e.semanticRole?{"x-report-semanticRole":e.semanticRole}:{},...e.aggregation?{"x-report-aggregation":e.aggregation}:{},...e.format?{"x-report-format":{...e.format}}:{},...e.missingMeaning?{"x-report-missingMeaning":e.missingMeaning}:{},...e.calculation?{"x-report-calculation":{description:e.calculation.description,dependsOn:[...e.calculation.dependsOn]}}:{}}}function j(e,n){const t={};return(e.minLength!==void 0||n&&e.type!=="number")&&(t.minLength=Math.max(e.minLength??0,n?1:0)),e.type==="decimal"?t.maxLength=Math.min(e.maxLength??1e4,1e4):e.maxLength!==void 0&&(t.maxLength=e.maxLength),t}function p(e){return e==="text"||e==="date"||e==="decimal"?"string":e}exports.datasetJsonSchema=E;exports.validateDatasetRows=N;