bdip-office-assistant-cli 0.0.0-stage → 1.0.0

package/dist/field-preparation.js

@@ -0,0 +1,185 @@
+import {definitions,detailTables,fingerprint,loadAdapter,buildDraft,verifyDraft} from './workflow-runtime.js';
+import {createApiFromProfile} from './client.js';
+
+const clone=x=>structuredClone(x);
+const cell=x=>x&&typeof x==='object'&&'value'in x?clone(x):{value:x??''};
+const fieldKey=id=>String(id).replace(/^field/,'');
+const equal=(a,b)=>JSON.stringify(a)===JSON.stringify(b);
+export function paragraphText(value,field) {
+    if(Number(field?.htmltype)!==2 || Number(field?.detailtype)!==2 || !/[\r\n]/.test(String(value)) || /<[^>]+>/.test(String(value))) return value;
+    const escape=s=>s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+    return String(value).replace(/\r\n/g,'\n').split('\n').map(line=>'<p>'+escape(line)+'</p>').join('');
+}
+
+const fail=(state,message)=>{const error=Error(message);error.preparationState=state;throw error;};
+export function stableConfig(value) {
+    if(Array.isArray(value))return value.map(stableConfig);
+    if(value&&typeof value==='object')return Object.fromEntries(Object.keys(value).sort().filter(k=>!['systemdatas','files','linkageUUID','currenttime','signatureSecretKey','signatureAttributesStr','formulakey'].includes(k)).map(k=>[k,stableConfig(value[k])]));
+    return value;
+}
+// 小语法解释器：字段引用、字符串、IF和相等判断；从不执行服务器JavaScript。
+export function formulaValue(text,read) {
+    const tokens=text.match(/\[(?:main|detail_\d+)\.-?\d+\]|'(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"|==|!=|IF|[(),]|\s+|-?\d+(?:\.\d+)?/g)??[];
+    if(tokens.join('')!==text)fail('unsupported','不支持的公式语法');
+    const ts=tokens.filter(t=>!/^\s+$/.test(t));let i=0;
+    const primary=()=>{
+        const t=ts[i++];
+        if(t==='IF'){if(ts[i++]!=='(')throw Error('IF语法');const cond=expr();if(ts[i++]!==',')throw Error('IF语法');const yes=expr();if(ts[i++]!==',')throw Error('IF语法');const no=expr();if(ts[i++]!==')')throw Error('IF语法');return cond?yes:no;}
+        if(/^\[/.test(t??''))return read(t.slice(1,-1));
+        if(/^['"]/.test(t??''))return t.slice(1,-1);
+        if(/^-?\d/.test(t??''))return t;
+        fail('unsupported','无法解释公式');
+    };
+    const expr=()=>{let a=primary();if(ts[i]==='=='||ts[i]==='!='){const op=ts[i++],b=primary();a=op==='=='?String(a)===String(b):String(a)!==String(b);}return a;};
+    const result=expr();if(i!==ts.length)fail('unsupported','公式存在未处理内容');return result;
+}
+export async function executeLinkages(api,form,tables,input,{maxSteps=100,covered=[]}={}) {
+    const f=clone(form),t=clone(tables),defs=definitions(f),cfg=f.linkageCfg??{};
+    const evidence={state:'preparing',coverage:[],rowChanges:[]};
+    // 未支持的配置必须明确由已验证适配承担，不能吞错继续。
+    for(const [kind,data]of Object.entries(cfg))if(!['formulaCfg','dataInputCfg','fieldSqlCfg'].includes(kind)&&JSON.stringify(data)!=='{}'&&JSON.stringify(data)!=='[]'&&!covered.includes(kind))fail('unsupported','联动配置尚未支持：'+kind);
+    const getCells=(table,row)=>table==='main'?f.maindata:t[table]?.rows[row];
+    const protectedValues=new Map();
+    const write=(table,row,id,value,source)=>{
+        const field=defs.find(x=>x.table===table&&x.id===String(id));if(!field)fail('unsupported','联动目标字段不存在：'+id);
+        const cells=getCells(table,row);if(!cells)fail('unsupported','联动行不存在');
+        const next=cell(value),key=`${table}.${id}:${row}`;
+        if(protectedValues.has(key)&&String(next.value)!==String(protectedValues.get(key)))fail('conflict','用户值与联动冲突：'+id);
+        if(String(cells['field'+id]?.value??'')===String(next.value)&&(!next.specialobj||equal(cells['field'+id]?.specialobj,next.specialobj)))return false;
+        cells['field'+id]=next;return true;
+    };
+    for(let [raw,v]of Object.entries(input.values??{})){
+        const id=fieldKey(raw);if(Number(id)<0)continue;
+        const d=defs.find(x=>x.id===id&&x.table==='main');if(!d||![2,3].includes(Number(d.viewattr)))fail('conflict','禁止用户覆盖只读/隐藏字段：'+id);
+        v=paragraphText(v,d);
+        write('main',-1,id,{value:v,specialobj:input.browserNames?.[id]?[{name:input.browserNames[id]}]:undefined});protectedValues.set(`main.${id}:-1`,v);
+    }
+    for(const dt of input.details??[]){const mark='detail_'+(Number(dt.index)+1);if(!t[mark])fail('unsupported','明细不存在');
+        if(input.requestId&&t[mark].rows.length!==dt.rows.length)fail('unsupported','用户增删明细需专门适配');
+        if(!input.requestId)t[mark].rows=dt.rows.map(()=>clone(t[mark].addRowDefValue??{}));
+        dt.rows.forEach((row,i)=>Object.entries(row).forEach(([raw,v])=>{const id=fieldKey(raw),d=defs.find(x=>x.id===id&&x.table===mark);if(!d||![2,3].includes(Number(d.viewattr)))fail('conflict','禁止用户覆盖只读明细：'+id);v=paragraphText(v,d);write(mark,i,id,{value:v,specialobj:input.detailBrowserNames?.[dt.index]?.[i]?.[id]?[{name:input.detailBrowserNames[dt.index][i][id]}]:undefined});protectedValues.set(`${mark}.${id}:${i}`,v);}));
+    }
+    const seen=new Map();let steps=0;
+    const formulas=cfg.formulaCfg?.formulas??[];
+    for(let pass=0;pass<maxSteps;pass++){
+        let changed=false;
+        for(const rule of formulas){
+            const m=String(rule.formula??'').match(/^\[(main|detail_\d+)\.(-?\d+)\]\s*=\s*(.*)$/);if(!m)fail('unsupported','公式目标语法不支持');
+            const [,table,id,expression]=m;
+            const rows=table==='main'?[-1]:(t[table]?.rows??[]).map((_,i)=>i);
+            for(const row of rows){const read=ref=>{const [tab,fid]=ref.split('.');return getCells(tab,tab==='main'?-1:row)?.['field'+fid]?.value??'';};
+                const value=formulaValue(expression,read);
+                const sourceRef=expression.trim().match(/^\[(main|detail_\d+)\.(\d+)\]$/);
+                const next=sourceRef?getCells(sourceRef[1],sourceRef[1]==='main'?-1:row)?.['field'+sourceRef[2]]:{value};
+                // 双向互拷贝以非空输入为起点；未设置一端不能清掉另一端。
+                if(sourceRef&&String(next?.value??'')===''&&String(getCells(table,row)?.['field'+id]?.value??'')!=='')continue;
+                changed=write(table,row,id,next??{value},'formula')||changed;
+                evidence.coverage.push({kind:'formula',target:table+'.'+id,row,state:'executed'});
+            }
+        }
+        for(const [trigger,rules]of Object.entries(cfg.fieldSqlCfg??{}))for(const rule of rules){
+            const targetIds=String(rule.assignField??'').split(',').filter(Boolean);
+            const targetDefs=targetIds.map(id=>defs.find(d=>d.id===id));
+            if(!targetDefs.length||targetDefs.some(d=>!d))fail('unsupported','SQL字段查询目标未知');
+            const table=targetDefs[0].table;
+            if(targetDefs.some(d=>d.table!==table))fail('unsupported','SQL字段查询跨表目标需适配');
+            for(const row of table==='main'?[-1]:(t[table]?.rows??[]).map((_,i)=>i)){
+                const params={};
+                for(const id of rule.relateFields??[]){const def=defs.find(d=>d.id===String(id));if(!def)fail('unsupported','SQL依赖字段不存在');params['field'+id+(def.table==='main'?'':'_'+row)]=getCells(def.table,def.table==='main'?-1:row)?.['field'+id]?.value??'';}
+                const key='sql:'+rule.config+':'+row,signature=JSON.stringify(params);if(seen.get(key)===signature)continue;
+                if(++steps>maxSteps)fail('nonconvergent','字段查询超限');seen.set(key,signature);
+                const p=f.params,body={...params,requestid:String(input.requestId??'-1'),workflowid:String(input.workflowId),nodeid:String(p.nodeid),formid:String(p.formid),isbill:String(p.isbill??'1'),triSource:'1',showAI:'1',linkageid:String(rule.config),linkageUUID:f.submitParams.linkageUUID??'',
+                    ['triFieldid_'+rule.config]:trigger==='emptyTriField'?'':trigger,['rowIndexStr_'+rule.config]:String(row),['triTableMark_'+rule.config]:table,f_weaver_belongto_userid:input.accountId,f_weaver_belongto_usertype:String(p.f_weaver_belongto_usertype??'0')};
+                const response=await api.post('/api/workflow/linkage/reqFieldSqlResult',body,{forceCookie:true});const info=response.json?.['assignInfo_'+rule.config];
+                if(!info||info.resultOutOfLimit||response.json?.status===false)fail('failed','字段查询失败：'+rule.config);
+                for(const key of Object.keys(info))if(!['changeValue','linkageSql','resultOutOfLimit'].includes(key))fail('unsupported','字段查询响应未支持：'+key);
+                for(const [raw,value]of Object.entries(info.changeValue??{})){const m=raw.match(/^field(\d+)(?:_(\d+))?$/);if(!m)fail('unsupported','SQL目标格式未知');const d=defs.find(d=>d.id===m[1]);changed=write(d?.table,m[2]?Number(m[2]):d?.table==='main'?-1:row,m[1],value,'server')||changed;}
+                evidence.coverage.push({kind:'fieldSql',config:String(rule.config),row,state:'executed'});
+            }
+        }
+        for(const [raw,configs]of Object.entries(cfg.dataInputCfg??{})){
+            const id=fieldKey(raw),d=defs.find(x=>x.id===id);if(!d||!Array.isArray(configs))fail('unsupported','数据联动配置无效');
+            for(const row of d.table==='main'?[-1]:(t[d.table]?.rows??[]).map((_,i)=>i))for(const rule of configs){
+                const key=`${rule.config}:${d.table}:${row}`;
+                const values={};for(const field of defs){const cells=getCells(field.table,field.table==='main'?-1:row);if(cells?.['field'+field.id])values['field'+field.id]=cells['field'+field.id].value;}
+                const signature=JSON.stringify(values);if(seen.get(key)===signature)continue;
+                if(++steps>maxSteps)fail('nonconvergent','联动超限或循环不收敛');seen.set(key,signature);
+                const p=f.params,sp=f.submitParams;
+                const body={...values,requestid:String(input.requestId??'-1'),workflowid:String(input.workflowId),nodeid:String(p.nodeid),formid:String(p.formid),isbill:String(p.isbill??'1'),triSource:'1',showAI:'1',linkageid:String(rule.config),linkageUUID:sp.linkageUUID??'',
+                    [`triFieldid_${rule.config}`]:id,[`rowIndexStr_${rule.config}`]:String(row),[`triTableMark_${rule.config}`]:d.table,f_weaver_belongto_userid:input.accountId,f_weaver_belongto_usertype:String(p.f_weaver_belongto_usertype??'0')};
+                if(row>=0)for(const [k,v]of Object.entries(values))body[k+'_'+row]=v;
+                for(const assigned of rule.otherParams?.assignfields??[]) {
+                    const assignedDef=defs.find(x=>x.id===String(assigned));
+                    const dependencies=assignedDef?.browserattr?.cusDependShip??[];
+                    if(dependencies.length){const depend={};for(const dep of dependencies){const d=defs.find(x=>x.id===String(dep.fieldid));if(!d)fail('unsupported','自定义浏览框依赖不存在');const c=getCells(d.table,d.table==='main'?-1:row);if(!c)fail('unsupported','缺少自定义浏览框同行依赖');depend[dep.key]=c['field'+dep.fieldid]?.value??'';}body['customDepend_field'+assigned+(assignedDef.table==='main'?'':'_'+row)]=JSON.stringify(depend);}
+                }
+                const r=await api.post('/api/workflow/linkage/reqDataInputResult',body,{forceCookie:true});
+                const info=r.json?.['assignInfo_'+rule.config];if(!info||info.resultOutOfLimit||info.error||r.json?.status===false)fail('failed','数据联动失败/超限：'+rule.config);
+                for(const k of Object.keys(info))if(!['linkageSql','changeValue','addDetailRow','resultOutOfLimit'].includes(k))fail('unsupported','联动响应操作未支持：'+k);
+                for(const [target,v]of Object.entries(info.changeValue??{})){
+                    const match=target.match(/^field(\d+)(?:_(\d+))?$/);if(!match)fail('unsupported','联动目标格式未知');const dest=defs.find(x=>x.id===match[1]);
+                    changed=write(dest?.table,match[2]?Number(match[2]):dest?.table==='main'?-1:row,match[1],v,'server')||changed;
+                }
+                for(const [mark,rows]of Object.entries(info.addDetailRow??{})){
+                    if(!Array.isArray(rows)||!t[mark])fail('unsupported','联动新增明细格式未知');
+                    const existing=t[mark].rows,used=new Set();
+                    const result=rows.map(r=>{const fields=Object.keys(r);const index=existing.findIndex((e,i)=>!used.has(i)&&fields.every(k=>String(e[k]?.value??'')===String(r[k]?.value??'')));if(index>=0)used.add(index);return {...clone(t[mark].addRowDefValue??{}),...(index>=0?existing[index]:{}),...r};});
+                    if(String(rule.otherParams?.isdel)==='1'){
+                        if(existing.some((e,i)=>e.keyid&&!used.has(i)))fail('unsupported','联动删除/替换已有明细需经验证的行删除适配');
+                        if(!equal(existing,result)){t[mark].rows=result;changed=true;}
+                    }else{
+                        const additions=result.filter(r=>!existing.some(e=>Object.keys(r).filter(k=>k!=='keyid').every(k=>equal(e[k],r[k]))));
+                        if(additions.length){existing.push(...additions);changed=true;}
+                    }
+                    evidence.rowChanges.push({config:String(rule.config),table:mark,rows:t[mark].rows.length,mode:String(rule.otherParams?.isdel)==='1'?'replace':'append'});
+                }
+                evidence.coverage.push({kind:'dataInput',config:String(rule.config),row,state:'executed'});
+            }
+        }
+        if(!changed){for(const [key,value]of protectedValues){const [ref,row]=key.split(':');const [table,id]=ref.split('.');if(String(getCells(table,Number(row))?.['field'+id]?.value??'')!==String(value))fail('conflict','联动明细覆盖用户值：'+id);}evidence.state='complete';return {form:f,tables:t,evidence};}
+    }
+    fail('nonconvergent','联动循环未收敛');
+}
+export async function prepareFields(cfg,plan,{api,form,tables}={}) {
+    api??=await createApiFromProfile(cfg);
+    if(!form){const r=await api.post('/api/workflow/reqform/loadForm',{workflowid:String(plan.workflowId),requestid:String(plan.requestId??'-1'),iscreate:plan.requestId?'0':'1'},{forceCookie:true});form=r.json;}
+    if(form?.params?.verifyRight!==true||String(form.params.currentUserid)!==String(plan.accountId))throw Error('账号或表单权限不符');
+    tables??=await detailTables(api,form,plan.workflowId,plan.requestId);
+    const adapter=await loadAdapter(cfg,plan.workflowId,form);
+    if(adapter?.prepare)await adapter.prepare({plan,form,tables,mapping:adapter.mapping});
+    const linked=await executeLinkages(api,form,tables,plan,{covered:adapter?.supportedLinkageKinds??[]});
+    const prepared=buildDraft({...plan,serverResolved:true,values:{},details:[],browserNames:{},detailBrowserNames:{}},linked.form,linked.tables);
+    // buildDraft receives only server/proven state; user permissions were checked before execution.
+    prepared.expected.coverage=linked.evidence;
+    prepared.expected.adapterDigest=adapter?.scriptDigest??null;
+    prepared.expected.originalFingerprint=fingerprint(form);
+    return {...prepared,evidence:linked.evidence,baseline:baseline(form,tables)};
+}
+export async function checkAdapter(cfg,plan,form) {
+    const adapter=await loadAdapter(cfg,plan.workflowId,form);
+    if((adapter?.scriptDigest??null)!==plan.prepared.expected.adapterDigest)throw Error('适配逻辑变化，请重新预览');
+}
+export function baseline(form,tables) {
+    const values=cells=>Object.fromEntries(Object.entries(cells??{}).filter(([k])=>/^field\d+$/.test(k)).map(([k,c])=>[k,{value:c?.value??'',specialobj:Array.isArray(c?.specialobj)?c.specialobj.map(x=>({id:x.id,name:x.name})):undefined}]));
+    return {main:values(form.maindata),details:Object.fromEntries(Object.entries(tables).map(([mark,t])=>[mark,t.rows.map(row=>({keyid:row.keyid,fields:values(row)}))]))};
+}
+export function checkBaseline(prepared,form,tables) {
+    if(!equal(prepared.baseline,baseline(form,tables)))throw Error('服务器默认值或原稿内容变化，请重新预览；不会静默重算');
+}
+export function classifyWrite(response,requestId) {
+    const data=response.json?.data??response.json??{},type=data.type;
+    return {responseType:type,requestId:data.resultInfo?.requestid??data.requestid??requestId,
+        state:type==='FAILD'||type==='FAILED'||data.status===false?'failed':type==='SUCCESS'?'written-unverified':'uncertain',messageInfo:data.messageInfo??response.json?.msg};
+}
+export function actionBody(prepared,form,action='save') {
+    if(!['save','submit'].includes(action)||prepared.expected?.coverage?.state!=='complete')throw Error('字段准备/联动覆盖未完成');
+    if(fingerprint(form)!==prepared.expected.originalFingerprint)throw Error('表单配置变化，请重新预览');
+    const business=Object.fromEntries(Object.entries(prepared.body).filter(([k])=>/^field|^nodesnum|^indexnum|^submitdtlid|^dtl_id_|^deldtlid|FieldUnEmptyCount$/.test(k)||['existChangeRange','requestname','requestid','iscreate'].includes(k)));
+    const body={...prepared.body,...form.submitParams,...business,signatureAttributesStr:String(form.params.signatureAttributesStr??''),signatureSecretKey:String(form.params.signatureSecretKey??''),src:action,isaffirmance:'0',isaffirmanceSrc:''};
+    if(String(form.params.currentUserid)!==prepared.expected.accountId)throw Error('执行账号已变化');
+    return body;
+}
+export function verifyAction(expected,form,tables,action='save') {
+    if(expected.coverage?.state!=='complete')return ['联动覆盖未完成'];
+    return verifyDraft(expected,form,tables,{action});
+}

package/dist/fileutil.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/** 下载文件不覆盖用户已有文件；重名时追加 (1)、(2)… */
+export function nextAvailablePath(outDir, filename) {
+    const parsed = path.parse(filename);
+    let candidate = path.join(outDir, filename);
+    for (let index = 1; fs.existsSync(candidate); index++)
+        candidate = path.join(outDir, `${parsed.name} (${index})${parsed.ext}`);
+    return candidate;
+}
+
+/** 接受 OOXML zip 或传统 OLE Excel；拒绝 HTML 登录页、JSON 错误和空响应。 */
+export function assertExcelLike(buf, label = 'Excel 文件') {
+    const isZip = Buffer.isBuffer(buf) && buf.length >= 64 && buf.readUInt32LE(0) === 0x04034b50;
+    const isOle = Buffer.isBuffer(buf) && buf.length >= 512 && buf.subarray(0, 8).equals(Buffer.from('D0CF11E0A1B11AE1', 'hex'));
+    if (!isZip && !isOle)
+        throw new Error(`${label}响应不是有效的 xls/xlsx，可能是登录页或错误页。`);
+    return { format: isZip ? 'xlsx' : 'xls', size: buf.length };
+}