@tbox.cn/app-toolkit 0.8.5 → 0.8.6

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 CHANGED
@@ -767,6 +767,9 @@ interface ModuleConfig {
767
767
  provider?: string;
768
768
  /** 模块级共享配置(config 五层级联第三层:root ByInstance 之后、slot 之前) */
769
769
  config?: Record<string, unknown>;
770
+ /** 模块级共享凭据引用(v6 归属链层:实例 > 槽 > modules[owner] > root——连接三件套
771
+ * (provider/config/credentialRef)共享营业主写位;该模块拥有的全部槽免逐槽重配) */
772
+ credentialRef?: string;
770
773
  /** resourceId → 类型化资源声明(resourceId 词汇真源 = 模块 manifest declare.resources) */
771
774
  resources?: Record<string, ResourceSpec>;
772
775
  }
@@ -1093,7 +1096,7 @@ interface ModuleDetailView {
1093
1096
  /** v6 所有权模型:模块归属服务(declare.owns 展平,排序;零归属 = [])——
1094
1097
  * v5 domainKeys 退役(破坏性更名;面板 presence-detection 双读义务见 api.md §3) */
1095
1098
  ownedServices: string[];
1096
- /** modules[install id] 集成位原值(provider/config;resources 不投影——见 resources 字段);未配置 = null */
1099
+ /** modules[install id] 集成位原值(provider/config/credentialRef——共享连接归属层三键;resources 不投影——见 resources 字段);未配置 = null */
1097
1100
  integration: ModuleIntegrationNode | null;
1098
1101
  /** 模块资源只读镜像(N2 读半边——写侧 resources 恒保全;含 ref 台账展开态 resolvedDatasetId);
1099
1102
  * 无模块键/无资源节 = null */
@@ -1272,15 +1275,18 @@ interface AppIntegrationNode {
1272
1275
  * (缺席根键删除;services/modules 域不在其中;v6 domains 键退役)+ views/app 投影
1273
1276
  * (GET 预填 ≡ PUT body,/L1——文件含 services/modules 但 root 节点投影只含本键集)) */
1274
1277
  declare const APP_INTEGRATION_NODE_KEYS: readonly ["$comment", "$schema", "provider", "config", "configByInstance", "credentialRef", "credentialRefByInstance", "instances", "defaultInstanceId"];
1275
- /** 模块集成位节点(v6——provider 绑定默认 + config 级联层;resources 不投影不写——
1276
- * 集成位编辑恒保全资源节,N2) */
1278
+ /** 模块集成位节点(v6——provider 绑定默认 + config 级联层 + credentialRef 共享凭据归属层
1279
+ * (contracts ModuleConfig.credentialRef——连接三件套整组共享,「连接只配一次」);
1280
+ * resources 不投影不写——集成位编辑恒保全资源节,N2) */
1277
1281
  interface ModuleIntegrationNode {
1278
1282
  provider?: string;
1279
1283
  config?: Record<string, unknown>;
1284
+ credentialRef?: string;
1280
1285
  }
1281
1286
  /** ModuleIntegrationNode 可写键集单源(v6——write applyModule 全量替换白名单
1282
- * (键集外 400;resources 恒随既有节点保全)+ views/modules 投影(GET ≡ PUT,三同构)) */
1283
- declare const MODULE_INTEGRATION_NODE_KEYS: readonly ["provider", "config"];
1287
+ * (键集外 400;resources 恒随既有节点保全)+ views/modules 投影(GET ≡ PUT,三同构;
1288
+ * 锁步约束同 SERVICE_INTEGRATION_NODE_KEYS——须 ⊆ contracts zod 节点 schema)) */
1289
+ declare const MODULE_INTEGRATION_NODE_KEYS: readonly ["provider", "config", "credentialRef"];
1284
1290
  /** 模块资源回显(只读投影——N2 读半边:写侧仍仅 provider/config,resources 恒保全)。
1285
1291
  * 原值文件镜像(L1)+ ref 台账展开态:`ref` 在场且同目录 knowledge.json 命中时
1286
1292
  * `resolvedDatasetId` = 台账 datasetId(镜像 SDK resolveKnowledge 展开语义),未命中/台账缺失 = null。
@@ -1578,6 +1584,7 @@ interface IntegrationServicePredicateInput {
1578
1584
  modules?: Record<string, {
1579
1585
  provider?: string;
1580
1586
  config?: Record<string, unknown>;
1587
+ credentialRef?: string;
1581
1588
  resources?: Record<string, {
1582
1589
  type?: unknown;
1583
1590
  }>;
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- import{a as Be,b as se,c as T,d as We}from"./chunk-K5FIGT5A.js";import{z as b}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,bt=b.object({cardType:b.string(),schemaVersion:b.number().optional()}),bn=b.object({route:b.string(),component:b.string()}),An=b.object({route:b.string(),label:b.string().optional(),icon:b.string().optional(),order:b.number().optional()}),Cn=b.object({id:b.string(),range:b.string().optional(),required:b.boolean().default(!0)}),En=b.object({service:b.string(),provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string(),credentialType:b.string(),local:b.boolean().optional(),configSchema:b.string().optional(),credentialSchema:b.string().optional()}),On=b.object({service:b.string(),optional:b.boolean().default(!0),defaults:b.array(b.object({provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string()})).default([]),name:b.string().optional(),description:b.string().optional()}),xn=b.object({service:b.string()}).strict(),Mn=b.object({id:b.string(),type:b.string()}),jn=b.object({$comment:b.union([b.string(),b.record(b.string(),b.unknown())]).optional(),$schema:b.string().optional(),schemaVersion:b.number().default(1),id:b.string(),name:b.string().optional(),description:b.string().optional(),hidden:b.boolean().optional(),version:b.string().default("0.0.0"),kind:b.enum(["platform","business","third-party"]).default("business"),risk:b.object({level:b.enum(["high","medium","low"]).default("low"),writeBoundary:b.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:b.object({defaultMode:b.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:b.object({handlers:b.array(b.string()).default([]),tools:b.array(b.string()).default([]),cards:b.array(bt).default([]),routes:b.array(b.string()).default([]),pages:b.array(bn).default([]),tabs:b.array(An).default([]),providers:b.object({id:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:b.array(En).default([])}).default({}),owns:b.array(xn).default([]),consumes:b.array(On).default([]),resources:b.array(Mn).default([])}).default({}),dependencies:b.object({modules:b.array(Cn).default([])}).default({}),env:b.array(b.string()).default([])}).strict();function At(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ae(e){let n=At(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=jn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Ct=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Nn(e){return JSON.stringify(e).slice(1,-1)}function Ue(e,n=process.env){let r=[],t=e.replace(Ct,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let d=n[o];return d!==void 0?Nn(d):s!==void 0?Nn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as Et,existsSync as Tn,readFileSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt,join as Pn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function jt(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Pn(e,W(n));if(!Tn(r))return null;try{let t=JSON.parse(Ot(r,"utf8"));if(typeof t.type!="string")return null;let{type:i,...o}=t,s={};for(let[d,S]of Object.entries(o))typeof S=="string"&&(s[d]=S);return{type:i,values:s}}catch{return null}}function Ke(e,n,r){let t=Pn(e,W(n)),i=Tn(t);return Et(Mt(t),{recursive:!0}),xt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
- `,"utf8"),i}import{mkdirSync as Nt,renameSync as Tt,writeFileSync as Pt}from"fs";import{dirname as Vt}from"path";function $(e,n){Vn(Vt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;Pt(r,n,"utf8"),Tt(r,e)}function Vn(e){Nt(e,{recursive:!0})}import{existsSync as _,readdirSync as Ge,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as Dt,readFileSync as Dn,mkdirSync as _t,writeFileSync as $t}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function $n(e){let n=Re(e);if(!Dt(n))return null;try{let r=JSON.parse(Dn(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 Ft(e,n){let r=Re(e);_t(_n.dirname(r),{recursive:!0}),$t(r,`${JSON.stringify(n,null,2)}
3
- `,"utf8")}function ze(e){let n=$n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Dn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Lt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Bt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Wt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ut(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Fn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(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:d}=o,S={};typeof s=="string"&&s.length>0&&(S.name=s),typeof d=="string"&&d.length>0&&(S.description=d),(S.name!==void 0||S.description!==void 0)&&(t[i]=S)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=ae(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(!_(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function zt(e){let n=V(e,".tbox","app.json");if(!_(n))return[];try{let r=JSON.parse(X(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 Gt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!_(r))return[];try{let t=JSON.parse(X(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 Wn(e,n){let r=[],t=[e];for(let d of["apps","packages"]){let S=V(e,d);if(_(S))try{for(let l of Ge(S,{withFileTypes:!0}))l.isDirectory()&&t.push(V(S,l.name))}catch{}}let i=new Set,o=(d,S,l)=>{let f=n?n.read(S,Ln):Ln(X(S,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:l})},s=V(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let d of t){let S=V(d,"node_modules","@tbox.cn");if(!_(S))continue;let l=[];try{l=Ge(S)}catch{continue}for(let f of l){let R=V(S,f);if(i.has(R))continue;i.add(R);let k=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(k)?o(R,k,"package"):_(g)&&o(R,g,"package")}}for(let d of t)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])_(S)&&o(d,S,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let y=t.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},l=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},k=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(v.defaults.push(c),w.add(y))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,a.id),d.add(a.id);continue}if(!u)continue;d.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,a.package,f(u)),c.length&&S(c,a.package,v,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){k(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&l(w,a,f(h)),v.length&&S(v,a,m,f(h),w);let c=u?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=Ge(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,m),d.add(m);continue}if(!u)continue;let v=u.id??m;if(d.has(v))continue;d.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,`@app/${v}`,f(u)),c.length&&S(c,`@app/${v}`,h,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${v}`);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),v)}}let x=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)x.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...x].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(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",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(e){return D(e).ownership}function F(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 U(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 de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(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 Kn(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 Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};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 d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:l,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:O,ownership:x,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let N=I??Object.keys(y.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,N,s,x);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(k||g)for(let[c,y]of Object.entries(t.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=I.credentialRef??y.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof M!="string"||!M.startsWith("secret://"))continue;let N=M.slice(9);k?.[N]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${N}(${c}@${A} effective ref=${M};档内 config/credentials/ 无此文件)`});let j=g?.[N];if(j){let P=h(c,y,I,A);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${N}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let u=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(t.services)){if(!o[c]&&x?.[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 y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!K(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){u(I,`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:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),N&&j){let P=M.provider,L=M.implementation;typeof P=="string"&&typeof L=="string"?i[le(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${I})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||m.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=x?.[y],I=A!=null?t.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[y,A]of Object.entries(t.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(t.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=r.resolveEffectiveService(t,c,I,s,x);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(t.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(t.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(x)for(let j of Object.values(x))j===c&&(M+=1);if(I||!(x===void 0)&&M===0){let j=I?"未安装(键 = 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(l){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(l[I]&&c.add(I),!l[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(t.provider);for(let I of Object.values(t.modules??{}))A(I?.provider);for(let I of Object.values(t.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)l[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of l[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let N=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??I).has(q)?Z&&Z.size>0&&!Z.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 L=F(t,j).provider??void 0;if(L===void 0){N(P.config,`modules.${j}.config`,void 0,M);continue}let Z=l[L];if(!Z||R?.[L])continue;let q=f?.[L];N(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,y]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(t.modules??{})){let A=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[I,M]of Object.entries(y?.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.${I} type 非法(${String(N)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(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 ue(e,n,r,t=process.env){let i={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[u,v]of Object.entries(n.catalog.services))o[u]={optional:v.optional,owners:[...v.owners]};let s={},d={},S={},l={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,y=d[v.provider]??=new Set;for(let I of Qt(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[v.provider]=!0}v.credentialSchema&&!Ye(ke(u.dir,v.credentialSchema))&&(l[v.credentialType]=!0)}}let R={},k=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let u of qt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);k.add(v);let w=zn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,O=[],x=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(C.services??{}))if(u&&typeof u=="object"){x(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&x(v.credentialRef)}for(let u of Object.values(C.credentialRefByInstance??{}))x(u);x(C.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[Gn(v)]===void 0&&(k.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,y]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:l,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,S]of Object.entries(s))r[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),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(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function G(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await T(e),t=G(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 E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let S=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,W(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,W(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(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 d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(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 g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.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),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,l=structuredClone(r);l.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(l.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete l.modules[g.module])}else l.provider&&(f.push(`root.provider=${l.provider}`),delete l.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=l.modules??{};if(C[g.module]){let O=C[g.module],x=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${x.join("+")} 整节点)`),delete l.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=l.services[g.service];if(!C)continue;let O=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),O!==void 0?Ee(l.modules?.[O]?.provider):void 0,Ee(l.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete l.services[g.service]}else delete l.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(l.services).length===0&&delete l.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!l.provider&&Object.keys(l.services??{}).length===0&&Object.keys(l.config??{}).length===0&&Object.keys(l.configByInstance??{}).length===0&&!l.credentialRef&&Object.keys(l.credentialRefByInstance??{}).length===0&&(l.instances??[]).length===0&&l.defaultInstanceId==null&&Object.keys(l.modules??{}).length===0;if(!R&&(l.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(l)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):$(n,`${JSON.stringify(l,null,2)}
4
- `),k=ne(e).map(g=>g.message),{removed:f,orphanCredentials:k}}function Oe(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 E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("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 d of Object.values(s))for(let S of d.services)t.add(S);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,d]of Object.entries(e.catalog.services))d.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as rt,readFileSync as it}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>fe(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=>fe(e[i],n[i]))}return!1}var ot=["$comment","$schema"];function Me(e,n){if(n)for(let r of ot)!(r in e)&&r in n&&(e[r]=n[r])}function Xn(e){if(e===null)return null;let n={...e};for(let r of ot)delete n[r];return n}function et(e,n){return fe(Xn(e),Xn(n))}function Pe(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 E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Pe(t,`${n}.${r}`)}}function je(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 E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nt(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 E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Ne(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Te(e,n){let r=re(e,H),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!rt(r))return null;try{return t(it(r,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Je(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(r===void 0||d.services.includes(r))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function tt(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:d}=D(e,o),S=d[`${n}\0${r}`];if(!S?.credentialSchema)return;let l=dr(S.packageDir,S.credentialSchema);if(rt(l))try{let R=new lr({allErrors:!0}).compile(JSON.parse(it(l,"utf8")));if(!R({type:t.type,...t.values})){let k=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",k)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:r,cache:t}=n;function i(l,f,R,k){let g=l!==null,C=f.length>0,O=!k&&g,x=!k&&C;O&&($(re(e,H),`${JSON.stringify(l,null,2)}
5
- `),t?.invalidate([re(e,H)]));let p=O||x;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),C&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let o;async function s(){o=await T(e)}function d(l,f){return l.filter(R=>Array.isArray(R.path)).map(R=>{let k=R.path.map(String).join(".");return f!==""&&k.startsWith(f)&&k.length>f.length?k.slice(f.length):k}).filter(R=>R.length>0)}function S(l,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let k=se(o);if(k==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(o));if(k==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(o)});return}try{o.module.parseIntegrationsConfig(l)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(l,f={}){Pe(l,"root"),nt(l,f,"root"),Ne(l,te,"root");let R=[],k=Te(e,t),g=k??{services:{}};k===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let v of te)v in l||delete C[v];for(let[v,w]of Object.entries(l))C[v]=w;let O=typeof C.provider=="string"?C.provider:"app",x=Hn(O,f.credentials,f.credentialsByInstance);for(let v of x)tt(e,O,void 0,v.input,void 0,t);let p=x.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let v={...C.credentialRefByInstance??{}};for(let w of x)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);C.credentialRefByInstance=v}Me(C,k);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=et(k,C);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};S(C,R,"");let h=f.dryRun===!0,u=Qe(e,x,h);return R.push(...Xe(C)),i(m?null:C,u,R,f.dryRun)},applyModule(l,f,R={}){Pe(f,"root");let{modules:k,catalog:g,ownership:C}=D(e,t),O=k.find(c=>c.id===l);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${l} 非已装模块`);if(!U({modules:k,catalog:g,ownership:C},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${l} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Te(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},u={...h[l]??{}};Ne(f,xe,`modules.${l}`);let v={...u};for(let c of xe){let y=f[c];y==null||y===""||typeof y=="object"&&!Array.isArray(y)&&Object.keys(y).length===0?delete v[c]:v[c]=y}Object.keys(v).length===0?delete h[l]:h[l]=v;let w={...m,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(S(w,p,`modules.${l}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(l,f,R={}){Pe(f,"root"),nt(f,R,"slot"),Ne(f,qn,`services.${l}`);for(let[N,j]of Object.entries(f.instances??{}))Ne(j,Qn,`services.${l}.instances.${N}`);let k=[],g=Te(e,t),C=D(e,t);if(!pe(C.vocabulary,Object.keys(g?.services??{}),l,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&k.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},x={...O.services??{}},p={...O,services:x};Me(p,g),x[l]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",u=l.includes(".")?l.slice(0,l.indexOf(".")):l,v=Zn(h,l,u,R.credentials,R.credentialsByInstance);for(let N of v)tt(e,h,l,N.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=x[l],c=v.find(N=>N.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let N={...w.instances??{}};for(let j of v){if(j.instanceId===void 0)continue;let P={...N[j.instanceId]??{}};P.credentialRef=j.ref,N[j.instanceId]=P}w.instances=N}Me(p,g);let y=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=et(g,p);if(A&&!y)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:k};S(p,k,`services.${l}.`);let I=R.dryRun===!0,M=Qe(e,v,I);return k.push(...Xe(p)),i(A?null:p,M,k,R.dryRun)},deleteService(l){let f=[],R=Te(e,t),k=D(e,t);if(!pe(k.vocabulary,Object.keys(R?.services??{}),l,Object.keys(k.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(l in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[l];let C={...R??{services:{}},services:g};$(re(e,H),`${JSON.stringify(C,null,2)}
6
- `),t?.invalidate([re(e,H)]),f.push(...ne(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[H],credentials:[],issues:f}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var st=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...st]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of st)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&t.push({service:d.service,provider:d.provider,implementation:d.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of t)i[d.service]={};$(n,`${JSON.stringify({...r,provider:s,services:i},null,2)}
7
- `)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation};$(n,`${JSON.stringify({...r,services:i},null,2)}
8
- `)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=F(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(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 De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(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 wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,l=>JSON.parse(l))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,l]of Object.entries(i)){if(!l||typeof l!="object"||Array.isArray(l))continue;let f=l,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),k=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=k??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...k!==void 0?{datasetId:k}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=O}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(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 an(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,g)=>{let C=J(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(k=>o(k.service,k.optional===!1)),...[...new Set(t.ownedServices)].filter(k=>!i.has(k)).map(k=>o(k,!1))],d=e.integrations?.modules??{},S=d[n],l=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:l,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(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 te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let l of Object.values(t))l.services.includes(r)&&o.push({implementation:l.implementation,credentialType:l.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(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&&F(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,l=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,l,s),R=mt(n,e,l),k=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),x=g!==void 0&&O.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...x!==void 0?{supplied:x}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(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 ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(x=>x.id),S=n.integrations?.services?.[e],l=S?.instances?Object.keys(S.instances):void 0,f=St(l,d),R=new Map;for(let x of f)R.set(x,vt(n,t,e,x,i));let k=f.map(x=>{let p=R.get(x);return{instanceId:x,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),O={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:g};return{contracts:_e(n.contracts),resolution:O,issues:r.filter(x=>x.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 wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?F(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.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 ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function $e(e,n,r){let t=B(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=B(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(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 xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(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 Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Nr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Tr(e){let n=e.map(t=>Nr(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=>jr(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(r=!1);let l=S.properties;if(!l||typeof l!="object"||Array.isArray(l))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(l)){let k=t.get(R)??[];k.push({service:o,subschema:l[R],required:f.includes(R)}),t.set(R,k)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Tr(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:F(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt(Fe(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt(Fe(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return F(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(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]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(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,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var $r={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=$r[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Fr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function d(p){return at(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function l(){let p=await T(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},u=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let k={async loadModules(p){let a=await T(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await T(e),u=d(h),v=Oe(u.walk,p),w=an(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await l().then(y=>ve(u,y,c)):$e(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await T(e),h=d(m),u=cn(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await l().then(v=>ve(h,v)):$e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=kn("service",a?.include),h=await T(e),u=d(h),v=Y(u.walk,S(u),p),w=dn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(u,v)),w},async loadServiceResolutions(p){let a=await T(e),m=d(a);if(!ye(a))return $e(m,a,p);let h=await l();return ve(m,h,p)},async loadServiceResolution(p){let a=await T(e),m=d(a),h=Y(m.walk,S(m),p);if(!ye(a))return Rt(h,m,a);let u=await l();return gn(h,m,u)},async loadProviders(){let p=await T(e);return ln(d(p))},async loadProviderSupply(p,a){Fr(a);let m=await T(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await T(e),h=d(m),u=Y(h.walk,S(h),a);return un(h,p,u)},async loadCredentials(){let p=await T(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await T(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await T(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=Oe(d(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=d(h),v=Y(u.walk,S(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await T(e);return o(a),R(()=>{let m=d(a),h=Y(m.walk,S(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await T(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function x(p){return D(p,r)}return{...k,...C,...O}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");$(t,`${JSON.stringify(n,null,2)}
9
- `),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,on as appProviderBinding,Kt as assertValidModuleId,Fe as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Yt as collectDeclaredModules,B as contractsNotResolvedMessage,Lr as createAppToolkit,Be as createFileCache,en as createWriteCore,ir as credentialArtifactExists,fe as deepEqual,Q as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,K as isControlledInlineProvider,Fn as isValidModuleId,Pr as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,U as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ae as parseModuleDescriptor,de as providerFootprint,En as providerSlotContribSchema,cr as pruneIntegrationBindings,$n as readAppManifest,ze as readAppManifestFull,ce as readCredentialFile,G as readIntegrationsConfig,Yn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Gn as refToEnvKey,Bt as removeNpmModule,me as resolutionKeys,T as resolveContractsForApp,T as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,F as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,jt as stemToRef,An as tabContribSchema,Ut as updateNpmModule,Wt as upsertMiniappContainer,Lt as upsertNpmModule,D as walkManifests,Ft as writeAppManifest,$ as writeAtomic,Ke as writeCredentialFile};
1
+ import{a as Be,b as se,c as N,d as We}from"./chunk-K5FIGT5A.js";import{z as b}from"zod";var G=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,bt=b.object({cardType:b.string(),schemaVersion:b.number().optional()}),bn=b.object({route:b.string(),component:b.string()}),An=b.object({route:b.string(),label:b.string().optional(),icon:b.string().optional(),order:b.number().optional()}),Cn=b.object({id:b.string(),range:b.string().optional(),required:b.boolean().default(!0)}),En=b.object({service:b.string(),provider:b.string().regex(G,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string(),credentialType:b.string(),local:b.boolean().optional(),configSchema:b.string().optional(),credentialSchema:b.string().optional()}),On=b.object({service:b.string(),optional:b.boolean().default(!0),defaults:b.array(b.object({provider:b.string().regex(G,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string()})).default([]),name:b.string().optional(),description:b.string().optional()}),xn=b.object({service:b.string()}).strict(),Mn=b.object({id:b.string(),type:b.string()}),jn=b.object({$comment:b.union([b.string(),b.record(b.string(),b.unknown())]).optional(),$schema:b.string().optional(),schemaVersion:b.number().default(1),id:b.string(),name:b.string().optional(),description:b.string().optional(),hidden:b.boolean().optional(),version:b.string().default("0.0.0"),kind:b.enum(["platform","business","third-party"]).default("business"),risk:b.object({level:b.enum(["high","medium","low"]).default("low"),writeBoundary:b.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:b.object({defaultMode:b.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:b.object({handlers:b.array(b.string()).default([]),tools:b.array(b.string()).default([]),cards:b.array(bt).default([]),routes:b.array(b.string()).default([]),pages:b.array(bn).default([]),tabs:b.array(An).default([]),providers:b.object({id:b.string().regex(G,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:b.array(En).default([])}).default({}),owns:b.array(xn).default([]),consumes:b.array(On).default([]),resources:b.array(Mn).default([])}).default({}),dependencies:b.object({modules:b.array(Cn).default([])}).default({}),env:b.array(b.string()).default([])}).strict();function At(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ae(e){let n=At(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=jn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Ct=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Nn(e){return JSON.stringify(e).slice(1,-1)}function Ue(e,n=process.env){let r=[],t=e.replace(Ct,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let d=n[o];return d!==void 0?Nn(d):s!==void 0?Nn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as Et,existsSync as Tn,readFileSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt,join as Pn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function W(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function jt(e){return`secret://${e}`}function U(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Pn(e,U(n));if(!Tn(r))return null;try{let t=JSON.parse(Ot(r,"utf8"));if(typeof t.type!="string")return null;let{type:i,...o}=t,s={};for(let[d,S]of Object.entries(o))typeof S=="string"&&(s[d]=S);return{type:i,values:s}}catch{return null}}function Ke(e,n,r){let t=Pn(e,U(n)),i=Tn(t);return Et(Mt(t),{recursive:!0}),xt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
+ `,"utf8"),i}import{mkdirSync as Nt,renameSync as Tt,writeFileSync as Pt}from"fs";import{dirname as Vt}from"path";function F(e,n){Vn(Vt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;Pt(r,n,"utf8"),Tt(r,e)}function Vn(e){Nt(e,{recursive:!0})}import{existsSync as $,readdirSync as Ge,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as Dt,readFileSync as Dn,mkdirSync as _t,writeFileSync as $t}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function $n(e){let n=Re(e);if(!Dt(n))return null;try{let r=JSON.parse(Dn(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 Ft(e,n){let r=Re(e);_t(_n.dirname(r),{recursive:!0}),$t(r,`${JSON.stringify(n,null,2)}
3
+ `,"utf8")}function ze(e){let n=$n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Dn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Lt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Bt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Wt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ut(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Fn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(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:d}=o,S={};typeof s=="string"&&s.length>0&&(S.name=s),typeof d=="string"&&d.length>0&&(S.description=d),(S.name!==void 0||S.description!==void 0)&&(t[i]=S)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=ae(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(!$(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function zt(e){let n=V(e,".tbox","app.json");if(!$(n))return[];try{let r=JSON.parse(X(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 Gt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!$(r))return[];try{let t=JSON.parse(X(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 Wn(e,n){let r=[],t=[e];for(let d of["apps","packages"]){let S=V(e,d);if($(S))try{for(let u of Ge(S,{withFileTypes:!0}))u.isDirectory()&&t.push(V(S,u.name))}catch{}}let i=new Set,o=(d,S,u)=>{let f=n?n.read(S,Ln):Ln(X(S,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:u})},s=V(e,"config","service-slots.json");$(s)&&o(e,s,"config-override");for(let d of t){let S=V(d,"node_modules","@tbox.cn");if(!$(S))continue;let u=[];try{u=Ge(S)}catch{continue}for(let f of u){let R=V(S,f);if(i.has(R))continue;i.add(R);let k=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");$(k)?o(R,k,"package"):$(g)&&o(R,g,"package")}}for(let d of t)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])$(S)&&o(d,S,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,m,h,l,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...l?.name?{name:l.name}:{},...l?.description?{description:l.description}:{}});let y=t.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&l?.name?{name:l.name}:{},...c&&l?.description?{description:l.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},u=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let l=s[h];l===void 0?s[h]=m:l!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${l} 与 ${m} 均声明 owns(先声明 ${l} 胜出)——修正 manifest declare.owns 互斥`})}},k=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,l=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of l){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(v.defaults.push(c),w.add(y))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...l],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),l=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){k(l,a.id),d.add(a.id);continue}if(!l)continue;d.add(a.id);let v=$(V(m,"tbox.module.json"))?m:h,w=g(l);l.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,a.package,f(l)),c.length&&S(c,a.package,v,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){k(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let l=g(h),v=l?.providers?.slots??[],w=l?.providers?.id;w&&u(w,a,f(h)),v.length&&S(v,a,m,f(h),w);let c=l?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let x=V(e,"packages");if($(x)){let a=[];try{a=Ge(x,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(x,m),l=Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){k(l,m),d.add(m);continue}if(!l)continue;let v=l.id??m;if(d.has(v))continue;d.add(v);let w=g(l);l.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,`@app/${v}`,f(l)),c.length&&S(c,`@app/${v}`,h,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${v}`);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),v)}}let O=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)O.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...O].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!$(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!$(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(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",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(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 K(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 de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function z(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 Kn(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 Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};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 d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:u,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:x,ownership:O,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let T=I??Object.keys(y.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,O);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(k||g)for(let[c,y]of Object.entries(t.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=O?.[c],T=M!=null?t.modules?.[M]?.credentialRef:void 0,j=I.credentialRef??y.credentialRef??T??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof j!="string"||!j.startsWith("secret://"))continue;let P=j.slice(9);k?.[P]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${P}(${c}@${A} effective ref=${j};档内 config/credentials/ 无此文件)`});let _=g?.[P];if(_){let B=h(c,y,I,A);B&&_!==B&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${P}.json type=${_} 与绑定 credentialType ${B} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let l=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))l(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))l(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(t.services)){if(!o[c]&&O?.[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 y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!z(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){l(I,`services.${c}.instances`);let T=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=M.provider,_=M.implementation;typeof P=="string"&&typeof _=="string"?i[le(P,_)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${_} 未命中已装供给(${c}@${I})`}):z(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||m.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=O?.[y],I=A!=null?t.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[y,A]of Object.entries(t.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(t.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=r.resolveEffectiveService(t,c,I,s,O);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(t.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(t.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(O)for(let j of Object.values(O))j===c&&(M+=1);if(I||!(O===void 0)&&M===0){let j=I?"未安装(键 = 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(u){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(u[I]&&c.add(I),!u[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(t.provider);for(let I of Object.values(t.modules??{}))A(I?.provider);for(let I of Object.values(t.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)u[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of u[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let T=(j,P,_,B)=>{for(let[q]of Object.entries(j??{}))(_??I).has(q)?B&&B.size>0&&!B.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 内(死配置)`})};T(t.config,"root.config",void 0,M);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let _=L(t,j).provider??void 0;if(_===void 0){T(P.config,`modules.${j}.config`,void 0,M);continue}let B=u[_];if(!B||R?.[_])continue;let q=f?.[_];T(P.config,`modules.${j}.config`,new Set(B),q)}}}for(let[c,y]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(t.modules??{})){let A=x?.[c];x&&!(c in x)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[I,M]of Object.entries(y?.resources??{})){let T=M?.type;(typeof T!="string"||!r.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${I} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(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 ue(e,n,r,t=process.env){let i={};for(let[l,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${l}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[l,v]of Object.entries(n.catalog.services))o[l]={optional:v.optional,owners:[...v.owners]};let s={},d={},S={},u={},f={};for(let l of n.modules){f[l.id]=new Set((l.descriptor.declare.resources??[]).map(v=>v.id));for(let v of l.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(l.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,y=d[v.provider]??=new Set;for(let I of Qt(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[v.provider]=!0}v.credentialSchema&&!Ye(ke(l.dir,v.credentialSchema))&&(u[v.credentialType]=!0)}}let R={},k=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let l of qt(g)){if(!l.endsWith(".json"))continue;let v=l.slice(0,-5);k.add(v);let w=zn(ke(g,l));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,x=[],O=l=>{typeof l=="string"&&l.startsWith("secret://")&&x.push(l)};for(let l of Object.values(C.services??{}))if(l&&typeof l=="object"){O(l.credentialRef);for(let v of Object.values(l.instances??{}))v&&typeof v=="object"&&O(v.credentialRef)}for(let l of Object.values(C.modules??{}))l&&typeof l=="object"&&O(l.credentialRef);for(let l of Object.values(C.credentialRefByInstance??{}))O(l);O(C.credentialRef);let p={};for(let l of x){let v=l.slice(9);t[Gn(v)]===void 0&&(k.has(v)||(p[v]=!0))}let a=[];for(let[l,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,y]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${l}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(l=>l&&typeof l=="object"&&typeof l.id=="string"?l.id:void 0).filter(l=>typeof l=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:u,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(l=>l.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,S]of Object.entries(s))r[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),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(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function J(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await N(e),t=J(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 E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let S=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,U(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,U(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(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 d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${U(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&z(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=J(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await N(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.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),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,u=structuredClone(r);u.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let x=(u.modules??{})[g.module];x?.provider&&(f.push(`modules.${g.module}.provider=${String(x.provider)}`),delete x.provider,Object.keys(x).length===0&&delete u.modules[g.module])}else u.provider&&(f.push(`root.provider=${u.provider}`),delete u.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=u.modules??{};if(C[g.module]){let x=C[g.module],O=[x.provider!==void 0?"provider":void 0,x.config!==void 0?"config":void 0,x.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${O.join("+")} 整节点)`),delete u.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=u.services[g.service];if(!C)continue;let x=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),x!==void 0?Ee(u.modules?.[x]?.provider):void 0,Ee(u.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete u.services[g.service]}else delete u.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(u.services).length===0&&delete u.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!u.provider&&Object.keys(u.services??{}).length===0&&Object.keys(u.config??{}).length===0&&Object.keys(u.configByInstance??{}).length===0&&!u.credentialRef&&Object.keys(u.credentialRefByInstance??{}).length===0&&(u.instances??[]).length===0&&u.defaultInstanceId==null&&Object.keys(u.modules??{}).length===0;if(!R&&(u.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(u)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):F(n,`${JSON.stringify(u,null,2)}
4
+ `),k=ne(e).map(g=>g.message),{removed:f,orphanCredentials:k}}function Oe(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 E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function H(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let d of Object.values(s))for(let S of d.services)t.add(S);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,d]of Object.entries(e.catalog.services))d.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as rt,readFileSync as it}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config","credentialRef"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var Z=re("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>fe(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=>fe(e[i],n[i]))}return!1}var ot=["$comment","$schema"];function Me(e,n){if(n)for(let r of ot)!(r in e)&&r in n&&(e[r]=n[r])}function Xn(e){if(e===null)return null;let n={...e};for(let r of ot)delete n[r];return n}function et(e,n){return fe(Xn(e),Xn(n))}function Pe(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"&&!G.test(t))throw new E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Pe(t,`${n}.${r}`)}}function je(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!G.test(t))throw new E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nt(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"&&!G.test(s))throw new E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Ne(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Te(e,n){let r=re(e,Z),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!rt(r))return null;try{return t(it(r,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Je(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(r===void 0||d.services.includes(r))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function tt(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:d}=D(e,o),S=d[`${n}\0${r}`];if(!S?.credentialSchema)return;let u=dr(S.packageDir,S.credentialSchema);if(rt(u))try{let R=new lr({allErrors:!0}).compile(JSON.parse(it(u,"utf8")));if(!R({type:t.type,...t.values})){let k=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",k)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:r,cache:t}=n;function i(u,f,R,k){let g=u!==null,C=f.length>0,x=!k&&g,O=!k&&C;x&&(F(re(e,Z),`${JSON.stringify(u,null,2)}
5
+ `),t?.invalidate([re(e,Z)]));let p=x||O;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(Z),C&&m.push(...f.map(h=>U(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let o;async function s(){o=await N(e)}function d(u,f){return u.filter(R=>Array.isArray(R.path)).map(R=>{let k=R.path.map(String).join(".");return f!==""&&k.startsWith(f)&&k.length>f.length?k.slice(f.length):k}).filter(R=>R.length>0)}function S(u,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let k=se(o);if(k==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,W(o));if(k==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:W(o)});return}try{o.module.parseIntegrationsConfig(u)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(u,f={}){Pe(u,"root"),nt(u,f,"root"),Ne(u,te,"root");let R=[],k=Te(e,t),g=k??{services:{}};k===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let v of te)v in u||delete C[v];for(let[v,w]of Object.entries(u))C[v]=w;let x=typeof C.provider=="string"?C.provider:"app",O=Hn(x,f.credentials,f.credentialsByInstance);for(let v of O)tt(e,x,void 0,v.input,void 0,t);let p=O.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let v={...C.credentialRefByInstance??{}};for(let w of O)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);C.credentialRefByInstance=v}Me(C,k);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=et(k,C);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};S(C,R,"");let h=f.dryRun===!0,l=Qe(e,O,h);return R.push(...Xe(C)),i(m?null:C,l,R,f.dryRun)},applyModule(u,f,R={}){Pe(f,"root");let{modules:k,catalog:g,ownership:C}=D(e,t),x=k.find(c=>c.id===u);if(!x)throw new E("MODULE_NOT_FOUND",404,`模块 ${u} 非已装模块`);if(!K({modules:k,catalog:g,ownership:C},x).writable)throw new E("VALIDATION_FAILED",400,`模块 ${u} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Te(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},l={...h[u]??{}};Ne(f,xe,`modules.${u}`);let v={...l};for(let c of xe){let y=f[c];y==null||y===""||typeof y=="object"&&!Array.isArray(y)&&Object.keys(y).length===0?delete v[c]:v[c]=y}Object.keys(v).length===0?delete h[u]:h[u]=v;let w={...m,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(S(w,p,`modules.${u}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(u,f,R={}){Pe(f,"root"),nt(f,R,"slot"),Ne(f,qn,`services.${u}`);for(let[T,j]of Object.entries(f.instances??{}))Ne(j,Qn,`services.${u}.instances.${T}`);let k=[],g=Te(e,t),C=D(e,t);if(!pe(C.vocabulary,Object.keys(g?.services??{}),u,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&k.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let x=g??{services:{}},O={...x.services??{}},p={...x,services:O};Me(p,g),O[u]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",l=u.includes(".")?u.slice(0,u.indexOf(".")):u,v=Zn(h,u,l,R.credentials,R.credentialsByInstance);for(let T of v)tt(e,h,u,T.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=O[u],c=v.find(T=>T.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let T={...w.instances??{}};for(let j of v){if(j.instanceId===void 0)continue;let P={...T[j.instanceId]??{}};P.credentialRef=j.ref,T[j.instanceId]=P}w.instances=T}Me(p,g);let y=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=et(g,p);if(A&&!y)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:k};S(p,k,`services.${u}.`);let I=R.dryRun===!0,M=Qe(e,v,I);return k.push(...Xe(p)),i(A?null:p,M,k,R.dryRun)},deleteService(u){let f=[],R=Te(e,t),k=D(e,t);if(!pe(k.vocabulary,Object.keys(R?.services??{}),u,Object.keys(k.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(u in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[u];let C={...R??{services:{}},services:g};F(re(e,Z),`${JSON.stringify(C,null,2)}
6
+ `),t?.invalidate([re(e,Z)]),f.push(...ne(e));let x=r!==void 0;return x&&r?.(),{written:!0,restartScheduled:x,files:[Z],credentials:[],issues:f}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var st=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...st]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of st)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&t.push({service:d.service,provider:d.provider,implementation:d.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of t)i[d.service]={};F(n,`${JSON.stringify({...r,provider:s,services:i},null,2)}
7
+ `)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation};F(n,`${JSON.stringify({...r,services:i},null,2)}
8
+ `)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=L(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:z(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=J(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(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 De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function Y(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 wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,u=>JSON.parse(u))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,u]of Object.entries(i)){if(!u||typeof u!="object"||Array.isArray(u))continue;let f=u,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),k=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=k??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),x={type:R,...k!==void 0?{datasetId:k}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=x}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(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 an(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=K(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,g)=>{let C=Y(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(k=>o(k.service,k.optional===!1)),...[...new Set(t.ownedServices)].filter(k=>!i.has(k)).map(k=>o(k,!1))],d=e.integrations?.modules??{},S=d[n],u=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{},...typeof S.credentialRef=="string"?{credentialRef:S.credentialRef}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:u,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=Y(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 te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=Y(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let u of Object.values(t))u.services.includes(r)&&o.push({implementation:u.implementation,credentialType:u.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(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 vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,u=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,u,s),R=mt(n,e,u),k=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:g??null,layer:R??null},x=new Set(Object.keys(n.catalog.providers)),O=g!==void 0&&x.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...O!==void 0?{supplied:O}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(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 ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(O=>O.id),S=n.integrations?.services?.[e],u=S?.instances?Object.keys(S.instances):void 0,f=St(u,d),R=new Map;for(let O of f)R.set(O,vt(n,t,e,O,i));let k=f.map(O=>{let p=R.get(O);return{instanceId:O,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),x={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:g};return{contracts:_e(n.contracts),resolution:x,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 wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?L(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.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 ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function $e(e,n,r){let t=W(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=W(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(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 xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=K(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:Y(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(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 Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Nr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Tr(e){let n=e.map(t=>Nr(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=>jr(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(r=!1);let u=S.properties;if(!u||typeof u!="object"||Array.isArray(u))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(u)){let k=t.get(R)??[];k.push({service:o,subschema:u[R],required:f.includes(R)}),t.set(R,k)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Tr(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!K(n.walk,t).writable?null:L(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt(Fe(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt(Fe(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(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 Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(z(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(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]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(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,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var $r={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=$r[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Fr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,W(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,W(p))}function d(p){return at(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function u(){let p=await N(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},l=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...l})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let k={async loadModules(p){let a=await N(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await N(e),l=d(h),v=Oe(l.walk,p),w=an(l,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await u().then(y=>ve(l,y,c)):$e(l,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(l,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await N(e),h=d(m),l=cn(h);if(a.has("serviceResolutions")&&(l.serviceResolutions=ye(m)?await u().then(v=>ve(h,v)):$e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(l.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(l.integrationFieldRegistry=v.integrationFieldRegistry)}return l},async loadService(p,a){let m=kn("service",a?.include),h=await N(e),l=d(h),v=H(l.walk,S(l),p),w=dn(l,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(l,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(l,v)),w},async loadServiceResolutions(p){let a=await N(e),m=d(a);if(!ye(a))return $e(m,a,p);let h=await u();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=d(a),h=H(m.walk,S(m),p);if(!ye(a))return Rt(h,m,a);let l=await u();return gn(h,m,l)},async loadProviders(){let p=await N(e);return ln(d(p))},async loadProviderSupply(p,a){Fr(a);let m=await N(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=d(m),l=H(h.walk,S(h),a);return un(h,p,l)},async loadCredentials(){let p=await N(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await N(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await N(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=Oe(d(h).walk,p);return g.applyModule(l.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=d(h),v=H(l.walk,S(l),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return o(a),R(()=>{let m=d(a),h=H(m.walk,S(m),p);return g.deleteService(h)})}},x={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return N(e)},walkManifests(){return O(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return J(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function O(p){return D(p,r)}return{...k,...C,...x}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");F(t,`${JSON.stringify(n,null,2)}
9
+ `),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,G as SAFE_NAME_PATTERN,on as appProviderBinding,Kt as assertValidModuleId,Fe as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Yt as collectDeclaredModules,W as contractsNotResolvedMessage,Lr as createAppToolkit,Be as createFileCache,en as createWriteCore,ir as credentialArtifactExists,fe as deepEqual,Q as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,z as isControlledInlineProvider,Fn as isValidModuleId,Pr as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,K as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ae as parseModuleDescriptor,de as providerFootprint,En as providerSlotContribSchema,cr as pruneIntegrationBindings,$n as readAppManifest,ze as readAppManifestFull,ce as readCredentialFile,J as readIntegrationsConfig,Yn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Gn as refToEnvKey,Bt as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,L as resolveModuleBinding,Oe as resolveModuleKey,H as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,U as stemToFilePath,jt as stemToRef,An as tabContribSchema,Ut as updateNpmModule,Wt as upsertMiniappContainer,Lt as upsertNpmModule,D as walkManifests,Ft as writeAppManifest,F as writeAtomic,Ke as writeCredentialFile};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbox.cn/app-toolkit",
3
- "version": "0.8.5",
3
+ "version": "0.8.6",
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.13.3",
21
+ "@tbox.cn/app-contracts": "0.13.4",
22
22
  "typescript": "5.9.3",
23
23
  "tsup": "8.5.1",
24
24
  "vitest": "4.1.10",
package/src/dto.ts CHANGED
@@ -100,7 +100,7 @@ export interface ModuleDetailView {
100
100
  /** v6 所有权模型:模块归属服务(declare.owns 展平,排序;零归属 = [])——
101
101
  * v5 domainKeys 退役(破坏性更名;面板 presence-detection 双读义务见 api.md §3) */
