@tbox.cn/app-toolkit 0.8.6 → 0.8.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +30 -10
- package/dist/index.js +9 -9
- package/package.json +2 -2
- package/src/assembly/walk-manifests.ts +26 -11
- package/src/core/module-schema.ts +6 -0
- package/src/factory.ts +20 -3
- package/src/views/providers.ts +29 -3
- package/tests/provider-selection-scope.test.ts +363 -0
- package/tests/vendor-schema-keywords.test.ts +20 -2
package/dist/index.d.ts
CHANGED
|
@@ -229,6 +229,12 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
229
229
|
/** 供给商标识自声明(v8——零槽厂商入 catalog:「custom 即 provider 模块」。
|
|
230
230
|
* charset 同 provider 槽(名字进凭据 stem 派生——输入约束①安全面)。 */
|
|
231
231
|
id: z.ZodOptional<z.ZodString>;
|
|
232
|
+
/** 厂商候选范围策略自声明(任务12 可选协议):缺席/='all' ——候选清单恒完整(
|
|
233
|
+
* 缺省语义由消费端解释——walk/vendorMeta 仅显式 'supplied-services' 生效);
|
|
234
|
+
* 'supplied-services' = 厂商仅在供给足迹与请求范围相交时进入限定候选清单。
|
|
235
|
+
* 策略只随**自声明厂商**(id === 本包厂商)进 vendorMeta——槽贡献
|
|
236
|
+
* (slot.provider 为外来厂商)不附着(U6 同源隔离,「跨厂商不得携带策略」)。 */
|
|
237
|
+
selectionScope: z.ZodOptional<z.ZodEnum<["all", "supplied-services"]>>;
|
|
232
238
|
slots: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
233
239
|
service: z.ZodString;
|
|
234
240
|
provider: z.ZodString;
|
|
@@ -265,8 +271,10 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
265
271
|
credentialSchema?: string | undefined;
|
|
266
272
|
}[];
|
|
267
273
|
id?: string | undefined;
|
|
274
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
268
275
|
}, {
|
|
269
276
|
id?: string | undefined;
|
|
277
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
270
278
|
slots?: {
|
|
271
279
|
service: string;
|
|
272
280
|
provider: string;
|
|
@@ -357,6 +365,7 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
357
365
|
credentialSchema?: string | undefined;
|
|
358
366
|
}[];
|
|
359
367
|
id?: string | undefined;
|
|
368
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
360
369
|
};
|
|
361
370
|
owns: {
|
|
362
371
|
service: string;
|
|
@@ -395,6 +404,7 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
395
404
|
}[] | undefined;
|
|
396
405
|
providers?: {
|
|
397
406
|
id?: string | undefined;
|
|
407
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
398
408
|
slots?: {
|
|
399
409
|
service: string;
|
|
400
410
|
provider: string;
|
|
@@ -492,6 +502,7 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
492
502
|
credentialSchema?: string | undefined;
|
|
493
503
|
}[];
|
|
494
504
|
id?: string | undefined;
|
|
505
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
495
506
|
};
|
|
496
507
|
owns: {
|
|
497
508
|
service: string;
|
|
@@ -561,6 +572,7 @@ declare const moduleDescriptorSchema: z.ZodObject<{
|
|
|
561
572
|
}[] | undefined;
|
|
562
573
|
providers?: {
|
|
563
574
|
id?: string | undefined;
|
|
575
|
+
selectionScope?: "all" | "supplied-services" | undefined;
|
|
564
576
|
slots?: {
|
|
565
577
|
service: string;
|
|
566
578
|
provider: string;
|
|
@@ -1759,11 +1771,15 @@ interface WalkCatalog {
|
|
|
1759
1771
|
credentialSchema?: string;
|
|
1760
1772
|
}>;
|
|
1761
1773
|
/** 厂商展示元数据单源(v8——全厂商统一,slots 厂商 + `declare.providers.id` 零槽自声明同路径;
|
|
1762
|
-
* 首声明胜出与 owner 同语义。U6 守卫:自声明包声明外来厂商槽 → 供给照常贡献、meta 不附着)。
|
|
1774
|
+
* 首声明胜出与 owner 同语义。U6 守卫:自声明包声明外来厂商槽 → 供给照常贡献、meta 不附着)。
|
|
1775
|
+
* selectionScope(任务12 可选协议):仅 'supplied-services' 受限时在场('all'/缺席同义恒
|
|
1776
|
+
* 完整清单)——来源恒为厂商**自声明**(declare.providers 顶层字段,与 id 同块);槽贡献
|
|
1777
|
+
* 不携带(防外来厂商策略附着),首有效声明胜出(??=)。 */
|
|
1763
1778
|
vendorMeta: Record<string, {
|
|
1764
1779
|
owner: string;
|
|
1765
1780
|
name?: string;
|
|
1766
1781
|
description?: string;
|
|
1782
|
+
selectionScope?: 'supplied-services';
|
|
1767
1783
|
}>;
|
|
1768
1784
|
}
|
|
1769
1785
|
/** 词汇源条目(via 标记供 doctor 幻影槽判定——config 快照 vs 真源;walkManifests 消费忽略此字段) */
|
|
@@ -2302,15 +2318,11 @@ declare function loadAppView(snapshot: ViewSnapshot): AppView;
|
|
|
2302
2318
|
*/
|
|
2303
2319
|
declare function loadServiceDetailView(snapshot: ViewSnapshot, service: string): ServiceDetail;
|
|
2304
2320
|
|
|
2305
|
-
/**
|
|
2306
|
-
* 供给轴投影(views/providers;C4)。v8 后供给面 = 名单(/providers,vendorMeta 单源含
|
|
2307
|
-
* 零槽自声明厂商)· 判定(/providers/:p/supply——见 provider-supply.ts)·
|
|
2308
|
-
* 表单(组合单体 /providers/:p/services/:s——configSchema 唯一暴露面)。
|
|
2309
|
-
* 静态端点零求值(铁律 #3)。
|
|
2310
|
-
*/
|
|
2311
2321
|
/** GET /providers:厂商基本信息(vendorMeta 单源——slots 厂商 + 零槽自声明厂商同路径;
|
|
2312
|
-
* 零槽厂商 = 空 impl map + 自声明 meta(supply
|
|
2313
|
-
|
|
2322
|
+
* 零槽厂商 = 空 impl map + 自声明 meta(supply 判定「厂商在、供给空」语义)。
|
|
2323
|
+
* scope(任务12 可选):限定候选清单——仅 supplied-services 受限厂商参与筛选;
|
|
2324
|
+
* 无策略厂商恒保留;成员/字段/排序与完整清单同构(响应不新增必填字段,相对排序保持)。 */
|
|
2325
|
+
declare function loadProvidersView(snapshot: ViewSnapshot, scope?: ProviderSupplyScope): ProvidersView;
|
|
2314
2326
|
/** 组合单体(GET /providers/:p/services/:s):catalog 供给与槽级内联声明统一解析(/) */
|
|
2315
2327
|
declare function loadProviderServiceDetailView(snapshot: ViewSnapshot, provider: string, service: string): ProviderServiceDetail;
|
|
2316
2328
|
|
|
@@ -2481,7 +2493,15 @@ interface AppToolkitRead {
|
|
|
2481
2493
|
}): Promise<ServiceDetail>;
|
|
2482
2494
|
loadServiceResolutions(services?: string[]): Promise<ServiceResolutionsView>;
|
|
2483
2495
|
loadServiceResolution(service: string): Promise<ServiceResolutionDetail>;
|
|
2484
|
-
|
|
2496
|
+
/** GET /providers(v8 完整清单;任务12 可选 scope 限定):缺省/`{}` = 完整在册清单
|
|
2497
|
+
* (忽略候选范围策略——成员、字段和排序保持当前行为);`{scope}` = 限定候选清单
|
|
2498
|
+
* (supplied-services 受限厂商按供给足迹与范围相交筛选;无策略厂商恒保留)。
|
|
2499
|
+
* scope 显式请求参数(不从其他来源推断);错误矩阵沿 loadProviderSupply:
|
|
2500
|
+
* 未知 kind/空值/伴随参数缺席 → 400 fields 指向出错参数;scope=module 未安装
|
|
2501
|
+
* 模块 → 404 MODULE_NOT_FOUND(参数错误先于资源查询)。additive——原调用零变化。 */
|
|
2502
|
+
loadProviders(o?: {
|
|
2503
|
+
scope?: ProviderSupplyScope;
|
|
2504
|
+
}): Promise<ProvidersView>;
|
|
2485
2505
|
/** GET /providers/:p/supply?scope=…(v8——供给判定;切换预览唯一判定源,前端零关系计算)。
|
|
2486
2506
|
* scope 显式判别联合;provider ∉ catalog → 404;scope=module 未装 → 404;
|
|
2487
2507
|
* scope=service 任意 id 恒 200(判定非寻址)。 */
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import{a as Be,b as
|
|
2
|
-
`,"utf8"),i}import{mkdirSync as
|
|
3
|
-
`,"utf8")}function ze(e){let n=$n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Dn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Lt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Bt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Wt(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ut(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Fn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(i=>typeof i=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:d}=o,S={};typeof s=="string"&&s.length>0&&(S.name=s),typeof d=="string"&&d.length>0&&(S.description=d),(S.name!==void 0||S.description!==void 0)&&(t[i]=S)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let i=JSON.parse(t),o=ae(i);if(o.ok)return{kind:"strict",id:o.value.id,version:o.value.version,descriptor:o.value,declare:o.value.declare};if(o.legacy)return{kind:"legacy",detail:o.errors.join("; ")};if(i&&typeof i=="object"&&"declare"in i){let s=i;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!$(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function zt(e){let n=V(e,".tbox","app.json");if(!$(n))return[];try{let r=JSON.parse(X(n,"utf8"));return Array.isArray(r.npmModules)?r.npmModules.filter(t=>!!t&&typeof t=="object"&&typeof t.id=="string"&&typeof t.package=="string"):[]}catch{return[]}}function Gt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!$(r))return[];try{let t=JSON.parse(X(r,"utf8")),i=[];for(let[o,s]of Object.entries(t.redirects??{}))typeof s!="string"||!o.startsWith("@tbox.cn/app-")||i.push({pkg:o,dir:V(n,s)});return i}catch{return[]}}function Wn(e,n){let r=[],t=[e];for(let d of["apps","packages"]){let S=V(e,d);if($(S))try{for(let u of Ge(S,{withFileTypes:!0}))u.isDirectory()&&t.push(V(S,u.name))}catch{}}let i=new Set,o=(d,S,u)=>{let f=n?n.read(S,Ln):Ln(X(S,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:u})},s=V(e,"config","service-slots.json");$(s)&&o(e,s,"config-override");for(let d of t){let S=V(d,"node_modules","@tbox.cn");if(!$(S))continue;let u=[];try{u=Ge(S)}catch{continue}for(let f of u){let R=V(S,f);if(i.has(R))continue;i.add(R);let k=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");$(k)?o(R,k,"package"):$(g)&&o(R,g,"package")}}for(let d of t)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])$(S)&&o(d,S,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,m,h,l,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...l?.name?{name:l.name}:{},...l?.description?{description:l.description}:{}});let y=t.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&l?.name?{name:l.name}:{},...c&&l?.description?{description:l.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},u=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let l=s[h];l===void 0?s[h]=m:l!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${l} 与 ${m} 均声明 owns(先声明 ${l} 胜出)——修正 manifest declare.owns 互斥`})}},k=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,l=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of l){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(v.defaults.push(c),w.add(y))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...l],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),l=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){k(l,a.id),d.add(a.id);continue}if(!l)continue;d.add(a.id);let v=$(V(m,"tbox.module.json"))?m:h,w=g(l);l.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,a.package,f(l)),c.length&&S(c,a.package,v,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){k(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let l=g(h),v=l?.providers?.slots??[],w=l?.providers?.id;w&&u(w,a,f(h)),v.length&&S(v,a,m,f(h),w);let c=l?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let x=V(e,"packages");if($(x)){let a=[];try{a=Ge(x,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(x,m),l=Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){k(l,m),d.add(m);continue}if(!l)continue;let v=l.id??m;if(d.has(v))continue;d.add(v);let w=g(l);l.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,`@app/${v}`,f(l)),c.length&&S(c,`@app/${v}`,h,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${v}`);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),v)}}let O=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)O.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...O].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!$(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!$(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(e){return D(e).ownership}function L(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function K(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function z(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Kn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:u,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:x,ownership:O,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let T=I??Object.keys(y.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,O);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(k||g)for(let[c,y]of Object.entries(t.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=O?.[c],T=M!=null?t.modules?.[M]?.credentialRef:void 0,j=I.credentialRef??y.credentialRef??T??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof j!="string"||!j.startsWith("secret://"))continue;let P=j.slice(9);k?.[P]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${P}(${c}@${A} effective ref=${j};档内 config/credentials/ 无此文件)`});let _=g?.[P];if(_){let B=h(c,y,I,A);B&&_!==B&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${P}.json type=${_} 与绑定 credentialType ${B} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let l=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))l(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))l(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(t.services)){if(!o[c]&&O?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!z(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){l(I,`services.${c}.instances`);let T=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=M.provider,_=M.implementation;typeof P=="string"&&typeof _=="string"?i[le(P,_)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${_} 未命中已装供给(${c}@${I})`}):z(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||m.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=O?.[y],I=A!=null?t.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[y,A]of Object.entries(t.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(t.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=r.resolveEffectiveService(t,c,I,s,O);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(t.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(t.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(O)for(let j of Object.values(O))j===c&&(M+=1);if(I||!(O===void 0)&&M===0){let j=I?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(u){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(u[I]&&c.add(I),!u[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(t.provider);for(let I of Object.values(t.modules??{}))A(I?.provider);for(let I of Object.values(t.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)u[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of u[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let T=(j,P,_,B)=>{for(let[q]of Object.entries(j??{}))(_??I).has(q)?B&&B.size>0&&!B.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};T(t.config,"root.config",void 0,M);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let _=L(t,j).provider??void 0;if(_===void 0){T(P.config,`modules.${j}.config`,void 0,M);continue}let B=u[_];if(!B||R?.[_])continue;let q=f?.[_];T(P.config,`modules.${j}.config`,new Set(B),q)}}}for(let[c,y]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(t.modules??{})){let A=x?.[c];x&&!(c in x)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[I,M]of Object.entries(y?.resources??{})){let T=M?.type;(typeof T!="string"||!r.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${I} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function ue(e,n,r,t=process.env){let i={};for(let[l,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${l}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[l,v]of Object.entries(n.catalog.services))o[l]={optional:v.optional,owners:[...v.owners]};let s={},d={},S={},u={},f={};for(let l of n.modules){f[l.id]=new Set((l.descriptor.declare.resources??[]).map(v=>v.id));for(let v of l.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(l.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,y=d[v.provider]??=new Set;for(let I of Qt(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[v.provider]=!0}v.credentialSchema&&!Ye(ke(l.dir,v.credentialSchema))&&(u[v.credentialType]=!0)}}let R={},k=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let l of qt(g)){if(!l.endsWith(".json"))continue;let v=l.slice(0,-5);k.add(v);let w=zn(ke(g,l));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,x=[],O=l=>{typeof l=="string"&&l.startsWith("secret://")&&x.push(l)};for(let l of Object.values(C.services??{}))if(l&&typeof l=="object"){O(l.credentialRef);for(let v of Object.values(l.instances??{}))v&&typeof v=="object"&&O(v.credentialRef)}for(let l of Object.values(C.modules??{}))l&&typeof l=="object"&&O(l.credentialRef);for(let l of Object.values(C.credentialRefByInstance??{}))O(l);O(C.credentialRef);let p={};for(let l of x){let v=l.slice(9);t[Gn(v)]===void 0&&(k.has(v)||(p[v]=!0))}let a=[];for(let[l,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,y]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${l}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(l=>l&&typeof l=="object"&&typeof l.id=="string"?l.id:void 0).filter(l=>typeof l=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:u,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(l=>l.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,S]of Object.entries(s))r[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function J(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await N(e),t=J(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let S=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,U(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,U(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${U(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&z(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=J(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await N(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ze(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,u=structuredClone(r);u.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let x=(u.modules??{})[g.module];x?.provider&&(f.push(`modules.${g.module}.provider=${String(x.provider)}`),delete x.provider,Object.keys(x).length===0&&delete u.modules[g.module])}else u.provider&&(f.push(`root.provider=${u.provider}`),delete u.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=u.modules??{};if(C[g.module]){let x=C[g.module],O=[x.provider!==void 0?"provider":void 0,x.config!==void 0?"config":void 0,x.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${O.join("+")} 整节点)`),delete u.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=u.services[g.service];if(!C)continue;let x=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),x!==void 0?Ee(u.modules?.[x]?.provider):void 0,Ee(u.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete u.services[g.service]}else delete u.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(u.services).length===0&&delete u.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!u.provider&&Object.keys(u.services??{}).length===0&&Object.keys(u.config??{}).length===0&&Object.keys(u.configByInstance??{}).length===0&&!u.credentialRef&&Object.keys(u.credentialRefByInstance??{}).length===0&&(u.instances??[]).length===0&&u.defaultInstanceId==null&&Object.keys(u.modules??{}).length===0;if(!R&&(u.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(u)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):F(n,`${JSON.stringify(u,null,2)}
|
|
4
|
-
`),
|
|
5
|
-
`),
|
|
6
|
-
`),
|
|
7
|
-
`)}else{for(let s of
|
|
8
|
-
`)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=L(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:z(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=J(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function Y(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,u=>JSON.parse(u))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,u]of Object.entries(i)){if(!u||typeof u!="object"||Array.isArray(u))continue;let f=u,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),k=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=k??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),x={type:R,...k!==void 0?{datasetId:k}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=x}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function an(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=K(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,g)=>{let C=Y(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(k=>o(k.service,k.optional===!1)),...[...new Set(t.ownedServices)].filter(k=>!i.has(k)).map(k=>o(k,!1))],d=e.integrations?.modules??{},S=d[n],u=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{},...typeof S.credentialRef=="string"?{credentialRef:S.credentialRef}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:u,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=Y(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=Y(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let u of Object.values(t))u.services.includes(r)&&o.push({implementation:u.implementation,credentialType:u.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&L(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,u=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,u,s),R=mt(n,e,u),k=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:g??null,layer:R??null},x=new Set(Object.keys(n.catalog.providers)),O=g!==void 0&&x.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...O!==void 0?{supplied:O}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(O=>O.id),S=n.integrations?.services?.[e],u=S?.instances?Object.keys(S.instances):void 0,f=St(u,d),R=new Map;for(let O of f)R.set(O,vt(n,t,e,O,i));let k=f.map(O=>{let p=R.get(O);return{instanceId:O,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),x={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:g};return{contracts:_e(n.contracts),resolution:x,issues:r.filter(O=>O.service===e)}}function St(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?L(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function $e(e,n,r){let t=W(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=W(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return St(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=K(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:Y(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Nr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Tr(e){let n=e.map(t=>Nr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=oe(e[0].subschema);return e.every(i=>oe(i.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>jr(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(r=!1);let u=S.properties;if(!u||typeof u!="object"||Array.isArray(u))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(u)){let k=t.get(R)??[];k.push({service:o,subschema:u[R],required:f.includes(R)}),t.set(R,k)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Tr(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!K(n.walk,t).writable?null:L(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt(Fe(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt(Fe(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return L(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(z(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:i}of n?.instances??[]){let o=n?.credentialRefByInstance?.[i];o!==void 0&&(r.byInstance[i]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let i=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var $r={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=$r[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Fr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,W(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,W(p))}function d(p){return at(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function u(){let p=await N(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},l=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...l})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let k={async loadModules(p){let a=await N(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await N(e),l=d(h),v=Oe(l.walk,p),w=an(l,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await u().then(y=>ve(l,y,c)):$e(l,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(l,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await N(e),h=d(m),l=cn(h);if(a.has("serviceResolutions")&&(l.serviceResolutions=ye(m)?await u().then(v=>ve(h,v)):$e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(l.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(l.integrationFieldRegistry=v.integrationFieldRegistry)}return l},async loadService(p,a){let m=kn("service",a?.include),h=await N(e),l=d(h),v=H(l.walk,S(l),p),w=dn(l,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(l,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(l,v)),w},async loadServiceResolutions(p){let a=await N(e),m=d(a);if(!ye(a))return $e(m,a,p);let h=await u();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=d(a),h=H(m.walk,S(m),p);if(!ye(a))return Rt(h,m,a);let l=await u();return gn(h,m,l)},async loadProviders(){let p=await N(e);return ln(d(p))},async loadProviderSupply(p,a){Fr(a);let m=await N(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=d(m),l=H(h.walk,S(h),a);return un(h,p,l)},async loadCredentials(){let p=await N(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await N(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await N(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=Oe(d(h).walk,p);return g.applyModule(l.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=d(h),v=H(l.walk,S(l),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return o(a),R(()=>{let m=d(a),h=H(m.walk,S(m),p);return g.deleteService(h)})}},x={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return N(e)},walkManifests(){return O(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return J(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function O(p){return D(p,r)}return{...k,...C,...x}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");F(t,`${JSON.stringify(n,null,2)}
|
|
9
|
-
`),
|
|
1
|
+
import{a as Be,b as ae,c as N,d as We}from"./chunk-K5FIGT5A.js";import{z as k}from"zod";var G=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,Ar=k.object({cardType:k.string(),schemaVersion:k.number().optional()}),bn=k.object({route:k.string(),component:k.string()}),An=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)}),En=k.object({service:k.string(),provider:k.string().regex(G,"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()}),On=k.object({service:k.string(),optional:k.boolean().default(!0),defaults:k.array(k.object({provider:k.string().regex(G,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string()})).default([]),name:k.string().optional(),description:k.string().optional()}),xn=k.object({service:k.string()}).strict(),Mn=k.object({id:k.string(),type:k.string()}),jn=k.object({$comment:k.union([k.string(),k.record(k.string(),k.unknown())]).optional(),$schema:k.string().optional(),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(Ar).default([]),routes:k.array(k.string()).default([]),pages:k.array(bn).default([]),tabs:k.array(An).default([]),providers:k.object({id:k.string().regex(G,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),selectionScope:k.enum(["all","supplied-services"]).optional(),slots:k.array(En).default([])}).default({}),owns:k.array(xn).default([]),consumes:k.array(On).default([]),resources:k.array(Mn).default([])}).default({}),dependencies:k.object({modules:k.array(Cn).default([])}).default({}),env:k.array(k.string()).default([])}).strict();function Cr(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],t=e;"contributes"in t&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let r=t.declare;r&&typeof r=="object"&&!Array.isArray(r)&&"services"in r&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in t)&&"name"in t&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=r&&typeof r=="object"&&!Array.isArray(r)?r:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in t||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ce(e){let n=Cr(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let t=jn.safeParse(e);return t.success?{ok:!0,value:t.data}:{ok:!1,errors:t.error.issues.map(r=>`${r.path.join(".")||"(root)"}: ${r.message}`)}}var Er=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Nn(e){return JSON.stringify(e).slice(1,-1)}function Ue(e,n=process.env){let t=[],r=e.replace(Er,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let d=n[o];return d!==void 0?Nn(d):s!==void 0?Nn(s):(t.push(o),i)});return t.length>0?{missing:t}:{text:r,missing:[]}}import{mkdirSync as Or,existsSync as Tn,readFileSync as xr,writeFileSync as Mr}from"fs";import{dirname as jr,join as Pn}from"path";function we(e){let n={};for(let[t,r]of Object.entries(e)){if(typeof r!="string"){n[t]=null;continue}n[t]=r.length<=4?"****":`${r.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,t,r,i){super(r),this.name="AppToolkitError",this.code=n,this.httpStatus=t,this.fields=i}};function U(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 X(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 Nr(e){return`secret://${e}`}function K(e){return`config/credentials/${e}.json`}function de(e,n){let t=Pn(e,K(n));if(!Tn(t))return null;try{let r=JSON.parse(xr(t,"utf8"));if(typeof r.type!="string")return null;let{type:i,...o}=r,s={};for(let[d,S]of Object.entries(o))typeof S=="string"&&(s[d]=S);return{type:i,values:s}}catch{return null}}function Ke(e,n,t){let r=Pn(e,K(n)),i=Tn(r);return Or(jr(r),{recursive:!0}),Mr(r,`${JSON.stringify({type:t.type,...t.values},null,2)}
|
|
2
|
+
`,"utf8"),i}import{mkdirSync as Tr,renameSync as Pr,writeFileSync as Vr}from"fs";import{dirname as Dr}from"path";function $(e,n){Vn(Dr(e));let t=`${e}.tmp-${process.pid}-${Date.now()}`;Vr(t,n,"utf8"),Pr(t,e)}function Vn(e){Tr(e,{recursive:!0})}import{existsSync as F,readdirSync as Ge,readFileSync as ee}from"fs";import{join as V}from"path";import{existsSync as _r,readFileSync as Dn,mkdirSync as Fr,writeFileSync as $r}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function Fn(e){let n=Re(e);if(!_r(n))return null;try{let t=JSON.parse(Dn(n,"utf8")),r=t?.templateVersion;return typeof r!="string"||r.trim().length===0?null:{templateVersion:r.trim(),npmModules:Array.isArray(t?.npmModules)?t.npmModules:[]}}catch{return null}}function Lr(e,n){let t=Re(e);Fr(_n.dirname(t),{recursive:!0}),$r(t,`${JSON.stringify(n,null,2)}
|
|
3
|
+
`,"utf8")}function ze(e){let n=Fn(e);if(n===null)return null;let t=Re(e);try{let r=JSON.parse(Dn(t,"utf8"));return{...n,miniappContainers:Array.isArray(r?.miniappContainers)?r.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Br(e,n){let t=e.npmModules.filter(r=>r.id!==n.id);return{...e,npmModules:[...t,n]}}function Wr(e,n){return{...e,npmModules:e.npmModules.filter(t=>t.id!==n)}}function Ur(e,n){let t=(e.miniappContainers??[]).filter(r=>r.id!==n.id);return{...e,miniappContainers:[...t,n]}}function Kr(e,n,t){return{...e,npmModules:e.npmModules.map(r=>r.id===n?{...r,...t}:r)}}function $n(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function zr(e,n){if(!$n(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Ln(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let t=n.slots.filter(i=>typeof i=="string"),r={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[i,o]of Object.entries(n.meta)){if(!o||typeof o!="object"||Array.isArray(o))continue;let{name:s,description:d}=o,S={};typeof s=="string"&&s.length>0&&(S.name=s),typeof d=="string"&&d.length>0&&(S.description=d),(S.name!==void 0||S.description!==void 0)&&(r[i]=S)}return{slots:t,meta:r}}catch{return null}}function Ie(e,n){let t=r=>{try{let i=JSON.parse(r),o=ce(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,t)??null;if(!F(e))return null;try{return t(ee(e,"utf8"))}catch{return null}}function Gr(e){let n=V(e,".tbox","app.json");if(!F(n))return[];try{let t=JSON.parse(ee(n,"utf8"));return Array.isArray(t.npmModules)?t.npmModules.filter(r=>!!r&&typeof r=="object"&&typeof r.id=="string"&&typeof r.package=="string"):[]}catch{return[]}}function Jr(e){let n=V(e,".tbox-dev.local"),t=V(n,"dev-manifest.json");if(!F(t))return[];try{let r=JSON.parse(ee(t,"utf8")),i=[];for(let[o,s]of Object.entries(r.redirects??{}))typeof s!="string"||!o.startsWith("@tbox.cn/app-")||i.push({pkg:o,dir:V(n,s)});return i}catch{return[]}}function Wn(e,n){let t=[],r=[e];for(let d of["apps","packages"]){let S=V(e,d);if(F(S))try{for(let u of Ge(S,{withFileTypes:!0}))u.isDirectory()&&r.push(V(S,u.name))}catch{}}let i=new Set,o=(d,S,u)=>{let f=n?n.read(S,Ln):Ln(ee(S,"utf8"));f!=null&&t.push({dir:d,slots:f.slots,meta:f.meta,via:u})},s=V(e,"config","service-slots.json");F(s)&&o(e,s,"config-override");for(let d of r){let S=V(d,"node_modules","@tbox.cn");if(!F(S))continue;let u=[];try{u=Ge(S)}catch{continue}for(let f of u){let R=V(S,f);if(i.has(R))continue;i.add(R);let b=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");F(b)?o(R,b,"package"):F(g)&&o(R,g,"package")}}for(let d of r)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])F(S)&&o(d,S,"local");return t}function D(e,n){let t=[],r={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,v,h,l,m)=>{for(let w of a){let c=m===void 0||m===w.provider;c&&(r.vendorMeta[w.provider]??={owner:v,...l?.name?{name:l.name}:{},...l?.description?{description:l.description}:{}});let y=r.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:v,...c&&l?.name?{name:l.name}:{},...c&&l?.description?{description:l.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},r.credentialTypes[w.credentialType]??={owner:v,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},u=(a,v,h,l)=>{r.providers[a]??={};let m=r.vendorMeta[a]!==void 0,w=r.vendorMeta[a]??={owner:v,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}};!m&&l==="supplied-services"&&(w.selectionScope="supplied-services")},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,v)=>{for(let h of a){let l=s[h];l===void 0?s[h]=v:l!==v&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:v,message:`服务 ${h} 归属冲突:${l} 与 ${v} 均声明 owns(先声明 ${l} 胜出)——修正 manifest declare.owns 互斥`})}},b=(a,v)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:v,message:`${v}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,v)=>{let h=a.optional!==!1,l=a.defaults??[],m=r.services[a.service];if(m){m.optional=m.optional&&h;let w=new Set(m.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of l){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(m.defaults.push(c),w.add(y))}m.owners.includes(v)||m.owners.push(v);return}r.services[a.service]={optional:h,defaults:[...l],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[v]}};for(let a of Gr(e)){if(d.has(a.id))continue;let v=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),l=Ie(V(v,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){b(l,a.id),d.add(a.id);continue}if(!l)continue;d.add(a.id);let m=F(V(v,"tbox.module.json"))?v:h,w=g(l);l.kind==="strict"&&t.push({id:a.id,dir:m,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,a.package,f(l),w?.providers?.selectionScope),c.length&&S(c,a.package,m,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:v}of Jr(e)){let h=Ie(V(v,"tbox.module.json"),n);if(h?.kind==="legacy"){b(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let l=g(h),m=l?.providers?.slots??[],w=l?.providers?.id;w&&u(w,a,f(h),l?.providers?.selectionScope),m.length&&S(m,a,v,f(h),w);let c=l?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let x=V(e,"packages");if(F(x)){let a=[];try{a=Ge(x,{withFileTypes:!0}).filter(v=>v.isDirectory()).map(v=>v.name)}catch{}for(let v of a){if(d.has(v))continue;let h=V(x,v),l=Ie(V(h,"tbox.module.json"),n);if(l?.kind==="legacy"){b(l,v),d.add(v);continue}if(!l)continue;let m=l.id??v;if(d.has(m))continue;d.add(m);let w=g(l);l.kind==="strict"&&t.push({id:m,dir:h,pkg:`@app/${m}`,descriptor:l.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&u(y,`@app/${m}`,f(l),w?.providers?.selectionScope),c.length&&S(c,`@app/${m}`,h,f(l),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${m}`);let I=l.kind==="strict"?l.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),m)}}let O=new Set,p={};for(let a of Wn(e,n)){for(let v of a.slots)O.add(v);for(let[v,h]of Object.entries(a.meta))p[v]===void 0&&(p[v]=h)}return{modules:t,catalog:r,serviceSchemas:i,vocabulary:[...O].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,t){let r=V(e,"src",n,"index.ts");if(!F(r))return!1;try{let i=ee(r,"utf8");return new RegExp(`export\\s+const\\s+${t}\\b`).test(i)}catch{return!1}}function Yr(e){let n=V(e,"src","server","index.ts");if(!F(n))return"";try{return ee(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Hr(e){let n=[],t=D(e),r=ze(e),i=new Map;for(let o of r?.npmModules??[])i.set(o.id,o.mode);for(let o of t.modules){let s=i.get(o.id)??"local",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Yr(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Zr(e){return D(e).ownership}function L(e,n){let t=e?.modules?.[n]?.provider;if(typeof t=="string"&&t.length>0)return{provider:t,layer:"module"};let r=e?.provider;return typeof r=="string"&&r.length>0?{provider:r,layer:"app"}:{provider:null,layer:null}}function B(e,n){let t=(n.descriptor.declare.owns??[]).map(r=>r.service).sort();return t.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:t}}function H(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(t=>t.services))].sort()}function z(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),t=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>t.has(i)))return!1;let r=e;return typeof r.provider=="string"&&r.provider.length>0&&typeof r.credentialType=="string"&&r.credentialType.length>0&&(r.configSchema===void 0||typeof r.configSchema=="string")}function Kn(e,n,t){return e==="*"||t.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...t].join(", ")})`}}function Je(e,n){let t=new Set(n),r=[],i=(o,s)=>{let d=Kn(o,s,t);d&&r.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return r}function ne(e){let n=[],t=e.contracts,{integrations:r,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:u,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:b,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:x,ownership:O,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let v=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let T=I??Object.keys(y.instances??{})[0]??"",j=t.resolveEffectiveService(r,c,T,s,O);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(b||g)for(let[c,y]of Object.entries(r.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=O?.[c],T=M!=null?r.modules?.[M]?.credentialRef:void 0,j=I.credentialRef??y.credentialRef??T??r.credentialRefByInstance?.[A]??r.credentialRef;if(typeof j!="string"||!j.startsWith("secret://"))continue;let P=j.slice(9);b?.[P]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${P}(${c}@${A} effective ref=${j};档内 config/credentials/ 无此文件)`});let _=g?.[P];if(_){let W=h(c,y,I,A);W&&_!==W&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${P}.json type=${_} 与绑定 credentialType ${W} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let l=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(r.configByInstance??{}))l(c,"configByInstance");for(let[c]of Object.entries(r.credentialRefByInstance??{}))l(c,"credentialRefByInstance");let m=Object.entries(r.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(m.length>0){let c=Object.entries(r.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${m.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=t.normalizeInstances({instances:r.instances,defaultInstanceId:r.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(r.services)){if(!o[c]&&O?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!z(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){l(I,`services.${c}.instances`);let T=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=M.provider,_=M.implementation;typeof P=="string"&&typeof _=="string"?i[le(P,_)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${_} 未命中已装供给(${c}@${I})`}):z(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",r.provider],...Object.entries(r.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||v.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=O?.[y],I=A!=null?r.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof r.provider=="string"&&r.provider)return{provider:r.provider,where:"root"}};for(let[y,A]of Object.entries(r.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(r.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=t.resolveEffectiveService(r,c,I,s,O);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(r.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(r.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(O)for(let j of Object.values(O))j===c&&(M+=1);if(I||!(O===void 0)&&M===0){let j=I?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(u){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(u[I]&&c.add(I),!u[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(r.provider);for(let I of Object.values(r.modules??{}))A(I?.provider);for(let I of Object.values(r.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)u[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of u[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let T=(j,P,_,W)=>{for(let[Q]of Object.entries(j??{}))(_??I).has(Q)?W&&W.size>0&&!W.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(r.config,"root.config",void 0,M);for(let[j,P]of Object.entries(r.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(r.modules??{})){if(!P?.config)continue;let _=L(r,j).provider??void 0;if(_===void 0){T(P.config,`modules.${j}.config`,void 0,M);continue}let W=u[_];if(!W||R?.[_])continue;let Q=f?.[_];T(P.config,`modules.${j}.config`,new Set(W),Q)}}}for(let[c,y]of Object.entries(o)){let A=r.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(r.modules??{})){let A=x?.[c];x&&!(c in x)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[I,M]of Object.entries(y?.resources??{})){let T=M?.type;(typeof T!="string"||!t.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${I} type 非法(${String(T)};词汇表 = ${t.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as qr,readdirSync as Qr}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(qr(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Xr(e){let n=new Set,t=e.properties;if(t&&typeof t=="object"&&!Array.isArray(t))for(let r of Object.keys(t))n.add(r);return n}function ue(e,n,t,r=process.env){let i={};for(let[l,m]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(m))i[`${l}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[l,m]of Object.entries(n.catalog.services))o[l]={optional:m.optional,owners:[...m.owners]};let s={},d={},S={},u={},f={};for(let l of n.modules){f[l.id]=new Set((l.descriptor.declare.resources??[]).map(m=>m.id));for(let m of l.descriptor.declare.providers?.slots??[]){if(m.configSchema){let w=zn(ke(l.dir,m.configSchema));if(w){let c=s[m.provider]??=new Set,y=d[m.provider]??=new Set;for(let I of Xr(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[m.provider]=!0}m.credentialSchema&&!Ye(ke(l.dir,m.credentialSchema))&&(u[m.credentialType]=!0)}}let R={},b=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let l of Qr(g)){if(!l.endsWith(".json"))continue;let m=l.slice(0,-5);b.add(m);let w=zn(ke(g,l));w&&typeof w.type=="string"&&(R[m]=w.type)}let C=t,x=[],O=l=>{typeof l=="string"&&l.startsWith("secret://")&&x.push(l)};for(let l of Object.values(C.services??{}))if(l&&typeof l=="object"){O(l.credentialRef);for(let m of Object.values(l.instances??{}))m&&typeof m=="object"&&O(m.credentialRef)}for(let l of Object.values(C.modules??{}))l&&typeof l=="object"&&O(l.credentialRef);for(let l of Object.values(C.credentialRefByInstance??{}))O(l);O(C.credentialRef);let p={};for(let l of x){let m=l.slice(9);r[Gn(m)]===void 0&&(b.has(m)||(p[m]=!0))}let a=[];for(let[l,m]of Object.entries(C.services??{})){let w=m&&typeof m=="object"&&typeof m.provider=="string"?m.provider:void 0;for(let[c,y]of Object.entries((m&&typeof m=="object"?m.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${l}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(l=>l&&typeof l=="object"&&typeof l.id=="string"?l.id:void 0).filter(l=>typeof l=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:u,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(l=>l.id),...new Set(Object.values(n.ownership))])}}import{existsSync as Si,readFileSync as wi}from"fs";import{join as Ri,resolve as Ii}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,t={};for(let[o,s]of Object.entries(n.providers)){t[o]={};for(let[d,S]of Object.entries(s))t[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let r={};for(let[o,s]of Object.entries(n.services))r[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:t,services:r,credentialTypes:i}}async function Ze(e,n,t,r=process.env){let i=t.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,r);return ne({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as st,rmSync as at}from"fs";import{join as ct}from"path";import{existsSync as et,readFileSync as nt}from"fs";import{join as Jn}from"path";var rt=Jn("config","integrations.json");function J(e,n){let t=Jn(e,rt),r=i=>JSON.parse(i);if(n)return n.read(t,r)??null;if(!et(t))return null;try{return r(nt(t,"utf8"))}catch{return null}}async function Yn(e,n){let t=await N(e),r=J(e,n);if(r===null)return{config:null,strict:!1,contracts:t};if(t.strictValidation&&t.module.parseIntegrationsConfig)try{return{config:t.module.parseIntegrationsConfig(r),strict:!0,contracts:t}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:r,strict:!1,contracts:t}}function pe(e,n,t,r){return e.includes(t)||n.includes(t)||r.includes(t)}import{readdirSync as tt,existsSync as Ae,readFileSync as it}from"fs";import{join as Ce}from"path";function Hn(e,n,t){let r=[];if(n){let i=X({provider:e});r.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(t??{})){let s=X({provider:e,instanceId:i});r.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return r}function Zn(e,n,t,r,i){let o=[];if(r){let s=X({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:r})}for(let[s,d]of Object.entries(i??{})){let S=X({provider:e,instanceId:s,domain:t});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,t){return n.map(r=>({stem:r.stem,ref:r.ref,overwrote:t?Ae(Ce(e,K(r.stem))):Ke(e,r.stem,r.input)}))}function ot(e,n){return Ae(Ce(e,K(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let t of e)qe(t,n);return}if(e&&typeof e=="object")for(let t of Object.values(e))qe(t,n)}function re(e){let n=Ce(e,"config","credentials"),t=new Set,r=Ce(e,"config","integrations.json");if(Ae(r))try{qe(JSON.parse(it(r,"utf8")),t)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tt(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(t.has(s))continue;let d=de(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${K(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&z(e)){let n=e.provider;return n.length>0?n:void 0}}async function dt(e){let n=ct(e,"config","integrations.json"),t=J(e);if(t===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let r=await N(e);if(!r.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(t),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ze(e,i,r,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,u=structuredClone(t);u.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let x=(u.modules??{})[g.module];x?.provider&&(f.push(`modules.${g.module}.provider=${String(x.provider)}`),delete x.provider,Object.keys(x).length===0&&delete u.modules[g.module])}else u.provider&&(f.push(`root.provider=${u.provider}`),delete u.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=u.modules??{};if(C[g.module]){let x=C[g.module],O=[x.provider!==void 0?"provider":void 0,x.config!==void 0?"config":void 0,x.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${O.join("+")} 整节点)`),delete u.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=u.services[g.service];if(!C)continue;let x=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),x!==void 0?Ee(u.modules?.[x]?.provider):void 0,Ee(u.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete u.services[g.service]}else delete u.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(u.services).length===0&&delete u.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!u.provider&&Object.keys(u.services??{}).length===0&&Object.keys(u.config??{}).length===0&&Object.keys(u.configByInstance??{}).length===0&&!u.credentialRef&&Object.keys(u.credentialRefByInstance??{}).length===0&&(u.instances??[]).length===0&&u.defaultInstanceId==null&&Object.keys(u.modules??{}).length===0;if(!R&&(u.services??={},typeof r.module.parseIntegrationsConfig=="function"))try{r.module.parseIntegrationsConfig(u)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let b=[];return R?st(n)&&at(n,{force:!0}):$(n,`${JSON.stringify(u,null,2)}
|
|
4
|
+
`),b=re(e).map(g=>g.message),{removed:f,orphanCredentials:b}}function Oe(e,n){let t=e.modules.find(i=>i.id===n);if(t)return t;let r=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(r.length===1)return r[0];throw r.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${r.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Z(e,n,t){let r=new Set;for(let s of Object.values(e.catalog.providers))for(let d of Object.values(s))for(let S of d.services)r.add(S);if(e.vocabulary.includes(t)||Object.hasOwn(e.catalog.services,t)||r.has(t)||n.includes(t)||Object.hasOwn(e.ownership,t))return t;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===t&&o(s);for(let[s,d]of Object.entries(e.catalog.services))d.name===t&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${t}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${t} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as tr,readFileSync as ir}from"fs";import{join as ie,resolve as lt}from"path";import ut from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config","credentialRef"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var q=ie("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((t,r)=>fe(t,n[r]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let t=Object.keys(e),r=Object.keys(n);return t.length!==r.length?!1:t.every(i=>fe(e[i],n[i]))}return!1}var or=["$comment","$schema"];function Me(e,n){if(n)for(let t of or)!(t in e)&&t in n&&(e[t]=n[t])}function Xn(e){if(e===null)return null;let n={...e};for(let t of or)delete n[t];return n}function er(e,n){return fe(Xn(e),Xn(n))}function Pe(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[t,r]of Object.entries(e)){if((t==="provider"||t==="instanceId")&&typeof r=="string"&&!G.test(r))throw new E("VALIDATION_FAILED",400,`${t} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${t}`]);Pe(r,`${n}.${t}`)}}function je(e,n,t){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let r of Object.keys(e))if(!(t&&(r==="*"||r==="**"))&&!G.test(r))throw new E("VALIDATION_FAILED",400,`${n} 键 ${r} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nr(e,n,t){if(t==="root"){let r=e.instances;Array.isArray(r)&&r.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!G.test(s))throw new E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Ne(e,n,t){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let r of Object.keys(e))if(!n.includes(r))throw new E("VALIDATION_FAILED",400,`${t} 仅接受 ${n.join("/")} 键(收到 ${r})`,[r])}}function Te(e,n){let t=ie(e,q),r=i=>JSON.parse(i);if(n)return n.read(t,r)??null;if(!tr(t))return null;try{return r(ir(t,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(t=>t.id);return n.length===0?[]:Je(e,n)}function pt(e,n,t,r){let{catalog:i}=D(e,r),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(t===void 0||d.services.includes(t))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function rr(e,n,t,r,i,o){if(typeof r.type!="string"||r.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??pt(e,n,t,o);if(s!==void 0&&s!=="-"&&r.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${r.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(t===void 0)return;let{serviceSchemas:d}=D(e,o),S=d[`${n}\0${t}`];if(!S?.credentialSchema)return;let u=lt(S.packageDir,S.credentialSchema);if(tr(u))try{let R=new ut({allErrors:!0}).compile(JSON.parse(ir(u,"utf8")));if(!R({type:r.type,...r.values})){let b=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",b)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:t,cache:r}=n;function i(u,f,R,b){let g=u!==null,C=f.length>0,x=!b&&g,O=!b&&C;x&&($(ie(e,q),`${JSON.stringify(u,null,2)}
|
|
5
|
+
`),r?.invalidate([ie(e,q)]));let p=x||O;p&&R.push(...re(e));let a=p&&t!==void 0;a&&t?.();let v=[];return g&&v.push(q),C&&v.push(...f.map(h=>K(h.stem))),{written:p,restartScheduled:a,files:v,credentials:f,issues:R}}let o;async function s(){o=await N(e)}function d(u,f){return u.filter(R=>Array.isArray(R.path)).map(R=>{let b=R.path.map(String).join(".");return f!==""&&b.startsWith(f)&&b.length>f.length?b.slice(f.length):b}).filter(R=>R.length>0)}function S(u,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let b=ae(o);if(b==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,U(o));if(b==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:U(o)});return}try{o.module.parseIntegrationsConfig(u)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(u,f={}){Pe(u,"root"),nr(u,f,"root"),Ne(u,te,"root");let R=[],b=Te(e,r),g=b??{services:{}};b===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let m of te)m in u||delete C[m];for(let[m,w]of Object.entries(u))C[m]=w;let x=typeof C.provider=="string"?C.provider:"app",O=Hn(x,f.credentials,f.credentialsByInstance);for(let m of O)rr(e,x,void 0,m.input,void 0,r);let p=O.find(m=>m.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let m={...C.credentialRefByInstance??{}};for(let w of O)w.instanceId!==void 0&&(m[w.instanceId]=w.ref);C.credentialRefByInstance=m}Me(C,b);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,v=er(b,C);if(v&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};S(C,R,"");let h=f.dryRun===!0,l=Qe(e,O,h);return R.push(...Xe(C)),i(v?null:C,l,R,f.dryRun)},applyModule(u,f,R={}){Pe(f,"root");let{modules:b,catalog:g,ownership:C}=D(e,r),x=b.find(c=>c.id===u);if(!x)throw new E("MODULE_NOT_FOUND",404,`模块 ${u} 非已装模块`);if(!B({modules:b,catalog:g,ownership:C},x).writable)throw new E("VALIDATION_FAILED",400,`模块 ${u} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Te(e,r);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 v=a??{services:{}},h={...v.modules??{}},l={...h[u]??{}};Ne(f,xe,`modules.${u}`);let m={...l};for(let c of xe){let y=f[c];y==null||y===""||typeof y=="object"&&!Array.isArray(y)&&Object.keys(y).length===0?delete m[c]:m[c]=y}Object.keys(m).length===0?delete h[u]:h[u]=m;let w={...v,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(S(w,p,`modules.${u}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(u,f,R={}){Pe(f,"root"),nr(f,R,"slot"),Ne(f,qn,`services.${u}`);for(let[T,j]of Object.entries(f.instances??{}))Ne(j,Qn,`services.${u}.instances.${T}`);let b=[],g=Te(e,r),C=D(e,r);if(!pe(C.vocabulary,Object.keys(g?.services??{}),u,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&b.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let x=g??{services:{}},O={...x.services??{}},p={...x,services:O};Me(p,g),O[u]={...f};let a=f.provider,v=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof v?.provider=="string"?v.provider:"app",l=u.includes(".")?u.slice(0,u.indexOf(".")):u,m=Zn(h,u,l,R.credentials,R.credentialsByInstance);for(let T of m)rr(e,h,u,T.input,typeof v?.credentialType=="string"?v.credentialType:void 0,r);let w=O[u],c=m.find(T=>T.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let T={...w.instances??{}};for(let j of m){if(j.instanceId===void 0)continue;let P={...T[j.instanceId]??{}};P.credentialRef=j.ref,T[j.instanceId]=P}w.instances=T}Me(p,g);let y=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=er(g,p);if(A&&!y)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:b};S(p,b,`services.${u}.`);let I=R.dryRun===!0,M=Qe(e,m,I);return b.push(...Xe(p)),i(A?null:p,M,b,R.dryRun)},deleteService(u){let f=[],R=Te(e,r),b=D(e,r);if(!pe(b.vocabulary,Object.keys(R?.services??{}),u,Object.keys(b.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(u in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[u];let C={...R??{services:{}},services:g};$(ie(e,q),`${JSON.stringify(C,null,2)}
|
|
6
|
+
`),r?.invalidate([ie(e,q)]),f.push(...re(e));let x=t!==void 0;return x&&t?.(),{written:!0,restartScheduled:x,files:[q],credentials:[],issues:f}}}}import{existsSync as ft,readFileSync as gt}from"fs";import{join as mt}from"path";var sr=["$comment","$schema"];function vt(e){try{let n=JSON.parse(gt(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let t=new Set(["services",...sr]);if(Object.keys(n).some(o=>!t.has(o)))return{pristine:!1,meta:{}};let r=n.services;if(!r||typeof r!="object"||Array.isArray(r)||Object.keys(r).length>0)return{pristine:!1,meta:{}};let i={};for(let o of sr)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=mt(e,"config","integrations.json"),t={};if(ft(n)){let s=vt(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};t=s.meta}let r=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&r.push({service:d.service,provider:d.provider,implementation:d.implementation});if(r.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(r.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of r)i[d.service]={};$(n,`${JSON.stringify({...t,provider:s,services:i},null,2)}
|
|
7
|
+
`)}else{for(let s of r)i[s.service]={provider:s.provider,implementation:s.implementation};$(n,`${JSON.stringify({...t,services:i},null,2)}
|
|
8
|
+
`)}return{generated:!0,reason:"generated",services:r.map(s=>s.service).sort()}}var rn={provider:null,layer:null};function tn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:rn}function on(e){let n=tn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:rn,inherited:rn}}function Ve(e,n){let t=e?.modules?.[n]?.provider,r=typeof t=="string"&&t.length>0?t:null,i=L(e,n),o={provider:i.provider,layer:i.layer};return{configured:r,effective:o,inherited:r!==null?tn(e):o}}function yt(e){return typeof e=="string"?e.length>0?e:null:z(e)?e.provider:null}function ge(e,n,t){let r=e?.services?.[t]?.provider,i=yt(r),o=n.ownership[t],s=o!==void 0?Ve(e,o).effective:tn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as St,readFileSync as wt}from"fs";import{join as lr}from"path";function ar(e,n){let t=D(e.appDir,e.cache),r=J(e.appDir,e.cache);return{appDir:e.appDir,walk:t,catalog:t.catalog,integrations:r,contracts:n,...e.cache?{cache:e.cache}:{}}}function cr(e){let n=new Set;for(let t of e.modules){for(let r of t.descriptor.declare.owns??[])n.add(r.service);for(let r of t.descriptor.declare.consumes??[])n.add(r.service);for(let r of t.descriptor.declare.providers?.slots??[])n.add(r.service)}return n}function De(e,n,t){let r=e.providers[n];return r?Object.values(r).some(i=>i.services.includes(t)):!1}function Y(e,n){let t=e.slotMeta[n],r=e.catalog.services[n],i=t?.name??r?.name??n,o=t?.description??r?.description;return{name:i,...o!==void 0?{description:o}:{}}}var ht=lr("config","knowledge.json");function Rt(e,n,t){let i=t[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lr(e.appDir,ht),s={};if(St(o))try{s=(e.cache?.read(o,u=>JSON.parse(u))??JSON.parse(wt(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,u]of Object.entries(i)){if(!u||typeof u!="object"||Array.isArray(u))continue;let f=u,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),b=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=b??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),x={type:R,...b!==void 0?{datasetId:b}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=x}return Object.keys(d).length>0?d:null}function dr(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function It(e){return dr(e.id).startsWith("provider-")||dr(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(r=>!It(r)).filter(r=>n.includeHidden===!0||r.descriptor.hidden!==!0).map(r=>({id:r.id,name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{}})).sort((r,i)=>r.id.localeCompare(i.id))}}function an(e,n){let t=e.walk.modules.find(b=>b.id===n);if(!t)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let r=B(e.walk,t),i=new Set((t.descriptor.declare.consumes??[]).map(b=>b.service)),o=(b,g)=>{let C=Y(e.walk,b);return{service:b,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(t.descriptor.declare.consumes??[]).map(b=>o(b.service,b.optional===!1)),...[...new Set(r.ownedServices)].filter(b=>!i.has(b)).map(b=>o(b,!1))],d=e.integrations?.modules??{},S=d[n],u=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{},...typeof S.credentialRef=="string"?{credentialRef:S.credentialRef}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:r.ownedServices,integration:u,resources:Rt(e,n,d),binding:R,configEditable:r.writable,services:s}}function cn(e){let n=cr(e.walk),t=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=Y(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),r=e.integrations,i=null;if(r){let o={};for(let s of te)s in r&&(o[s]=r[s]);i=o}return{services:t,integration:i,binding:on(r)}}function dn(e,n){let t=e.integrations?.services??{},r=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(t),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=t[n]??null,o=Y(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:r?!r.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as fr,readFileSync as gr,realpathSync as ur}from"fs";import{isAbsolute as kt,join as bt,relative as At,resolve as pr,sep as Ct}from"path";function Et(e,n,t){let r=new Set(H(e.catalog,n));if(t.kind==="app")return!1;if(t.kind==="service")return r.has(t.service);let i=e.walk.modules.find(s=>s.id===t.module);if(!i)throw new E("MODULE_NOT_FOUND",404,`模块 ${t.module} 非已装模块`);return B(e.walk,i).ownedServices.some(s=>r.has(s))}function ln(e,n){if(n?.kind==="module"&&!e.walk.modules.some(r=>r.id===n.module))throw new E("MODULE_NOT_FOUND",404,`模块 ${n.module} 非已装模块`);let t=[];for(let[r,i]of Object.entries(e.catalog.providers)){let o=Object.values(i),s=e.catalog.vendorMeta[r];o.length===0&&!s||n&&s?.selectionScope==="supplied-services"&&!Et(e,r,n)||t.push({provider:r,local:o.length>0&&o.every(d=>d.local===!0),...s?.name?{name:s.name}:o[0]?.name?{name:o[0].name}:{}})}return{providers:t.sort((r,i)=>r.provider.localeCompare(i.provider))}}function un(e,n,t){let r=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(r)for(let u of Object.values(r))u.services.includes(t)&&o.push({implementation:u.implementation,credentialType:u.credentialType});let s=i[t]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw r?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${t}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[t]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=oe(e,n,t,d?s?.configSchema:void 0);return{provider:n,service:t,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function oe(e,n,t,r){let i=e.walk.serviceSchemas[`${n}\0${t}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof r=="string"?Ot(e.appDir,r):null}function pn(e,n,t){if(!t)return null;let r=bt(n,t);if(!fr(r))return null;try{return JSON.parse(gr(r,"utf8"))}catch{return null}}function Ot(e,n){let t=pr(e,"config","schemas"),r=pr(e,n),i=At(t,r);if(i===""||i.startsWith("..")||kt(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!fr(r))return null;let o,s;try{o=ur(t),s=ur(r)}catch{return null}if(s!==o&&!s.startsWith(o+Ct))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gr(r,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mr(e,n,t){let r=e.integrations,i=r?.services?.[n],o=i?.instances?.[t]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&L(e.integrations,s).layer==="module"?"module":typeof r?.provider=="string"&&r.provider.length>0?"app":null}function vr(e,n,t,r,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},t,r,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mr(e,t,r)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yr(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,t){let r=yr(n),{integrations:i,catalog:o}=n,s=t?.supplies??r.buildSupplyLookup(o),d=i,u=r.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=t?.evaluation??vr(n,r,e,u,s),R=mr(n,e,u),b=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof b=="string"?b:typeof b=="object"&&b?String(b.provider):void 0),C={provider:g??null,layer:R??null},x=new Set(Object.keys(n.catalog.providers)),O=g!==void 0&&x.has(g)?xt(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,v=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...O!==void 0?{supplied:O}:{},...v!==void 0?{module:v}:{},...a!==void 0?{required:a}:{}}}function xt(e,n,t){return De(e,n,t)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),t=e.integrations?.services??{};for(let r of Object.keys(t))n.add(r);return[...n].sort()}function ve(e,n,t){let r={};for(let i of me(e))t&&!t.includes(i)||(r[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:r,issues:n}}function gn(e,n,t){let r=yr(n),i=r.buildSupplyLookup(n.catalog),o=n.integrations,s=r.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(O=>O.id),S=n.integrations?.services?.[e],u=S?.instances?Object.keys(S.instances):void 0,f=Sr(u,d),R=new Map;for(let O of f)R.set(O,vr(n,r,e,O,i));let b=f.map(O=>{let p=R.get(O);return{instanceId:O,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wr(n,e,s.defaultInstanceId??"*"),x={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:b,inheritance:g};return{contracts:_e(n.contracts),resolution:x,issues:t.filter(O=>O.service===e)}}function Sr(e,n){if(n.length>0){let t=[...n];return e?.includes("*")&&t.push("*"),t}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function wr(e,n,t){let r=e.integrations,i=r?.services?.[n],o=i?.instances?.[t]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?L(r,s):{provider:null,layer:null};return[{layer:"app",...r?.provider?{provider:r.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function hr(e,n,t){let r=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:t,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...r!==void 0?{required:!r.optional}:{}}}function Fe(e,n,t){let r=U(n),i={};for(let o of me(e))t&&!t.includes(o)||(i[o]=hr(e,o,r));return{contracts:_e(n),resolutions:i,issues:[]}}function Rr(e,n,t){let r=U(t),i={...hr(n,e,r),instances:Mt(n,e),inheritance:wr(n,e,jt(n))};return{contracts:_e(t),resolution:i,issues:[]}}function Mt(e,n){let t=e.integrations?.services?.[n],r=e.integrations,i=Array.isArray(r?.instances)?r.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=t?.instances?Object.keys(t.instances):void 0;return Sr(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function jt(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,t){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let r;if(t.kind==="app")r=me(e);else if(t.kind==="module"){let o=e.walk.modules.find(s=>s.id===t.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${t.module} 非已装模块`);r=B(e.walk,o).ownedServices}else r=[t.service];let i=new Set(H(e.catalog,n));return{provider:n,scope:t,services:r.map(o=>({service:o,name:Y(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,t){if(n===null)return null;let r={};for(let i of t)r[i]={configSchema:oe(e,n,i)};return{provider:n,services:r}}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(t=>`${JSON.stringify(t)}:${se(e[t])}`).join(",")}}`}var Nt="\0no-enum";function Tt(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(se))].sort().join(",")}]`:Nt}function Pt(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:se(n)}function Vt(e){let n=e.map(r=>Pt(r.subschema));if(n.some(r=>r===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let r=se(e[0].subschema);return e.every(i=>se(i.subschema)===r)?e[0].subschema:null}return new Set(e.map(r=>Tt(r.subschema))).size===1?e[0].subschema:null}function $e(e){let n=[],t=!0,r=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(t=!1);let u=S.properties;if(!u||typeof u!="object"||Array.isArray(u))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(u)){let b=r.get(R)??[];b.push({service:o,subschema:u[R],required:f.includes(R)}),r.set(R,b)}}let i=[];for(let[o,s]of r)i.push({key:o,schema:Vt(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:t,fields:i}}function yn(e,n,t){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let r=n.walk.modules.find(o=>o.id===t);return!r||!B(n.walk,r).writable?null:L(n.integrations,r.id).provider}var Ir={integrationSchemas:null,integrationFieldRegistry:null};function kr(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return Ir;let t=vn(e,n,H(e.catalog,n));return{integrationSchemas:t,integrationFieldRegistry:kr($e(t))}}function wn(e,n){let t=yn("module",e,n),r=e.walk.modules.find(s=>s.id===n);if(t===null||!r)return Ir;let i=(r.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,t,i.filter(s=>De(e.catalog,t,s)));return{integrationSchemas:o,integrationFieldRegistry:kr($e(o))}}function Dt(e){return Sn(e).integrationSchemas}function _t(e,n){return wn(e,n).integrationSchemas}function Ft(e,n){let t=e.walk.ownership[n];if(t!==void 0)return L(e.integrations,t).provider;let r=e.integrations?.provider;return typeof r=="string"&&r.length>0?r:null}function Le(e,n){let t=e.integrations?.services?.[n]?.provider;if(t===void 0||t===""){let r=Ft(e,n);return r===null?null:{provider:r,configSchema:oe(e,r,n)}}if(typeof t=="string")return{provider:t,configSchema:oe(e,t,n)};if(z(t)){let r=t;return{provider:r.provider,configSchema:oe(e,r.provider,n,r.configSchema)}}return null}function hn(e,n){let t=Le(e,n);if(t===null)return null;let r={provider:t.provider,services:{[n]:{configSchema:t.configSchema}}};return $e(r)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let t=n.slice(9),r=de(e,t);if(r)return{type:r.type,ref:n,masked:we(r.values)}}function Rn(e){let n=e.integrations,t={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&&(t.byInstance[i]=Se(e.appDir,o)??null)}let r={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;r[i]=s}return{app:t,services:r}}function In(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(r=>r.credentialType))]).sort().map(r=>{let i=e.catalog.credentialTypes[r];return{credentialType:r,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import $t from"path";var Lt={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let t=Lt[e],r=[...new Set(n)].filter(i=>!t.includes(i));if(r.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${r.join("、")}(白名单:${t.join("、")})`,["include"]);return new Set(n)}function br(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"]);let t=e;if(n==="module"&&t.service!==void 0)throw new E("VALIDATION_FAILED",400,"scope=module 不得携带 service 伴随参数(组合互斥——参数与 scope 不匹配)",["scope"]);if(n==="service"&&t.module!==void 0)throw new E("VALIDATION_FAILED",400,"scope=service 不得携带 module 伴随参数(组合互斥——参数与 scope 不匹配)",["scope"]);if(n==="app"&&(t.module!==void 0||t.service!==void 0))throw new E("VALIDATION_FAILED",400,"scope=app 不接受 module/service 伴随参数",["scope"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Bt(e,n={}){let t=Be(),r=Promise.resolve(),i={appDir:e,cache:t};function o(p){if(ae(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,U(p))}function s(p){if(ae(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,U(p))}function d(p){return ar(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function u(){let p=await N(e),a=d(p),v=a.integrations;if(v===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},l=ue(e,a.walk,v,process.env);return ne({contracts:h,integrations:v,supplies:h.buildSupplyLookup(a.catalog),...l})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=r.then(p,p);return r=a.catch(()=>{}),a}let b={async loadModules(p){let a=await N(e);return sn(d(a),p)},async loadModule(p,a){let v=kn("module",a?.include),h=await N(e),l=d(h),m=Oe(l.walk,p),w=an(l,m.id);if(v.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await u().then(y=>ve(l,y,c)):Fe(l,h,c)}if(v.has("integrationSchemas")||v.has("integrationFieldRegistry")){let c=wn(l,m.id);v.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),v.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),v=await N(e),h=d(v),l=cn(h);if(a.has("serviceResolutions")&&(l.serviceResolutions=ye(v)?await u().then(m=>ve(h,m)):Fe(h,v)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let m=Sn(h);a.has("integrationSchemas")&&(l.integrationSchemas=m.integrationSchemas),a.has("integrationFieldRegistry")&&(l.integrationFieldRegistry=m.integrationFieldRegistry)}return l},async loadService(p,a){let v=kn("service",a?.include),h=await N(e),l=d(h),m=Z(l.walk,S(l),p),w=dn(l,m);return v.has("integrationSchemas")&&(w.integrationSchemas=Le(l,m)),v.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(l,m)),w},async loadServiceResolutions(p){let a=await N(e),v=d(a);if(!ye(a))return Fe(v,a,p);let h=await u();return ve(v,h,p)},async loadServiceResolution(p){let a=await N(e),v=d(a),h=Z(v.walk,S(v),p);if(!ye(a))return Rr(h,v,a);let l=await u();return gn(h,v,l)},async loadProviders(p){let a=await N(e);return p?.scope!==void 0&&br(p.scope),ln(d(a),p?.scope)},async loadProviderSupply(p,a){br(a);let v=await N(e);return mn(d(v),p,a)},async loadProviderService(p,a){let v=await N(e),h=d(v),l=Z(h.walk,S(h),a);return un(h,p,l)},async loadCredentials(){let p=await N(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await N(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:t}),C={async writeAppIntegration(p,a){await g.warmup();let v=await N(e);return o(v),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,v){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=Oe(d(h).walk,p);return g.applyModule(l.id,a,v)})},async writeServiceIntegration(p,a,v){await g.warmup();let h=await N(e);return o(h),R(()=>{let l=d(h),m=Z(l.walk,S(l),p);return g.applyService(m,a,v)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return o(a),R(()=>{let v=d(a),h=Z(v.walk,S(v),p);return g.deleteService(h)})}},x={invalidate(){t.invalidate(),We(e)},async resolveContracts(){return N(e)},walkManifests(){return O(e)},parseModuleDescriptor(p){return ce(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return J(e,t)},async writeIntegrationsConfig(p){return R(()=>Wt(e,p,t))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let v={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 ne({...p,contracts:v})}};function O(p){return D(p,t)}return{...b,...C,...x}}function Wt(e,n,t){let r=$t.join(e,"config","integrations.json");$(r,`${JSON.stringify(n,null,2)}
|
|
9
|
+
`),t.invalidate([r])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,G as SAFE_NAME_PATTERN,on as appProviderBinding,zr as assertValidModuleId,$e as buildIntegrationFieldRegistry,Zr as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Hr as collectDeclaredModules,U as contractsNotResolvedMessage,Bt as createAppToolkit,Be as createFileCache,en as createWriteCore,ot as credentialArtifactExists,fe as deepEqual,X as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ne as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,z as isControlledInlineProvider,$n as isValidModuleId,Dt as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,_t as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,B as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ce as parseModuleDescriptor,H as providerFootprint,En as providerSlotContribSchema,dt as pruneIntegrationBindings,Fn as readAppManifest,ze as readAppManifestFull,de as readCredentialFile,J as readIntegrationsConfig,Yn as readIntegrationsStrict,re as reconcileOrphanCredentials,Gn as refToEnvKey,Wr as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,L as resolveModuleBinding,Oe as resolveModuleKey,Z as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,K as stemToFilePath,Nr as stemToRef,An as tabContribSchema,Kr as updateNpmModule,Ur as upsertMiniappContainer,Br as upsertNpmModule,D as walkManifests,Lr as writeAppManifest,$ as writeAtomic,Ke as writeCredentialFile};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tbox.cn/app-toolkit",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.7",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "tbox 应用工具面(运行面/工具面对仗:app-sdk 给运行的应用用,app-toolkit 给操作应用的工具用)——模块解析、集成配置求值/校验/写入内核,contracts 经应用侧动态解析(沙箱与目标应用版本解耦)。",
|
|
6
6
|
"exports": {
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"zod": "3.25.76"
|
|
19
19
|
},
|
|
20
20
|
"devDependencies": {
|
|
21
|
-
"@tbox.cn/app-contracts": "0.13.
|
|
21
|
+
"@tbox.cn/app-contracts": "0.13.5",
|
|
22
22
|
"typescript": "5.9.3",
|
|
23
23
|
"tsup": "8.5.1",
|
|
24
24
|
"vitest": "4.1.10",
|
|
@@ -135,13 +135,16 @@ export interface WalkCatalog {
|
|
|
135
135
|
>;
|
|
136
136
|
credentialTypes: Record<string, { owner: string; packageDir: string; credentialSchema?: string }>;
|
|
137
137
|
/** 厂商展示元数据单源(v8——全厂商统一,slots 厂商 + `declare.providers.id` 零槽自声明同路径;
|
|
138
|
-
* 首声明胜出与 owner 同语义。U6 守卫:自声明包声明外来厂商槽 → 供给照常贡献、meta 不附着)。
|
|
139
|
-
|
|
138
|
+
* 首声明胜出与 owner 同语义。U6 守卫:自声明包声明外来厂商槽 → 供给照常贡献、meta 不附着)。
|
|
139
|
+
* selectionScope(任务12 可选协议):仅 'supplied-services' 受限时在场('all'/缺席同义恒
|
|
140
|
+
* 完整清单)——来源恒为厂商**自声明**(declare.providers 顶层字段,与 id 同块);槽贡献
|
|
141
|
+
* 不携带(防外来厂商策略附着),首有效声明胜出(??=)。 */
|
|
142
|
+
vendorMeta: Record<string, { owner: string; name?: string; description?: string; selectionScope?: 'supplied-services' }>;
|
|
140
143
|
}
|
|
141
144
|
|
|
142
145
|
/** loose 允许的 declare 局部结构(本地声明——解跨模块类型身份耦合,TS2719 防线) */
|
|
143
|
-
|
|
144
|
-
providers?: { id?: string; slots?: ProviderSlotContrib[] };
|
|
146
|
+
type LooseDeclare = {
|
|
147
|
+
providers?: { id?: string; selectionScope?: 'all' | 'supplied-services'; slots?: ProviderSlotContrib[] };
|
|
145
148
|
consumes?: Array<{
|
|
146
149
|
service: string;
|
|
147
150
|
optional?: boolean;
|
|
@@ -378,14 +381,26 @@ export function walkManifests(appDir: string, cache?: FileCache): WalkManifestsR
|
|
|
378
381
|
};
|
|
379
382
|
|
|
380
383
|
/** v8 零槽自声明:`declare.providers.id` 厂商入 catalog(空 impl map——供给判定
|
|
381
|
-
* 「厂商在、供给空」语义,绑定 → binding-unresolved 待实施 ⚠)+ vendorMeta 首声明登记。
|
|
382
|
-
|
|
384
|
+
* 「厂商在、供给空」语义,绑定 → binding-unresolved 待实施 ⚠)+ vendorMeta 首声明登记。
|
|
385
|
+
* selectionScope(任务12):**范围随厂商首声明一并确定——缺省 all 也是有效声明**
|
|
386
|
+
* (首包未写/写 all → 恒完整清单语义,后包 supplied-services 不得补入锁定;首包
|
|
387
|
+
* restricted → 后包 all 亦不覆盖——两方向后声明均无效)。仅 'supplied-
|
|
388
|
+
* services' 受限值落 meta;槽贡献永不携带(U6 同源隔离);slots 首建的 vendorMeta
|
|
389
|
+
* 对后到自声明同样构成首声明(visible 轴不因通道不同而重开)。 */
|
|
390
|
+
const ensureSelfVendor = (
|
|
391
|
+
id: string,
|
|
392
|
+
owner: string,
|
|
393
|
+
modMeta?: SlotMeta,
|
|
394
|
+
selectionScope?: 'all' | 'supplied-services',
|
|
395
|
+
): void => {
|
|
383
396
|
catalog.providers[id] ??= {};
|
|
384
|
-
catalog.vendorMeta[id]
|
|
397
|
+
const existed = catalog.vendorMeta[id] !== undefined; // 首声明(含 slots 通道先建)
|
|
398
|
+
const meta = (catalog.vendorMeta[id] ??= {
|
|
385
399
|
owner,
|
|
386
400
|
...(modMeta?.name ? { name: modMeta.name } : {}),
|
|
387
401
|
...(modMeta?.description ? { description: modMeta.description } : {}),
|
|
388
|
-
};
|
|
402
|
+
});
|
|
403
|
+
if (!existed && selectionScope === 'supplied-services') meta.selectionScope = 'supplied-services';
|
|
389
404
|
};
|
|
390
405
|
|
|
391
406
|
/** 厂商展示元数据(strict manifest descriptor 透传——loose 形态无 descriptor → undefined) */
|
|
@@ -480,7 +495,7 @@ export function walkManifests(appDir: string, cache?: FileCache): WalkManifestsR
|
|
|
480
495
|
}
|
|
481
496
|
const slots = declare?.providers?.slots ?? [];
|
|
482
497
|
const selfId = declare?.providers?.id;
|
|
483
|
-
if (selfId) ensureSelfVendor(selfId, entry.package, modMetaOf(manifest));
|
|
498
|
+
if (selfId) ensureSelfVendor(selfId, entry.package, modMetaOf(manifest), declare?.providers?.selectionScope);
|
|
484
499
|
if (slots.length) addSlots(slots, entry.package, dir, modMetaOf(manifest), selfId);
|
|
485
500
|
const consumes = declare?.consumes ?? [];
|
|
486
501
|
for (const need of consumes) addServiceConsume(need, entry.package);
|
|
@@ -503,7 +518,7 @@ export function walkManifests(appDir: string, cache?: FileCache): WalkManifestsR
|
|
|
503
518
|
const declare = declareOf(manifest);
|
|
504
519
|
const slots = declare?.providers?.slots ?? [];
|
|
505
520
|
const selfId = declare?.providers?.id;
|
|
506
|
-
if (selfId) ensureSelfVendor(selfId, pkg, modMetaOf(manifest));
|
|
521
|
+
if (selfId) ensureSelfVendor(selfId, pkg, modMetaOf(manifest), declare?.providers?.selectionScope);
|
|
507
522
|
if (slots.length) addSlots(slots, pkg, dir, modMetaOf(manifest), selfId);
|
|
508
523
|
const consumes = declare?.consumes ?? [];
|
|
509
524
|
for (const need of consumes) addServiceConsume(need, pkg);
|
|
@@ -539,7 +554,7 @@ export function walkManifests(appDir: string, cache?: FileCache): WalkManifestsR
|
|
|
539
554
|
}
|
|
540
555
|
const slots = declare?.providers?.slots ?? [];
|
|
541
556
|
const selfId = declare?.providers?.id;
|
|
542
|
-
if (selfId) ensureSelfVendor(selfId, `@app/${modId}`, modMetaOf(manifest));
|
|
557
|
+
if (selfId) ensureSelfVendor(selfId, `@app/${modId}`, modMetaOf(manifest), declare?.providers?.selectionScope);
|
|
543
558
|
if (slots.length) addSlots(slots, `@app/${modId}`, dir, modMetaOf(manifest), selfId);
|
|
544
559
|
const consumes = declare?.consumes ?? [];
|
|
545
560
|
for (const need of consumes) addServiceConsume(need, `@app/${modId}`);
|
|
@@ -139,6 +139,12 @@ export const moduleDescriptorSchema = z
|
|
|
139
139
|
.string()
|
|
140
140
|
.regex(SAFE_NAME_PATTERN, 'provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)')
|
|
141
141
|
.optional(),
|
|
142
|
+
/** 厂商候选范围策略自声明(任务12 可选协议):缺席/='all' ——候选清单恒完整(
|
|
143
|
+
* 缺省语义由消费端解释——walk/vendorMeta 仅显式 'supplied-services' 生效);
|
|
144
|
+
* 'supplied-services' = 厂商仅在供给足迹与请求范围相交时进入限定候选清单。
|
|
145
|
+
* 策略只随**自声明厂商**(id === 本包厂商)进 vendorMeta——槽贡献
|
|
146
|
+
* (slot.provider 为外来厂商)不附着(U6 同源隔离,「跨厂商不得携带策略」)。 */
|
|
147
|
+
selectionScope: z.enum(['all', 'supplied-services']).optional(),
|
|
142
148
|
slots: z.array(providerSlotContribSchema).default([]),
|
|
143
149
|
})
|
|
144
150
|
.default({}),
|
package/src/factory.ts
CHANGED
|
@@ -115,6 +115,16 @@ function assertSupplyScope(scope: ProviderSupplyScope): void {
|
|
|
115
115
|
if (kind === 'module' && (typeof (scope as { module?: unknown }).module !== 'string' || (scope as { module: string }).module.length === 0)) {
|
|
116
116
|
throw new AppToolkitError('VALIDATION_FAILED', 400, 'scope=module 需携带非空 module 参数', ['module']);
|
|
117
117
|
}
|
|
118
|
+
const extra = (scope as { module?: unknown; service?: unknown });
|
|
119
|
+
if (kind === 'module' && extra.service !== undefined) {
|
|
120
|
+
throw new AppToolkitError('VALIDATION_FAILED', 400, 'scope=module 不得携带 service 伴随参数(组合互斥——参数与 scope 不匹配)', ['scope']);
|
|
121
|
+
}
|
|
122
|
+
if (kind === 'service' && extra.module !== undefined) {
|
|
123
|
+
throw new AppToolkitError('VALIDATION_FAILED', 400, 'scope=service 不得携带 module 伴随参数(组合互斥——参数与 scope 不匹配)', ['scope']);
|
|
124
|
+
}
|
|
125
|
+
if (kind === 'app' && (extra.module !== undefined || extra.service !== undefined)) {
|
|
126
|
+
throw new AppToolkitError('VALIDATION_FAILED', 400, 'scope=app 不接受 module/service 伴随参数', ['scope']);
|
|
127
|
+
}
|
|
118
128
|
if (kind === 'service' && (typeof (scope as { service?: unknown }).service !== 'string' || (scope as { service: string }).service.length === 0)) {
|
|
119
129
|
throw new AppToolkitError('VALIDATION_FAILED', 400, 'scope=service 需携带非空 service 参数', ['service']);
|
|
120
130
|
}
|
|
@@ -132,7 +142,13 @@ export interface AppToolkitRead {
|
|
|
132
142
|
loadService(service: string, o?: { include?: string[] }): Promise<ServiceDetail>;
|
|
133
143
|
loadServiceResolutions(services?: string[]): Promise<ServiceResolutionsView>;
|
|
134
144
|
loadServiceResolution(service: string): Promise<ServiceResolutionDetail>;
|
|
135
|
-
|
|
145
|
+
/** GET /providers(v8 完整清单;任务12 可选 scope 限定):缺省/`{}` = 完整在册清单
|
|
146
|
+
* (忽略候选范围策略——成员、字段和排序保持当前行为);`{scope}` = 限定候选清单
|
|
147
|
+
* (supplied-services 受限厂商按供给足迹与范围相交筛选;无策略厂商恒保留)。
|
|
148
|
+
* scope 显式请求参数(不从其他来源推断);错误矩阵沿 loadProviderSupply:
|
|
149
|
+
* 未知 kind/空值/伴随参数缺席 → 400 fields 指向出错参数;scope=module 未安装
|
|
150
|
+
* 模块 → 404 MODULE_NOT_FOUND(参数错误先于资源查询)。additive——原调用零变化。 */
|
|
151
|
+
loadProviders(o?: { scope?: ProviderSupplyScope }): Promise<ProvidersView>;
|
|
136
152
|
/** GET /providers/:p/supply?scope=…(v8——供给判定;切换预览唯一判定源,前端零关系计算)。
|
|
137
153
|
* scope 显式判别联合;provider ∉ catalog → 404;scope=module 未装 → 404;
|
|
138
154
|
* scope=service 任意 id 恒 200(判定非寻址)。 */
|
|
@@ -341,9 +357,10 @@ export function createAppToolkit(appDir: string, options: AppToolkitOptions = {}
|
|
|
341
357
|
const issues = await predicateIssues();
|
|
342
358
|
return loadServiceResolutionDetail(serviceId, snap, issues);
|
|
343
359
|
},
|
|
344
|
-
async loadProviders() {
|
|
360
|
+
async loadProviders(o?: { scope?: ProviderSupplyScope }) {
|
|
345
361
|
const contracts = await resolveContractsForApp(appDir);
|
|
346
|
-
|
|
362
|
+
if (o?.scope !== undefined) assertSupplyScope(o.scope);
|
|
363
|
+
return loadProvidersView(snapshot(contracts), o?.scope);
|
|
347
364
|
},
|
|
348
365
|
// v8 供给判定(静态零 contracts;scope 校验单点在本方法内——400 先于 404)
|
|
349
366
|
async loadProviderSupply(provider: string, scope: ProviderSupplyScope): Promise<ProviderSupplyView> {
|
package/src/views/providers.ts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import type { ProviderEntry, ProviderServiceDetail, ProvidersView } from '../dto.js';
|
|
1
|
+
import type { ProviderEntry, ProviderServiceDetail, ProviderSupplyScope, ProvidersView } from '../dto.js';
|
|
2
2
|
import { AppToolkitError } from '../core/errors.js';
|
|
3
3
|
import { existsSync, readFileSync, realpathSync } from 'node:fs';
|
|
4
4
|
import { isAbsolute, join, relative, resolve, sep } from 'node:path';
|
|
5
|
+
import { moduleOwnershipWritable, providerFootprint } from '../integrations/module-binding.js';
|
|
5
6
|
import type { ViewSnapshot } from './context.js';
|
|
6
7
|
|
|
7
8
|
/**
|
|
@@ -11,14 +12,39 @@ import type { ViewSnapshot } from './context.js';
|
|
|
11
12
|
* 静态端点零求值(铁律 #3)。
|
|
12
13
|
*/
|
|
13
14
|
|
|
15
|
+
/** 受限候选供应商可见性(selectionScope='supplied-services';任务12——协议 api.md
|
|
16
|
+
* 「可选的候选范围扩展」):scope 缺席恒可见(无参调用=完整清单本行为);
|
|
17
|
+
* app=排除;module=供给足迹 ∩ 模块 owns 服务非空;service=供给足迹命中该服务。
|
|
18
|
+
* service 判定过滤而非寻址——未知 service id 恒可查(未受限供应商恒保留)。 */
|
|
19
|
+
function restrictedProviderVisible(snapshot: ViewSnapshot, provider: string, scope: ProviderSupplyScope): boolean {
|
|
20
|
+
const footprint = new Set(providerFootprint(snapshot.catalog, provider));
|
|
21
|
+
if (scope.kind === 'app') return false;
|
|
22
|
+
if (scope.kind === 'service') return footprint.has(scope.service);
|
|
23
|
+
const mod = snapshot.walk.modules.find((m) => m.id === scope.module);
|
|
24
|
+
if (!mod) throw new AppToolkitError('MODULE_NOT_FOUND', 404, `模块 ${scope.module} 非已装模块`);
|
|
25
|
+
const owned = moduleOwnershipWritable(snapshot.walk, mod).ownedServices;
|
|
26
|
+
return owned.some((service) => footprint.has(service));
|
|
27
|
+
}
|
|
28
|
+
|
|
14
29
|
/** GET /providers:厂商基本信息(vendorMeta 单源——slots 厂商 + 零槽自声明厂商同路径;
|
|
15
|
-
* 零槽厂商 = 空 impl map + 自声明 meta(supply
|
|
16
|
-
|
|
30
|
+
* 零槽厂商 = 空 impl map + 自声明 meta(supply 判定「厂商在、供给空」语义)。
|
|
31
|
+
* scope(任务12 可选):限定候选清单——仅 supplied-services 受限厂商参与筛选;
|
|
32
|
+
* 无策略厂商恒保留;成员/字段/排序与完整清单同构(响应不新增必填字段,相对排序保持)。 */
|
|
33
|
+
export function loadProvidersView(snapshot: ViewSnapshot, scope?: ProviderSupplyScope): ProvidersView {
|
|
34
|
+
// module scope 模块存在性校验先于清单遍历(&先于任何筛选判定)——全 all/空清单时
|
|
35
|
+
// 未知模块同样 404(协议矩阵「scope=module 未装 → 404;参数错误先于资源查询」的
|
|
36
|
+
// 完整语义,不依赖受限供应商在场才走到校验——模块校验先于遍历独立成立)。
|
|
37
|
+
if (scope?.kind === 'module' && !snapshot.walk.modules.some((m) => m.id === scope.module)) {
|
|
38
|
+
throw new AppToolkitError('MODULE_NOT_FOUND', 404, `模块 ${scope.module} 非已装模块`);
|
|
39
|
+
}
|
|
17
40
|
const providers: ProviderEntry[] = [];
|
|
18
41
|
for (const [provider, impls] of Object.entries(snapshot.catalog.providers)) {
|
|
19
42
|
const entries = Object.values(impls);
|
|
20
43
|
const meta = snapshot.catalog.vendorMeta[provider];
|
|
21
44
|
if (entries.length === 0 && !meta) continue;
|
|
45
|
+
if (scope && meta?.selectionScope === 'supplied-services' && !restrictedProviderVisible(snapshot, provider, scope)) {
|
|
46
|
+
continue;
|
|
47
|
+
}
|
|
22
48
|
providers.push({
|
|
23
49
|
provider,
|
|
24
50
|
// 零槽厂商(空 entries)非 local(local 旗标语义 = 供给实现级聚合——空集无实现可聚合)
|
|
@@ -0,0 +1,363 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { mkdirSync } from 'node:fs';
|
|
4
|
+
import { createAppToolkit, type AppToolkit } from '../src/factory.js';
|
|
5
|
+
import { invalidateContractsResolver } from '../src/core/contracts-resolver.js';
|
|
6
|
+
import { AppToolkitError } from '../src/core/errors.js';
|
|
7
|
+
import { walkManifests } from '../src/assembly/walk-manifests.js';
|
|
8
|
+
import {
|
|
9
|
+
createTempApp,
|
|
10
|
+
writeFakeContractsPackage,
|
|
11
|
+
linkContracts,
|
|
12
|
+
writeAppFile,
|
|
13
|
+
CASCADE_RESOLVE_BODY,
|
|
14
|
+
SUPPLY_AGGREGATE_BODY,
|
|
15
|
+
type TempApp,
|
|
16
|
+
} from './demo-app.js';
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* 任务12 B 面测试:selectionScope(可选候选范围协议)。
|
|
20
|
+
* ① 声明 → manifest parser(zod 接受/拒绝)→ walk vendorMeta(仅自声明通道;槽贡献
|
|
21
|
+
* 不附着;首有效声明胜出)→ loadProvidersView 筛选。
|
|
22
|
+
* ② loadProviders() 无参/缺省 = 完整清单(成员/字段/顺序零变化——T12-05)。
|
|
23
|
+
* ③ scope 三模式矩阵:app=排除受限厂商;module=供给足迹 ∩ owns;service=供给命中
|
|
24
|
+
* (任意 id 可查,未受限恒留——T12-06/07)。
|
|
25
|
+
* ④ 错误矩阵:未知 kind/伴随参数不匹配 400 fields;module 未安装 404(参数错误先于
|
|
26
|
+
* 404——T12-08);additive 旧调用零变化。
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
interface Harness {
|
|
30
|
+
app: TempApp;
|
|
31
|
+
tk: AppToolkit;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* scope 基座:词汇 3 服务(parking.query/parking.payment/member.account)+
|
|
36
|
+
* - provider-limited: 自声明 'limited' + selectionScope: 'supplied-services'(供给 parking.query)
|
|
37
|
+
* - provider-free: 自声明 'free'(无策略——slots 供 parking.query/parking.payment)
|
|
38
|
+
* - provider-allspec: 自声明 'allspec' + 显式 selectionScope: 'all'(供给 parking.vehicle 词汇外——
|
|
39
|
+
* 显式 all 恒完整清单语义)
|
|
40
|
+
* - provider-zero-restricted: 零槽自声明 'zerolim' + supplied-services(「厂商在、供给空」)
|
|
41
|
+
* - provider-foreign: 自声明 'vendora' + supplied-services + slots 全部贡献给外来厂商
|
|
42
|
+
* 'vendorb'(U6:供给照常、meta/策略不附着——vendorb 恒不受 vendora 策略污染)
|
|
43
|
+
* - module-parking(owns query+payment)/ module-member(owns member.account——跨域负例)
|
|
44
|
+
*/
|
|
45
|
+
function scopeHarness(): Harness {
|
|
46
|
+
const app = createTempApp('tbox-t12-scope-');
|
|
47
|
+
invalidateContractsResolver();
|
|
48
|
+
const store = join(app.appDir, 'contracts');
|
|
49
|
+
writeFakeContractsPackage(store, {
|
|
50
|
+
version: '0.9.0',
|
|
51
|
+
resolveBody: CASCADE_RESOLVE_BODY,
|
|
52
|
+
supplyBody: SUPPLY_AGGREGATE_BODY,
|
|
53
|
+
slots: ['parking.query', 'parking.payment', 'parking.vehicle', 'member.account'],
|
|
54
|
+
});
|
|
55
|
+
linkContracts(app.appDir, store, { subdir: 'apps/server' });
|
|
56
|
+
|
|
57
|
+
const manifest = (o: Record<string, unknown>): string =>
|
|
58
|
+
JSON.stringify({ schemaVersion: 1, version: '0.1.0', kind: 'business', dependencies: { modules: [] }, env: [], ...o });
|
|
59
|
+
|
|
60
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-limited'), { recursive: true });
|
|
61
|
+
writeAppFile(app.appDir, 'packages/provider-limited/tbox.module.json', manifest({
|
|
62
|
+
id: 'provider-limited',
|
|
63
|
+
declare: {
|
|
64
|
+
providers: {
|
|
65
|
+
id: 'limited',
|
|
66
|
+
selectionScope: 'supplied-services',
|
|
67
|
+
slots: [{ service: 'parking.query', provider: 'limited', implementation: 'limited-parking@1', credentialType: 'limited-c' }],
|
|
68
|
+
},
|
|
69
|
+
},
|
|
70
|
+
}));
|
|
71
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-free'), { recursive: true });
|
|
72
|
+
writeAppFile(app.appDir, 'packages/provider-free/tbox.module.json', manifest({
|
|
73
|
+
id: 'provider-free',
|
|
74
|
+
declare: {
|
|
75
|
+
providers: {
|
|
76
|
+
id: 'free',
|
|
77
|
+
slots: [
|
|
78
|
+
{ service: 'parking.query', provider: 'free', implementation: 'free-query@1', credentialType: 'free-c' },
|
|
79
|
+
{ service: 'parking.payment', provider: 'free', implementation: 'free-pay@1', credentialType: 'free-c' },
|
|
80
|
+
],
|
|
81
|
+
},
|
|
82
|
+
},
|
|
83
|
+
}));
|
|
84
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-allspec'), { recursive: true });
|
|
85
|
+
writeAppFile(app.appDir, 'packages/provider-allspec/tbox.module.json', manifest({
|
|
86
|
+
id: 'provider-allspec',
|
|
87
|
+
declare: {
|
|
88
|
+
providers: {
|
|
89
|
+
id: 'allspec',
|
|
90
|
+
selectionScope: 'all',
|
|
91
|
+
slots: [{ service: 'parking.vehicle', provider: 'allspec', implementation: 'allspec-vehicle@1', credentialType: 'allspec-c' }],
|
|
92
|
+
},
|
|
93
|
+
},
|
|
94
|
+
}));
|
|
95
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-zero-restricted'), { recursive: true });
|
|
96
|
+
writeAppFile(app.appDir, 'packages/provider-zero-restricted/tbox.module.json', manifest({
|
|
97
|
+
id: 'provider-zero-restricted',
|
|
98
|
+
declare: { providers: { id: 'zerolim', selectionScope: 'supplied-services', slots: [] } },
|
|
99
|
+
}));
|
|
100
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-foreign'), { recursive: true });
|
|
101
|
+
writeAppFile(app.appDir, 'packages/provider-foreign/tbox.module.json', manifest({
|
|
102
|
+
id: 'provider-foreign',
|
|
103
|
+
declare: {
|
|
104
|
+
providers: {
|
|
105
|
+
id: 'vendora',
|
|
106
|
+
selectionScope: 'supplied-services',
|
|
107
|
+
slots: [{ service: 'member.account', provider: 'vendorb', implementation: 'vendorb-member@1', credentialType: 'vendorb-c' }],
|
|
108
|
+
},
|
|
109
|
+
},
|
|
110
|
+
}));
|
|
111
|
+
mkdirSync(join(app.appDir, 'packages', 'module-parking'), { recursive: true });
|
|
112
|
+
writeAppFile(app.appDir, 'packages/module-parking/tbox.module.json', manifest({
|
|
113
|
+
id: 'module-parking',
|
|
114
|
+
declare: {
|
|
115
|
+
owns: [{ service: 'parking.query' }, { service: 'parking.payment' }],
|
|
116
|
+
consumes: [{ service: 'parking.query', optional: false }],
|
|
117
|
+
},
|
|
118
|
+
}));
|
|
119
|
+
mkdirSync(join(app.appDir, 'packages', 'module-member'), { recursive: true });
|
|
120
|
+
writeAppFile(app.appDir, 'packages/module-member/tbox.module.json', manifest({
|
|
121
|
+
id: 'module-member',
|
|
122
|
+
declare: { owns: [{ service: 'member.account' }] },
|
|
123
|
+
}));
|
|
124
|
+
writeAppFile(app.appDir, 'config/integrations.json', JSON.stringify({ provider: 'mock', services: {} }));
|
|
125
|
+
return { app, tk: createAppToolkit(app.appDir) };
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
describe('任务12 B:selectionScope 声明与 walk 传递', () => {
|
|
129
|
+
it('manifest → vendorMeta:仅自声明厂商受限在场;槽贡献(外来厂商)不附着策略', () => {
|
|
130
|
+
const { app } = scopeHarness();
|
|
131
|
+
const walk = walkManifests(app.appDir);
|
|
132
|
+
expect(walk.catalog.vendorMeta.limited?.selectionScope).toBe('supplied-services');
|
|
133
|
+
expect(walk.catalog.vendorMeta.free?.selectionScope).toBeUndefined();
|
|
134
|
+
expect(walk.catalog.vendorMeta.allspec?.selectionScope).toBeUndefined(); // 显式 all ≡ 缺省——不进 meta
|
|
135
|
+
expect(walk.catalog.vendorMeta.zerolim?.selectionScope).toBe('supplied-services'); // 零槽自声明同路径
|
|
136
|
+
// U6:vendora 的 supplied-services 策略不附着到 vendorb(贡献槽厂商)
|
|
137
|
+
expect(walk.catalog.vendorMeta.vendora?.selectionScope).toBe('supplied-services');
|
|
138
|
+
expect(walk.catalog.vendorMeta.vendorb?.selectionScope).toBeUndefined();
|
|
139
|
+
// vendorb 供给照常贡献(U6——供给/impl/credentialType 不受策略隔离)
|
|
140
|
+
expect(walk.catalog.providers.vendorb?.['vendorb-member@1']?.services).toEqual(['member.account']);
|
|
141
|
+
});
|
|
142
|
+
|
|
143
|
+
it('satisfied zod:selectionScope 缺席/合法值通过;非法值被 parser 拒(非解析期静默剥掉)', () => {
|
|
144
|
+
const { app } = scopeHarness();
|
|
145
|
+
const valid = walkManifests(app.appDir);
|
|
146
|
+
expect(valid.modules.map((m) => m.id)).toContain('provider-limited');
|
|
147
|
+
// 非法值: manifest 解析失败 → 不进 modules+不落 catalog(宽松/legacy 通道不兜底新键)
|
|
148
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-bad'), { recursive: true });
|
|
149
|
+
writeAppFile(app.appDir, 'packages/provider-bad/tbox.module.json', JSON.stringify({
|
|
150
|
+
schemaVersion: 1, id: 'provider-bad', version: '0.1.0', kind: 'business',
|
|
151
|
+
declare: { providers: { id: 'badspec', selectionScope: 'maybe', slots: [] } },
|
|
152
|
+
dependencies: { modules: [] }, env: [],
|
|
153
|
+
}));
|
|
154
|
+
const after = walkManifests(app.appDir);
|
|
155
|
+
expect(after.modules.map((m) => m.id)).not.toContain('provider-bad');
|
|
156
|
+
expect(after.catalog.vendorMeta.badspec?.selectionScope).toBeUndefined();
|
|
157
|
+
});
|
|
158
|
+
|
|
159
|
+
it('范围随首声明一并确定:首包缺省/显式 all 也是有效声明——后包 supplied-services 不得补入(P2②返修)', () => {
|
|
160
|
+
const { app } = scopeHarness();
|
|
161
|
+
// 首包 aa-first 自声明 limited-all(缺省) + slots 供给 parking.query;后包 zz-second 同厂商 restricted
|
|
162
|
+
mkdirSync(join(app.appDir, 'packages', 'aa-first'), { recursive: true });
|
|
163
|
+
writeAppFile(app.appDir, 'packages/aa-first/tbox.module.json', JSON.stringify({
|
|
164
|
+
schemaVersion: 1, id: 'aa-first', version: '0.1.0', kind: 'business',
|
|
165
|
+
declare: { providers: { id: 'latervo', selectionScope: 'all', slots: [{ service: 'parking.query', provider: 'latervo', implementation: 'latervo-q@1', credentialType: 'latervo-c' }] } },
|
|
166
|
+
dependencies: { modules: [] }, env: [],
|
|
167
|
+
}));
|
|
168
|
+
mkdirSync(join(app.appDir, 'packages', 'zz-second'), { recursive: true });
|
|
169
|
+
writeAppFile(app.appDir, 'packages/zz-second/tbox.module.json', JSON.stringify({
|
|
170
|
+
schemaVersion: 1, id: 'zz-second', version: '0.1.0', kind: 'business',
|
|
171
|
+
declare: { providers: { id: 'latervo', selectionScope: 'supplied-services', slots: [] } },
|
|
172
|
+
dependencies: { modules: [] }, env: [],
|
|
173
|
+
}));
|
|
174
|
+
const walk = walkManifests(app.appDir);
|
|
175
|
+
expect(walk.catalog.vendorMeta.latervo?.selectionScope).toBeUndefined(); // 首声明 all 锁定——后声明 restricted 无效
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
it('首声明缺省(未写 selectionScope)同锁:后包 restricted 不得令厂商被隐藏(P2②返修另一向)', async () => {
|
|
179
|
+
const { app } = scopeHarness();
|
|
180
|
+
mkdirSync(join(app.appDir, 'packages', 'aa-first'), { recursive: true });
|
|
181
|
+
writeAppFile(app.appDir, 'packages/aa-first/tbox.module.json', JSON.stringify({
|
|
182
|
+
schemaVersion: 1, id: 'aa-first', version: '0.1.0', kind: 'business',
|
|
183
|
+
declare: { providers: { id: 'silentvo', slots: [{ service: 'parking.query', provider: 'silentvo', implementation: 'silentvo-q@1', credentialType: 'silentvo-c' }] } },
|
|
184
|
+
dependencies: { modules: [] }, env: [],
|
|
185
|
+
}));
|
|
186
|
+
mkdirSync(join(app.appDir, 'packages', 'zz-second'), { recursive: true });
|
|
187
|
+
writeAppFile(app.appDir, 'packages/zz-second/tbox.module.json', JSON.stringify({
|
|
188
|
+
schemaVersion: 1, id: 'zz-second', version: '0.1.0', kind: 'business',
|
|
189
|
+
declare: { providers: { id: 'silentvo', selectionScope: 'supplied-services', slots: [] } },
|
|
190
|
+
dependencies: { modules: [] }, env: [],
|
|
191
|
+
}));
|
|
192
|
+
const walk = walkManifests(app.appDir);
|
|
193
|
+
expect(walk.catalog.vendorMeta.silentvo?.selectionScope).toBeUndefined();
|
|
194
|
+
const view = await createAppToolkit(app.appDir).loadProviders({ scope: { kind: 'app' } });
|
|
195
|
+
expect(view.providers.map((p) => p.provider)).toContain('silentvo'); // 首声明缺省 all——后包不得隐藏
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
it('首有效声明胜出:先自声明 supplied-services 的包建立策略,后包 all 不覆盖', () => {
|
|
199
|
+
const { app } = scopeHarness();
|
|
200
|
+
// packages 发现序 = 目录序;provider-limited(lexically first)已写 supplied-services
|
|
201
|
+
mkdirSync(join(app.appDir, 'packages', 'zz-second'), { recursive: true });
|
|
202
|
+
writeAppFile(app.appDir, 'packages/zz-second/tbox.module.json', JSON.stringify({
|
|
203
|
+
schemaVersion: 1, id: 'zz-second', version: '0.1.0', kind: 'business',
|
|
204
|
+
declare: { providers: { id: 'limited', selectionScope: 'all', slots: [] } },
|
|
205
|
+
dependencies: { modules: [] }, env: [],
|
|
206
|
+
}));
|
|
207
|
+
const walk = walkManifests(app.appDir);
|
|
208
|
+
expect(walk.catalog.vendorMeta.limited?.selectionScope).toBe('supplied-services');
|
|
209
|
+
});
|
|
210
|
+
});
|
|
211
|
+
|
|
212
|
+
describe('任务12 B:loadProviders 筛选矩阵(T12-05/06/07)', () => {
|
|
213
|
+
it('无参/缺省:完整清单——成员、字段、顺序与协议保持(受限厂商仍在完整元数据清单)', async () => {
|
|
214
|
+
const { tk } = scopeHarness();
|
|
215
|
+
const none = await tk.loadProviders();
|
|
216
|
+
const empty = await tk.loadProviders({});
|
|
217
|
+
expect(empty).toEqual(none);
|
|
218
|
+
expect(none.providers.map((p) => p.provider)).toEqual(
|
|
219
|
+
['allspec', 'free', 'limited', 'vendora', 'vendorb', 'zerolim'].sort((a, b) => a.localeCompare(b)),
|
|
220
|
+
);
|
|
221
|
+
for (const p of none.providers) {
|
|
222
|
+
expect(Object.keys(p).filter((k) => k !== 'name').sort()).toEqual(['local', 'provider']); // 不新增必填字段
|
|
223
|
+
}
|
|
224
|
+
});
|
|
225
|
+
|
|
226
|
+
it('scope=app:受限厂商(limited/zerolim/vendora)排除;无策略 free 与显式 all allspec 保留', async () => {
|
|
227
|
+
const { tk } = scopeHarness();
|
|
228
|
+
const view = await tk.loadProviders({ scope: { kind: 'app' } });
|
|
229
|
+
const names = view.providers.map((p) => p.provider);
|
|
230
|
+
expect(names).toContain('free');
|
|
231
|
+
expect(names).toContain('allspec');
|
|
232
|
+
expect(names).not.toContain('limited');
|
|
233
|
+
expect(names).not.toContain('zerolim');
|
|
234
|
+
expect(names).not.toContain('vendora');
|
|
235
|
+
expect(names).toContain('vendorb'); // 未受限厂商不受外来策略污染——恒可选
|
|
236
|
+
});
|
|
237
|
+
|
|
238
|
+
it('scope=module:模块 owns 服务 ∩ 供给足迹——module-parking 保留 limited;module-member 排除', async () => {
|
|
239
|
+
const { tk } = scopeHarness();
|
|
240
|
+
const parkingScope = await tk.loadProviders({ scope: { kind: 'module', module: 'module-parking' } });
|
|
241
|
+
expect(parkingScope.providers.map((p) => p.provider)).toContain('limited');
|
|
242
|
+
const memberScope = await tk.loadProviders({ scope: { kind: 'module', module: 'module-member' } });
|
|
243
|
+
expect(memberScope.providers.map((p) => p.provider)).not.toContain('limited');
|
|
244
|
+
expect(memberScope.providers.map((p) => p.provider)).toContain('free'); // 无策略恒留
|
|
245
|
+
expect(memberScope.providers.map((p) => p.provider)).not.toContain('zerolim'); // 零槽 restricted 不交集
|
|
246
|
+
});
|
|
247
|
+
|
|
248
|
+
it('scope=service:供给命中保留(limited×parking.query);不供给/未知 id 排除受限、保留未受限', async () => {
|
|
249
|
+
const { tk } = scopeHarness();
|
|
250
|
+
const q = await tk.loadProviders({ scope: { kind: 'service', service: 'parking.query' } });
|
|
251
|
+
expect(q.providers.map((p) => p.provider)).toContain('limited');
|
|
252
|
+
const v = await tk.loadProviders({ scope: { kind: 'service', service: 'parking.vehicle' } });
|
|
253
|
+
expect(v.providers.map((p) => p.provider)).not.toContain('limited');
|
|
254
|
+
expect(v.providers.map((p) => p.provider)).toContain('free'); // 判定过滤——未受限供应商恒保留
|
|
255
|
+
const unknown = await tk.loadProviders({ scope: { kind: 'service', service: 'auth.never-declared' } });
|
|
256
|
+
expect(unknown.providers.map((p) => p.provider)).not.toContain('limited'); // 未知 service 非寻址——受限不供给即排除
|
|
257
|
+
expect(unknown.providers.map((p) => p.provider)).toContain('free');
|
|
258
|
+
});
|
|
259
|
+
|
|
260
|
+
it('排序保持:任意 scope 下结果仍按 provider 字典序(完整清单同构)', async () => {
|
|
261
|
+
const { tk } = scopeHarness();
|
|
262
|
+
const scoped = await tk.loadProviders({ scope: { kind: 'app' } });
|
|
263
|
+
const sorted = [...scoped.providers].sort((a, b) => a.provider.localeCompare(b.provider));
|
|
264
|
+
expect(scoped.providers).toEqual(sorted);
|
|
265
|
+
});
|
|
266
|
+
});
|
|
267
|
+
|
|
268
|
+
describe('任务12 B:错误矩阵(T12-08——参数错误先于 404;additive 旧调用兼容)', () => {
|
|
269
|
+
it('未知/空 kind → 400 fields=[scope];module/service 伴随参数缺席 → 400 fields 对应', async () => {
|
|
270
|
+
const { tk } = scopeHarness();
|
|
271
|
+
await expect(tk.loadProviders({ scope: { kind: 'nope' } as never })).rejects.toMatchObject({
|
|
272
|
+
code: 'VALIDATION_FAILED', httpStatus: 400, fields: ['scope'],
|
|
273
|
+
});
|
|
274
|
+
await expect(tk.loadProviders({ scope: { kind: 'app', module: 'module-parking' } as never })).rejects.toMatchObject({
|
|
275
|
+
code: 'VALIDATION_FAILED', httpStatus: 400,
|
|
276
|
+
});
|
|
277
|
+
await expect(tk.loadProviders({ scope: { kind: 'module' } as never })).rejects.toMatchObject({
|
|
278
|
+
code: 'VALIDATION_FAILED', httpStatus: 400, fields: ['module'],
|
|
279
|
+
});
|
|
280
|
+
await expect(tk.loadProviders({ scope: { kind: 'service' } as never })).rejects.toMatchObject({
|
|
281
|
+
code: 'VALIDATION_FAILED', httpStatus: 400, fields: ['service'],
|
|
282
|
+
});
|
|
283
|
+
});
|
|
284
|
+
|
|
285
|
+
it('scope=module 指向未安装模块 → 404 MODULE_NOT_FOUND(参数合法后)', async () => {
|
|
286
|
+
const { tk } = scopeHarness();
|
|
287
|
+
await expect(tk.loadProviders({ scope: { kind: 'module', module: 'module-not-installed' } })).rejects.toMatchObject({
|
|
288
|
+
code: 'MODULE_NOT_FOUND', httpStatus: 404,
|
|
289
|
+
});
|
|
290
|
+
// 错误种类为 AppToolkitError(复用 toolkit 错误类型)
|
|
291
|
+
await expect(tk.loadProviders({ scope: { kind: 'module', module: 'module-not-installed' } })).rejects.toBeInstanceOf(AppToolkitError);
|
|
292
|
+
});
|
|
293
|
+
|
|
294
|
+
it('404 不依赖受限供应商:全场无策略(all/缺省)时未知模块同样 404 而非 200 完整清单(P2①返修)', async () => {
|
|
295
|
+
// 独立 app:仅 free/allspec(零策略厂商)——受限供应商不在场走不到原 per-provider 校验
|
|
296
|
+
const app = createTempApp('tbox-t12-all404-');
|
|
297
|
+
invalidateContractsResolver();
|
|
298
|
+
const store = join(app.appDir, 'contracts');
|
|
299
|
+
writeFakeContractsPackage(store, {
|
|
300
|
+
version: '0.9.0',
|
|
301
|
+
resolveBody: CASCADE_RESOLVE_BODY,
|
|
302
|
+
supplyBody: SUPPLY_AGGREGATE_BODY,
|
|
303
|
+
slots: ['parking.query'],
|
|
304
|
+
});
|
|
305
|
+
linkContracts(app.appDir, store, { subdir: 'apps/server' });
|
|
306
|
+
const manifest = (o: Record<string, unknown>): string =>
|
|
307
|
+
JSON.stringify({ schemaVersion: 1, version: '0.1.0', kind: 'business', dependencies: { modules: [] }, env: [], ...o });
|
|
308
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-free'), { recursive: true });
|
|
309
|
+
writeAppFile(app.appDir, 'packages/provider-free/tbox.module.json', manifest({
|
|
310
|
+
id: 'provider-free',
|
|
311
|
+
declare: { providers: { id: 'free', slots: [{ service: 'parking.query', provider: 'free', implementation: 'free-query@1', credentialType: 'free-c' }] } },
|
|
312
|
+
}));
|
|
313
|
+
mkdirSync(join(app.appDir, 'packages', 'provider-allspec'), { recursive: true });
|
|
314
|
+
writeAppFile(app.appDir, 'packages/provider-allspec/tbox.module.json', manifest({
|
|
315
|
+
id: 'provider-allspec',
|
|
316
|
+
declare: { providers: { id: 'allspec', selectionScope: 'all', slots: [{ service: 'parking.query', provider: 'allspec', implementation: 'allspec-q@1', credentialType: 'allspec-c' }] } },
|
|
317
|
+
}));
|
|
318
|
+
writeAppFile(app.appDir, 'config/integrations.json', JSON.stringify({ provider: 'mock', services: {} }));
|
|
319
|
+
const tk = createAppToolkit(app.appDir);
|
|
320
|
+
await expect(tk.loadProviders({ scope: { kind: 'module', module: 'module-not-installed' } })).rejects.toMatchObject({
|
|
321
|
+
code: 'MODULE_NOT_FOUND', httpStatus: 404,
|
|
322
|
+
});
|
|
323
|
+
// 已安装模块 + 全 all → 200 完整清单(不受限不筛)
|
|
324
|
+
const okView = await tk.loadProviders({ scope: { kind: 'module', module: 'provider-free' } });
|
|
325
|
+
expect(okView.providers.map((p) => p.provider).sort()).toEqual(['allspec', 'free']);
|
|
326
|
+
});
|
|
327
|
+
|
|
328
|
+
it('空供应商清单时未知模块同样 404(校验先于遍历——不产 200 空清单误导)(P2①返修)', async () => {
|
|
329
|
+
const app = createTempApp('tbox-t12-empty404-');
|
|
330
|
+
invalidateContractsResolver();
|
|
331
|
+
const store = join(app.appDir, 'contracts');
|
|
332
|
+
writeFakeContractsPackage(store, {
|
|
333
|
+
version: '0.9.0',
|
|
334
|
+
resolveBody: CASCADE_RESOLVE_BODY,
|
|
335
|
+
supplyBody: SUPPLY_AGGREGATE_BODY,
|
|
336
|
+
slots: ['parking.query'],
|
|
337
|
+
});
|
|
338
|
+
linkContracts(app.appDir, store, { subdir: 'apps/server' });
|
|
339
|
+
mkdirSync(join(app.appDir, 'packages', 'module-parking'), { recursive: true });
|
|
340
|
+
writeAppFile(app.appDir, 'packages/module-parking/tbox.module.json', JSON.stringify({
|
|
341
|
+
schemaVersion: 1, id: 'module-parking', version: '0.1.0', kind: 'business',
|
|
342
|
+
dependencies: { modules: [] }, env: [],
|
|
343
|
+
declare: { owns: [{ service: 'parking.query' }] },
|
|
344
|
+
}));
|
|
345
|
+
writeAppFile(app.appDir, 'config/integrations.json', JSON.stringify({ provider: 'mock', services: {} }));
|
|
346
|
+
const tk = createAppToolkit(app.appDir);
|
|
347
|
+
await expect(tk.loadProviders({ scope: { kind: 'module', module: 'module-not-installed' } })).rejects.toMatchObject({
|
|
348
|
+
code: 'MODULE_NOT_FOUND', httpStatus: 404,
|
|
349
|
+
});
|
|
350
|
+
const empty = await tk.loadProviders();
|
|
351
|
+
expect(empty.providers).toEqual([]); // 零供应商在场——空清单基线(校验不误伤)
|
|
352
|
+
});
|
|
353
|
+
|
|
354
|
+
it('供给预览端点语义不变:loadProviderSupply 不因缺省受本扩展影响(缺省仍要求显式 scope)', async () => {
|
|
355
|
+
const { tk } = scopeHarness();
|
|
356
|
+
// supply scope 校验单点沿用(签名为必传参——编译级保证;此处断言既有错误矩阵未被触及)
|
|
357
|
+
await expect(tk.loadProviderSupply('limited', { kind: 'module', module: 'module-not-installed' })).rejects.toMatchObject({
|
|
358
|
+
code: 'MODULE_NOT_FOUND', httpStatus: 404,
|
|
359
|
+
});
|
|
360
|
+
const sup = await tk.loadProviderSupply('limited', { kind: 'service', service: 'parking.query' });
|
|
361
|
+
expect(sup.services[0]).toMatchObject({ service: 'parking.query', supplied: true });
|
|
362
|
+
});
|
|
363
|
+
});
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { describe, it, expect } from 'vitest';
|
|
2
|
-
import { readdirSync, readFileSync, statSync } from 'node:fs';
|
|
2
|
+
import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
|
|
3
3
|
import { join } from 'node:path';
|
|
4
4
|
import { fileURLToPath } from 'node:url';
|
|
5
5
|
|
|
@@ -149,7 +149,14 @@ describe('G 批 x-tbox-global 标记结构断言(integrations-v6 全局字段
|
|
|
149
149
|
expect(globalKeysOf(join(base, 'mall-info.config.json'))).toEqual([]); // 零声明负例
|
|
150
150
|
});
|
|
151
151
|
|
|
152
|
-
it('
|
|
152
|
+
it('hupo 期望集锁(任务12 商家两字段):merchantId/merchantKey 恒全局标记(配置面表单可见基线)', () => {
|
|
153
|
+
const base = join(fileURLToPath(new URL('../../..', import.meta.url)), 'modules', 'provider-hupo', 'schemas');
|
|
154
|
+
expect(globalKeysOf(join(base, 'activity-play.config.json')).sort()).toEqual(['merchantId', 'merchantKey']);
|
|
155
|
+
// 凭据 schema 已退场(任务12 零 credentialRef——目录若回潮即结构性异常)
|
|
156
|
+
expect(existsSync(join(base, 'credentials'))).toBe(false);
|
|
157
|
+
});
|
|
158
|
+
|
|
159
|
+
it('素材对账锁:.real-env 全局层键 ⊆ 对应厂商声明并集(mock/mocktest/wanda/joycity 四档 + activity-play 素材目录)', () => {
|
|
153
160
|
const repoRoot = fileURLToPath(new URL('../../..', import.meta.url));
|
|
154
161
|
const collect = (vendor: string): Set<string> => {
|
|
155
162
|
const out = new Set<string>();
|
|
@@ -183,5 +190,16 @@ describe('G 批 x-tbox-global 标记结构断言(integrations-v6 全局字段
|
|
|
183
190
|
expect(declared.has(k), `${vendor} 档全局层键 "${k}" ∉ schema x-tbox-global 声明并集——补标记或改素材(对账锁)`).toBe(true);
|
|
184
191
|
}
|
|
185
192
|
}
|
|
193
|
+
// 活动玩法素材目录(任务12 商家两字段——modules.*.config 键 ⊆ hupo 声明并集)
|
|
194
|
+
const hDeclared = collect('hupo');
|
|
195
|
+
const apDir = join(repoRoot, '.real-env', 'config', 'activity-play');
|
|
196
|
+
for (const f of readdirSync(apDir).filter((x) => x.endsWith('.json'))) {
|
|
197
|
+
const ig = JSON.parse(readFileSync(join(apDir, f), 'utf8')) as { modules?: Record<string, { config?: Record<string, unknown> }> };
|
|
198
|
+
for (const [mod, node] of Object.entries(ig.modules ?? {})) {
|
|
199
|
+
for (const k of Object.keys(node.config ?? {})) {
|
|
200
|
+
expect(hDeclared.has(k), `activity-play/${f} ${mod} config 键 "${k}" ∉ hupo x-tbox-global 声明并集——补标记或改素材(对账锁)`).toBe(true);
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
}
|
|
186
204
|
});
|
|
187
205
|
});
|