@tbox.cn/app-toolkit 0.7.3 → 0.7.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +114 -114
- package/dist/index.js +1 -1
- package/package.json +2 -3
- package/src/assembly/app-manifest.ts +1 -1
- package/src/assembly/provider-catalog.ts +4 -4
- package/src/assembly/resolve-key.ts +1 -1
- package/src/assembly/walk-manifests.ts +8 -8
- package/src/core/contracts-expected.ts +1 -1
- package/src/core/contracts-resolver.ts +9 -9
- package/src/core/file-cache.ts +3 -3
- package/src/core/module-schema.ts +1 -1
- package/src/dto.ts +30 -30
- package/src/factory.ts +31 -31
- package/src/index.ts +1 -1
- package/src/integrations/credentials.ts +4 -4
- package/src/integrations/evaluate-app.ts +2 -2
- package/src/integrations/mock-bindings.ts +1 -1
- package/src/integrations/module-binding.ts +4 -4
- package/src/integrations/predicate-io.ts +1 -1
- package/src/integrations/predicate.ts +9 -9
- package/src/integrations/prune-bindings.ts +6 -6
- package/src/integrations/read.ts +3 -3
- package/src/integrations/write.ts +17 -17
- package/src/views/app.ts +3 -3
- package/src/views/credential-types.ts +1 -1
- package/src/views/credentials.ts +2 -2
- package/src/views/integration-schemas.ts +28 -28
- package/src/views/modules.ts +1 -1
- package/src/views/providers.ts +8 -8
- package/src/views/service-detail.ts +3 -3
- package/src/views/service-resolutions.ts +17 -17
package/dist/index.js
CHANGED
|
@@ -2,7 +2,7 @@ import{a as Ve,b as T,c as De}from"./chunk-WUULQDOV.js";import{z as k}from"zod";
|
|
|
2
2
|
`,"utf8"),i}import{mkdirSync as Rt,renameSync as It,writeFileSync as kt}from"fs";import{dirname as bt}from"path";function $(e,n){En(bt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;kt(r,n,"utf8"),It(r,e)}function En(e){Rt(e,{recursive:!0})}import{existsSync as F,readdirSync as Le,readFileSync as ee}from"fs";import{join as V}from"path";import{existsSync as Ct,readFileSync as On,mkdirSync as At,writeFileSync as Et}from"fs";import xn from"path";function Se(e){return xn.join(e,".tbox","app.json")}function Mn(e){let n=Se(e);if(!Ct(n))return null;try{let r=JSON.parse(On(n,"utf8")),t=r?.templateVersion;return typeof t!="string"||t.trim().length===0?null:{templateVersion:t.trim(),npmModules:Array.isArray(r?.npmModules)?r.npmModules:[]}}catch{return null}}function Ot(e,n){let r=Se(e);At(xn.dirname(r),{recursive:!0}),Et(r,`${JSON.stringify(n,null,2)}
|
|
3
3
|
`,"utf8")}function $e(e){let n=Mn(e);if(n===null)return null;let r=Se(e);try{let t=JSON.parse(On(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function xt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Mt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function jt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Tt(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function jn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Nt(e,n){if(!jn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Tn(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(i=>typeof i=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:l}=o,u={};typeof s=="string"&&s.length>0&&(u.name=s),typeof l=="string"&&l.length>0&&(u.description=l),(u.name!==void 0||u.description!==void 0)&&(t[i]=u)}return{slots:r,meta:t}}catch{return null}}function we(e,n){let r=t=>{try{let i=JSON.parse(t),o=se(i);if(o.ok)return{kind:"strict",id:o.value.id,version:o.value.version,descriptor:o.value,declare:o.value.declare};if(o.legacy)return{kind:"legacy",detail:o.errors.join("; ")};if(i&&typeof i=="object"&&"declare"in i){let s=i;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!F(e))return null;try{return r(ee(e,"utf8"))}catch{return null}}function Pt(e){let n=V(e,".tbox","app.json");if(!F(n))return[];try{let r=JSON.parse(ee(n,"utf8"));return Array.isArray(r.npmModules)?r.npmModules.filter(t=>!!t&&typeof t=="object"&&typeof t.id=="string"&&typeof t.package=="string"):[]}catch{return[]}}function Vt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!F(r))return[];try{let t=JSON.parse(ee(r,"utf8")),i=[];for(let[o,s]of Object.entries(t.redirects??{}))typeof s!="string"||!o.startsWith("@tbox.cn/app-")||i.push({pkg:o,dir:V(n,s)});return i}catch{return[]}}function Pn(e,n){let r=[],t=[e];for(let l of["apps","packages"]){let u=V(e,l);if(F(u))try{for(let d of Le(u,{withFileTypes:!0}))d.isDirectory()&&t.push(V(u,d.name))}catch{}}let i=new Set,o=(l,u,d)=>{let m=n?n.read(u,Tn):Tn(ee(u,"utf8"));m!=null&&r.push({dir:l,slots:m.slots,meta:m.meta,via:d})},s=V(e,"config","service-slots.json");F(s)&&o(e,s,"config-override");for(let l of t){let u=V(l,"node_modules","@tbox.cn");if(!F(u))continue;let d=[];try{d=Le(u)}catch{continue}for(let m of d){let y=V(u,m);if(i.has(y))continue;i.add(y);let R=V(y,"service-slots.json"),v=V(y,"src","service-slots.json");F(R)?o(y,R,"package"):F(v)&&o(y,v,"package")}}for(let l of t)for(let u of[V(l,"service-slots.json"),V(l,"src","service-slots.json")])F(u)&&o(l,u,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{}},i={},o=[],s={},l=new Set,u=(a,g,h,w)=>{for(let p of a){let S=t.providers[p.provider]??={},b=S[p.implementation];b?b.services.includes(p.service)||b.services.push(p.service):(S[p.implementation]={provider:p.provider,implementation:p.implementation,credentialType:p.credentialType,owner:g,...w?.name?{name:w.name}:{},...w?.description?{description:w.description}:{},...p.local?{local:!0}:{},...p.configSchema?{configSchema:p.configSchema}:{},...p.credentialSchema?{credentialSchema:p.credentialSchema}:{},services:[p.service]},t.credentialTypes[p.credentialType]??={owner:g,packageDir:h,...p.credentialSchema?{credentialSchema:p.credentialSchema}:{}});let c=`${p.provider}\0${p.service}`;i[c]||(i[c]={...p.configSchema?{configSchema:p.configSchema}:{},...p.credentialSchema?{credentialSchema:p.credentialSchema}:{},packageDir:h})}},d=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,m=(a,g)=>{for(let h of a){let w=s[h];w===void 0?s[h]=g:w!==g&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:g,message:`服务 ${h} 归属冲突:${w} 与 ${g} 均声明 owns(先声明 ${w} 胜出)——修正 manifest declare.owns 互斥`})}},y=(a,g)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:g,message:`${g}:${a.detail}`})},R=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,v=(a,g)=>{let h=a.optional!==!1,w=a.defaults??[],p=t.services[a.service];if(p){p.optional=p.optional&&h;let S=new Set(p.defaults.map(b=>`${b.provider}\0${b.implementation}`));for(let b of w){let c=`${b.provider}\0${b.implementation}`;S.has(c)||(p.defaults.push(b),S.add(c))}p.owners.includes(g)||p.owners.push(g);return}t.services[a.service]={optional:h,defaults:[...w],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[g]}};for(let a of Pt(e)){if(l.has(a.id))continue;let g=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),w=we(V(g,"tbox.module.json"),n)??we(V(h,"tbox.module.json"),n);if(w?.kind==="legacy"){y(w,a.id),l.add(a.id);continue}if(!w)continue;l.add(a.id);let p=F(V(g,"tbox.module.json"))?g:h,S=R(w);w.kind==="strict"&&r.push({id:a.id,dir:p,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:w.descriptor});let b=S?.providers?.slots??[];b.length&&u(b,a.package,p,d(w));let c=S?.consumes??[];for(let E of c)v(E,a.package);let I=w.kind==="strict"?w.descriptor.declare.owns:[];I.length&&m(I.map(E=>E.service),a.id)}for(let{pkg:a,dir:g}of Vt(e)){let h=we(V(g,"tbox.module.json"),n);if(h?.kind==="legacy"){y(h,a);continue}if(!h?.id||l.has(h.id))continue;l.add(h.id);let w=R(h),p=w?.providers?.slots??[];p.length&&u(p,a,g,d(h));let S=w?.consumes??[];for(let c of S)v(c,a);let b=h.kind==="strict"?h.descriptor.declare.owns:[];b.length&&m(b.map(c=>c.service),h.id)}let A=V(e,"packages");if(F(A)){let a=[];try{a=Le(A,{withFileTypes:!0}).filter(g=>g.isDirectory()).map(g=>g.name)}catch{}for(let g of a){if(l.has(g))continue;let h=V(A,g),w=we(V(h,"tbox.module.json"),n);if(w?.kind==="legacy"){y(w,g),l.add(g);continue}if(!w)continue;let p=w.id??g;if(l.has(p))continue;l.add(p);let S=R(w);w.kind==="strict"&&r.push({id:p,dir:h,pkg:`@app/${p}`,descriptor:w.descriptor});let b=S?.providers?.slots??[];b.length&&u(b,`@app/${p}`,h,d(w));let c=S?.consumes??[];for(let E of c)v(E,`@app/${p}`);let I=w.kind==="strict"?w.descriptor.declare.owns:[];I.length&&m(I.map(E=>E.service),p)}}let O=new Set,f={};for(let a of Pn(e,n)){for(let g of a.slots)O.add(g);for(let[g,h]of Object.entries(a.meta))f[g]===void 0&&(f[g]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...O].sort(),slotMeta:f,ownership:s,declarationIssues:o}}function Nn(e,n,r){let t=V(e,"src",n,"index.ts");if(!F(t))return!1;try{let i=ee(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Dt(e){let n=V(e,"src","server","index.ts");if(!F(n))return"";try{return ee(n,"utf8")}catch{return""}}function Vn(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Ft(e){let n=[],r=D(e),t=$e(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",l=Nn(o.dir,"server","serverModule"),u=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:l,hasClientEntry:Nn(o.dir,"client","clientModule"),hasCards:(u.cards?.length??0)>0,...l?{moduleId:Vn(Dt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function _t(e){return D(e).ownership}function L(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function G(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function We(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function H(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Dn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Be(e,n){let r=new Set(n),t=[],i=(o,s)=>{let l=Dn(o,s,r);l&&t.push(l)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let l of Object.keys(s.instances??{}))i(l,`services.${o}.instances`);return t}function ne(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:l,credentialSchemaMissing:u,vendorConfigKeys:d,vendorGlobalConfigKeys:m,vendorConfigSchemaMissing:y,credentialFileMissing:R,credentialFileType:v,realmSwitchHints:A,moduleResourceNeeds:O,ownership:f,installedModuleIds:a}=e,g=l?new Set(l):void 0;for(let c of A??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let h=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),w=(c,I,E,C)=>{if(typeof E?.provider=="string"&&typeof E.implementation=="string"&&E.provider&&E.implementation)return i[ce(E.provider,E.implementation)]?.credentialType;if(typeof I.provider=="string"&&typeof I.implementation=="string")return i[ce(I.provider,I.implementation)]?.credentialType;let M=I.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let N=C??Object.keys(I.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,N,s,f);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[ce(j.effective.provider,j.effective.implementation)]?.credentialType};if(R||v)for(let[c,I]of Object.entries(t.services))for(let[E,C]of Object.entries(I.instances??{})){if(C.enabled===!1)continue;let M=C.credentialRef??I.credentialRef??t.credentialRefByInstance?.[E]??t.credentialRef;if(typeof M!="string"||!M.startsWith("secret://"))continue;let N=M.slice(9);R?.[N]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:E,message:`integrations: 凭据文件缺失 ${N}(${c}@${E} effective ref=${M};档内 config/credentials/ 无此文件)`});let j=v?.[N];if(j){let P=w(c,I,C,E);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:E,message:`integrations: 凭据文件 ${N}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${E}——transport 创建期将按 type 选策略)`})}}let p=(c,I)=>{if(!g)return;let E=Dn(c,I,g);E&&n.push(E)};for(let[c]of Object.entries(t.configByInstance??{}))p(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))p(c,"credentialRefByInstance");let S=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(S.length>0){let c=Object.entries(t.services).filter(([,I])=>I.instances!=null&&I.instances["*"]==null).map(([I])=>I);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${S.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let b=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});b.instances.length>=2&&b.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${b.instances.length} 个部署实例(${b.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,I]of Object.entries(t.services)){if(!o[c]&&f?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof I.provider=="string"?typeof I.implementation=="string"&&!i[ce(I.provider,I.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${I.provider}/${I.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):I.provider!==void 0&&!H(I.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),u){let C=w(c,I);C&&u[C]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${C} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof I.provider=="object"&&typeof I.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[C,M]of Object.entries(I.instances??{})){p(C,`services.${c}.instances`);let N=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!N&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:C,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${C}——impl-only 禁止,provider 是绑定组头)`}),N&&j){let P=M.provider,W=M.implementation;typeof P=="string"&&typeof W=="string"?i[ce(P,W)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:C,message:`integrations: 实例级 provider 覆盖 ${P}/${W} 未命中已装供给(${c}@${C})`}):H(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:C,message:`integrations: 实例级内联 provider 超受控形状(${c}@${C})`})}}}for(let[c,I]of[["root",t.provider],...Object.entries(t.modules??{}).map(([E,C])=>[`modules.${E}`,C?.provider])])typeof I!="string"||I.length===0||h.has(I)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${I} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[c,I]of Object.entries(t.services)){let E=I.instances?Object.keys(I.instances):[""];for(let C of E){let M=r.resolveEffectiveService(t,c,C,s,f);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:C||void 0,message:`integrations: ${M.message}`})}}for(let[c,I]of Object.entries(t.services))I.implementation!==void 0&&I.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,I]of Object.entries(t.modules??{})){if(!(I?.provider!==void 0||I?.config!==void 0))continue;let C=a?!a.has(c):!1,M=0;if(f)for(let j of Object.values(f))j===c&&(M+=1);if(C||!(f===void 0)&&M===0){let j=C?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(d){let c=new Set,I=!1,E=C=>{typeof C!="string"||C.length===0||(d[C]&&c.add(C),!d[C]&&!y?.[C]&&(I=!0),y?.[C]&&(I=!0))};E(t.provider);for(let C of Object.values(t.modules??{}))E(C?.provider);for(let C of Object.values(t.services)){let M=C.provider;E(typeof C.provider=="string"?C.provider:M?.provider)}if(c.size>0&&!I){let C=new Set;for(let j of c)for(let P of d[j]??[])C.add(P);let M=new Set;for(let j of c)for(let P of m?.[j]??[])M.add(P);let N=(j,P,W,q)=>{for(let[Q]of Object.entries(j??{}))(W??C).has(Q)?q&&q.size>0&&!q.has(Q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${Q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${Q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};N(t.config,"root.config",void 0,M);for(let[j,P]of Object.entries(t.configByInstance??{}))N(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let W=L(t,j).provider??void 0;if(W===void 0){N(P.config,`modules.${j}.config`,void 0,M);continue}let q=d[W];if(!q||y?.[W])continue;let Q=m?.[W];N(P.config,`modules.${j}.config`,new Set(q),Q)}}}for(let[c,I]of Object.entries(o)){let E=t.services[c];if(!E){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${I.owners.join(", ")})未配置${I.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let C=Object.entries(E.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);C.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:C.join(", "),message:`integrations: ${c} 实例禁用(${C.join(", ")})`})}for(let[c,I]of Object.entries(t.modules??{})){let E=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[C,M]of Object.entries(I?.resources??{})){let N=M?.type;(typeof N!="string"||!r.RESOURCE_TYPE_IDS.includes(N))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${C} type 非法(${String(N)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),E&&E.size>0&&!E.has(C)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${C} 未被模块 manifest declare.resources 声明`})}}return n}function ce(e,n){return`${e}\0${n}`}import{existsSync as Ue,readFileSync as $t,readdirSync as Lt}from"fs";import{join as he}from"path";function _n(e){return e.replaceAll("-","_").toUpperCase()}function Fn(e){if(!Ue(e))return null;try{let n=JSON.parse($t(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Wt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function de(e,n,r,t=process.env){let i={};for(let[p,S]of Object.entries(n.catalog.providers))for(let[b,c]of Object.entries(S))i[`${p}\0${b}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[p,S]of Object.entries(n.catalog.services))o[p]={optional:S.optional,owners:[...S.owners]};let s={},l={},u={},d={},m={};for(let p of n.modules){m[p.id]=new Set((p.descriptor.declare.resources??[]).map(S=>S.id));for(let S of p.descriptor.declare.providers?.slots??[]){if(S.configSchema){let b=Fn(he(p.dir,S.configSchema));if(b){let c=s[S.provider]??=new Set,I=l[S.provider]??=new Set;for(let C of Wt(b))c.add(C);let E=b.properties;if(E&&typeof E=="object"&&!Array.isArray(E))for(let[C,M]of Object.entries(E))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&I.add(C)}else u[S.provider]=!0}S.credentialSchema&&!Ue(he(p.dir,S.credentialSchema))&&(d[S.credentialType]=!0)}}let y={},R=new Set,v=he(e,"config","credentials");if(Ue(v))for(let p of Lt(v)){if(!p.endsWith(".json"))continue;let S=p.slice(0,-5);R.add(S);let b=Fn(he(v,p));b&&typeof b.type=="string"&&(y[S]=b.type)}let A=r,O=[],f=p=>{typeof p=="string"&&p.startsWith("secret://")&&O.push(p)};for(let p of Object.values(A.services??{}))if(p&&typeof p=="object"){f(p.credentialRef);for(let S of Object.values(p.instances??{}))S&&typeof S=="object"&&f(S.credentialRef)}for(let p of Object.values(A.credentialRefByInstance??{}))f(p);f(A.credentialRef);let a={};for(let p of O){let S=p.slice(9);t[_n(S)]===void 0&&(R.has(S)||(a[S]=!0))}let g=[];for(let[p,S]of Object.entries(A.services??{})){let b=S&&typeof S=="object"&&typeof S.provider=="string"?S.provider:void 0;for(let[c,I]of Object.entries((S&&typeof S=="object"?S.instances:void 0)??{})){let E=I&&typeof I=="object"&&typeof I.provider=="string"?I.provider:void 0;b&&E&&E!==b&&g.push(`integrations: ${p}@${c} 实现覆盖跨厂商(${b} → ${E})——凭据域切换,确认该 mall 对应凭据在场`)}}let w=((Array.isArray(A.instances)?A.instances:void 0)??[]).map(p=>p&&typeof p=="object"&&typeof p.id=="string"?p.id:void 0).filter(p=>typeof p=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:a,credentialFileType:y,credentialSchemaMissing:d,vendorConfigKeys:s,vendorGlobalConfigKeys:l,vendorConfigSchemaMissing:u,realmSwitchHints:g,moduleResourceNeeds:m,...w.length>0?{malls:w}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(p=>p.id),...new Set(Object.values(n.ownership))])}}import{existsSync as ti,readFileSync as ri}from"fs";import{join as oi,resolve as si}from"path";function Ke(e){return D(e).catalog}function Re(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[l,u]of Object.entries(s))r[o][l]={provider:u.provider,implementation:u.implementation,credentialType:u.credentialType,owner:u.owner,...u.local?{local:!0}:{},...u.configSchema?{configSchema:u.configSchema}:{},...u.credentialSchema?{credentialSchema:u.credentialSchema}:{},services:[...u.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(l=>({...l})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(Re(e)),l=de(e,o,n,t);return ne({contracts:i,integrations:n,supplies:s,...l})}import{existsSync as Ht,rmSync as Yt}from"fs";import{join as Zt}from"path";import{existsSync as Bt,readFileSync as Ut}from"fs";import{join as $n}from"path";var Kt=$n("config","integrations.json");function B(e,n){let r=$n(e,Kt),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Bt(r))return null;try{return t(Ut(r,"utf8"))}catch{return null}}async function Ln(e,n){let r=await T(e),t=B(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new x("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new x("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function le(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as zt,existsSync as Ie,readFileSync as Jt}from"fs";import{join as ke}from"path";function Wn(e,n,r){let t=[];if(n){let i=X({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=X({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Bn(e,n,r,t,i){let o=[];if(t){let s=X({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,l]of Object.entries(i??{})){let u=X({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:u,ref:`secret://${u}`,input:l})}return o}function Ge(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ie(ke(e,_(t.stem))):_e(e,t.stem,t.input)}))}function Gt(e,n){return Ie(ke(e,_(n)))}function Je(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)Je(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))Je(r,n)}function te(e){let n=ke(e,"config","credentials"),r=new Set,t=ke(e,"config","integrations.json");if(Ie(t))try{Je(JSON.parse(Jt(t,"utf8")),r)}catch{}let i=[];if(!Ie(n))return i;let o=[];try{o=zt(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let l=ae(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${_(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function be(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&H(e)){let n=e.provider;return n.length>0?n:void 0}}async function qt(e){let n=Zt(e,"config","integrations.json"),r=B(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await T(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let v=Fe(JSON.stringify(r),process.env);if(v.missing.length>0||v.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(v.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await ze(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),l=new Set(Object.keys(s.catalog.providers)),u=s.ownership,d=structuredClone(r);d.services??={};let m=[];for(let v of o)if(v.severity==="error"){if(v.code==="VENDOR_NOT_INSTALLED")if(v.module){let O=(d.modules??{})[v.module];O?.provider&&(m.push(`modules.${v.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete d.modules[v.module])}else d.provider&&(m.push(`root.provider=${d.provider}`),delete d.provider);else if(v.code==="MODULE_CONFIG_DEAD"&&v.module){let A=d.modules??{};if(A[v.module]){let O=A[v.module],f=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);m.push(`modules.${v.module}(${f.join("+")} 整节点)`),delete d.modules[v.module]}}else if(v.code==="BINDING_UNRESOLVED"&&v.service){let A=d.services[v.service];if(!A)continue;let O=u[v.service];if([v.instance?be(A.instances?.[v.instance]?.provider):void 0,be(A.provider),O!==void 0?be(d.modules?.[O]?.provider):void 0,be(d.provider)].filter(a=>typeof a=="string").some(a=>l.has(a)))continue;if(v.instance){let a=A.instances;if(!a||!(v.instance in a))continue;delete a[v.instance],m.push(`services.${v.service}.instances.${v.instance}`),Object.keys(a).length===0&&delete A.instances,Object.keys(A).length===0&&delete d.services[v.service]}else delete d.services[v.service],m.push(`services.${v.service}`)}}if(Object.keys(d.services).length===0&&delete d.services,m.length===0)return{removed:m,orphanCredentials:[]};let y=!d.provider&&Object.keys(d.services??{}).length===0&&Object.keys(d.config??{}).length===0&&Object.keys(d.configByInstance??{}).length===0&&!d.credentialRef&&Object.keys(d.credentialRefByInstance??{}).length===0&&(d.instances??[]).length===0&&d.defaultInstanceId==null&&Object.keys(d.modules??{}).length===0;if(!y&&(d.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(d)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let R=[];return y?Ht(n)&&Yt(n,{force:!0}):$(n,`${JSON.stringify(d,null,2)}
|
|
4
4
|
`),R=te(e).map(v=>v.message),{removed:m,orphanCredentials:R}}function Ce(e,n){let r=e.modules.find(i=>i.id===n);if(r)return r;let t=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new x("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new x("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Y(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let l of Object.values(s))for(let u of l.services)t.add(u);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&o(s);for(let[s,l]of Object.entries(e.catalog.services))l.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new x("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new x("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as zn,readFileSync as Jn}from"fs";import{join as re,resolve as Qt}from"path";import Xt from"ajv";var ue=["provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],pe=["provider","config"];var Z=re("config","integrations.json");function ie(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>ie(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(i=>ie(e[i],n[i]))}return!1}function Oe(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new x("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Oe(t,`${n}.${r}`)}}function Ae(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new x("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function Un(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!z.test(s))throw new x("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),Ae(e.configByInstance,"root.configByInstance",!1),Ae(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else Ae(e.instances,"services.instances",!0);Ae(n.credentialsByInstance,"credentialsByInstance",!1)}function Ee(e,n){let r=re(e,Z),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!zn(r))return null;try{return t(Jn(r,"utf8"))}catch{return null}}function He(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Be(e,n)}function er(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let l of Object.values(o))(r===void 0||l.services.includes(r))&&s.add(l.credentialType);return s.size===1?[...s][0]:void 0}function Kn(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new x("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??er(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new x("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:l}=D(e,o),u=l[`${n}\0${r}`];if(!u?.credentialSchema)return;let d=Qt(u.packageDir,u.credentialSchema);if(zn(d))try{let y=new Xt({allErrors:!0}).compile(JSON.parse(Jn(d,"utf8")));if(!y({type:t.type,...t.values})){let R=(y.errors??[]).map(v=>`credentials.values.${String(v.instancePath||v.params?.missingProperty||"").replace(/^\//,"")}`);throw new x("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",R)}}catch(m){if(m instanceof x)throw m}}function Ye(e,n={}){let{onApplied:r,cache:t}=n;function i(d,m,y,R){let v=d!==null,A=m.length>0,O=!R&&v,f=!R&&A;O&&($(re(e,Z),`${JSON.stringify(d,null,2)}
|
|
5
|
-
`),t?.invalidate([re(e,Z)]));let a=O||f;a&&y.push(...te(e));let g=a&&r!==void 0;g&&r?.();let h=[];return v&&h.push(Z),A&&h.push(...m.map(w=>_(w.stem))),{written:a,restartScheduled:g,files:h,credentials:m,issues:y}}let o;async function s(){o=await T(e)}function l(d,m){return d.filter(y=>Array.isArray(y.path)).map(y=>{let R=y.path.map(String).join(".");return m!==""&&R.startsWith(m)&&R.length>m.length?R.slice(m.length):R}).filter(y=>y.length>0)}function u(d,m,y){let R=o;if(!R||!R.strictValidation||!R.module.parseIntegrationsConfig)throw new x("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用(需 ≥0.9)——写路径门控失败(工厂边缘断言应先行拦截)");try{R.module.parseIntegrationsConfig(d)}catch(v){throw v instanceof Error&&Array.isArray(v.issues)?new x("VALIDATION_FAILED",400,"节点 schema 校验失败",l(v.issues,y)):new x("VALIDATION_FAILED",400,v instanceof Error?v.message:String(v))}}return{warmup:s,applyApp(d,m={}){Oe(d,"root"),Un(d,m,"root");let y=[],R=Ee(e,t),v=R??{services:{}};R===null&&y.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化;
|
|
5
|
+
`),t?.invalidate([re(e,Z)]));let a=O||f;a&&y.push(...te(e));let g=a&&r!==void 0;g&&r?.();let h=[];return v&&h.push(Z),A&&h.push(...m.map(w=>_(w.stem))),{written:a,restartScheduled:g,files:h,credentials:m,issues:y}}let o;async function s(){o=await T(e)}function l(d,m){return d.filter(y=>Array.isArray(y.path)).map(y=>{let R=y.path.map(String).join(".");return m!==""&&R.startsWith(m)&&R.length>m.length?R.slice(m.length):R}).filter(y=>y.length>0)}function u(d,m,y){let R=o;if(!R||!R.strictValidation||!R.module.parseIntegrationsConfig)throw new x("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用(需 ≥0.9)——写路径门控失败(工厂边缘断言应先行拦截)");try{R.module.parseIntegrationsConfig(d)}catch(v){throw v instanceof Error&&Array.isArray(v.issues)?new x("VALIDATION_FAILED",400,"节点 schema 校验失败",l(v.issues,y)):new x("VALIDATION_FAILED",400,v instanceof Error?v.message:String(v))}}return{warmup:s,applyApp(d,m={}){Oe(d,"root"),Un(d,m,"root");let y=[],R=Ee(e,t),v=R??{services:{}};R===null&&y.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let A={...v};for(let S of ue)S in d||delete A[S];for(let[S,b]of Object.entries(d))A[S]=b;let O=typeof A.provider=="string"?A.provider:"app",f=Wn(O,m.credentials,m.credentialsByInstance);for(let S of f)Kn(e,O,void 0,S.input,void 0,t);let a=f.find(S=>S.instanceId===void 0);if(m.credentials&&a&&(A.credentialRef=a.ref),m.credentialsByInstance){let S={...A.credentialRefByInstance??{}};for(let b of f)b.instanceId!==void 0&&(S[b.instanceId]=b.ref);A.credentialRefByInstance=S}let g=m.credentials!==void 0||m.credentialsByInstance!==void 0,h=ie(R,A);if(h&&!g)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:y};u(A,y,"");let w=m.dryRun===!0,p=Ge(e,f,w);return y.push(...He(A)),i(h?null:A,p,y,m.dryRun)},applyModule(d,m,y={}){Oe(m,"root");let{modules:R,catalog:v,ownership:A}=D(e,t),O=R.find(c=>c.id===d);if(!O)throw new x("MODULE_NOT_FOUND",404,`模块 ${d} 非已装模块`);if(!G({modules:R,catalog:v,ownership:A},O).writable)throw new x("VALIDATION_FAILED",400,`模块 ${d} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let a=[],g=Ee(e,t);if(g===null&&Object.keys(m).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:a};g===null&&a.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let h=g??{services:{}},w={...h.modules??{}},p={...w[d]??{}};for(let c of Object.keys(m))if(!pe.includes(c))throw new x("VALIDATION_FAILED",400,`模块集成位仅接受 ${pe.join("/")} 键(收到 ${c})`,[c]);let S={...p};for(let c of pe){let I=m[c];I==null||I===""||typeof I=="object"&&!Array.isArray(I)&&Object.keys(I).length===0?delete S[c]:S[c]=I}Object.keys(S).length===0?delete w[d]:w[d]=S;let b={...h,modules:w};return ie(g,b)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:a}:(u(b,a,`modules.${d}.`),a.push(...He(b)),i(b,[],a,y.dryRun))},applyService(d,m,y={}){Oe(m,"root"),Un(m,y,"slot");let R=[],v=Ee(e,t),A=D(e,t);if(!le(A.vocabulary,Object.keys(v?.services??{}),d,Object.keys(A.ownership)))throw new x("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);v===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=v??{services:{}},f={...O.services??{}},a={...O,services:f};f[d]={...m};let g=m.provider,h=g!==null&&typeof g=="object"?g:void 0,w=typeof g=="string"?g:typeof h?.provider=="string"?h.provider:"app",p=d.includes(".")?d.slice(0,d.indexOf(".")):d,S=Bn(w,d,p,y.credentials,y.credentialsByInstance);for(let N of S)Kn(e,w,d,N.input,typeof h?.credentialType=="string"?h.credentialType:void 0,t);let b=f[d],c=S.find(N=>N.instanceId===void 0);if(y.credentials&&c&&(b.credentialRef=c.ref),y.credentialsByInstance){let N={...b.instances??{}};for(let j of S){if(j.instanceId===void 0)continue;let P={...N[j.instanceId]??{}};P.credentialRef=j.ref,N[j.instanceId]=P}b.instances=N}let I=y.credentials!==void 0||y.credentialsByInstance!==void 0,E=ie(v,a);if(E&&!I)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};u(a,R,`services.${d}.`);let C=y.dryRun===!0,M=Ge(e,S,C);return R.push(...He(a)),i(E?null:a,M,R,y.dryRun)},deleteService(d){let m=[],y=Ee(e,t),R=D(e,t);if(!le(R.vocabulary,Object.keys(y?.services??{}),d,Object.keys(R.ownership)))throw new x("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let v={...y?.services??{}};if(!(d in v))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:m};delete v[d];let A={...y??{services:{}},services:v};$(re(e,Z),`${JSON.stringify(A,null,2)}
|
|
6
6
|
`),t?.invalidate([re(e,Z)]),m.push(...te(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[Z],credentials:[],issues:m}}}}import{existsSync as nr}from"fs";import{join as tr}from"path";function Ze(e){let n=tr(e,"config","integrations.json");if(nr(n))return{generated:!1,reason:"in-place",services:[]};let r=[];for(let o of D(e).modules)for(let s of o.descriptor.declare.providers?.slots??[])s.local===!0&&r.push({service:s.service,provider:s.provider,implementation:s.implementation});if(r.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let t={},i=new Set(r.map(o=>o.provider));if(i.size===1){let[o]=i;for(let s of r)t[s.service]={};$(n,`${JSON.stringify({provider:o,services:t},null,2)}
|
|
7
7
|
`)}else{for(let o of r)t[o.service]={provider:o.provider,implementation:o.implementation};$(n,`${JSON.stringify({services:t},null,2)}
|
|
8
8
|
`)}return{generated:!0,reason:"generated",services:r.map(o=>o.service).sort()}}import{existsSync as rr,readFileSync as ir}from"fs";import{join as qn}from"path";function Gn(e,n){let r=D(e.appDir,e.cache),t=B(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function Hn(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function xe(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function Yn(e,n){let r=[];for(let[t,i]of Object.entries(e.providers))Object.values(i).some(o=>o.services.includes(n))&&r.push(t);return r.sort()}function U(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var or=qn("config","knowledge.json");function sr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=qn(e.appDir,or),s={};if(rr(o))try{s=(e.cache?.read(o,d=>JSON.parse(d))??JSON.parse(ir(o,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[u,d]of Object.entries(i)){if(!d||typeof d!="object"||Array.isArray(d))continue;let m=d,y=m.type==="knowledge"?"knowledge":String(m.type??"knowledge"),R=typeof m.datasetId=="string"&&m.datasetId!==""?m.datasetId:void 0,v=typeof m.ref=="string"&&m.ref!==""?m.ref:void 0,A=R??(v!==void 0&&typeof s[v]?.datasetId=="string"?s[v].datasetId:null),O={type:y,...R!==void 0?{datasetId:R}:{},...v!==void 0?{ref:v}:{},resolvedDatasetId:A,...typeof m.topK=="number"?{topK:m.topK}:{},...typeof m.scoreThreshold=="number"?{scoreThreshold:m.scoreThreshold}:{}};l[u]=O}return Object.keys(l).length>0?l:null}function Zn(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function ar(e){return Zn(e.id).startsWith("provider-")||Zn(e.pkg).startsWith("provider-")}function qe(e,n={}){return{modules:e.walk.modules.filter(t=>!ar(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function Qe(e,n){let r=e.walk.modules.find(y=>y.id===n);if(!r)throw new x("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=G(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(y=>y.service)),o=(y,R)=>{let v=U(e.walk,y);return{service:y,name:v.name,...v.description!==void 0?{description:v.description}:{},required:R}},s=[...(r.descriptor.declare.consumes??[]).map(y=>o(y.service,y.optional===!1)),...[...new Set(t.ownedServices)].filter(y=>!i.has(y)).map(y=>o(y,!1))],l=e.integrations?.modules??{},u=l[n],d=u?{...typeof u.provider=="string"?{provider:u.provider}:{},...u.config&&typeof u.config=="object"&&!Array.isArray(u.config)?{config:u.config}:{}}:null,m=L(e.integrations,n);return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:d,resources:sr(e,n,l),binding:{provider:m.provider,layer:m.layer},configEditable:t.writable,services:s}}function Xe(e){let n=Hn(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=U(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of ue)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i}}function en(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!le(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new x("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=U(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,defaults:t?t.defaults.map(s=>({...s})):[],integration:i,suppliedBy:Yn(e.catalog,n)}}import{existsSync as et,readFileSync as nt,realpathSync as Qn}from"fs";import{isAbsolute as cr,join as dr,relative as lr,resolve as Xn,sep as ur}from"path";function nn(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t);i.length!==0&&n.push({provider:r,local:i.every(o=>o.local===!0),owner:i[0].owner,...i[0].name?{name:i[0].name}:{},...i[0].description?{description:i[0].description}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function tn(e,n,r){let t=e.catalog.providers[n];if(!t)throw new x("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——身份与表单经组合端点暴露)`);let i={};for(let s of Object.values(t))for(let l of s.services)(i[l]??={implementations:[]}).implementations.push({implementation:s.implementation,credentialType:s.credentialType});for(let[s,l]of Object.entries(i)){let u=U(e.walk,s);l.name=u.name,u.description!==void 0&&(l.description=u.description)}if(r?.has("integrationSchemas"))for(let[s,l]of Object.entries(i))l.integrationSchemas={configSchema:K(e,n,s)};let o=Object.values(t);return{provider:n,local:o.every(s=>s.local===!0),owner:o[0].owner,...o[0].name?{name:o[0].name}:{},...o[0].description?{description:o[0].description}:{},services:i}}function rn(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let d of Object.values(t))d.services.includes(r)&&o.push({implementation:d.implementation,credentialType:d.credentialType});let s=i[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!l)throw t?new x("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new x("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&l&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let u=K(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,integrationSchemas:{configSchema:u}}}function K(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?on(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?pr(e.appDir,t):null}function on(e,n,r){if(!r)return null;let t=dr(n,r);if(!et(t))return null;try{return JSON.parse(nt(t,"utf8"))}catch{return null}}function pr(e,n){let r=Xn(e,"config","schemas"),t=Xn(e,n),i=lr(r,t);if(i===""||i.startsWith("..")||cr(i))throw new x("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!et(t))return null;let o,s;try{o=Qn(r),s=Qn(t)}catch{return null}if(s!==o&&!s.startsWith(o+ur))throw new x("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(nt(t,"utf8"))}catch{return null}}function Me(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,notes:[...e.notes]}}function tt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&L(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function rt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations,r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:o.effective.implementation,effective:{provider:l,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:tt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function it(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new x("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function sn(e,n){let r=it(n),{integrations:t,catalog:i}=n,o=r.buildSupplyLookup(i),s=t,u=r.normalizeInstances({instances:s?.instances,defaultInstanceId:s?.defaultInstanceId}).defaultInstanceId??"*",d=rt(n,r,e,u,o),m=tt(n,e,u),y=n.integrations?.services?.[e]?.provider,R=d.provider??(typeof y=="string"?y:typeof y=="object"&&y?String(y.provider):void 0),v=new Set(Object.keys(n.catalog.providers)),A=R!==void 0&&v.has(R)?fr(n.catalog,R,e):void 0,O=i.services[e],f=O!==void 0?!O.optional:void 0,a=n.walk.ownership[e];return{status:d.status,...d.statusMessage?{statusMessage:d.statusMessage}:{},...R!==void 0?{provider:R}:{},...R!==void 0&&m!==null?{layer:m}:{},...A!==void 0?{supplied:A}:{},...a!==void 0?{module:a}:{},...f!==void 0?{required:f}:{}}}function fr(e,n,r){return xe(e,n,r)}function ot(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function fe(e,n,r){let t={};for(let i of ot(e))r&&!r.includes(i)||(t[i]=sn(i,e));return{contracts:Me(e.contracts),resolutions:t,issues:n}}function an(e,n,r){let t=it(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),l=s.instances.map(O=>O.id),u=n.integrations?.services?.[e],d=u?.instances?Object.keys(u.instances):void 0,y=st(d,l).map(O=>{let f=rt(n,t,e,O,i);return{instanceId:O,status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},...f.effective?{effective:f.effective}:{}}}),R=at(n,e,s.defaultInstanceId??"*"),A={...sn(e,n),instances:y,inheritance:R};return{contracts:Me(n.contracts),resolution:A,issues:r.filter(O=>O.service===e)}}function st(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function at(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?L(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ge(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ct(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function je(e,n,r){let t=J(n),i={};for(let o of ot(e))r&&!r.includes(o)||(i[o]=ct(e,o,t));return{contracts:Me(n),resolutions:i,issues:[]}}function dt(e,n,r){let t=J(r),i={...ct(n,e,t),instances:gr(n,e),inheritance:at(n,e,mr(n))};return{contracts:Me(r),resolution:i,issues:[]}}function gr(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return st(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function mr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function cn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:K(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var vr="\0no-enum";function yr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:vr}function Sr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function wr(e){let n=e.map(t=>Sr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=oe(e[0].subschema);return e.every(i=>oe(i.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>yr(t.subschema))).size===1?e[0].subschema:null}function Te(e,n){let r=[],t=!0,i=new Map;for(let[s,l]of Object.entries(e.services)){let u=l.configSchema;if(u===null){r.push(s);continue}if(!u||typeof u!="object"||Array.isArray(u))continue;let d=u;d.additionalProperties===!1&&(t=!1);let m=d.properties;if(!m||typeof m!="object"||Array.isArray(m))continue;let y=Array.isArray(d.required)?d.required:[];for(let R of Object.keys(m)){let v=i.get(R)??[];v.push({service:s,subschema:m[R],required:y.includes(R)}),i.set(R,v)}}let o=[];for(let[s,l]of i)o.push({key:s,schema:wr(l),sources:l.map(({service:u,required:d})=>({service:u,required:d})),global:l.some(u=>!!u.subschema&&typeof u.subschema=="object"&&u.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:r,unsupplied:[...n?.unsupplied??[]],additionalPropertiesAllowed:t,fields:o}}function dn(e,n,r,t){let i=typeof t=="string"&&t.length>0?t:void 0;if(e==="app"){if(i!==void 0)return i;let l=n.integrations?.provider;return typeof l=="string"&&l.length>0?l:null}let o=n.walk.modules.find(l=>l.id===r);return!o||!G(n.walk,o).writable?null:i!==void 0?i:L(n.integrations,o.id).provider}var lt={integrationSchemas:null,integrationFieldRegistry:null};function ut(e){return{...e,fields:e.fields.filter(n=>n.global)}}function ln(e,n){let r=dn("app",e,void 0,n);if(r===null)return lt;let t=cn(e,r,We(e.catalog,r));return{integrationSchemas:t,integrationFieldRegistry:ut(Te(t))}}function un(e,n,r){let t=dn("module",e,n,r),i=e.walk.modules.find(u=>u.id===n);if(t===null||!i)return lt;let o=(i.descriptor.declare.owns??[]).map(u=>u.service),s=u=>xe(e.catalog,t,u),l=cn(e,t,o.filter(s));return{integrationSchemas:l,integrationFieldRegistry:ut(Te(l,{unsupplied:[...new Set(o.filter(u=>!s(u)))]}))}}function hr(e){return ln(e).integrationSchemas}function Rr(e,n){return un(e,n).integrationSchemas}function Ir(e,n){let r=e.walk.ownership[n];if(r!==void 0)return L(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Ne(e,n,r){let t=typeof r=="string"&&r.length>0?r:void 0;if(t!==void 0)return{provider:t,configSchema:K(e,t,n)};let i=e.integrations?.services?.[n]?.provider;if(i===void 0||i===""){let o=Ir(e,n);return o===null?null:{provider:o,configSchema:K(e,o,n)}}if(typeof i=="string")return{provider:i,configSchema:K(e,i,n)};if(H(i)){let o=i;return{provider:o.provider,configSchema:K(e,o.provider,n,o.configSchema)}}return null}function pn(e,n,r){let t=Ne(e,n,r);if(t===null)return null;let i={provider:t.provider,services:{[n]:{configSchema:t.configSchema}}};return Te(i)}function me(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ae(e,r);if(t)return{type:t.type,ref:n,file:_(r),masked:ve(t.values)}}function fn(e){let n=e.integrations,r={credential:me(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:i}of n?.instances??[]){let o=n?.credentialRefByInstance?.[i];o!==void 0&&(r.byInstance[i]=me(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:me(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[l,u]of Object.entries(o.instances??{}))s.byInstance[l]=me(e.appDir,u.credentialRef)??null;t[i]=s}return{app:r,services:t}}function gn(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let i=e.catalog.credentialTypes[t];return{credentialType:t,owner:i?.owner??"",credentialSchema:i?on(e.appDir,i.packageDir,i.credentialSchema):null}})}}import kr from"path";var br={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],provider:["integrationSchemas"],service:["integrationSchemas","integrationFieldRegistry"]};function Pe(e,n){if(!n||n.length===0)return new Set;let r=br[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new x("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}var pt=["integrationSchemas","integrationFieldRegistry"];function mn(e,n,r){if(!(typeof n!="string"||n.length===0)&&!pt.some(t=>r.has(t)))throw new x("VALIDATION_FAILED",400,`参数 ${e} 需与表单 include 键(${pt.join("、")})同现——轴参仅重定向表单层双投影`,[e])}function Cr(e,n={}){let r=Ve(),t=Promise.resolve(),i={appDir:e,cache:r};function o(f){if(!f.strictValidation)throw new x("CONTRACTS_NOT_RESOLVED",503,J(f));if(!f.ownershipBindingV6)throw new x("CONTRACTS_NOT_RESOLVED",503,J(f))}function s(f){return Gn(i,f)}function l(f){let a=f.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function u(){let f=await T(e),a=s(f),g=a.integrations;if(g===null)return[];let h={resolveEffectiveService:d(f.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:d(f.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:d(f.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:f.module.RESOURCE_TYPE_IDS??[]},w=de(e,a.walk,g,process.env);return ne({contracts:h,integrations:g,supplies:h.buildSupplyLookup(a.catalog),...w})}function d(f,a){if(typeof f!="function")throw new x("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return f}function m(f){let a=t.then(f,f);return t=a.catch(()=>{}),a}let y={async loadModules(f){let a=await T(e);return qe(s(a),f)},async loadModule(f,a){let g=Pe("module",a?.include);mn("moduleProvider",a?.moduleProvider,g);let h=await T(e),w=s(h),p=Ce(w.walk,f),S=Qe(w,p.id);if(g.has("serviceResolutions")){let b=[...new Set([...S.ownedServices,...S.services.map(c=>c.service)])];S.serviceResolutions=ge(h)?await u().then(c=>fe(w,c,b)):je(w,h,b)}if(g.has("integrationSchemas")||g.has("integrationFieldRegistry")){let b=un(w,p.id,a?.moduleProvider);g.has("integrationSchemas")&&(S.integrationSchemas=b.integrationSchemas),g.has("integrationFieldRegistry")&&(S.integrationFieldRegistry=b.integrationFieldRegistry)}return S},async loadApp(f){let a=Pe("app",f?.include);mn("appProvider",f?.appProvider,a);let g=await T(e),h=s(g),w=Xe(h);if(a.has("serviceResolutions")&&(w.serviceResolutions=ge(g)?await u().then(p=>fe(h,p)):je(h,g)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let p=ln(h,f?.appProvider);a.has("integrationSchemas")&&(w.integrationSchemas=p.integrationSchemas),a.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=p.integrationFieldRegistry)}return w},async loadService(f,a){let g=Pe("service",a?.include);mn("serviceProvider",a?.serviceProvider,g);let h=await T(e),w=s(h),p=Y(w.walk,l(w),f),S=en(w,p);return g.has("integrationSchemas")&&(S.integrationSchemas=Ne(w,p,a?.serviceProvider)),g.has("integrationFieldRegistry")&&(S.integrationFieldRegistry=pn(w,p,a?.serviceProvider)),S},async loadServiceResolutions(f){let a=await T(e),g=s(a);if(!ge(a))return je(g,a,f);let h=await u();return fe(g,h,f)},async loadServiceResolution(f){let a=await T(e),g=s(a),h=Y(g.walk,l(g),f);if(!ge(a))return dt(h,g,a);let w=await u();return an(h,g,w)},async loadProviders(){let f=await T(e);return nn(s(f))},async loadProvider(f,a){let g=Pe("provider",a?.include),h=await T(e);return tn(s(h),f,g)},async loadProviderService(f,a){let g=await T(e),h=s(g),w=Y(h.walk,l(h),a);return rn(h,f,w)},async loadCredentials(){let f=await T(e);return fn(s(f))},async loadCredentialTypes(f){let a=await T(e);return gn(s(a),f)}},R=Ye(e,{onApplied:n.onApplied,cache:r}),v={async writeAppIntegration(f,a){await R.warmup();let g=await T(e);return o(g),m(()=>R.applyApp(f,a))},async writeModuleIntegration(f,a,g){await R.warmup();let h=await T(e);return o(h),m(()=>{let w=Ce(s(h).walk,f);return R.applyModule(w.id,a,g)})},async writeServiceIntegration(f,a,g){await R.warmup();let h=await T(e);return o(h),m(()=>{let w=s(h),p=Y(w.walk,l(w),f);return R.applyService(p,a,g)})},async deleteServiceIntegration(f){await R.warmup();let a=await T(e);return o(a),m(()=>{let g=s(a),h=Y(g.walk,l(g),f);return R.deleteService(h)})}},A={invalidate(){r.invalidate(),De(e)},async resolveContracts(){return T(e)},walkManifests(){return O(e)},parseModuleDescriptor(f){return se(f)},loadProviderCatalogRaw(){return Ke(e)},async readIntegrationsConfig(){return B(e,r)},async writeIntegrationsConfig(f){await R.warmup();let a=await T(e);return o(a),m(()=>Ar(e,f,r))},async ensureMockBindings(){await R.warmup();let f=await T(e);return o(f),m(()=>Ze(e))},async evaluateIntegrationServices(f){await R.warmup();let a=await T(e);o(a);let g={resolveEffectiveService:d(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:d(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:d(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ne({...f,contracts:g})}};function O(f){return D(f,r)}return{...y,...v,...A}}function Ar(e,n,r){let t=kr.join(e,"config","integrations.json");$(t,`${JSON.stringify(n,null,2)}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tbox.cn/app-toolkit",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.4",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "tbox 应用工具面(运行面/工具面对仗:app-sdk 给运行的应用用,app-toolkit 给操作应用的工具用)——模块解析、集成配置求值/校验/写入内核,contracts 经应用侧动态解析(沙箱与目标应用版本解耦)。",
|
|
6
6
|
"exports": {
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"zod": "3.25.76"
|
|
19
19
|
},
|
|
20
20
|
"devDependencies": {
|
|
21
|
-
"@tbox.cn/app-contracts": "0.12.
|
|
21
|
+
"@tbox.cn/app-contracts": "0.12.4",
|
|
22
22
|
"typescript": "5.9.3",
|
|
23
23
|
"tsup": "8.5.1",
|
|
24
24
|
"vitest": "4.1.10",
|
|
@@ -32,7 +32,6 @@
|
|
|
32
32
|
"src",
|
|
33
33
|
"tests",
|
|
34
34
|
"tsconfig.json",
|
|
35
|
-
"tsconfig.build.json",
|
|
36
35
|
"tsup.config.ts",
|
|
37
36
|
"README.md",
|
|
38
37
|
"LICENSE"
|
|
@@ -21,7 +21,7 @@ export interface NpmModuleEntry {
|
|
|
21
21
|
/** 3-way merge 基线(codegen 模式) */
|
|
22
22
|
baseVersion?: string;
|
|
23
23
|
/**
|
|
24
|
-
*
|
|
24
|
+
* 条目类别(单一模板统一化):'ui-kit' = 壳 UI 组件包——create 全量继承后
|
|
25
25
|
* 不再承担保留判据(模板 manifest = 出厂装配真源);现职 = update 三方合并锚 +
|
|
26
26
|
* sync-agent-ui-kit 副本 identity 标记(由该脚本派生维护)。
|
|
27
27
|
*/
|
|
@@ -3,7 +3,7 @@ import { join, resolve } from 'node:path';
|
|
|
3
3
|
import { walkManifests, type WalkCatalog, type WalkProviderEntry } from './walk-manifests.js';
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
|
-
* provider catalog 双形态(ai-
|
|
6
|
+
* provider catalog 双形态(ai-buildb/):
|
|
7
7
|
* - **桥源 `loadProviderCatalog(appDir)`**:签名与返回形态冻结(app-sdk re-export 桥源——
|
|
8
8
|
* 存量克隆应用模板导入零改动;≠ 富形态,双形态有意)。实现自 app-sdk
|
|
9
9
|
* runtime/provider-catalog.ts 等价迁入(共享 walkManifests 缓存生命周期——本包内统一走
|
|
@@ -82,7 +82,7 @@ export function loadProviderCatalog(appDir: string): BridgeProviderCatalog {
|
|
|
82
82
|
}
|
|
83
83
|
|
|
84
84
|
// ---------------------------------------------------------------------------
|
|
85
|
-
// provider-schemas
|
|
85
|
+
// provider-schemas:组合单体装配链;表单 schema 唯一暴露面的服务端装配)
|
|
86
86
|
// ---------------------------------------------------------------------------
|
|
87
87
|
|
|
88
88
|
export interface ProviderServiceSchemas {
|
|
@@ -101,12 +101,12 @@ export type ProviderServiceSchemasResult =
|
|
|
101
101
|
| { found: false; reason: 'provider-not-found' | 'supply-not-found' };
|
|
102
102
|
|
|
103
103
|
/**
|
|
104
|
-
* 组合单体 schema 解析(api.md 4.9
|
|
104
|
+
* 组合单体 schema 解析(api.md 4.9 数据源;/ 单源):
|
|
105
105
|
* - 供给解析 = catalog 槽供给在场 → implementations[] 数组装配(vendor→impl 展开该 service 的
|
|
106
106
|
* 全部 {implementation, credentialType},声明序);service 级内联声明在场(该 provider 名)→
|
|
107
107
|
* 单元素(声明对)。
|
|
108
108
|
* - schema 解析自默认 impl(唯一供给 ?? manifest 声明序首个——H1 单源规则);复合键
|
|
109
|
-
* `${provider}\u0000${service}` 产物读取;供给在场未声明 = null(mock 合法,非 404
|
|
109
|
+
* `${provider}\u0000${service}` 产物读取;供给在场未声明 = null(mock 合法,非 404——)。
|
|
110
110
|
* - 内联声明 configSchema 引用文件解析:**路径约束(H9 安全钉子)**——纯相对路径 + resolve 后
|
|
111
111
|
* 必须落在 <appDir>/config/schemas/ 内 + realpath 复核;违例 → throw(HTTP 层 400)。
|
|
112
112
|
*/
|
|
@@ -8,7 +8,7 @@ import { AppToolkitError } from '../core/errors.js';
|
|
|
8
8
|
* **消费边界(O1——双键语义单点)**:仅 factory.ts 控制面七方法入口接入;
|
|
9
9
|
* views / write-core / CLI 恒 id-only 纯函数。
|
|
10
10
|
*
|
|
11
|
-
*
|
|
11
|
+
* **纯参数式**:configuredKeys 由调用方注入——零 integrations 依赖、零 IO,
|
|
12
12
|
* 解析输入恒为 walk 产物快照 + 调用方键集。
|
|
13
13
|
*/
|
|
14
14
|
|
|
@@ -5,13 +5,13 @@ import { parseModuleDescriptor, type ModuleDescriptor, type ProviderSlotContrib
|
|
|
5
5
|
import { readAppManifestFull, type NpmModuleEntry, type AppManifestFull } from './app-manifest.js';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
-
* walkManifests(appDir)
|
|
8
|
+
* walkManifests(appDir)——单次遍历四产物(/;ai-build)。
|
|
9
9
|
*
|
|
10
10
|
* manifest 候选路径探测(packages/<id>/tbox.module.json 优先 → node_modules/<pkg>/tbox.module.json;
|
|
11
11
|
* tbox-app dev 真身经 .tbox-dev.local/dev-manifest.json redirects 独立 catalog 通道直达)一次遍历同时产出:
|
|
12
12
|
* 1. modules:已装模块清单(declared;demand meta name/description 透传)
|
|
13
13
|
* 2. catalog(富形态):providers 嵌套(vendor→impl→entry,per-service {implementation, credentialType}
|
|
14
|
-
*
|
|
14
|
+
* 保真——同厂商异构/多实现合法,/H1)+ 需求侧聚合
|
|
15
15
|
* 3. serviceSchemas:per-service schema 复合键表——键 `${provider}\u0000${service}`(H2,同一服务
|
|
16
16
|
* 多厂商供给各自 schema 零碰撞);多 impl 同 (provider, service) 异 schema → 声明序首个
|
|
17
17
|
* 4. vocabulary:所有携带 service-slots.json 的已装契约包该文件 `.slots` 键并集(fs 直读、
|
|
@@ -19,22 +19,22 @@ import { readAppManifestFull, type NpmModuleEntry, type AppManifestFull } from '
|
|
|
19
19
|
* ② 同包 src/service-slots.json(发布包 src 附带 / 模板 shim 链接)
|
|
20
20
|
* ③ 候选自身 {service-slots.json, src/service-slots.json}(local/codegen 全量副本——
|
|
21
21
|
* mall 生成应用主形态,不依赖 install);零缓存枚举,与 manifest 探测同机制;
|
|
22
|
-
* 多行业 contracts-*
|
|
22
|
+
* 多行业 contracts-* 天然扩展);缺席 → [](退化 demanded ∪ configured)
|
|
23
23
|
* 5. slotMeta:词汇 meta 节(per-service {name,description} 展示元数据——消费端兜底链
|
|
24
24
|
* 词汇 > demand > id,views/context resolveServiceDisplay 单源);多包发现序首声明胜出
|
|
25
25
|
* (与 catalog addSlots 同语义);contracts-mall 词汇锁保证 mall 域全量覆盖;缺席 → {}
|
|
26
26
|
* 6. ownership:service → moduleId 归属表(v6——declare.owns 聚合;install id 键控;
|
|
27
27
|
* 双 owner 冲突 → declarationIssues OWNERSHIP_CONFLICT + 先声明胜出)
|
|
28
|
-
* 7. declarationIssues:声明面诊断(OWNERSHIP_CONFLICT / OLD_MANIFEST_KEY——
|
|
28
|
+
* 7. declarationIssues:声明面诊断(OWNERSHIP_CONFLICT / OLD_MANIFEST_KEY—— 通道)
|
|
29
29
|
*
|
|
30
|
-
* **约束(
|
|
30
|
+
* **约束(FX-3/ 边界)**:目录枚举零缓存——readdir / node_modules 候选探测 / `.tbox/app.json` 读取 /
|
|
31
31
|
* dev-manifest 读取每次执行(枚举输入保持 fresh——agent 装卸模块下一笔即见);manifest/service-slots
|
|
32
32
|
* **文件内容**经 file-cache(`cache` 可选参——工厂/写内核传本实例 cache(stat 指纹自愈 + 写后失效);
|
|
33
33
|
* CLI 传 undefined 即全 fresh)。
|
|
34
34
|
* 宽松解析语义(坏文件静默 + 重复键首声明保留)零改动。
|
|
35
35
|
*/
|
|
36
36
|
|
|
37
|
-
/** 声明面诊断(v6
|
|
37
|
+
/** 声明面诊断(v6 通道——OWNERSHIP_CONFLICT / OLD_MANIFEST_KEY;error 级) */
|
|
38
38
|
export type DeclarationIssue =
|
|
39
39
|
| { severity: 'error'; code: 'OWNERSHIP_CONFLICT'; message: string; module?: string }
|
|
40
40
|
| { severity: 'error'; code: 'OLD_MANIFEST_KEY'; message: string; module?: string };
|
|
@@ -158,7 +158,7 @@ type ReadManifestResult =
|
|
|
158
158
|
|
|
159
159
|
/** 读单文件 manifest(坏文件 → null;宽松——strict 解析失败但为新形态 declare → loose 兜底;
|
|
160
160
|
* 旧键 → legacy(定向 issue,静默兜底防线——单源 = parseModuleDescriptor legacy 标志)。
|
|
161
|
-
* FX-3
|
|
161
|
+
* FX-3(边界):**文件内容**经 file-cache(stat 指纹——外部写下一笔自愈);目录枚举仍零缓存。 */
|
|
162
162
|
function readManifestFile(file: string, cache?: FileCache): ReadManifestResult | null {
|
|
163
163
|
const parse = (raw: string): ReadManifestResult | null => {
|
|
164
164
|
try {
|
|
@@ -256,7 +256,7 @@ export interface DiscoveredSlotSource {
|
|
|
256
256
|
* ③ 候选自身 {service-slots.json, src/service-slots.json}(local/codegen 全量副本——
|
|
257
257
|
* mall 生成应用主形态,stage rewriteExportsToSrc 展开后永驻 packages/*,不依赖 install)
|
|
258
258
|
* 词汇覆盖 = Set 并集(跳⓪ 不遮蔽真源新增);meta = 发现序首声明胜出(跳⓪ 最前 = 覆盖权)。
|
|
259
|
-
* 同包双在场(异常态)root 优先。slots 与 meta 单次解析同产(目录枚举零缓存,
|
|
259
|
+
* 同包双在场(异常态)root 优先。slots 与 meta 单次解析同产(目录枚举零缓存,
|
|
260
260
|
* FX-3:文件**内容**经 file-cache)。 */
|
|
261
261
|
export function discoverContractPackages(appDir: string, cache?: FileCache): DiscoveredSlotSource[] {
|
|
262
262
|
const found: DiscoveredSlotSource[] = [];
|
|
@@ -9,7 +9,7 @@ import type {
|
|
|
9
9
|
/**
|
|
10
10
|
* contracts 期望面编译期锁(satisfies 语义防接口漂移——contracts 加名/改签名即编译红)。
|
|
11
11
|
* resolver 运行时产物按本接口逐命名导出存在性检查(evaluation/strictValidation 按在场降级)。
|
|
12
|
-
* contracts 恒 devDep 且限 import type——运行时全经 resolver 动态 import
|
|
12
|
+
* contracts 恒 devDep 且限 import type——运行时全经 resolver 动态 import(版本解耦)。
|
|
13
13
|
*/
|
|
14
14
|
|
|
15
15
|
export interface EvaluationExports {
|
|
@@ -5,7 +5,7 @@ import type { ResolvedModule } from './contracts-expected.js';
|
|
|
5
5
|
import { createFileCache, type FileCache } from './file-cache.js';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
-
* contracts
|
|
8
|
+
* contracts 动态解析器(方案心脏):`resolveContractsForApp(appDir)`——
|
|
9
9
|
* 成员扫描 + 包根定位。沙箱内 toolkit 与目标应用版本解耦:求值与校验双面由
|
|
10
10
|
* 应用自己的 @tbox.cn/app-contracts 版本驱动。
|
|
11
11
|
*
|
|
@@ -38,7 +38,7 @@ export interface ResolvedContracts {
|
|
|
38
38
|
evaluation: boolean;
|
|
39
39
|
/** 严格 zod 面可用(parseIntegrationsConfig 在场——≥0.9 门控判据) */
|
|
40
40
|
strictValidation: boolean;
|
|
41
|
-
/** v6 形状标记在场(OWNERSHIP_BINDING_V6——modules[owner] 绑定形状支持;标记门
|
|
41
|
+
/** v6 形状标记在场(OWNERSHIP_BINDING_V6——modules[owner] 绑定形状支持;标记门
|
|
42
42
|
* v5 contracts + v6 toolkit 偏斜 → 503 第四分支,防静默忽略 ownerOf) */
|
|
43
43
|
ownershipBindingV6: boolean;
|
|
44
44
|
/** 动态 import 产物(命名导出子集——Partial<EvaluationExports>) */
|
|
@@ -95,7 +95,7 @@ function candidateDirs(appDir: string): string[] {
|
|
|
95
95
|
return dirs;
|
|
96
96
|
}
|
|
97
97
|
|
|
98
|
-
/**
|
|
98
|
+
/** 轻探测单候选快照:路径 + version(file-cache)+ 产物态——memo 命中判定指纹的原子单元 */
|
|
99
99
|
interface CandidateProbe {
|
|
100
100
|
/** package.json 路径(轻探测读路径——symlink 原路径,pnpm 换 store 目标可觉察) */
|
|
101
101
|
pkgPath: string;
|
|
@@ -110,7 +110,7 @@ interface MemoEntry {
|
|
|
110
110
|
promise: Promise<ResolvedContracts>;
|
|
111
111
|
/** 解析时首个在册候选(候选序变化/修复/新候选出现可觉察) */
|
|
112
112
|
first: CandidateProbe | null;
|
|
113
|
-
/** 解析实际命中候选(unresolved → null;版本变更/产物物化/候选消失可觉察——
|
|
113
|
+
/** 解析实际命中候选(unresolved → null;版本变更/产物物化/候选消失可觉察—— 两处 stale 边缘同修) */
|
|
114
114
|
resolved: CandidateProbe | null;
|
|
115
115
|
}
|
|
116
116
|
|
|
@@ -162,7 +162,7 @@ function candidateFingerprint(p: CandidateProbe | null): string {
|
|
|
162
162
|
return p === null ? 'none' : `${p.pkgPath}|${p.version ?? 'null'}|${p.artifact}`;
|
|
163
163
|
}
|
|
164
164
|
|
|
165
|
-
/** memo
|
|
165
|
+
/** memo 命中判定:首个在册候选指纹稳定(序/版本/产物态)+ 命中候选指纹稳定(版本/产物态)。
|
|
166
166
|
* 同指纹即等价——unresolved(resolved=null)仅需首个候选稳定。 */
|
|
167
167
|
function memoHit(appDir: string, entry: MemoEntry): boolean {
|
|
168
168
|
const first = probeFirstCandidate(appDir);
|
|
@@ -204,14 +204,14 @@ async function probeCandidate(
|
|
|
204
204
|
try {
|
|
205
205
|
// 动态 import 路径运行时计算(pathToFileURL——Windows 安全 + 打包器禁折叠)。
|
|
206
206
|
// version query cache-bust:Node ESM import 缓存按完整 URL 去重——版本不变命中缓存
|
|
207
|
-
// (dedup 保留),版本变更 → 新 URL → 强制重 import
|
|
207
|
+
// (dedup 保留),版本变更 → 新 URL → 强制重 import(新版本语义生效,;覆盖
|
|
208
208
|
// symlink 换 store 目标与候选包原地 bump 两种升级形态)。
|
|
209
209
|
const versionQuery = version !== null ? `?v=${encodeURIComponent(version)}` : '';
|
|
210
210
|
const mod = (await import(pathToFileURL(probeFile).href + versionQuery)) as Record<string, unknown>;
|
|
211
211
|
const evaluation = EVALUATION_EXPORT_NAMES.every((name) => mod[name] !== undefined);
|
|
212
212
|
const strictValidation = mod[STRICT_EXPORT_NAME] !== undefined;
|
|
213
213
|
// v6 形状标记(出口在场性——判据先例 STRICT_EXPORT_NAME);缺席时不在此 push note
|
|
214
|
-
// (503 文案归 factory assertContractsUsable
|
|
214
|
+
// (503 文案归 factory assertContractsUsable 门控单点——)
|
|
215
215
|
const ownershipBindingV6 = mod[OWNERSHIP_MARKER_NAME] === true;
|
|
216
216
|
return {
|
|
217
217
|
version,
|
|
@@ -233,7 +233,7 @@ async function probeCandidate(
|
|
|
233
233
|
}
|
|
234
234
|
|
|
235
235
|
/** 解析应用自己的 contracts(memoize + 轻探测指纹;绝不 throw——全缺席 → 未解析产物)。
|
|
236
|
-
*
|
|
236
|
+
* 命中判定 = 首个在册候选 + 命中候选双指纹(版本变更 / dist 物化 / 候选序变化 / 候选消失
|
|
237
237
|
* 全面可觉察——覆盖「build 后重试」长生命周期宿主与多候选走位两处 stale 边缘)。 */
|
|
238
238
|
export function resolveContractsForApp(appDir: string): Promise<ResolvedContracts> {
|
|
239
239
|
// 轻探测:双指纹与 memoized 比对(1 候选序扫描 + 版本读(cache)+ 产物 existsSync)
|
|
@@ -261,7 +261,7 @@ export function resolveContractsForApp(appDir: string): Promise<ResolvedContract
|
|
|
261
261
|
`contracts ${resolved.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`,
|
|
262
262
|
);
|
|
263
263
|
}
|
|
264
|
-
//
|
|
264
|
+
// 实际命中候选覆写(多候选走位可觉察——后续命中判定以命中候选为基准;)
|
|
265
265
|
entry.resolved = probeCandidatePath(candidate);
|
|
266
266
|
return resolved;
|
|
267
267
|
}
|
package/src/core/file-cache.ts
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import { existsSync, readFileSync, statSync } from 'node:fs';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
|
-
* 统一文件读原语:stat 指纹(mtimeMs+size)+ parse 产物缓存 +
|
|
4
|
+
* 统一文件读原语:stat 指纹(mtimeMs+size)+ parse 产物缓存 + 写后失效协议。
|
|
5
5
|
*
|
|
6
6
|
* Freshness Contract 机制载体(README 单源引用):
|
|
7
7
|
* - 外部写自愈:每笔读 stat 指纹比对——不命中即重读重 parse(外部写下一笔即见);
|
|
8
8
|
* - read-your-writes:写核心成功后调用 invalidate(本实例即刻失效,不依赖 mtime 粒度——
|
|
9
|
-
* 同毫秒连写兜底,
|
|
9
|
+
* 同毫秒连写兜底, 钉死);
|
|
10
10
|
* - 缓存对象 = 文件**内容/parse 产物**;目录枚举不经此原语(walkManifests 每次执行——零缓存约束)。
|
|
11
11
|
*
|
|
12
12
|
* parse 失败不缓存(下一笔重试——坏文件短暂窗口自愈);read 前存在性由调用方判定或捕获。
|
|
@@ -22,7 +22,7 @@ export interface FileCache {
|
|
|
22
22
|
read<T>(absolutePath: string, parse: (raw: string) => T): T | undefined;
|
|
23
23
|
/** 写后失效协议:paths 缺省全失效;指定路径仅失效对应条目 */
|
|
24
24
|
invalidate(paths?: readonly string[]): void;
|
|
25
|
-
/** 测试观测:parse
|
|
25
|
+
/** 测试观测:parse 执行计数(缓存命中不重 parse 断言用) */
|
|
26
26
|
readonly parseCount: number;
|
|
27
27
|
}
|
|
28
28
|
|
|
@@ -4,7 +4,7 @@ import { z } from 'zod';
|
|
|
4
4
|
* tbox.module.json schema v1(001 §3.6 字段名,003 §4.1 schema v1 定版;v6 声明面翻转)。
|
|
5
5
|
* app-toolkit 单一校验源(自 CLI module-schema.ts 迁入;CLI 经 re-export 消费)。
|
|
6
6
|
*
|
|
7
|
-
* 迁移改造(ai-build
|
|
7
|
+
* 迁移改造(ai-build):
|
|
8
8
|
* - resourceNeedContribSchema 的 type 由 `z.enum(RESOURCE_TYPE_IDS)` 放宽为 `z.string()`——
|
|
9
9
|
* 词汇校验移谓词、经 contracts 动态解析取 RESOURCE_TYPE_IDS(比静态 enum 更忠实应用版本);
|
|
10
10
|
* - demand meta additive:serviceConsumeContribSchema 增 name?/description?(服务展示元数据,
|