102
102
  ownedServices: string[];
103
- /** modules[install id] 集成位原值(provider/config;resources 不投影——见 resources 字段);未配置 = null */
103
+ /** modules[install id] 集成位原值(provider/config/credentialRef——共享连接归属层三键;resources 不投影——见 resources 字段);未配置 = null */
104
104
  integration: ModuleIntegrationNode | null;
105
105
  /** 模块资源只读镜像(N2 读半边——写侧 resources 恒保全;含 ref 台账展开态 resolvedDatasetId);
106
106
  * 无模块键/无资源节 = null */
@@ -293,16 +293,19 @@ export const APP_INTEGRATION_NODE_KEYS = [
293
293
  'defaultInstanceId',
294
294
  ] as const;
295
295
 
296
- /** 模块集成位节点(v6——provider 绑定默认 + config 级联层;resources 不投影不写——
297
- * 集成位编辑恒保全资源节,N2) */
296
+ /** 模块集成位节点(v6——provider 绑定默认 + config 级联层 + credentialRef 共享凭据归属层
297
+ * (contracts ModuleConfig.credentialRef——连接三件套整组共享,「连接只配一次」);
298
+ * resources 不投影不写——集成位编辑恒保全资源节,N2) */
298
299
  export interface ModuleIntegrationNode {
299
300
  provider?: string;
300
301
  config?: Record<string, unknown>;
302
+ credentialRef?: string;
301
303
  }
