@tbox.cn/app-toolkit 0.8.1 → 0.8.2
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/README.md +14 -3
- package/dist/chunk-K5FIGT5A.js +1 -0
- package/dist/contracts-resolver-2COLDT6T.js +1 -0
- package/dist/index.d.ts +18 -10
- package/dist/index.js +9 -9
- package/package.json +1 -1
- package/src/core/contracts-resolver.ts +20 -1
- package/src/core/errors.ts +2 -2
- package/src/dto.ts +12 -0
- package/src/factory.ts +39 -27
- package/src/integrations/read.ts +1 -1
- package/src/integrations/write.ts +59 -27
- package/src/views/service-resolutions.ts +4 -2
- package/tests/contracts-resolver.test.ts +16 -1
- package/tests/demo-app.ts +1 -1
- package/tests/keyset-lockstep.test.ts +95 -0
- package/tests/views.test.ts +7 -2
- package/tests/write-core.test.ts +141 -2
- package/dist/chunk-WUULQDOV.js +0 -1
- package/dist/contracts-resolver-PS2UH2G6.js +0 -1
package/README.md
CHANGED
|
@@ -45,6 +45,17 @@ views/ 视图装配:modules / app / service-detail / service-resolutio
|
|
|
45
45
|
| ③ 发布形态门禁 | `pnpm --filter @tbox.cn/app-toolkit pack --check`(prepack 内建 build,tgz 内即 minified dist) | 打包完整性 |
|
|
46
46
|
| ④ 跨仓 file: tgz 联调 | agtcodingbox 联调(`file:` tgz 消费——真实宿主) | 消费面全链路 |
|
|
47
47
|
|
|
48
|
-
## 能力门控(
|
|
49
|
-
|
|
50
|
-
|
|
48
|
+
## 能力门控(0.8.2 降级写批:contractsTier 三态状态机单源)
|
|
49
|
+
|
|
50
|
+
**状态机**(`core/contracts-resolver contractsTier`——判据 = version null 与否,非严格校验面):
|
|
51
|
+
`degraded`(version null = 未安装/未构建/导入拒绝)|`blocked`(包在场但能力缺失 = <0.9 已装 / ≥0.9 缺 OWNERSHIP_BINDING_V6 标记)|`ok`。
|
|
52
|
+
|
|
53
|
+
**读求值轴**(loadServiceResolutions / loadServiceResolution / include=serviceResolutions):contracts 不可用 →
|
|
54
|
+
**200 降级骨架**(`evaluation-unavailable` + N1 指引入 statusMessage;机制见 Agent Note evaluation-axis-degrade)。
|
|
55
|
+
**写×4 = tier !== 'blocked' 放行**:`ok` 全量 zod;`degraded` 跳过 zod 降级保存 + `SaveResult.issues` warning
|
|
56
|
+
`STRICT_VALIDATION_SKIPPED`(N1 指引单源,dryRun 对称;后装依赖由 doctor/求值轴 fail-visible 兜底);`blocked`
|
|
57
|
+
503 升级指引(v6 形状写入旧代码语境静默无效或被旧 zod 拒)。**Internals 写面无门**(ensureMockBindings 纯 fs
|
|
58
|
+
派生 / writeIntegrationsConfig 透传整写零校验——行为不随 contracts 状态分叉,blanket 残留摘除;形状责任在调用方)。
|
|
59
|
+
**evaluate = tier === 'ok'**。静态方法与 contracts 可用性解耦。门控断言单点 = 工厂边缘(assertWritableContracts /
|
|
60
|
+
assertFullyUsable),机制层保持纯函数;节点键集静态防线 `assertNodeKeys`(四位未知键 400,无条件两态一致——
|
|
61
|
+
zod 拒绝语义前移,tests/keyset-lockstep 锁步)。
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{existsSync as l,readdirSync as V,realpathSync as m}from"fs";import{join as c}from"path";import{pathToFileURL as M}from"url";import{existsSync as T,readFileSync as w,statSync as x}from"fs";function p(){let e=new Map,n=0;function r(t){if(!T(t))return null;let s=x(t);return`${s.mtimeMs}:${s.size}`}return{read(t,s){let o=r(t);if(o===null){e.delete(t);return}let i=e.get(t);if(i&&i.fingerprint===o)return i.value;n+=1;let a=s(w(t,"utf8"));return e.set(t,{fingerprint:o,value:a}),a},invalidate(t){if(t===void 0){e.clear();return}for(let s of t)e.delete(s)},get parseCount(){return n}}}var g=["resolveEffectiveService","buildSupplyLookup","moduleDomainOf","normalizeInstances","RESOURCE_TYPE_IDS"],F="parseIntegrationsConfig",N="OWNERSHIP_BINDING_V6",v={version:null,evaluation:!1,strictValidation:!1,ownershipBindingV6:!1,module:{},notes:[]};function C(e){let n=[e];for(let r of["apps","packages"]){let t=c(e,r);if(!l(t))continue;let s=V(t,{withFileTypes:!0}).filter(o=>o.isDirectory()).map(o=>o.name);r==="apps"?s.sort((o,i)=>o==="server"?-1:i==="server"?1:o.localeCompare(i)):s.sort((o,i)=>o.localeCompare(i));for(let o of s)n.push(c(t,o))}return n}var u=new Map,h=p();function b(e){return h.read(e,n=>{let r=JSON.parse(n);return typeof r.version=="string"?r.version:null})??null}function y(e){if(!l(e))return"gone";let n;try{n=m(e)}catch{n=e}return l(c(n,"dist","runtime.js"))?"dist":l(c(n,"src","runtime.ts"))?"src":"none"}function R(e){let n=c(e,"package.json");return{pkgPath:n,candidateDir:e,version:b(n),artifact:y(e)}}function E(e){for(let n of C(e)){let r=c(n,"node_modules","@tbox.cn","app-contracts"),t=c(r,"package.json");if(l(t))return{pkgPath:t,candidateDir:r,version:b(t),artifact:y(r)}}return null}function d(e){return e===null?"none":`${e.pkgPath}|${e.version??"null"}|${e.artifact}`}function O(e,n){let r=E(e);if(d(r)!==d(n.first))return!1;if(n.resolved===null)return!0;let t=r!==null&&r.candidateDir===n.resolved.candidateDir?r:R(n.resolved.candidateDir);return d(t)===d(n.resolved)}function L(e){return e.version===null?"degraded":!e.ownershipBindingV6||!e.strictValidation?"blocked":"ok"}async function _(e,n){if(!l(e))return null;let r;try{r=m(e)}catch{return null}let s=[c(r,"dist","runtime.js"),c(r,"src","runtime.ts")].find(i=>l(i)),o=h.read(c(e,"package.json"),i=>{let a=JSON.parse(i);return typeof a.version=="string"?a.version:null})??null;if(s===void 0)return n.push(`contracts ${o??"(版本未知)"} 探测命中但无构建产物(dist/runtime.js 缺失)——workspace 源码态未构建:执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null;try{let i=o!==null?`?v=${encodeURIComponent(o)}`:"",a=await import(M(s).href+i),f=g.every(S=>a[S]!==void 0),P=a[F]!==void 0,k=a[N]===!0;return{version:o,evaluation:f,strictValidation:P,ownershipBindingV6:k,module:a,notes:f?[]:[`${s} 命中但求值面具名导出缺席(${g.join("/")})——契约包形态异常`]}}catch(i){return n.push(`contracts ${o??"(版本未知)"} 构建产物导入失败(${i instanceof Error?i.message:String(i)})——workspace 源码态未构建或产物损坏:执行 pnpm --filter @tbox.cn/app-contracts build 后重试`),null}}function H(e){let n=u.get(e);if(n&&O(e,n))return n.promise;let r=E(e),t={promise:Promise.resolve({...v}),first:r,resolved:r};return t.promise=(async()=>{let s=[];for(let o of C(e)){let i=c(o,"node_modules","@tbox.cn","app-contracts"),a=await _(i,s);if(a)return a.version!==null&&!a.strictValidation&&a.notes.push(`contracts ${a.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`),t.resolved=R(i),a}return t.resolved=null,s.length===0&&s.push("contracts 不可解析(未安装)——检查应用依赖安装后重试"),{...v,notes:s}})(),u.set(e,t),t.promise}function z(e){e===void 0?u.clear():u.delete(e)}export{p as a,L as b,H as c,z as d};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{b as a,c as b,d as c}from"./chunk-K5FIGT5A.js";export{a as contractsTier,c as invalidateContractsResolver,b as resolveContractsForApp};
|
package/dist/index.d.ts
CHANGED
|
@@ -1434,6 +1434,10 @@ interface ContractsResolution {
|
|
|
1434
1434
|
version: string | null;
|
|
1435
1435
|
evaluation: boolean;
|
|
1436
1436
|
strictValidation: boolean;
|
|
1437
|
+
/** v6 形状标记(内部 ResolvedContracts.ownershipBindingV6 判据投影;additive 0.8.2——
|
|
1438
|
+
* 消费语义:false = 偏斜降级(写轴 503 / 前端禁保存);**缺席 = 旧 toolkit 未投影,不得按降级处理**;
|
|
1439
|
+
* 降级/阻断判定矩阵单源 = api.md §5 消费指引) */
|
|
1440
|
+
ownershipBindingV6?: boolean;
|
|
1437
1441
|
notes: string[];
|
|
1438
1442
|
}
|
|
1439
1443
|
/** 字段级真源 = 谓词结构化输出(H7) */
|
|
@@ -2216,8 +2220,8 @@ declare class AppToolkitError extends Error {
|
|
|
2216
2220
|
* P-4:notes 优先——resolver 在全部不可解析路径均已 push 携带操作指引的 notes(导入失败/
|
|
2217
2221
|
* 产物缺失/未安装/<0.9 升级);现行 version===null 分支会把 notes 内细分指引吞成通用文案。
|
|
2218
2222
|
* 分支保留为兜底(防御性——正常路径 notes 恒非空)。
|
|
2219
|
-
* v7:+= ownershipBindingV6
|
|
2220
|
-
*
|
|
2223
|
+
* v7:+= ownershipBindingV6 分支(标记门第四分支单源化——写门控(现 assertWritableContracts /
|
|
2224
|
+
* assertFullyUsable,0.8.2 降级写批拆分)与读求值轴降级 statusMessage 共用同一文案;可选参向后兼容)。 */
|
|
2221
2225
|
declare function contractsNotResolvedMessage(contracts: {
|
|
2222
2226
|
version: string | null;
|
|
2223
2227
|
strictValidation: boolean;
|
|
@@ -2411,13 +2415,15 @@ declare function loadCredentialTypesView(snapshot: ViewSnapshot, provider?: stri
|
|
|
2411
2415
|
* Read+Write = HTTP 直通面 additive 冻结(L1 端点↔方法 1:1,L3 命名镜像:Integration=节点级 /
|
|
2412
2416
|
* Config=文件级);Internals = CLI/doctor/桥消费(自由演进)。
|
|
2413
2417
|
*
|
|
2414
|
-
* **门控断言单点(policy at edge——
|
|
2415
|
-
*
|
|
2416
|
-
*
|
|
2417
|
-
*
|
|
2418
|
-
*
|
|
2419
|
-
*
|
|
2420
|
-
*
|
|
2418
|
+
* **门控断言单点(policy at edge——0.8.2 降级写批收窄为 contractsTier 两策略)**:写×4 =
|
|
2419
|
+
* tier !== 'blocked'(version null 降级放行——跳过 zod + STRICT_VALIDATION_SKIPPED warning 承载
|
|
2420
|
+
* 感知;<0.9 已装/偏斜 503 升级指引);evaluate = tier === 'ok'(求值无降级语义);
|
|
2421
|
+
* ensureMockBindings / writeIntegrationsConfig 无门(行为不随 contracts 状态分叉——纯 fs 派生 /
|
|
2422
|
+
* 透传整写,blanket 残留摘除);静态方法不门控(永不 503——铁律 #3);**读求值轴(
|
|
2423
|
+
* loadServiceResolutions/loadServiceResolution 及 include 装配)v7 起不再 503**——contracts 不可用
|
|
2424
|
+
* → 200 降级骨架(evaluation-unavailable,doctor 分级先例对齐;依据链与裁决见 Agent Note
|
|
2425
|
+
* evaluation-axis-degrade);**include 装配为条件分支非门控**(四面统一骨架);
|
|
2426
|
+
* integrations/ views/ 机制层保持纯函数。
|
|
2421
2427
|
*
|
|
2422
2428
|
* 并发:进程内写串行(per-factory promise chain)+ 原子写 + 写后本实例缓存即刻失效。
|
|
2423
2429
|
* onApplied:toolkit 判定「需要重启」(实际落盘且非 dryRun/no-diff)→ 调用一次 +
|
|
@@ -2500,8 +2506,10 @@ interface AppToolkitInternals {
|
|
|
2500
2506
|
loadProviderCatalogRaw(): ReturnType<typeof loadProviderCatalogRaw>;
|
|
2501
2507
|
/** 文件级读(doctor/migrate;宽松透传——strict 校验归门控面) */
|
|
2502
2508
|
readIntegrationsConfig(): Promise<Record<string, unknown> | null>;
|
|
2503
|
-
/** 文件级整写(provider-migrate
|
|
2509
|
+
/** 文件级整写(provider-migrate;0.8.2 降级写批摘门——行为不随 contracts 状态分叉,
|
|
2510
|
+
* config 形状兼容性责任在调用方(保形迁移)) */
|
|
2504
2511
|
writeIntegrationsConfig(config: Record<string, unknown>): Promise<void>;
|
|
2512
|
+
/** mock 绑定物化(0.8.2 降级写批摘门——纯 fs 派生零 contracts 依赖) */
|
|
2505
2513
|
ensureMockBindings(): Promise<ReturnType<typeof ensureMockBindings>>;
|
|
2506
2514
|
/** 谓词单源(contracts 注入签名;结构化输出) */
|
|
2507
2515
|
evaluateIntegrationServices(input: Omit<Parameters<typeof evaluateIntegrationServices>[0], 'contracts'>): Promise<IntegrationServiceIssue[]>;
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import{a as
|
|
2
|
-
`,"utf8"),
|
|
3
|
-
`,"utf8")}function We(e){let n=Vn(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Pn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function jt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Tt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Pt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Nt(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Dn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Vt(e,n){if(!Dn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Fn(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(i=>typeof i=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:l}=o,v={};typeof s=="string"&&s.length>0&&(v.name=s),typeof l=="string"&&l.length>0&&(v.description=l),(v.name!==void 0||v.description!==void 0)&&(t[i]=v)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=se(i);if(o.ok)return{kind:"strict",id:o.value.id,version:o.value.version,descriptor:o.value,declare:o.value.declare};if(o.legacy)return{kind:"legacy",detail:o.errors.join("; ")};if(i&&typeof i=="object"&&"declare"in i){let s=i;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!F(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function Dt(e){let n=V(e,".tbox","app.json");if(!F(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 Ft(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!F(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 $n(e,n){let r=[],t=[e];for(let l of["apps","packages"]){let v=V(e,l);if(F(v))try{for(let c of Ue(v,{withFileTypes:!0}))c.isDirectory()&&t.push(V(v,c.name))}catch{}}let i=new Set,o=(l,v,c)=>{let f=n?n.read(v,Fn):Fn(X(v,"utf8"));f!=null&&r.push({dir:l,slots:f.slots,meta:f.meta,via:c})},s=V(e,"config","service-slots.json");F(s)&&o(e,s,"config-override");for(let l of t){let v=V(l,"node_modules","@tbox.cn");if(!F(v))continue;let c=[];try{c=Ue(v)}catch{continue}for(let f of c){let k=V(v,f);if(i.has(k))continue;i.add(k);let w=V(k,"service-slots.json"),y=V(k,"src","service-slots.json");F(w)?o(k,w,"package"):F(y)&&o(k,y,"package")}}for(let l of t)for(let v of[V(l,"service-slots.json"),V(l,"src","service-slots.json")])F(v)&&o(l,v,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},l=new Set,v=(d,S,R,u,m)=>{for(let I of d){let a=m===void 0||m===I.provider;a&&(t.vendorMeta[I.provider]??={owner:S,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let h=t.providers[I.provider]??={},A=h[I.implementation];A?A.services.includes(I.service)||A.services.push(I.service):(h[I.implementation]={provider:I.provider,implementation:I.implementation,credentialType:I.credentialType,owner:S,...a&&u?.name?{name:u.name}:{},...a&&u?.description?{description:u.description}:{},...I.local?{local:!0}:{},...I.configSchema?{configSchema:I.configSchema}:{},...I.credentialSchema?{credentialSchema:I.credentialSchema}:{},services:[I.service]},t.credentialTypes[I.credentialType]??={owner:S,packageDir:R,...I.credentialSchema?{credentialSchema:I.credentialSchema}:{}});let C=`${I.provider}\0${I.service}`;i[C]||(i[C]={...I.configSchema?{configSchema:I.configSchema}:{},...I.credentialSchema?{credentialSchema:I.credentialSchema}:{},packageDir:R})}},c=(d,S,R)=>{t.providers[d]??={},t.vendorMeta[d]??={owner:S,...R?.name?{name:R.name}:{},...R?.description?{description:R.description}:{}}},f=d=>d.kind==="strict"?{name:d.descriptor.name,description:d.descriptor.description}:void 0,k=(d,S)=>{for(let R of d){let u=s[R];u===void 0?s[R]=S:u!==S&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:S,message:`服务 ${R} 归属冲突:${u} 与 ${S} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},w=(d,S)=>{d.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:S,message:`${S}:${d.detail}`})},y=d=>d.kind==="strict"||d.kind==="loose"?d.declare:null,E=(d,S)=>{let R=d.optional!==!1,u=d.defaults??[],m=t.services[d.service];if(m){m.optional=m.optional&&R;let I=new Set(m.defaults.map(a=>`${a.provider}\0${a.implementation}`));for(let a of u){let h=`${a.provider}\0${a.implementation}`;I.has(h)||(m.defaults.push(a),I.add(h))}m.owners.includes(S)||m.owners.push(S);return}t.services[d.service]={optional:R,defaults:[...u],...d.name?{name:d.name}:{},...d.description?{description:d.description}:{},owners:[S]}};for(let d of Dt(e)){if(l.has(d.id))continue;let S=V(e,"packages",d.id),R=V(e,"node_modules",...d.package.split("/")),u=Ie(V(S,"tbox.module.json"),n)??Ie(V(R,"tbox.module.json"),n);if(u?.kind==="legacy"){w(u,d.id),l.add(d.id);continue}if(!u)continue;l.add(d.id);let m=F(V(S,"tbox.module.json"))?S:R,I=y(u);u.kind==="strict"&&r.push({id:d.id,dir:m,pkg:d.mode==="sdk"?d.package:`@app/${d.id}`,descriptor:u.descriptor});let a=I?.providers?.slots??[],h=I?.providers?.id;h&&c(h,d.package,f(u)),a.length&&v(a,d.package,m,f(u),h);let A=I?.consumes??[];for(let M of A)E(M,d.package);let C=u.kind==="strict"?u.descriptor.declare.owns:[];C.length&&k(C.map(M=>M.service),d.id)}for(let{pkg:d,dir:S}of Ft(e)){let R=Ie(V(S,"tbox.module.json"),n);if(R?.kind==="legacy"){w(R,d);continue}if(!R?.id||l.has(R.id))continue;l.add(R.id);let u=y(R),m=u?.providers?.slots??[],I=u?.providers?.id;I&&c(I,d,f(R)),m.length&&v(m,d,S,f(R),I);let a=u?.consumes??[];for(let A of a)E(A,d);let h=R.kind==="strict"?R.descriptor.declare.owns:[];h.length&&k(h.map(A=>A.service),R.id)}let x=V(e,"packages");if(F(x)){let d=[];try{d=Ue(x,{withFileTypes:!0}).filter(S=>S.isDirectory()).map(S=>S.name)}catch{}for(let S of d){if(l.has(S))continue;let R=V(x,S),u=Ie(V(R,"tbox.module.json"),n);if(u?.kind==="legacy"){w(u,S),l.add(S);continue}if(!u)continue;let m=u.id??S;if(l.has(m))continue;l.add(m);let I=y(u);u.kind==="strict"&&r.push({id:m,dir:R,pkg:`@app/${m}`,descriptor:u.descriptor});let a=I?.providers?.slots??[],h=I?.providers?.id;h&&c(h,`@app/${m}`,f(u)),a.length&&v(a,`@app/${m}`,R,f(u),h);let A=I?.consumes??[];for(let M of A)E(M,`@app/${m}`);let C=u.kind==="strict"?u.descriptor.declare.owns:[];C.length&&k(C.map(M=>M.service),m)}}let p=new Set,g={};for(let d of $n(e,n)){for(let S of d.slots)p.add(S);for(let[S,R]of Object.entries(d.meta))g[S]===void 0&&(g[S]=R)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...p].sort(),slotMeta:g,ownership:s,declarationIssues:o}}function _n(e,n,r){let t=V(e,"src",n,"index.ts");if(!F(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function _t(e){let n=V(e,"src","server","index.ts");if(!F(n))return"";try{return X(n,"utf8")}catch{return""}}function Ln(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function $t(e){let n=[],r=D(e),t=We(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",l=_n(o.dir,"server","serverModule"),v=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:l,hasClientEntry:_n(o.dir,"client","clientModule"),hasCards:(v.cards?.length??0)>0,...l?{moduleId:Ln(_t(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Lt(e){return D(e).ownership}function $(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 W(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 ce(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function U(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 Bn(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 ze(e,n){let r=new Set(n),t=[],i=(o,s)=>{let l=Bn(o,s,r);l&&t.push(l)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let l of Object.keys(s.instances??{}))i(l,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:l,credentialSchemaMissing:v,vendorConfigKeys:c,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:k,credentialFileMissing:w,credentialFileType:y,realmSwitchHints:E,moduleResourceNeeds:x,ownership:p,installedModuleIds:g}=e,d=l?new Set(l):void 0;for(let a of E??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:a});let S=new Set(Object.keys(i).map(a=>a.slice(0,a.indexOf("\0"))).filter(a=>a.length>0)),R=(a,h,A,C)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[de(A.provider,A.implementation)]?.credentialType;if(typeof h.provider=="string"&&typeof h.implementation=="string")return i[de(h.provider,h.implementation)]?.credentialType;let M=h.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let P=C??Object.keys(h.instances??{})[0]??"",j=r.resolveEffectiveService(t,a,P,s,p);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[de(j.effective.provider,j.effective.implementation)]?.credentialType};if(w||y)for(let[a,h]of Object.entries(t.services))for(let[A,C]of Object.entries(h.instances??{})){if(C.enabled===!1)continue;let M=C.credentialRef??h.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof M!="string"||!M.startsWith("secret://"))continue;let P=M.slice(9);w?.[P]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:a,instance:A,message:`integrations: 凭据文件缺失 ${P}(${a}@${A} effective ref=${M};档内 config/credentials/ 无此文件)`});let j=y?.[P];if(j){let N=R(a,h,C,A);N&&j!==N&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:a,instance:A,message:`integrations: 凭据文件 ${P}.json type=${j} 与绑定 credentialType ${N} 不一致(${a}@${A}——transport 创建期将按 type 选策略)`})}}let u=(a,h)=>{if(!d)return;let A=Bn(a,h,d);A&&n.push(A)};for(let[a]of Object.entries(t.configByInstance??{}))u(a,"configByInstance");for(let[a]of Object.entries(t.credentialRefByInstance??{}))u(a,"credentialRefByInstance");let m=Object.entries(t.services).filter(([,a])=>a.instances==null||a.instances["*"]!=null).map(([a])=>a);if(m.length>0){let a=Object.entries(t.services).filter(([,h])=>h.instances!=null&&h.instances["*"]==null).map(([h])=>h);a.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${m.join(", ")};显式键集:${a.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let I=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});I.instances.length>=2&&I.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${I.instances.length} 个部署实例(${I.instances.map(a=>a.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[a,h]of Object.entries(t.services)){if(!o[a]&&p?.[a]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:a,message:`integrations: 服务槽 ${a} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof h.provider=="string"?typeof h.implementation=="string"&&!i[de(h.provider,h.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:a,message:`integrations: provider ${h.provider}/${h.implementation} 未命中已装供给(${a} 槽级)——装对应 provider 包或改绑`}):h.provider!==void 0&&!U(h.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:a,message:`integrations: 内联 provider 超受控形状(${a} 槽级;允许键 provider/credentialType/configSchema)`}),v){let C=R(a,h);C&&v[C]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:a,message:`integrations: credentialType ${C} 的 schema 引用不存在(${a};manifest 声明指向缺失文件)`})}typeof h.provider=="object"&&typeof h.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,message:`integrations: 内联厂商声明必须同时提供 implementation(${a} 槽级)`});for(let[C,M]of Object.entries(h.instances??{})){u(C,`services.${a}.instances`);let P=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!P&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,instance:C,message:`integrations: 实例级 implementation 需伴随 provider(${a}@${C}——impl-only 禁止,provider 是绑定组头)`}),P&&j){let N=M.provider,L=M.implementation;typeof N=="string"&&typeof L=="string"?i[de(N,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:a,instance:C,message:`integrations: 实例级 provider 覆盖 ${N}/${L} 未命中已装供给(${a}@${C})`}):U(N)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:a,instance:C,message:`integrations: 实例级内联 provider 超受控形状(${a}@${C})`})}}}for(let[a,h]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,C])=>[`modules.${A}`,C?.provider])])typeof h!="string"||h.length===0||S.has(h)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:a.startsWith("modules.")?a.slice(8):void 0,message:`integrations: ${a} provider ${h} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[a,h]of Object.entries(t.services)){let A=h.instances?Object.keys(h.instances):[""];for(let C of A){let M=r.resolveEffectiveService(t,a,C,s,p);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:a,instance:C||void 0,message:`integrations: ${M.message}`})}}for(let[a,h]of Object.entries(t.services))h.implementation!==void 0&&h.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,message:`integrations: 槽级 implementation 需伴随 provider(${a}——impl-only 禁止,provider 是绑定组头)`});for(let[a,h]of Object.entries(t.modules??{})){if(!(h?.provider!==void 0||h?.config!==void 0))continue;let C=g?!g.has(a):!1,M=0;if(p)for(let j of Object.values(p))j===a&&(M+=1);if(C||!(p===void 0)&&M===0){let j=C?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:a,message:`integrations: modules.${a} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(c){let a=new Set,h=!1,A=C=>{typeof C!="string"||C.length===0||(c[C]&&a.add(C),!c[C]&&!k?.[C]&&(h=!0),k?.[C]&&(h=!0))};A(t.provider);for(let C of Object.values(t.modules??{}))A(C?.provider);for(let C of Object.values(t.services)){let M=C.provider;A(typeof C.provider=="string"?C.provider:M?.provider)}if(a.size>0&&!h){let C=new Set;for(let j of a)for(let N of c[j]??[])C.add(N);let M=new Set;for(let j of a)for(let N of f?.[j]??[])M.add(N);let P=(j,N,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??C).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${N} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${N} 键 ${q} 不在引用厂商(${[...a].join("/")})任何槽 schema properties 内(死配置)`})};P(t.config,"root.config",void 0,M);for(let[j,N]of Object.entries(t.configByInstance??{}))P(N,`root.configByInstance[${j}]`,void 0,M);for(let[j,N]of Object.entries(t.modules??{})){if(!N?.config)continue;let L=$(t,j).provider??void 0;if(L===void 0){P(N.config,`modules.${j}.config`,void 0,M);continue}let Z=c[L];if(!Z||k?.[L])continue;let q=f?.[L];P(N.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[a,h]of Object.entries(o)){let A=t.services[a];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:a,message:`integrations: 服务槽 ${a}(需求方 ${h.owners.join(", ")})未配置${h.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let C=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);C.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:a,instance:C.join(", "),message:`integrations: ${a} 实例禁用(${C.join(", ")})`})}for(let[a,h]of Object.entries(t.modules??{})){let A=x?.[a];x&&!(a in x)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:a,message:`integrations: modules.${a} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[C,M]of Object.entries(h?.resources??{})){let P=M?.type;(typeof P!="string"||!r.RESOURCE_TYPE_IDS.includes(P))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:a,message:`integrations: modules.${a}.resources.${C} type 非法(${String(P)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(C)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:a,message:`integrations: modules.${a}.resources.${C} 未被模块 manifest declare.resources 声明`})}}return n}function de(e,n){return`${e}\0${n}`}import{existsSync as Ke,readFileSync as Bt,readdirSync as Wt}from"fs";import{join as ke}from"path";function Un(e){return e.replaceAll("-","_").toUpperCase()}function Wn(e){if(!Ke(e))return null;try{let n=JSON.parse(Bt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Ut(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 le(e,n,r,t=process.env){let i={};for(let[u,m]of Object.entries(n.catalog.providers))for(let[I,a]of Object.entries(m))i[`${u}\0${I}`]={services:[...a.services],owner:a.owner,credentialType:a.credentialType};let o={};for(let[u,m]of Object.entries(n.catalog.services))o[u]={optional:m.optional,owners:[...m.owners]};let s={},l={},v={},c={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(m=>m.id));for(let m of u.descriptor.declare.providers?.slots??[]){if(m.configSchema){let I=Wn(ke(u.dir,m.configSchema));if(I){let a=s[m.provider]??=new Set,h=l[m.provider]??=new Set;for(let C of Ut(I))a.add(C);let A=I.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[C,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&h.add(C)}else v[m.provider]=!0}m.credentialSchema&&!Ke(ke(u.dir,m.credentialSchema))&&(c[m.credentialType]=!0)}}let k={},w=new Set,y=ke(e,"config","credentials");if(Ke(y))for(let u of Wt(y)){if(!u.endsWith(".json"))continue;let m=u.slice(0,-5);w.add(m);let I=Wn(ke(y,u));I&&typeof I.type=="string"&&(k[m]=I.type)}let E=r,x=[],p=u=>{typeof u=="string"&&u.startsWith("secret://")&&x.push(u)};for(let u of Object.values(E.services??{}))if(u&&typeof u=="object"){p(u.credentialRef);for(let m of Object.values(u.instances??{}))m&&typeof m=="object"&&p(m.credentialRef)}for(let u of Object.values(E.credentialRefByInstance??{}))p(u);p(E.credentialRef);let g={};for(let u of x){let m=u.slice(9);t[Un(m)]===void 0&&(w.has(m)||(g[m]=!0))}let d=[];for(let[u,m]of Object.entries(E.services??{})){let I=m&&typeof m=="object"&&typeof m.provider=="string"?m.provider:void 0;for(let[a,h]of Object.entries((m&&typeof m=="object"?m.instances:void 0)??{})){let A=h&&typeof h=="object"&&typeof h.provider=="string"?h.provider:void 0;I&&A&&A!==I&&d.push(`integrations: ${u}@${a} 实现覆盖跨厂商(${I} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let R=((Array.isArray(E.instances)?E.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:g,credentialFileType:k,credentialSchemaMissing:c,vendorConfigKeys:s,vendorGlobalConfigKeys:l,vendorConfigSchemaMissing:v,realmSwitchHints:d,moduleResourceNeeds:f,...R.length>0?{malls:R}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as si,readFileSync as ai}from"fs";import{join as di,resolve as li}from"path";function Je(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[l,v]of Object.entries(s))r[o][l]={provider:v.provider,implementation:v.implementation,credentialType:v.credentialType,owner:v.owner,...v.local?{local:!0}:{},...v.configSchema?{configSchema:v.configSchema}:{},...v.credentialSchema?{credentialSchema:v.credentialSchema}:{},services:[...v.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(l=>({...l})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ge(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),l=le(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...l})}import{existsSync as Zt,rmSync as qt}from"fs";import{join as Qt}from"path";import{existsSync as zt,readFileSync as Kt}from"fs";import{join as zn}from"path";var Jt=zn("config","integrations.json");function K(e,n){let r=zn(e,Jt),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!zt(r))return null;try{return t(Kt(r,"utf8"))}catch{return null}}async function Kn(e,n){let r=await T(e),t=K(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 O("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new O("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function ue(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as Gt,existsSync as Ce,readFileSync as Ht}from"fs";import{join as Ae}from"path";function Jn(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 Gn(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,l]of Object.entries(i??{})){let v=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:v,ref:`secret://${v}`,input:l})}return o}function Ye(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ce(Ae(e,B(t.stem))):Be(e,t.stem,t.input)}))}function Yt(e,n){return Ce(Ae(e,B(n)))}function He(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)He(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))He(r,n)}function ne(e){let n=Ae(e,"config","credentials"),r=new Set,t=Ae(e,"config","integrations.json");if(Ce(t))try{He(JSON.parse(Ht(t,"utf8")),r)}catch{}let i=[];if(!Ce(n))return i;let o=[];try{o=Gt(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let l=ae(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${B(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&U(e)){let n=e.provider;return n.length>0?n:void 0}}async function Xt(e){let n=Qt(e,"config","integrations.json"),r=K(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 y=Le(JSON.stringify(r),process.env);if(y.missing.length>0||y.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(y.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ge(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),l=new Set(Object.keys(s.catalog.providers)),v=s.ownership,c=structuredClone(r);c.services??={};let f=[];for(let y of o)if(y.severity==="error"){if(y.code==="VENDOR_NOT_INSTALLED")if(y.module){let x=(c.modules??{})[y.module];x?.provider&&(f.push(`modules.${y.module}.provider=${String(x.provider)}`),delete x.provider,Object.keys(x).length===0&&delete c.modules[y.module])}else c.provider&&(f.push(`root.provider=${c.provider}`),delete c.provider);else if(y.code==="MODULE_CONFIG_DEAD"&&y.module){let E=c.modules??{};if(E[y.module]){let x=E[y.module],p=[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.${y.module}(${p.join("+")} 整节点)`),delete c.modules[y.module]}}else if(y.code==="BINDING_UNRESOLVED"&&y.service){let E=c.services[y.service];if(!E)continue;let x=v[y.service];if([y.instance?Ee(E.instances?.[y.instance]?.provider):void 0,Ee(E.provider),x!==void 0?Ee(c.modules?.[x]?.provider):void 0,Ee(c.provider)].filter(g=>typeof g=="string").some(g=>l.has(g)))continue;if(y.instance){let g=E.instances;if(!g||!(y.instance in g))continue;delete g[y.instance],f.push(`services.${y.service}.instances.${y.instance}`),Object.keys(g).length===0&&delete E.instances,Object.keys(E).length===0&&delete c.services[y.service]}else delete c.services[y.service],f.push(`services.${y.service}`)}}if(Object.keys(c.services).length===0&&delete c.services,f.length===0)return{removed:f,orphanCredentials:[]};let k=!c.provider&&Object.keys(c.services??{}).length===0&&Object.keys(c.config??{}).length===0&&Object.keys(c.configByInstance??{}).length===0&&!c.credentialRef&&Object.keys(c.credentialRefByInstance??{}).length===0&&(c.instances??[]).length===0&&c.defaultInstanceId==null&&Object.keys(c.modules??{}).length===0;if(!k&&(c.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(c)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let w=[];return k?Zt(n)&&qt(n,{force:!0}):_(n,`${JSON.stringify(c,null,2)}
|
|
4
|
-
`),
|
|
5
|
-
`),t?.invalidate([
|
|
6
|
-
`),t?.invalidate([
|
|
7
|
-
`)}else{for(let
|
|
8
|
-
`)}return{generated:!0,reason:"generated",services:r.map(o=>o.service).sort()}}var Xe={provider:null,layer:null};function en(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:Xe}function nn(e){let n=en(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:Xe,inherited:Xe}}function Te(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=$(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?en(e):o}}function or(e){return typeof e=="string"?e.length>0?e:null:U(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=or(t),o=n.ownership[r],s=o!==void 0?Te(e,o).effective:en(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as sr,readFileSync as ar}from"fs";import{join as nt}from"path";function Qn(e,n){let r=D(e.appDir,e.cache),t=K(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function Xn(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 Pe(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 cr=nt("config","knowledge.json");function dr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=nt(e.appDir,cr),s={};if(sr(o))try{s=(e.cache?.read(o,c=>JSON.parse(c))??JSON.parse(ar(o,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[v,c]of Object.entries(i)){if(!c||typeof c!="object"||Array.isArray(c))continue;let f=c,k=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),w=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,y=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,E=w??(y!==void 0&&typeof s[y]?.datasetId=="string"?s[y].datasetId:null),x={type:k,...w!==void 0?{datasetId:w}:{},...y!==void 0?{ref:y}:{},resolvedDatasetId:E,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};l[v]=x}return Object.keys(l).length>0?l:null}function et(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function lr(e){return et(e.id).startsWith("provider-")||et(e.pkg).startsWith("provider-")}function tn(e,n={}){return{modules:e.walk.modules.filter(t=>!lr(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 rn(e,n){let r=e.walk.modules.find(w=>w.id===n);if(!r)throw new O("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=W(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(w=>w.service)),o=(w,y)=>{let E=J(e.walk,w);return{service:w,name:E.name,...E.description!==void 0?{description:E.description}:{},required:y}},s=[...(r.descriptor.declare.consumes??[]).map(w=>o(w.service,w.optional===!1)),...[...new Set(t.ownedServices)].filter(w=>!i.has(w)).map(w=>o(w,!1))],l=e.integrations?.modules??{},v=l[n],c=v?{...typeof v.provider=="string"?{provider:v.provider}:{},...v.config&&typeof v.config=="object"&&!Array.isArray(v.config)?{config:v.config}:{}}:null,f=Te(e.integrations,n),k={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:c,resources:dr(e,n,l),binding:k,configEditable:t.writable,services:s}}function on(e){let n=Xn(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 pe)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:nn(t)}}function sn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!ue(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new O("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 it,readFileSync as ot,realpathSync as tt}from"fs";import{isAbsolute as ur,join as pr,relative as fr,resolve as rt,sep as gr}from"path";function an(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 cn(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let c of Object.values(t))c.services.includes(r)&&o.push({implementation:c.implementation,credentialType:c.credentialType});let s=i[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!l)throw t?new O("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new O("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&l&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let v=ie(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:v,integrationSchemas:{configSchema:v}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?dn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?mr(e.appDir,t):null}function dn(e,n,r){if(!r)return null;let t=pr(n,r);if(!it(t))return null;try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function mr(e,n){let r=rt(e,"config","schemas"),t=rt(e,n),i=fr(r,t);if(i===""||i.startsWith("..")||ur(i))throw new O("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!it(t))return null;let o,s;try{o=tt(r),s=tt(t)}catch{return null}if(s!==o&&!s.startsWith(o+gr))throw new O("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(ot(t,"utf8"))}catch{return null}}function Ne(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,notes:[...e.notes]}}function st(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&&$(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function at(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,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:o.effective.implementation,effective:{provider:l,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:st(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function ct(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function ln(e,n,r){let t=ct(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),l=i,c=t.normalizeInstances({instances:l?.instances,defaultInstanceId:l?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??at(n,t,e,c,s),k=st(n,e,c),w=n.integrations?.services?.[e]?.provider,y=f.provider??(typeof w=="string"?w:typeof w=="object"&&w?String(w.provider):void 0),E={provider:y??null,layer:k??null},x=new Set(Object.keys(n.catalog.providers)),p=y!==void 0&&x.has(y)?vr(n.catalog,y,e):void 0,g=o.services[e],d=g!==void 0?!g.optional:void 0,S=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:E,...y!==void 0?{provider:y}:{},...y!==void 0&&k!==null?{layer:k}:{},...p!==void 0?{supplied:p}:{},...S!==void 0?{module:S}:{},...d!==void 0?{required:d}:{}}}function vr(e,n,r){return Pe(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]=ln(i,e));return{contracts:Ne(e.contracts),resolutions:t,issues:n}}function un(e,n,r){let t=ct(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),l=s.instances.map(p=>p.id),v=n.integrations?.services?.[e],c=v?.instances?Object.keys(v.instances):void 0,f=dt(c,l),k=new Map;for(let p of f)k.set(p,at(n,t,e,p,i));let w=f.map(p=>{let g=k.get(p);return{instanceId:p,status:g.status,...g.statusMessage?{statusMessage:g.statusMessage}:{},...g.effective?{effective:g.effective}:{}}}),y=lt(n,e,s.defaultInstanceId??"*"),x={...ln(e,n,k.has(s.defaultInstanceId??"*")?{evaluation:k.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:w,inheritance:y};return{contracts:Ne(n.contracts),resolution:x,issues:r.filter(p=>p.service===e)}}function dt(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 lt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ut(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 Ve(e,n,r){let t=G(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ut(e,o,t));return{contracts:Ne(n),resolutions:i,issues:[]}}function pt(e,n,r){let t=G(r),i={...ut(n,e,t),instances:yr(n,e),inheritance:lt(n,e,Sr(n))};return{contracts:Ne(r),resolution:i,issues:[]}}function yr(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 dt(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function Sr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function pn(e,n,r){if(!(n in e.catalog.providers))throw new O("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 O("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=W(e.walk,o).ownedServices}else t=[r.service];let i=new Set(ce(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 fn(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 wr="\0no-enum";function hr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:wr}function Rr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Ir(e){let n=e.map(t=>Rr(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=>hr(t.subschema))).size===1?e[0].subschema:null}function De(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let l=s.configSchema;if(l===null){n.push(o);continue}if(!l||typeof l!="object"||Array.isArray(l))continue;let v=l;v.additionalProperties===!1&&(r=!1);let c=v.properties;if(!c||typeof c!="object"||Array.isArray(c))continue;let f=Array.isArray(v.required)?v.required:[];for(let k of Object.keys(c)){let w=t.get(k)??[];w.push({service:o,subschema:c[k],required:f.includes(k)}),t.set(k,w)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Ir(s),sources:s.map(({service:l,required:v})=>({service:l,required:v})),global:s.some(l=>!!l.subschema&&typeof l.subschema=="object"&&l.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function gn(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||!W(n.walk,t).writable?null:$(n.integrations,t.id).provider}var ft={integrationSchemas:null,integrationFieldRegistry:null};function gt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function mn(e){let n=gn("app",e);if(n===null)return ft;let r=fn(e,n,ce(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:gt(De(r))}}function vn(e,n){let r=gn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return ft;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=fn(e,r,i.filter(s=>Pe(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:gt(De(o))}}function kr(e){return mn(e).integrationSchemas}function br(e,n){return vn(e,n).integrationSchemas}function Cr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return $(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Fe(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Cr(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(U(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function yn(e,n){let r=Fe(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return De(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ae(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Sn(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[l,v]of Object.entries(o.instances??{}))s.byInstance[l]=Se(e.appDir,v.credentialRef)??null;t[i]=s}return{app:r,services:t}}function wn(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?dn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import Ar from"path";var Er={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function hn(e,n){if(!n||n.length===0)return new Set;let r=Er[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new O("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Or(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new O("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new O("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new O("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function xr(e,n={}){let r=_e(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(!p.strictValidation)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p));if(!p.ownershipBindingV6)throw new O("CONTRACTS_NOT_RESOLVED",503,G(p))}function s(p){return Qn(i,p)}function l(p){let g=p.integrations?.services;return g&&typeof g=="object"?Object.keys(g):[]}async function v(){let p=await T(e),g=s(p),d=g.integrations;if(d===null)return[];let S={resolveEffectiveService:c(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},R=le(e,g.walk,d,process.env);return ee({contracts:S,integrations:d,supplies:S.buildSupplyLookup(g.catalog),...R})}function c(p,g){if(typeof p!="function")throw new O("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${g} 缺席(形态异常)`);return p}function f(p){let g=t.then(p,p);return t=g.catch(()=>{}),g}let k={async loadModules(p){let g=await T(e);return tn(s(g),p)},async loadModule(p,g){let d=hn("module",g?.include),S=await T(e),R=s(S),u=Oe(R.walk,p),m=rn(R,u.id);if(d.has("serviceResolutions")){let I=[...new Set([...m.ownedServices,...m.services.map(a=>a.service)])];m.serviceResolutions=ye(S)?await v().then(a=>ve(R,a,I)):Ve(R,S,I)}if(d.has("integrationSchemas")||d.has("integrationFieldRegistry")){let I=vn(R,u.id);d.has("integrationSchemas")&&(m.integrationSchemas=I.integrationSchemas),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=I.integrationFieldRegistry)}return m},async loadApp(p){let g=hn("app",p?.include),d=await T(e),S=s(d),R=on(S);if(g.has("serviceResolutions")&&(R.serviceResolutions=ye(d)?await v().then(u=>ve(S,u)):Ve(S,d)),g.has("integrationSchemas")||g.has("integrationFieldRegistry")){let u=mn(S);g.has("integrationSchemas")&&(R.integrationSchemas=u.integrationSchemas),g.has("integrationFieldRegistry")&&(R.integrationFieldRegistry=u.integrationFieldRegistry)}return R},async loadService(p,g){let d=hn("service",g?.include),S=await T(e),R=s(S),u=H(R.walk,l(R),p),m=sn(R,u);return d.has("integrationSchemas")&&(m.integrationSchemas=Fe(R,u)),d.has("integrationFieldRegistry")&&(m.integrationFieldRegistry=yn(R,u)),m},async loadServiceResolutions(p){let g=await T(e),d=s(g);if(!ye(g))return Ve(d,g,p);let S=await v();return ve(d,S,p)},async loadServiceResolution(p){let g=await T(e),d=s(g),S=H(d.walk,l(d),p);if(!ye(g))return pt(S,d,g);let R=await v();return un(S,d,R)},async loadProviders(){let p=await T(e);return an(s(p))},async loadProviderSupply(p,g){Or(g);let d=await T(e);return pn(s(d),p,g)},async loadProviderService(p,g){let d=await T(e),S=s(d),R=H(S.walk,l(S),g);return cn(S,p,R)},async loadCredentials(){let p=await T(e);return Sn(s(p))},async loadCredentialTypes(p){let g=await T(e);return wn(s(g),p)}},w=qe(e,{onApplied:n.onApplied,cache:r}),y={async writeAppIntegration(p,g){await w.warmup();let d=await T(e);return o(d),f(()=>w.applyApp(p,g))},async writeModuleIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=Oe(s(S).walk,p);return w.applyModule(R.id,g,d)})},async writeServiceIntegration(p,g,d){await w.warmup();let S=await T(e);return o(S),f(()=>{let R=s(S),u=H(R.walk,l(R),p);return w.applyService(u,g,d)})},async deleteServiceIntegration(p){await w.warmup();let g=await T(e);return o(g),f(()=>{let d=s(g),S=H(d.walk,l(d),p);return w.deleteService(S)})}},E={invalidate(){r.invalidate(),$e(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return se(p)},loadProviderCatalogRaw(){return Je(e)},async readIntegrationsConfig(){return K(e,r)},async writeIntegrationsConfig(p){await w.warmup();let g=await T(e);return o(g),f(()=>Mr(e,p,r))},async ensureMockBindings(){await w.warmup();let p=await T(e);return o(p),f(()=>Qe(e))},async evaluateIntegrationServices(p){await w.warmup();let g=await T(e);o(g);let d={resolveEffectiveService:c(g.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:c(g.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:c(g.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:g.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:d})}};function x(p){return D(p,r)}return{...k,...y,...E}}function Mr(e,n,r){let t=Ar.join(e,"config","integrations.json");_(t,`${JSON.stringify(n,null,2)}
|
|
9
|
-
`),r.invalidate([t])}export{
|
|
1
|
+
import{a as Le,b as ae,c as N,d as Be}from"./chunk-K5FIGT5A.js";import{z as k}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,wt=k.object({cardType:k.string(),schemaVersion:k.number().optional()}),kn=k.object({route:k.string(),component:k.string()}),bn=k.object({route:k.string(),label:k.string().optional(),icon:k.string().optional(),order:k.number().optional()}),Cn=k.object({id:k.string(),range:k.string().optional(),required:k.boolean().default(!0)}),An=k.object({service:k.string(),provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string(),credentialType:k.string(),local:k.boolean().optional(),configSchema:k.string().optional(),credentialSchema:k.string().optional()}),En=k.object({service:k.string(),optional:k.boolean().default(!0),defaults:k.array(k.object({provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string()})).default([]),name:k.string().optional(),description:k.string().optional()}),On=k.object({service:k.string()}).strict(),xn=k.object({id:k.string(),type:k.string()}),Mn=k.object({schemaVersion:k.number().default(1),id:k.string(),name:k.string().optional(),description:k.string().optional(),hidden:k.boolean().optional(),version:k.string().default("0.0.0"),kind:k.enum(["platform","business","third-party"]).default("business"),risk:k.object({level:k.enum(["high","medium","low"]).default("low"),writeBoundary:k.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:k.object({defaultMode:k.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:k.object({handlers:k.array(k.string()).default([]),tools:k.array(k.string()).default([]),cards:k.array(wt).default([]),routes:k.array(k.string()).default([]),pages:k.array(kn).default([]),tabs:k.array(bn).default([]),providers:k.object({id:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:k.array(An).default([])}).default({}),owns:k.array(On).default([]),consumes:k.array(En).default([]),resources:k.array(xn).default([])}).default({}),dependencies:k.object({modules:k.array(Cn).default([])}).default({}),env:k.array(k.string()).default([])}).strict();function ht(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 o=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,i=Array.isArray(o?.consumes)&&o.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||i)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ce(e){let n=ht(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=Mn.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 Rt=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function jn(e){return JSON.stringify(e).slice(1,-1)}function We(e,n=process.env){let r=[],t=e.replace(Rt,(o,i,s)=>{if(o.startsWith("$$"))return o.slice(1);let l=n[i];return l!==void 0?jn(l):s!==void 0?jn(s):(r.push(i),o)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as It,existsSync as Tn,readFileSync as kt,writeFileSync as bt}from"fs";import{dirname as Ct,join as Nn}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,o){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=o}};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 At(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function de(e,n){let r=Nn(e,W(n));if(!Tn(r))return null;try{let t=JSON.parse(kt(r,"utf8"));if(typeof t.type!="string")return null;let{type:o,...i}=t,s={};for(let[l,y]of Object.entries(i))typeof y=="string"&&(s[l]=y);return{type:o,values:s}}catch{return null}}function Ue(e,n,r){let t=Nn(e,W(n)),o=Tn(t);return It(Ct(t),{recursive:!0}),bt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
|
|
2
|
+
`,"utf8"),o}import{mkdirSync as Et,renameSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt}from"path";function F(e,n){Pn(Mt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;xt(r,n,"utf8"),Ot(r,e)}function Pn(e){Et(e,{recursive:!0})}import{existsSync as _,readdirSync as ze,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as jt,readFileSync as Vn,mkdirSync as Tt,writeFileSync as Nt}from"fs";import Dn from"path";function Re(e){return Dn.join(e,".tbox","app.json")}function _n(e){let n=Re(e);if(!jt(n))return null;try{let r=JSON.parse(Vn(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 Pt(e,n){let r=Re(e);Tt(Dn.dirname(r),{recursive:!0}),Nt(r,`${JSON.stringify(n,null,2)}
|
|
3
|
+
`,"utf8")}function Ke(e){let n=_n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Vn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Vt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Dt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function _t(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ft(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 $t(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function $n(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(o=>typeof o=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[o,i]of Object.entries(n.meta)){if(!i||typeof i!="object"||Array.isArray(i))continue;let{name:s,description:l}=i,y={};typeof s=="string"&&s.length>0&&(y.name=s),typeof l=="string"&&l.length>0&&(y.description=l),(y.name!==void 0||y.description!==void 0)&&(t[o]=y)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let o=JSON.parse(t),i=ce(o);if(i.ok)return{kind:"strict",id:i.value.id,version:i.value.version,descriptor:i.value,declare:i.value.declare};if(i.legacy)return{kind:"legacy",detail:i.errors.join("; ")};if(o&&typeof o=="object"&&"declare"in o){let s=o;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 Lt(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 Bt(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")),o=[];for(let[i,s]of Object.entries(t.redirects??{}))typeof s!="string"||!i.startsWith("@tbox.cn/app-")||o.push({pkg:i,dir:V(n,s)});return o}catch{return[]}}function Bn(e,n){let r=[],t=[e];for(let l of["apps","packages"]){let y=V(e,l);if(_(y))try{for(let d of ze(y,{withFileTypes:!0}))d.isDirectory()&&t.push(V(y,d.name))}catch{}}let o=new Set,i=(l,y,d)=>{let f=n?n.read(y,$n):$n(X(y,"utf8"));f!=null&&r.push({dir:l,slots:f.slots,meta:f.meta,via:d})},s=V(e,"config","service-slots.json");_(s)&&i(e,s,"config-override");for(let l of t){let y=V(l,"node_modules","@tbox.cn");if(!_(y))continue;let d=[];try{d=ze(y)}catch{continue}for(let f of d){let R=V(y,f);if(o.has(R))continue;o.add(R);let I=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(I)?i(R,I,"package"):_(g)&&i(R,g,"package")}}for(let l of t)for(let y of[V(l,"service-slots.json"),V(l,"src","service-slots.json")])_(y)&&i(l,y,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},o={},i=[],s={},l=new Set,y=(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 S=t.providers[w.provider]??={},C=S[w.implementation];C?C.services.includes(w.service)||C.services.push(w.service):(S[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 b=`${w.provider}\0${w.service}`;o[b]||(o[b]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},d=(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&&i.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},I=(a,m)=>{a.kind==="legacy"&&i.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,A=(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 S=`${c.provider}\0${c.implementation}`;w.has(S)||(v.defaults.push(c),w.add(S))}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 Lt(e)){if(l.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"){I(u,a.id),l.add(a.id);continue}if(!u)continue;l.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??[],S=w?.providers?.id;S&&d(S,a.package,f(u)),c.length&&y(c,a.package,v,f(u),S);let C=w?.consumes??[];for(let x of C)A(x,a.package);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),a.id)}for(let{pkg:a,dir:m}of Bt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){I(h,a);continue}if(!h?.id||l.has(h.id))continue;l.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&d(w,a,f(h)),v.length&&y(v,a,m,f(h),w);let c=u?.consumes??[];for(let C of c)A(C,a);let S=h.kind==="strict"?h.descriptor.declare.owns:[];S.length&&R(S.map(C=>C.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=ze(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(l.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,m),l.add(m);continue}if(!u)continue;let v=u.id??m;if(l.has(v))continue;l.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??[],S=w?.providers?.id;S&&d(S,`@app/${v}`,f(u)),c.length&&y(c,`@app/${v}`,h,f(u),S);let C=w?.consumes??[];for(let x of C)A(x,`@app/${v}`);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),v)}}let M=new Set,p={};for(let a of Bn(e,n)){for(let m of a.slots)M.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:o,vocabulary:[...M].sort(),slotMeta:p,ownership:s,declarationIssues:i}}function Ln(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let o=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(o)}catch{return!1}}function Wt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Wn(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Ut(e){let n=[],r=D(e),t=Ke(e),o=new Map;for(let i of t?.npmModules??[])o.set(i.id,i.mode);for(let i of r.modules){let s=o.get(i.id)??"local",l=Ln(i.dir,"server","serverModule"),y=i.descriptor.declare;n.push({id:i.id,pkg:s==="sdk"?i.pkg:`@app/${i.id}`,mode:s,hasServerEntry:l,hasClientEntry:Ln(i.dir,"client","clientModule"),hasCards:(y.cards?.length??0)>0,...l?{moduleId:Wn(Wt(i.dir))}:{}})}return n.sort((i,s)=>i.id.localeCompare(s.id))}function Kt(e){return D(e).ownership}function $(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 le(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(o=>r.has(o)))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 Un(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 Ge(e,n){let r=new Set(n),t=[],o=(i,s)=>{let l=Un(i,s,r);l&&t.push(l)};for(let i of Object.keys(e.configByInstance??{}))o(i,"configByInstance");for(let i of Object.keys(e.credentialRefByInstance??{}))o(i,"credentialRefByInstance");for(let[i,s]of Object.entries(e.services??{}))for(let l of Object.keys(s.instances??{}))o(l,`services.${i}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:o,demandedServices:i,supplies:s,malls:l,credentialSchemaMissing:y,vendorConfigKeys:d,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:I,credentialFileType:g,realmSwitchHints:A,moduleResourceNeeds:O,ownership:M,installedModuleIds:p}=e,a=l?new Set(l):void 0;for(let c of A??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(o).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,S,C,b)=>{if(typeof C?.provider=="string"&&typeof C.implementation=="string"&&C.provider&&C.implementation)return o[ue(C.provider,C.implementation)]?.credentialType;if(typeof S.provider=="string"&&typeof S.implementation=="string")return o[ue(S.provider,S.implementation)]?.credentialType;let x=S.provider?.credentialType;if(typeof x=="string")return x;if(!s)return;let T=b??Object.keys(S.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,M);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return o[ue(j.effective.provider,j.effective.implementation)]?.credentialType};if(I||g)for(let[c,S]of Object.entries(t.services))for(let[C,b]of Object.entries(S.instances??{})){if(b.enabled===!1)continue;let x=b.credentialRef??S.credentialRef??t.credentialRefByInstance?.[C]??t.credentialRef;if(typeof x!="string"||!x.startsWith("secret://"))continue;let T=x.slice(9);I?.[T]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:C,message:`integrations: 凭据文件缺失 ${T}(${c}@${C} effective ref=${x};档内 config/credentials/ 无此文件)`});let j=g?.[T];if(j){let P=h(c,S,b,C);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:C,message:`integrations: 凭据文件 ${T}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${C}——transport 创建期将按 type 选策略)`})}}let u=(c,S)=>{if(!a)return;let C=Un(c,S,a);C&&n.push(C)};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(([,S])=>S.instances!=null&&S.instances["*"]==null).map(([S])=>S);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,S]of Object.entries(t.services)){if(!i[c]&&M?.[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 S.provider=="string"?typeof S.implementation=="string"&&!o[ue(S.provider,S.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${S.provider}/${S.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):S.provider!==void 0&&!K(S.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),y){let b=h(c,S);b&&y[b]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${b} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof S.provider=="object"&&typeof S.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[b,x]of Object.entries(S.instances??{})){u(b,`services.${c}.instances`);let T=x.provider!==void 0,j=x.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:b,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${b}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=x.provider,L=x.implementation;typeof P=="string"&&typeof L=="string"?o[ue(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:b,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${b})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:b,message:`integrations: 实例级内联 provider 超受控形状(${c}@${b})`})}}}for(let[c,S]of[["root",t.provider],...Object.entries(t.modules??{}).map(([C,b])=>[`modules.${C}`,b?.provider])])typeof S!="string"||S.length===0||m.has(S)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${S} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[c,S]of Object.entries(t.services)){let C=S.instances?Object.keys(S.instances):[""];for(let b of C){let x=r.resolveEffectiveService(t,c,b,s,M);x.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:b||void 0,message:`integrations: ${x.message}`})}}for(let[c,S]of Object.entries(t.services))S.implementation!==void 0&&S.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,S]of Object.entries(t.modules??{})){if(!(S?.provider!==void 0||S?.config!==void 0))continue;let b=p?!p.has(c):!1,x=0;if(M)for(let j of Object.values(M))j===c&&(x+=1);if(b||!(M===void 0)&&x===0){let j=b?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(d){let c=new Set,S=!1,C=b=>{typeof b!="string"||b.length===0||(d[b]&&c.add(b),!d[b]&&!R?.[b]&&(S=!0),R?.[b]&&(S=!0))};C(t.provider);for(let b of Object.values(t.modules??{}))C(b?.provider);for(let b of Object.values(t.services)){let x=b.provider;C(typeof b.provider=="string"?b.provider:x?.provider)}if(c.size>0&&!S){let b=new Set;for(let j of c)for(let P of d[j]??[])b.add(P);let x=new Set;for(let j of c)for(let P of f?.[j]??[])x.add(P);let T=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??b).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 内(死配置)`})};T(t.config,"root.config",void 0,x);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,x);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=$(t,j).provider??void 0;if(L===void 0){T(P.config,`modules.${j}.config`,void 0,x);continue}let Z=d[L];if(!Z||R?.[L])continue;let q=f?.[L];T(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,S]of Object.entries(i)){let C=t.services[c];if(!C){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${S.owners.join(", ")})未配置${S.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let b=Object.entries(C.instances??{}).filter(([,x])=>x.enabled===!1).map(([x])=>x);b.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:b.join(", "),message:`integrations: ${c} 实例禁用(${b.join(", ")})`})}for(let[c,S]of Object.entries(t.modules??{})){let C=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[b,x]of Object.entries(S?.resources??{})){let T=x?.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.${b} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),C&&C.size>0&&!C.has(b)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${b} 未被模块 manifest declare.resources 声明`})}}return n}function ue(e,n){return`${e}\0${n}`}import{existsSync as Je,readFileSync as zt,readdirSync as Gt}from"fs";import{join as ke}from"path";function zn(e){return e.replaceAll("-","_").toUpperCase()}function Kn(e){if(!Je(e))return null;try{let n=JSON.parse(zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Jt(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 pe(e,n,r,t=process.env){let o={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))o[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let i={};for(let[u,v]of Object.entries(n.catalog.services))i[u]={optional:v.optional,owners:[...v.owners]};let s={},l={},y={},d={},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=Kn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,S=l[v.provider]??=new Set;for(let b of Jt(w))c.add(b);let C=w.properties;if(C&&typeof C=="object"&&!Array.isArray(C))for(let[b,x]of Object.entries(C))x&&typeof x=="object"&&x["x-tbox-global"]===!0&&S.add(b)}else y[v.provider]=!0}v.credentialSchema&&!Je(ke(u.dir,v.credentialSchema))&&(d[v.credentialType]=!0)}}let R={},I=new Set,g=ke(e,"config","credentials");if(Je(g))for(let u of Gt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);I.add(v);let w=Kn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let A=r,O=[],M=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(A.services??{}))if(u&&typeof u=="object"){M(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&M(v.credentialRef)}for(let u of Object.values(A.credentialRefByInstance??{}))M(u);M(A.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[zn(v)]===void 0&&(I.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(A.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,S]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let C=S&&typeof S=="object"&&typeof S.provider=="string"?S.provider:void 0;w&&C&&C!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${C})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(A.instances)?A.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:o,demandedServices:i,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:d,vendorConfigKeys:s,vendorGlobalConfigKeys:l,vendorConfigSchemaMissing:y,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 li,readFileSync as ui}from"fs";import{join as fi,resolve as gi}from"path";function Ye(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[i,s]of Object.entries(n.providers)){r[i]={};for(let[l,y]of Object.entries(s))r[i][l]={provider:y.provider,implementation:y.implementation,credentialType:y.credentialType,owner:y.owner,...y.local?{local:!0}:{},...y.configSchema?{configSchema:y.configSchema}:{},...y.credentialSchema?{credentialSchema:y.credentialSchema}:{},services:[...y.services]}}let t={};for(let[i,s]of Object.entries(n.services))t[i]={optional:s.optional,defaults:s.defaults.map(l=>({...l})),owners:[...s.owners]};let o={};for(let[i,s]of Object.entries(n.credentialTypes))o[i]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:o}}async function He(e,n,r,t=process.env){let o=r.module,i=D(e),s=o.buildSupplyLookup(be(e)),l=pe(e,i,n,t);return ee({contracts:o,integrations:n,supplies:s,...l})}import{existsSync as er,rmSync as nr}from"fs";import{join as tr}from"path";import{existsSync as Yt,readFileSync as Ht}from"fs";import{join as Gn}from"path";var Zt=Gn("config","integrations.json");function G(e,n){let r=Gn(e,Zt),t=o=>JSON.parse(o);if(n)return n.read(r,t)??null;if(!Yt(r))return null;try{return t(Ht(r,"utf8"))}catch{return null}}async function Jn(e,n){let r=await N(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(o){if(o instanceof Error&&Array.isArray(o.issues)){let i=o.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 校验失败",i.length>0?i:void 0)}throw new E("VALIDATION_FAILED",400,o instanceof Error?o.message:String(o))}return{config:t,strict:!1,contracts:r}}function fe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as qt,existsSync as Ce,readFileSync as Qt}from"fs";import{join as Ae}from"path";function Yn(e,n,r){let t=[];if(n){let o=Q({provider:e});t.push({stem:o,ref:`secret://${o}`,input:n})}for(let[o,i]of Object.entries(r??{})){let s=Q({provider:e,instanceId:o});t.push({instanceId:o,stem:s,ref:`secret://${s}`,input:i})}return t}function Hn(e,n,r,t,o){let i=[];if(t){let s=Q({provider:e,service:n});i.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,l]of Object.entries(o??{})){let y=Q({provider:e,instanceId:s,domain:r});i.push({instanceId:s,stem:y,ref:`secret://${y}`,input:l})}return i}function qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ce(Ae(e,W(t.stem))):Ue(e,t.stem,t.input)}))}function Xt(e,n){return Ce(Ae(e,W(n)))}function Ze(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)Ze(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))Ze(r,n)}function ne(e){let n=Ae(e,"config","credentials"),r=new Set,t=Ae(e,"config","integrations.json");if(Ce(t))try{Ze(JSON.parse(Qt(t,"utf8")),r)}catch{}let o=[];if(!Ce(n))return o;let i=[];try{i=qt(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return o}for(let s of i.sort()){if(r.has(s))continue;let l=de(e,s);o.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return o}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 rr(e){let n=tr(e,"config","integrations.json"),r=G(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 o;try{let g=We(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};o=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let i;try{i=await He(e,o,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),l=new Set(Object.keys(s.catalog.providers)),y=s.ownership,d=structuredClone(r);d.services??={};let f=[];for(let g of i)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(d.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete d.modules[g.module])}else d.provider&&(f.push(`root.provider=${d.provider}`),delete d.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let A=d.modules??{};if(A[g.module]){let O=A[g.module],M=[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}(${M.join("+")} 整节点)`),delete d.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let A=d.services[g.service];if(!A)continue;let O=y[g.service];if([g.instance?Ee(A.instances?.[g.instance]?.provider):void 0,Ee(A.provider),O!==void 0?Ee(d.modules?.[O]?.provider):void 0,Ee(d.provider)].filter(p=>typeof p=="string").some(p=>l.has(p)))continue;if(g.instance){let p=A.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 A.instances,Object.keys(A).length===0&&delete d.services[g.service]}else delete d.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(d.services).length===0&&delete d.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!d.provider&&Object.keys(d.services??{}).length===0&&Object.keys(d.config??{}).length===0&&Object.keys(d.configByInstance??{}).length===0&&!d.credentialRef&&Object.keys(d.credentialRefByInstance??{}).length===0&&(d.instances??[]).length===0&&d.defaultInstanceId==null&&Object.keys(d.modules??{}).length===0;if(!R&&(d.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(d)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let I=[];return R?er(n)&&nr(n,{force:!0}):F(n,`${JSON.stringify(d,null,2)}
|
|
4
|
+
`),I=ne(e).map(g=>g.message),{removed:f,orphanCredentials:I}}function Oe(e,n){let r=e.modules.find(o=>o.id===n);if(r)return r;let t=e.modules.filter(o=>(o.descriptor.name??o.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(o=>`${o.descriptor.name}(id=${o.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 l of Object.values(s))for(let y of l.services)t.add(y);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 o=[],i=s=>{o.includes(s)||o.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&i(s);for(let[s,l]of Object.entries(e.catalog.services))l.name===r&&i(s);if(o.length===1)return o[0];throw o.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${o.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as et,readFileSync as nt}from"fs";import{join as re,resolve as ir}from"path";import or from"ajv";var te=["provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],Zn=["provider","implementation","config","credentialRef","instances"],qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function ie(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>ie(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(o=>ie(e[o],n[o]))}return!1}function Ne(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}`]);Ne(t,`${n}.${r}`)}}function Me(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 Qn(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((o,i)=>{let s=o&&typeof o=="object"?o.id:void 0;if(typeof s=="string"&&!z.test(s))throw new E("VALIDATION_FAILED",400,`instances[${i}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${i}].id`])}),Me(e.configByInstance,"root.configByInstance",!1),Me(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else Me(e.instances,"services.instances",!0);Me(n.credentialsByInstance,"credentialsByInstance",!1)}function je(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=o=>JSON.parse(o);if(n)return n.read(r,t)??null;if(!et(r))return null;try{return t(nt(r,"utf8"))}catch{return null}}function Qe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Ge(e,n)}function sr(e,n,r,t){let{catalog:o}=D(e,t),i=o.providers[n];if(!i)return;let s=new Set;for(let l of Object.values(i))(r===void 0||l.services.includes(r))&&s.add(l.credentialType);return s.size===1?[...s][0]:void 0}function Xn(e,n,r,t,o,i){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=o??sr(e,n,r,i);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:l}=D(e,i),y=l[`${n}\0${r}`];if(!y?.credentialSchema)return;let d=ir(y.packageDir,y.credentialSchema);if(et(d))try{let R=new or({allErrors:!0}).compile(JSON.parse(nt(d,"utf8")));if(!R({type:t.type,...t.values})){let I=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",I)}}catch(f){if(f instanceof E)throw f}}function Xe(e,n={}){let{onApplied:r,cache:t}=n;function o(d,f,R,I){let g=d!==null,A=f.length>0,O=!I&&g,M=!I&&A;O&&(F(re(e,H),`${JSON.stringify(d,null,2)}
|
|
5
|
+
`),t?.invalidate([re(e,H)]));let p=O||M;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),A&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let i;async function s(){i=await N(e)}function l(d,f){return d.filter(R=>Array.isArray(R.path)).map(R=>{let I=R.path.map(String).join(".");return f!==""&&I.startsWith(f)&&I.length>f.length?I.slice(f.length):I}).filter(R=>R.length>0)}function y(d,f,R){if(!i)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let I=ae(i);if(I==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(i));if(I==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(i)});return}try{i.module.parseIntegrationsConfig(d)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",l(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(d,f={}){Ne(d,"root"),Qn(d,f,"root"),je(d,te,"root");let R=[],I=Te(e,t),g=I??{services:{}};I===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let A={...g};for(let v of te)v in d||delete A[v];for(let[v,w]of Object.entries(d))A[v]=w;let O=typeof A.provider=="string"?A.provider:"app",M=Yn(O,f.credentials,f.credentialsByInstance);for(let v of M)Xn(e,O,void 0,v.input,void 0,t);let p=M.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(A.credentialRef=p.ref),f.credentialsByInstance){let v={...A.credentialRefByInstance??{}};for(let w of M)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);A.credentialRefByInstance=v}let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=ie(I,A);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};y(A,R,"");let h=f.dryRun===!0,u=qe(e,M,h);return R.push(...Qe(A)),o(m?null:A,u,R,f.dryRun)},applyModule(d,f,R={}){Ne(f,"root");let{modules:I,catalog:g,ownership:A}=D(e,t),O=I.find(c=>c.id===d);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${d} 非已装模块`);if(!U({modules:I,catalog:g,ownership:A},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${d} 未声明任何 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[d]??{}};je(f,xe,`modules.${d}`);let v={...u};for(let c of xe){let S=f[c];S==null||S===""||typeof S=="object"&&!Array.isArray(S)&&Object.keys(S).length===0?delete v[c]:v[c]=S}Object.keys(v).length===0?delete h[d]:h[d]=v;let w={...m,modules:h};return ie(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(y(w,p,`modules.${d}.`),p.push(...Qe(w)),o(w,[],p,R.dryRun))},applyService(d,f,R={}){Ne(f,"root"),Qn(f,R,"slot"),je(f,Zn,`services.${d}`);for(let[T,j]of Object.entries(f.instances??{}))je(j,qn,`services.${d}.instances.${T}`);let I=[],g=Te(e,t),A=D(e,t);if(!fe(A.vocabulary,Object.keys(g?.services??{}),d,Object.keys(A.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&I.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},M={...O.services??{}},p={...O,services:M};M[d]={...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=d.includes(".")?d.slice(0,d.indexOf(".")):d,v=Hn(h,d,u,R.credentials,R.credentialsByInstance);for(let T of v)Xn(e,h,d,T.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=M[d],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}let S=R.credentials!==void 0||R.credentialsByInstance!==void 0,C=ie(g,p);if(C&&!S)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:I};y(p,I,`services.${d}.`);let b=R.dryRun===!0,x=qe(e,v,b);return I.push(...Qe(p)),o(C?null:p,x,I,R.dryRun)},deleteService(d){let f=[],R=Te(e,t),I=D(e,t);if(!fe(I.vocabulary,Object.keys(R?.services??{}),d,Object.keys(I.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(d in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[d];let A={...R??{services:{}},services:g};F(re(e,H),`${JSON.stringify(A,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 ar}from"fs";import{join as cr}from"path";function en(e){let n=cr(e,"config","integrations.json");if(ar(n))return{generated:!1,reason:"in-place",services:[]};let r=[];for(let i of D(e).modules)for(let s of i.descriptor.declare.providers?.slots??[])s.local===!0&&r.push({service:s.service,provider:s.provider,implementation:s.implementation});if(r.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let t={},o=new Set(r.map(i=>i.provider));if(o.size===1){let[i]=o;for(let s of r)t[s.service]={};F(n,`${JSON.stringify({provider:i,services:t},null,2)}
|
|
7
|
+
`)}else{for(let i of r)t[i.service]={provider:i.provider,implementation:i.implementation};F(n,`${JSON.stringify({services:t},null,2)}
|
|
8
|
+
`)}return{generated:!0,reason:"generated",services:r.map(i=>i.service).sort()}}var nn={provider:null,layer:null};function tn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:nn}function rn(e){let n=tn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:nn,inherited:nn}}function Pe(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,o=$(e,n),i={provider:o.provider,layer:o.layer};return{configured:t,effective:i,inherited:t!==null?tn(e):i}}function dr(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,o=dr(t),i=n.ownership[r],s=i!==void 0?Pe(e,i).effective:tn(e);return{configured:o,effective:o!==null?{provider:o,layer:"service"}:s,inherited:s}}import{existsSync as lr,readFileSync as ur}from"fs";import{join as ot}from"path";function tt(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 rt(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 Ve(e,n,r){let t=e.providers[n];return t?Object.values(t).some(o=>o.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],o=r?.name??t?.name??n,i=r?.description??t?.description;return{name:o,...i!==void 0?{description:i}:{}}}var pr=ot("config","knowledge.json");function fr(e,n,r){let o=r[n]?.resources;if(!o||typeof o!="object"||Array.isArray(o))return null;let i=ot(e.appDir,pr),s={};if(lr(i))try{s=(e.cache?.read(i,d=>JSON.parse(d))??JSON.parse(ur(i,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[y,d]of Object.entries(o)){if(!d||typeof d!="object"||Array.isArray(d))continue;let f=d,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),I=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,A=I??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...I!==void 0?{datasetId:I}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:A,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};l[y]=O}return Object.keys(l).length>0?l:null}function it(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function gr(e){return it(e.id).startsWith("provider-")||it(e.pkg).startsWith("provider-")}function on(e,n={}){return{modules:e.walk.modules.filter(t=>!gr(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,o)=>t.id.localeCompare(o.id))}}function sn(e,n){let r=e.walk.modules.find(I=>I.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),o=new Set((r.descriptor.declare.consumes??[]).map(I=>I.service)),i=(I,g)=>{let A=J(e.walk,I);return{service:I,name:A.name,...A.description!==void 0?{description:A.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(I=>i(I.service,I.optional===!1)),...[...new Set(t.ownedServices)].filter(I=>!o.has(I)).map(I=>i(I,!1))],l=e.integrations?.modules??{},y=l[n],d=y?{...typeof y.provider=="string"?{provider:y.provider}:{},...y.config&&typeof y.config=="object"&&!Array.isArray(y.config)?{config:y.config}:{}}:null,f=Pe(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:d,resources:fr(e,n,l),binding:R,configEditable:t.writable,services:s}}function an(e){let n=rt(e.walk),r=e.walk.vocabulary.filter(i=>!n.has(i)).map(i=>{let s=J(e.walk,i);return{service:i,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,o=null;if(t){let i={};for(let s of te)s in t&&(i[s]=t[s]);o=i}return{services:r,integration:o,binding:rn(t)}}function cn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!fe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let o=r[n]??null,i=J(e.walk,n);return{service:n,name:i.name,...i.description!==void 0?{description:i.description}:{},required:t?!t.optional:!1,integration:o,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ct,readFileSync as dt,realpathSync as st}from"fs";import{isAbsolute as mr,join as vr,relative as yr,resolve as at,sep as Sr}from"path";function dn(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let o=Object.values(t),i=e.catalog.vendorMeta[r];o.length===0&&!i||n.push({provider:r,local:o.length>0&&o.every(s=>s.local===!0),...i?.name?{name:i.name}:o[0]?.name?{name:o[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function ln(e,n,r){let t=e.catalog.providers[n],o=e.integrations?.services??{},i=[];if(t)for(let d of Object.values(t))d.services.includes(r)&&i.push({implementation:d.implementation,credentialType:d.credentialType});let s=o[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(i.length===0&&!l)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);i.length===0&&l&&i.push({implementation:o[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let y=oe(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:i,configSchema:y,integrationSchemas:{configSchema:y}}}function oe(e,n,r,t){let o=e.walk.serviceSchemas[`${n}\0${r}`];return o?un(e.appDir,o.packageDir,o.configSchema):typeof t=="string"?wr(e.appDir,t):null}function un(e,n,r){if(!r)return null;let t=vr(n,r);if(!ct(t))return null;try{return JSON.parse(dt(t,"utf8"))}catch{return null}}function wr(e,n){let r=at(e,"config","schemas"),t=at(e,n),o=yr(r,t);if(o===""||o.startsWith("..")||mr(o))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ct(t))return null;let i,s;try{i=st(r),s=st(t)}catch{return null}if(s!==i&&!s.startsWith(i+Sr))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(dt(t,"utf8"))}catch{return null}}function De(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function lt(e,n,r){let t=e.integrations,o=t?.services?.[n],i=o?.instances?.[r]??o?.instances?.["*"];if(i&&i.provider!==void 0)return"instance";if(o?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&$(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function ut(e,n,r,t,o){let i=n.resolveEffectiveService(e.integrations??{services:{}},r,t,o,e.walk.ownership);if(i.status==="ok"&&i.effective){let s=i.effective.provider,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:i.effective.implementation,effective:{provider:l,implementation:i.effective.implementation,...i.effective.config!==void 0?{config:{...i.effective.config}}:{},...i.effective.credentialRef!==void 0?{credentialRef:i.effective.credentialRef}:{},layer:lt(e,r,t)??"app"}}}return i.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:i.message}:{status:i.status}}function pt(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 pn(e,n,r){let t=pt(n),{integrations:o,catalog:i}=n,s=r?.supplies??t.buildSupplyLookup(i),l=o,d=t.normalizeInstances({instances:l?.instances,defaultInstanceId:l?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??ut(n,t,e,d,s),R=lt(n,e,d),I=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof I=="string"?I:typeof I=="object"&&I?String(I.provider):void 0),A={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),M=g!==void 0&&O.has(g)?hr(n.catalog,g,e):void 0,p=i.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:A,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...M!==void 0?{supplied:M}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function hr(e,n,r){return Ve(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 o of me(e))r&&!r.includes(o)||(t[o]=pn(o,e));return{contracts:De(e.contracts),resolutions:t,issues:n}}function fn(e,n,r){let t=pt(n),o=t.buildSupplyLookup(n.catalog),i=n.integrations,s=t.normalizeInstances({instances:i?.instances,defaultInstanceId:i?.defaultInstanceId}),l=s.instances.map(M=>M.id),y=n.integrations?.services?.[e],d=y?.instances?Object.keys(y.instances):void 0,f=ft(d,l),R=new Map;for(let M of f)R.set(M,ut(n,t,e,M,o));let I=f.map(M=>{let p=R.get(M);return{instanceId:M,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=gt(n,e,s.defaultInstanceId??"*"),O={...pn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:o}:void 0),instances:I,inheritance:g};return{contracts:De(n.contracts),resolution:O,issues:r.filter(M=>M.service===e)}}function ft(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 gt(e,n,r){let t=e.integrations,o=t?.services?.[n],i=o?.instances?.[r]??o?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.provider}:{}},{layer:"service",...typeof o?.provider=="string"?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}},{layer:"instance",...i?.provider?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function mt(e,n,r){let t=e.catalog.services[n],o=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...o!==void 0?{module:o}:{},...t!==void 0?{required:!t.optional}:{}}}function _e(e,n,r){let t=B(n),o={};for(let i of me(e))r&&!r.includes(i)||(o[i]=mt(e,i,t));return{contracts:De(n),resolutions:o,issues:[]}}function vt(e,n,r){let t=B(r),o={...mt(n,e,t),instances:Rr(n,e),inheritance:gt(n,e,Ir(n))};return{contracts:De(r),resolution:o,issues:[]}}function Rr(e,n){let r=e.integrations?.services?.[n],t=e.integrations,o=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],i=r?.instances?Object.keys(r.instances):void 0;return ft(i,o).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function Ir(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function gn(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 i=e.walk.modules.find(s=>s.id===r.module);if(!i)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,i).ownedServices}else t=[r.service];let o=new Set(le(e.catalog,n));return{provider:n,scope:r,services:t.map(i=>({service:i,name:J(e.walk,i).name,supplied:o.has(i)}))}}function mn(e,n,r){if(n===null)return null;let t={};for(let o of r)t[o]={configSchema:oe(e,n,o)};return{provider:n,services:t}}function se(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(se).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${se(e[r])}`).join(",")}}`}var kr="\0no-enum";function br(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(se))].sort().join(",")}]`:kr}function Cr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:se(n)}function Ar(e){let n=e.map(t=>Cr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=se(e[0].subschema);return e.every(o=>se(o.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>br(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[i,s]of Object.entries(e.services)){let l=s.configSchema;if(l===null){n.push(i);continue}if(!l||typeof l!="object"||Array.isArray(l))continue;let y=l;y.additionalProperties===!1&&(r=!1);let d=y.properties;if(!d||typeof d!="object"||Array.isArray(d))continue;let f=Array.isArray(y.required)?y.required:[];for(let R of Object.keys(d)){let I=t.get(R)??[];I.push({service:i,subschema:d[R],required:f.includes(R)}),t.set(R,I)}}let o=[];for(let[i,s]of t)o.push({key:i,schema:Ar(s),sources:s.map(({service:l,required:y})=>({service:l,required:y})),global:s.some(l=>!!l.subschema&&typeof l.subschema=="object"&&l.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:o}}function vn(e,n,r){if(e==="app"){let i=n.integrations?.provider;return typeof i=="string"&&i.length>0?i:null}let t=n.walk.modules.find(i=>i.id===r);return!t||!U(n.walk,t).writable?null:$(n.integrations,t.id).provider}var yt={integrationSchemas:null,integrationFieldRegistry:null};function St(e){return{...e,fields:e.fields.filter(n=>n.global)}}function yn(e){let n=vn("app",e);if(n===null)return yt;let r=mn(e,n,le(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:St(Fe(r))}}function Sn(e,n){let r=vn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return yt;let o=(t.descriptor.declare.owns??[]).map(s=>s.service),i=mn(e,r,o.filter(s=>Ve(e.catalog,r,s)));return{integrationSchemas:i,integrationFieldRegistry:St(Fe(i))}}function Er(e){return yn(e).integrationSchemas}function Or(e,n){return Sn(e,n).integrationSchemas}function xr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return $(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function $e(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=xr(e,n);return t===null?null:{provider:t,configSchema:oe(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:oe(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:oe(e,t.provider,n,t.configSchema)}}return null}function wn(e,n){let r=$e(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=de(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function hn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:o}of n?.instances??[]){let i=n?.credentialRefByInstance?.[o];i!==void 0&&(r.byInstance[o]=Se(e.appDir,i)??null)}let t={};for(let[o,i]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,i.credentialRef)??null,byInstance:{}};for(let[l,y]of Object.entries(i.instances??{}))s.byInstance[l]=Se(e.appDir,y.credentialRef)??null;t[o]=s}return{app:r,services:t}}function Rn(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 o=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:o?un(e.appDir,o.packageDir,o.credentialSchema):null}})}}import Mr from"path";var jr={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function In(e,n){if(!n||n.length===0)return new Set;let r=jr[e],t=[...new Set(n)].filter(o=>!r.includes(o));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Tr(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 Nr(e,n={}){let r=Le(),t=Promise.resolve(),o={appDir:e,cache:r};function i(p){if(ae(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(ae(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function l(p){return tt(o,p)}function y(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function d(){let p=await N(e),a=l(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=pe(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 I={async loadModules(p){let a=await N(e);return on(l(a),p)},async loadModule(p,a){let m=In("module",a?.include),h=await N(e),u=l(h),v=Oe(u.walk,p),w=sn(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(S=>S.service)])];w.serviceResolutions=ye(h)?await d().then(S=>ve(u,S,c)):_e(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=Sn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=In("app",p?.include),m=await N(e),h=l(m),u=an(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await d().then(v=>ve(h,v)):_e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=yn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=In("service",a?.include),h=await N(e),u=l(h),v=Y(u.walk,y(u),p),w=cn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=$e(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=wn(u,v)),w},async loadServiceResolutions(p){let a=await N(e),m=l(a);if(!ye(a))return _e(m,a,p);let h=await d();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=l(a),h=Y(m.walk,y(m),p);if(!ye(a))return vt(h,m,a);let u=await d();return fn(h,m,u)},async loadProviders(){let p=await N(e);return dn(l(p))},async loadProviderSupply(p,a){Tr(a);let m=await N(e);return gn(l(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=l(m),u=Y(h.walk,y(h),a);return ln(h,p,u)},async loadCredentials(){let p=await N(e);return hn(l(p))},async loadCredentialTypes(p){let a=await N(e);return Rn(l(a),p)}},g=Xe(e,{onApplied:n.onApplied,cache:r}),A={async writeAppIntegration(p,a){await g.warmup();let m=await N(e);return i(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await N(e);return i(h),R(()=>{let u=Oe(l(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return i(h),R(()=>{let u=l(h),v=Y(u.walk,y(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return i(a),R(()=>{let m=l(a),h=Y(m.walk,y(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),Be(e)},async resolveContracts(){return N(e)},walkManifests(){return M(e)},parseModuleDescriptor(p){return ce(p)},loadProviderCatalogRaw(){return Ye(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Pr(e,p,r))},async ensureMockBindings(){return R(()=>en(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 M(p){return D(p,r)}return{...I,...A,...O}}function Pr(e,n,r){let t=Mr.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,z as SAFE_NAME_PATTERN,rn as appProviderBinding,$t as assertValidModuleId,Fe as buildIntegrationFieldRegistry,Kt as buildOwnershipMap,pe as buildPredicateAssembly,Ge as checkInstanceKeys,Ut as collectDeclaredModules,B as contractsNotResolvedMessage,Nr as createAppToolkit,Le as createFileCache,Xe as createWriteCore,Xt as credentialArtifactExists,ie as deepEqual,Q as deriveStem,Bn as discoverContractPackages,Se as echoForRef,Pn as ensureDir,en as ensureMockBindings,He as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,We as expandEnvVars,Wn as extractModuleIdFromSource,vn as formProviderOf,Be as invalidateContractsResolver,K as isControlledInlineProvider,Fn as isValidModuleId,Er as loadAppIntegrationSchemas,an as loadAppView,Rn as loadCredentialTypesView,hn as loadCredentialsView,sn as loadModuleDetailView,Or as loadModuleIntegrationSchemas,on as loadModulesView,be as loadProviderCatalog,Ye as loadProviderCatalogRaw,ln as loadProviderServiceDetailView,gn as loadProviderSupplyView,dn as loadProvidersView,cn as loadServiceDetailView,wn as loadServiceFieldRegistry,$e as loadServiceIntegrationSchemas,fn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,Mn as moduleDescriptorSchema,U as moduleOwnershipWritable,Pe as moduleProviderBinding,kn as pageContribSchema,ce as parseModuleDescriptor,le as providerFootprint,An as providerSlotContribSchema,rr as pruneIntegrationBindings,_n as readAppManifest,Ke as readAppManifestFull,de as readCredentialFile,G as readIntegrationsConfig,Jn as readIntegrationsStrict,ne as reconcileOrphanCredentials,zn as refToEnvKey,Dt as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,mn as resolveLayerIntegrationSchemas,$ as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,pn as resolveServiceSummary,xn as resourceNeedContribSchema,En as serviceConsumeContribSchema,On as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,At as stemToRef,bn as tabContribSchema,Ft as updateNpmModule,_t as upsertMiniappContainer,Vt as upsertNpmModule,D as walkManifests,Pt as writeAppManifest,F as writeAtomic,Ue as writeCredentialFile};
|
package/package.json
CHANGED
|
@@ -173,6 +173,25 @@ function memoHit(appDir: string, entry: MemoEntry): boolean {
|
|
|
173
173
|
return candidateFingerprint(resolvedNow) === candidateFingerprint(entry.resolved);
|
|
174
174
|
}
|
|
175
175
|
|
|
176
|
+
/** contracts 能力分层单源(写/求值双策略共用——降级写批 0.8.2):
|
|
177
|
+
* - degraded:version null(未安装/源码态未构建/导入拒绝)——无可用 contracts 代码,写轴允许降级
|
|
178
|
+
* (跳过 zod + STRICT_VALIDATION_SKIPPED warning);求值轴仍 503(求值结果造不出)。
|
|
179
|
+
* - blocked:包在场但能力缺失(<0.9 无严格面 / ≥0.9 缺 OWNERSHIP_BINDING_V6 标记 / 畸形)——
|
|
180
|
+
* v6 形状(modules[owner] 键)写入旧代码语境会被忽略(v5 宽松读)或拒绝(0.9.x 旧 zod),
|
|
181
|
+
* fail-visible 503 + 升级指引,不静默降级。
|
|
182
|
+
* 分层判据 = 包可解析性(version null 与否)而非严格校验面——<0.9 已装与未安装非同态
|
|
183
|
+
* (前者旧代码在场、后者 v6 世代装后即追齐)。
|
|
184
|
+
* 消费策略:写轴 = tier !== 'blocked'(degraded 放行);evaluate = tier === 'ok'(严选)。 */
|
|
185
|
+
export type ContractsTier = 'ok' | 'degraded' | 'blocked';
|
|
186
|
+
|
|
187
|
+
export function contractsTier(
|
|
188
|
+
c: Pick<ResolvedContracts, 'version' | 'strictValidation' | 'ownershipBindingV6'>,
|
|
189
|
+
): ContractsTier {
|
|
190
|
+
if (c.version === null) return 'degraded';
|
|
191
|
+
if (!c.ownershipBindingV6 || !c.strictValidation) return 'blocked';
|
|
192
|
+
return 'ok';
|
|
193
|
+
}
|
|
194
|
+
|
|
176
195
|
/** 探测单候选:返回已解析产物或 null(该候选不可用——缺席/导入拒绝) */
|
|
177
196
|
async function probeCandidate(
|
|
178
197
|
candidate: string,
|
|
@@ -211,7 +230,7 @@ async function probeCandidate(
|
|
|
211
230
|
const evaluation = EVALUATION_EXPORT_NAMES.every((name) => mod[name] !== undefined);
|
|
212
231
|
const strictValidation = mod[STRICT_EXPORT_NAME] !== undefined;
|
|
213
232
|
// v6 形状标记(出口在场性——判据先例 STRICT_EXPORT_NAME);缺席时不在此 push note
|
|
214
|
-
// (503 文案归 factory
|
|
233
|
+
// (503 文案归 factory 门控单点 assertWritableContracts/assertFullyUsable——)
|
|
215
234
|
const ownershipBindingV6 = mod[OWNERSHIP_MARKER_NAME] === true;
|
|
216
235
|
return {
|
|
217
236
|
version,
|
package/src/core/errors.ts
CHANGED
|
@@ -37,8 +37,8 @@ export class AppToolkitError extends Error {
|
|
|
37
37
|
* P-4:notes 优先——resolver 在全部不可解析路径均已 push 携带操作指引的 notes(导入失败/
|
|
38
38
|
* 产物缺失/未安装/<0.9 升级);现行 version===null 分支会把 notes 内细分指引吞成通用文案。
|
|
39
39
|
* 分支保留为兜底(防御性——正常路径 notes 恒非空)。
|
|
40
|
-
* v7:+= ownershipBindingV6
|
|
41
|
-
*
|
|
40
|
+
* v7:+= ownershipBindingV6 分支(标记门第四分支单源化——写门控(现 assertWritableContracts /
|
|
41
|
+
* assertFullyUsable,0.8.2 降级写批拆分)与读求值轴降级 statusMessage 共用同一文案;可选参向后兼容)。 */
|
|
42
42
|
export function contractsNotResolvedMessage(contracts: {
|
|
43
43
|
version: string | null;
|
|
44
44
|
strictValidation: boolean;
|
package/src/dto.ts
CHANGED
|
@@ -299,6 +299,14 @@ export interface ModuleIntegrationNode {
|
|
|
299
299
|
* (键集外 400;resources 恒随既有节点保全)+ views/modules 投影(GET ≡ PUT,三同构)) */
|
|
300
300
|
export const MODULE_INTEGRATION_NODE_KEYS = ['provider', 'config'] as const;
|
|
301
301
|
|
|
302
|
+
/** ServiceIntegrationNode 可写键集单源(applyService 节点键纪律白名单——assertNodeKeys
|
|
303
|
+
* 无条件静态防线,zod 未知键拒绝语义前移,两态一致 400;0.8.2 降级写批新增。
|
|
304
|
+
* 锁步约束:键集须 ⊆ contracts zod 节点 schema(tests 键集锁步用例锁定)) */
|
|
305
|
+
export const SERVICE_INTEGRATION_NODE_KEYS = ['provider', 'implementation', 'config', 'credentialRef', 'instances'] as const;
|
|
306
|
+
|
|
307
|
+
/** services[s].instances[k] 可写键集单源(同上——实例位节点;'*' 通配为 map 键位,不属节点键集) */
|
|
308
|
+
export const SERVICE_INSTANCE_NODE_KEYS = ['provider', 'implementation', 'config', 'credentialRef', 'enabled'] as const;
|
|
309
|
+
|
|
302
310
|
/** 模块资源回显(只读投影——N2 读半边:写侧仍仅 provider/config,resources 恒保全)。
|
|
303
311
|
* 原值文件镜像(L1)+ ref 台账展开态:`ref` 在场且同目录 knowledge.json 命中时
|
|
304
312
|
* `resolvedDatasetId` = 台账 datasetId(镜像 SDK resolveKnowledge 展开语义),未命中/台账缺失 = null。
|
|
@@ -483,6 +491,10 @@ export interface ContractsResolution {
|
|
|
483
491
|
version: string | null;
|
|
484
492
|
evaluation: boolean;
|
|
485
493
|
strictValidation: boolean;
|
|
494
|
+
/** v6 形状标记(内部 ResolvedContracts.ownershipBindingV6 判据投影;additive 0.8.2——
|
|
495
|
+
* 消费语义:false = 偏斜降级(写轴 503 / 前端禁保存);**缺席 = 旧 toolkit 未投影,不得按降级处理**;
|
|
496
|
+
* 降级/阻断判定矩阵单源 = api.md §5 消费指引) */
|
|
497
|
+
ownershipBindingV6?: boolean;
|
|
486
498
|
notes: string[];
|
|
487
499
|
}
|
|
488
500
|
|