302
304
 
303
305
  /** ModuleIntegrationNode 可写键集单源(v6——write applyModule 全量替换白名单
304
- * (键集外 400;resources 恒随既有节点保全)+ views/modules 投影(GET ≡ PUT,三同构)) */
305
- export const MODULE_INTEGRATION_NODE_KEYS = ['provider', 'config'] as const;
306
+ * (键集外 400;resources 恒随既有节点保全)+ views/modules 投影(GET ≡ PUT,三同构;
307
+ * 锁步约束同 SERVICE_INTEGRATION_NODE_KEYS——须 ⊆ contracts zod 节点 schema)) */
308
+ export const MODULE_INTEGRATION_NODE_KEYS = ['provider', 'config', 'credentialRef'] as const;
306
309
 
307
310
  /** ServiceIntegrationNode 可写键集单源(applyService 节点键纪律白名单——assertNodeKeys
308
311
  * 无条件静态防线,zod 未知键拒绝语义前移,两态一致 400;0.8.2 降级写批新增。
@@ -150,12 +150,15 @@ export function buildPredicateAssembly(
150
150
 
151
151
  const ig = integrations as {
152
152
  services?: Record<string, { provider?: unknown; credentialRef?: unknown; instances?: Record<string, { provider?: unknown; credentialRef?: unknown }> }>;
153
+ modules?: Record<string, { credentialRef?: unknown }>;
153
154
  credentialRefByInstance?: Record<string, unknown>;
154
155
  credentialRef?: unknown;
155
156
  instances?: unknown;
156
157
  };
157
158
 
158
- // ── #1 effective 候选 stem 收集(槽级 + 实例级 + root ByInstance + root 标量;env 通道兜底)──
159
+ // ── #1 effective 候选 stem 收集(槽级 + 实例级 + modules[owner] 归属层 + root ByInstance +
160
+ // root 标量;env 通道兜底)——归属层 credentialRef 与绑定组/config 同层共担(contracts
161
+ // 归属链补全),文件/环境两通道探测同其余层(模块层放的不存在凭据同样 CREDENTIAL_FILE_MISSING) ──
159
162
  const refs: string[] = [];
160
163
  const pushRef = (v: unknown): void => {
161
164
  if (typeof v === 'string' && v.startsWith('secret://')) refs.push(v);
@@ -168,6 +171,9 @@ export function buildPredicateAssembly(
168
171
  }
169
172
  }
170
173
  }
174
+ for (const mod of Object.values(ig.modules ?? {})) {
175
+ if (mod && typeof mod === 'object') pushRef(mod.credentialRef);
176
+ }
171
177
  for (const v of Object.values(ig.credentialRefByInstance ?? {})) pushRef(v);
172
178
  pushRef(ig.credentialRef);
173
179
  const credentialFileMissing: Record<string, boolean> = {};
@@ -111,7 +111,7 @@ export interface IntegrationServicePredicateInput {
111
111
  /** v4 默认实例(normalizeInstances 解析语义:显式 ?? 单候选唯一解) */
112
112
  defaultInstanceId?: string | null;
113
113
  /** v6 模块集成位(modules 节三键——宽松透传;严格 zod 归模板 loader) */
114
- modules?: Record<string, { provider?: string; config?: Record<string, unknown>; resources?: Record<string, { type?: unknown }> }>;
114
+ modules?: Record<string, { provider?: string; config?: Record<string, unknown>; credentialRef?: string; resources?: Record<string, { type?: unknown }> }>;
115
115
  };
116
116
  /** 已声明供给(`${vendor}\u0000${implementation}` → 槽集合;credentialType 供 #2/#6 绑定侧对齐) */
117
117
  suppliedProviders: Record<string, { services: string[]; owner: string; credentialType?: string }>;
@@ -265,7 +265,9 @@ export function evaluateIntegrationServices(
265
265
  for (const [serviceId, service] of Object.entries(integrations.services)) {
266
266
  for (const [instanceId, instance] of Object.entries(service.instances ?? {})) {
267
267
  if (instance.enabled === false) continue;
268
- const ref = instance.credentialRef ?? service.credentialRef
268
+ const owner = ownership?.[serviceId];
269
+ const moduleRef = owner != null ? integrations.modules?.[owner]?.credentialRef : undefined;
270
+ const ref = instance.credentialRef ?? service.credentialRef ?? moduleRef
269
271
  ?? integrations.credentialRefByInstance?.[instanceId] ?? integrations.credentialRef;
270
272
  if (typeof ref !== 'string' || !ref.startsWith('secret://')) continue;
271
273
  const stem = ref.slice('secret://'.length);
@@ -309,7 +309,9 @@ export function createWriteCore(appDir: string, opts: WriteCoreOptions = {}): Wr
309
309
  const written = integrationsWritten || credentialsWritten;
310
310
  // 孤儿凭据写后对账(api.md §4.13 承诺追平——「覆盖 DELETE 与 PUT 替换两类来源」;三 PUT 写路径
311
311
  // finalize 单点收口,未来第四写方法自动继承)。dryRun(written 蕴含 !dryRun)与 no-diff
312
- // (finalize 前短路 return)天然跳过;applyModule modules 节无凭据键——对账恒零新增,无害捎带。
312
+ // (finalize 前短路 return)天然跳过;applyModule 节点键为 provider/config/credentialRef
313
+ // ——credentialRef 是机密引用(引用落 integrations.json,真值恒走凭据旁路),无凭据文件
314
+ // 写动作,对账仍零新增比对项,无害捎带。
313
315
  if (written) issues.push(...reconcileOrphanCredentials(appDir));
314
316
  const restartScheduled = written && onApplied !== undefined;
315
317
  if (restartScheduled) onApplied?.();
@@ -132,8 +132,9 @@ export function loadModuleDetailView(snapshot: ViewSnapshot, moduleId: string):
132
132
  ...[...new Set(w.ownedServices)].filter((service) => !consumed.has(service)).map((service) => toDemand(service, false)),
133
133
  ];
134
134
  const modulesNode = (snapshot.integrations as { modules?: Record<string, unknown> } | null)?.modules ?? {};
135
- // integration = modules[install id] 集成位投影(编辑预填源;provider/config 两键——
136
- // resources 不投影不写,N2);未配置 = null
135
+ // integration = modules[install id] 集成位投影(编辑预填源;provider/config/credentialRef
136
+ // 三键 ≡ MODULE_INTEGRATION_NODE_KEYS(GET ≡ PUT 三同构——共享连接归属层凭据可经配置
137
+ // 面维护);resources 不投影不写,N2);未配置 = null
137
138
  const rawNode = modulesNode[moduleId] as Record<string, unknown> | undefined;
138
139
  const integration: ModuleDetailView['integration'] = rawNode
139
140
  ? {
@@ -141,6 +142,7 @@ export function loadModuleDetailView(snapshot: ViewSnapshot, moduleId: string):
141
142
  ...(rawNode.config && typeof rawNode.config === 'object' && !Array.isArray(rawNode.config)
142
143
  ? { config: rawNode.config as Record<string, unknown> }
143
144
  : {}),
145
+ ...(typeof rawNode.credentialRef === 'string' ? { credentialRef: rawNode.credentialRef } : {}),
144
146
  }
145
147
  : null;
146
148
  // v8 三轴同构:configured/effective/inherited(moduleProviderBinding 单源);
@@ -91,7 +91,8 @@ describe.skipIf(parseIntegrationsConfig === undefined)('键集-zod 锁步(asse
91
91
  it('module 节点:MODULE_INTEGRATION_NODE_KEYS 全键过 zod;未知键被 zod 拒', () => {
92
92
  const mod: Record<string, unknown> = {};
93
93
  for (const k of MODULE_INTEGRATION_NODE_KEYS) {
94
- mod[k] = k === 'provider' ? 'mock' : {};
94
+ // 标量键给标量形态(provider/credentialRef = string;config = record)
95
+ mod[k] = k === 'config' ? {} : (k === 'provider' || k === 'credentialRef') ? 'secret://x' : {};
95
96
  }
96
97
  expectZodPass({ services: {}, modules: { 'module-x': mod } });
97
98
  expectZodReject({ services: {}, modules: { 'module-x': { ...mod, unknownKey: 1 } } });
@@ -142,7 +142,7 @@ describe('module resources 只读投影(N2 读半边)', () => {
142
142
  noResourcesKey.app.dispose();
143
143
  });
144
144
 
145
- it('T5 写侧保全不变量:MODULE_INTEGRATION_NODE_KEYS 白名单恒不含 resources(N2 写半边不变)', () => {
146
- expect(MODULE_INTEGRATION_NODE_KEYS).toEqual(['provider', 'config']);
145
+ it('T5 写侧保全不变量:MODULE_INTEGRATION_NODE_KEYS 白名单恒不含 resources(N2 写半边不变;credentialRef 归属层凭据键入集——resources 仍恒保全)', () => {
146
+ expect(MODULE_INTEGRATION_NODE_KEYS).toEqual(['provider', 'config', 'credentialRef']);
147
147
  });
148
148
  });
@@ -0,0 +1,96 @@
1
+ /**
2
+ * 归属层凭据引用扫描回归(P2 返修):modules[owner].credentialRef 与槽/实例层
3
+ * 同诊断面——「同一不存在的凭据,放模块层与放槽层同报 CREDENTIAL_FILE_MISSING」。
4
+ * 覆盖两通道:
5
+ * - 文件通道:config/credentials/<stem>.json 缺席 → missing(stem 收集含归属层);
6
+ * - 环境通道:env 键在场(stem kebab → UPPER_SNAKE)→ 不算缺失(wanda env 化语义);
7
+ * - 求值转折:evaluateIntegrationServices 消费归属层 ref → #1 CREDENTIAL_FILE_MISSING
8
+ * (service/instance 定位信息随 issue 携带——诊断可定位)。
9
+ */
10
+ import { describe, expect, it } from 'vitest';
11
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
12
+ import { join } from 'node:path';
13
+ import { buildPredicateAssembly } from '../src/integrations/predicate-io.js';
14
+ import { evaluateIntegrationServices } from '../src/integrations/predicate.js';
15
+ import { walkManifests } from '../src/assembly/walk-manifests.js';
16
+ import { createTempApp, writeAppFile } from './demo-app.js';
17
+
18
+ const GHOST = 'secret://ghost-cred';
19
+
20
+ function appWithRef(modules: Record<string, unknown>, slotRef?: string) {
21
+ const app = createTempApp('tbox-credref-');
22
+ mkdirSync(join(app.appDir, 'packages', 'module-parking'), { recursive: true });
23
+ writeAppFile(app.appDir, 'packages/module-parking/tbox.module.json', JSON.stringify({
24
+ schemaVersion: 1, id: 'module-parking', version: '0.1.0', kind: 'business',
25
+ name: '停车缴费',
26
+ declare: { owns: [{ service: 'parking.query' }] },
27
+ }));
28
+ writeAppFile(app.appDir, 'config/integrations.json', JSON.stringify({
29
+ modules,
30
+ services: { 'parking.query': { instances: { '9001': {} }, ...(slotRef ? { credentialRef: slotRef } : {}) } },
31
+ }));
32
+ return app;
33
+ }
34
+
35
+ describe('buildPredicateAssembly:#1 stem 收集含 modules[*].credentialRef', () => {
36
+ it('文件通道:模块层不存在凭据 → missing(与槽层同报);槽层对照同诊断', () => {
37
+ const appMod = appWithRef({ 'module-parking': { provider: 'mock', credentialRef: GHOST } });
38
+ const asmMod = buildPredicateAssembly(appMod.appDir, walkManifests(appMod.appDir), integrationsOf(appMod.appDir), {});
39
+ expect(asmMod.credentialFileMissing['ghost-cred']).toBe(true);
40
+
41
+ const appSlot = appWithRef({}, GHOST);
42
+ const asmSlot = buildPredicateAssembly(appSlot.appDir, walkManifests(appSlot.appDir), integrationsOf(appSlot.appDir), {});
43
+ expect(asmSlot.credentialFileMissing['ghost-cred']).toBe(true);
44
+ appMod.dispose();
45
+ appSlot.dispose();
46
+ });
47
+
48
+ it('环境通道:env 键在场(kebab → UPPER_SNAKE) → 不算缺失(文件缺席免报)', () => {
49
+ const app = appWithRef({ 'module-parking': { provider: 'mock', credentialRef: GHOST } });
50
+ const asm = buildPredicateAssembly(app.appDir, walkManifests(app.appDir), integrationsOf(app.appDir), { GHOST_CRED: 'x' });
51
+ expect(asm.credentialFileMissing['ghost-cred']).toBeUndefined();
52
+ app.dispose();
53
+ });
54
+
55
+ it('文件通道对照:credentials/<stem>.json 在场 → 不报', () => {
56
+ const app = appWithRef({ 'module-parking': { provider: 'mock', credentialRef: GHOST } });
57
+ mkdirSync(join(app.appDir, 'config', 'credentials'), { recursive: true });
58
+ writeFileSync(join(app.appDir, 'config', 'credentials', 'ghost-cred.json'), JSON.stringify({ type: 'bearer' }));
59
+ const asm = buildPredicateAssembly(app.appDir, walkManifests(app.appDir), integrationsOf(app.appDir), {});
60
+ expect(asm.credentialFileMissing['ghost-cred']).toBeUndefined();
61
+ app.dispose();
62
+ });
63
+ });
64
+
65
+ describe('evaluateIntegrationServices:归属层 ref 的 #1 转折(doctor 面终态)', () => {
66
+ it('模块层凭据缺文件 + ownership 绑定在 → CREDENTIAL_FILE_MISSING 带 service 定位', () => {
67
+ const issues = evaluateIntegrationServices({
68
+ integrations: {
69
+ modules: { 'module-parking': { provider: 'mock', credentialRef: GHOST } },
70
+ services: { 'parking.query': { instances: { '9001': {} } } },
71
+ } as never,
72
+ suppliedProviders: {},
73
+ demandedServices: {},
74
+ contracts: {
75
+ normalizeInstances: (cfg: { instances?: unknown[]; defaultInstanceId?: unknown }) => ({
76
+ instances: cfg.instances ?? [],
77
+ defaultInstanceId: cfg.defaultInstanceId ?? null,
78
+ }),
79
+ },
80
+ ownership: { 'parking.query': 'module-parking' },
81
+ credentialFileMissing: { 'ghost-cred': true },
82
+ credentialFileType: {},
83
+ } as never);
84
+ const hits = issues.filter((i) => i.code === 'CREDENTIAL_FILE_MISSING');
85
+ expect(hits).toHaveLength(1);
86
+ expect(hits[0]?.service).toBe('parking.query');
87
+ expect(hits[0]?.severity).toBe('error');
88
+ // issue 文案含归属层 ref 语义定位(模块层引用同样可诊断)
89
+ expect(hits[0]?.message).toContain('parking.query');
90
+ expect(hits[0]?.message).toContain('ghost-cred');
91
+ });
92
+ });
93
+
94
+ function integrationsOf(appDir: string): Record<string, unknown> {
95
+ return JSON.parse(readFileSync(join(appDir, 'config/integrations.json'), 'utf8')) as Record<string, unknown>;
96
+ }
@@ -386,6 +386,25 @@ describe('views/工厂(O 矩阵核心族)', () => {
386
386
  expect(mod.integration).toEqual({ provider: 'wanda' });
387
387
  });
388
388
 
389
+ it('O1b 模块集成位投影含 credentialRef(GET ≡ PUT 三同构——共享连接归属层凭据可经配置面维护)', async () => {
390
+ const appView = await h.tk.loadApp();
391
+ expect(appView.integration?.provider).toBe('mock');
392
+ const mod = await h.tk.loadModule('module-parking');
393
+ // 基座 integrations modules 节仅 provider → 投影仅 provider(无凭据键不合成)
394
+ expect(mod.integration).toEqual({ provider: 'wanda' });
395
+ // 写侧带入 credentialRef 后读对偶对齐(新 toolkit 实例读同 app——与 PUT body 三同构)
396
+ writeIntegrations(h.app.appDir, {
397
+ provider: 'mock',
398
+ instances: [{ id: 'mall-bj-01', name: '北京店' }],
399
+ defaultInstanceId: 'mall-bj-01',
400
+ modules: { 'module-parking': { provider: 'wanda', config: { baseUrl: 'x' }, credentialRef: 'secret://parking-shared' } },
401
+ services: { 'parking.query': { provider: 'wanda', implementation: 'wanda-parking@1' } },
402
+ });
403
+ const tk2 = createAppToolkit(h.app.appDir);
404
+ const mod2 = await tk2.loadModule('module-parking');
405
+ expect(mod2.integration).toEqual({ provider: 'wanda', config: { baseUrl: 'x' }, credentialRef: 'secret://parking-shared' });
406
+ });
407
+
389
408
  it('O2 静态投影零求值键:/app、/modules/:m、/services/:s 结构性无 resolution/issues/contracts', async () => {
390
409
  const appView = await h.tk.loadApp();
391
410
  expect(Object.keys(appView)).toEqual(['services', 'integration', 'binding']);
@@ -367,6 +367,35 @@ describe('写核心管线(FX-1c)', () => {
367
367
  h2.app.dispose();
368
368
  });
369
369
 
370
+ it('v6-G4 模块级 credentialRef 可写(共享连接归属层——DTO/白名单投影三同构):写入/读回/清键', async () => {
371
+ const h2 = harnessWithModule();
372
+ writeAppFile(h2.app.appDir, INTEGRATIONS_FILE, JSON.stringify({
373
+ services: {},
374
+ modules: { 'module-parking': { provider: 'wanda', config: { baseUrl: 'x' } } },
375
+ }, null, 2));
376
+ // 写入(全量替换语义——credentialRef 进节点,provider/config 保留)
377
+ const r = await h2.tk.writeModuleIntegration('module-parking', {
378
+ provider: 'wanda', config: { baseUrl: 'x' }, credentialRef: 'secret://parking-shared',
379
+ });
380
+ expect(r.written).toBe(true);
381
+ const cfg = h2.readConfig();
382
+ expect((cfg.modules as Record<string, unknown>)['module-parking']).toEqual({
383
+ provider: 'wanda', config: { baseUrl: 'x' }, credentialRef: 'secret://parking-shared',
384
+ });
385
+ // 清键:PUT 不带 credentialRef = 该键删除(集成位编辑三键全量替换);resources 保全语义同
386
+ await h2.tk.writeModuleIntegration('module-parking', { provider: 'wanda', config: { baseUrl: 'x' } });
387
+ const cfg2 = h2.readConfig();
388
+ expect((cfg2.modules as Record<string, unknown>)['module-parking']).toEqual({ provider: 'wanda', config: { baseUrl: 'x' } });
389
+ h2.app.dispose();
390
+ });
391
+
392
+ it('v6-G5 implementation 仍是模块节外键(catalog 派生命名空间——不进 DTO/白名单/锁步 zod 键集)', async () => {
393
+ const h2 = harnessWithModule();
394
+ await expect(h2.tk.writeModuleIntegration('module-parking', { provider: 'wanda', implementation: 'wanda-parking@1' } as never))
395
+ .rejects.toMatchObject({ code: 'VALIDATION_FAILED', httpStatus: 400 });
396
+ h2.app.dispose();
397
+ });
398
+
370
399
  it('v6-G3 键集纪律:node 含 provider/config 外键 → 400(fail-visible);零归属模块 → 400', async () => {
371
400
  const h2 = harnessWithModule();
372
401
  await expect(h2.tk.writeModuleIntegration('module-parking', { provider: 'x', resources: { k: {} } } as never))