@tbox.cn/app-toolkit 0.8.5 → 1.0.0-alpha.1
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 +11 -18
- package/dist/index.js +9 -9
- package/package.json +2 -2
- package/src/assembly/app-manifest.ts +33 -21
- package/src/assembly/walk-manifests.ts +50 -0
- package/tests/api-snapshot.test.ts +32 -0
- package/tests/v1-modules.test.ts +59 -0
package/dist/index.d.ts
CHANGED
|
@@ -1924,11 +1924,12 @@ declare function resolveModuleKey(walk: WalkManifestsResult, key: string): WalkM
|
|
|
1924
1924
|
declare function resolveServiceKey(walk: WalkManifestsResult, configuredKeys: readonly string[], key: string): string;
|
|
1925
1925
|
|
|
1926
1926
|
/**
|
|
1927
|
-
* .tbox/app.json
|
|
1928
|
-
*
|
|
1929
|
-
*
|
|
1927
|
+
* .tbox/app.json manifest 读写(自 CLI manifest.ts 迁入——assembly 层目录知识单源)。
|
|
1928
|
+
*
|
|
1929
|
+
* 1.0 兼容面:appKind / schemaVersion 为 additive optional;写回保留未知字段。
|
|
1930
1930
|
*/
|
|
1931
1931
|
type ModuleMode = 'local' | 'sdk' | 'codegen';
|
|
1932
|
+
type AppKind = 'agent' | 'web';
|
|
1932
1933
|
interface NpmModuleEntry {
|
|
1933
1934
|
/** 模块短 id(如 "module-member"),装配别名来源 */
|
|
1934
1935
|
id: string;
|
|
@@ -1940,34 +1941,31 @@ interface NpmModuleEntry {
|
|
|
1940
1941
|
mode: ModuleMode;
|
|
1941
1942
|
/** 3-way merge 基线(codegen 模式) */
|
|
1942
1943
|
baseVersion?: string;
|
|
1943
|
-
/**
|
|
1944
|
-
* 条目类别(单一模板统一化):'ui-kit' = 壳 UI 组件包——create 全量继承后
|
|
1945
|
-
* 不再承担保留判据(模板 manifest = 出厂装配真源);现职 = update 三方合并锚 +
|
|
1946
|
-
* sync-agent-ui-kit 副本 identity 标记(由该脚本派生维护)。
|
|
1947
|
-
*/
|
|
1944
|
+
/** 条目类别 */
|
|
1948
1945
|
kind?: 'ui-kit';
|
|
1949
1946
|
}
|
|
1950
1947
|
interface AppManifest {
|
|
1951
1948
|
templateVersion: string;
|
|
1952
1949
|
npmModules: NpmModuleEntry[];
|
|
1950
|
+
/** 1.0:应用类型;旧 manifest 缺席(按 agent 兼容读,不写回)。 */
|
|
1951
|
+
appKind?: AppKind;
|
|
1952
|
+
/** 1.0:manifest schema 版本。 */
|
|
1953
|
+
schemaVersion?: 1;
|
|
1954
|
+
[key: string]: unknown;
|
|
1953
1955
|
}
|
|
1954
1956
|
declare function manifestPath(appDir: string): string;
|
|
1955
1957
|
/** 读应用 manifest(缺席 → null;损坏/版本非法 → null——宽松解析与 CLI 语义一致) */
|
|
1956
1958
|
declare function readAppManifest(appDir: string): AppManifest | null;
|
|
1957
|
-
/** 写应用 manifest
|
|
1959
|
+
/** 写应用 manifest(目录缺席物化;同步——写核心串行队列内使用;保留未知字段) */
|
|
1958
1960
|
declare function writeAppManifest(appDir: string, manifest: AppManifest): void;
|
|
1959
1961
|
/** 小程序容器登记项(miniapp-container init 写入;与 npmModules 正交,不参与装配/doctor) */
|
|
1960
1962
|
interface MiniappContainerEntry {
|
|
1961
|
-
/** 平台 id:'alipay' / 'weapp'(= CLI platform 参数,展开目录名后缀) */
|
|
1962
1963
|
id: string;
|
|
1963
|
-
/** 源包名(@tbox.cn/app-miniapp-container-*) */
|
|
1964
1964
|
package: string;
|
|
1965
1965
|
version: string;
|
|
1966
|
-
/** 展开目录(相对应用根,如 'apps/miniapp-container-alipay') */
|
|
1967
1966
|
dir: string;
|
|
1968
1967
|
}
|
|
1969
1968
|
interface AppManifestFull extends AppManifest {
|
|
1970
|
-
/** 已初始化的小程序容器(可选——旧 manifest 无此字段,读侧归一为 []) */
|
|
1971
1969
|
miniappContainers?: MiniappContainerEntry[];
|
|
1972
1970
|
}
|
|
1973
1971
|
/** 读应用 manifest(完整面——miniappContainers 归一) */
|
|
@@ -1978,12 +1976,7 @@ declare function removeNpmModule(manifest: AppManifest, id: string): AppManifest
|
|
|
1978
1976
|
declare function upsertMiniappContainer(manifest: AppManifestFull, entry: MiniappContainerEntry): AppManifestFull;
|
|
1979
1977
|
/** 更新某模块的元数据(update 命令用:version / baseVersion) */
|
|
1980
1978
|
declare function updateNpmModule(manifest: AppManifest, id: string, patch: Partial<Pick<NpmModuleEntry, 'version' | 'baseVersion'>>): AppManifest;
|
|
1981
|
-
/**
|
|
1982
|
-
* 模块 id 合法性:小写字母/数字开头,单词段以单个中划线分隔(无连续/尾部中划线),
|
|
1983
|
-
* 防路径穿越/目录注入,并保证 camelCaseId 派生别名唯一(a-b 与 a--b 不允许共存碰撞)。
|
|
1984
|
-
*/
|
|
1985
1979
|
declare function isValidModuleId(id: string): boolean;
|
|
1986
|
-
/** 校验失败抛出(统一错误信息) */
|
|
1987
1980
|
declare function assertValidModuleId(id: string, source: string): void;
|
|
1988
1981
|
|
|
1989
1982
|
/** 桥源形态冻结:ProviderCatalog = contracts TIER0 形状(providers/services/credentialTypes) */
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import{a 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 l of Ge(S,{withFileTypes:!0}))l.isDirectory()&&t.push(V(S,l.name))}catch{}}let i=new Set,o=(d,S,l)=>{let f=n?n.read(S,Ln):Ln(X(S,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:l})},s=V(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let d of t){let S=V(d,"node_modules","@tbox.cn");if(!_(S))continue;let l=[];try{l=Ge(S)}catch{continue}for(let f of l){let R=V(S,f);if(i.has(R))continue;i.add(R);let k=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(k)?o(R,k,"package"):_(g)&&o(R,g,"package")}}for(let d of t)for(let S of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])_(S)&&o(d,S,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,S=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let y=t.providers[w.provider]??={},A=y[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(y[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let I=`${w.provider}\0${w.service}`;i[I]||(i[I]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},l=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},k=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let y=`${c.provider}\0${c.implementation}`;w.has(y)||(v.defaults.push(c),w.add(y))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,a.id),d.add(a.id);continue}if(!u)continue;d.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,a.package,f(u)),c.length&&S(c,a.package,v,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,a.package);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){k(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&l(w,a,f(h)),v.length&&S(v,a,m,f(h),w);let c=u?.consumes??[];for(let A of c)C(A,a);let y=h.kind==="strict"?h.descriptor.declare.owns:[];y.length&&R(y.map(A=>A.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=Ge(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){k(u,m),d.add(m);continue}if(!u)continue;let v=u.id??m;if(d.has(v))continue;d.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],y=w?.providers?.id;y&&l(y,`@app/${v}`,f(u)),c.length&&S(c,`@app/${v}`,h,f(u),y);let A=w?.consumes??[];for(let M of A)C(M,`@app/${v}`);let I=u.kind==="strict"?u.descriptor.declare.owns:[];I.length&&R(I.map(M=>M.service),v)}}let x=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)x.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...x].sort(),slotMeta:p,ownership:s,declarationIssues:o}}function Bn(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let i=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Un(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=ze(e),i=new Map;for(let o of t?.npmModules??[])i.set(o.id,o.mode);for(let o of r.modules){let s=i.get(o.id)??"local",d=Bn(o.dir,"server","serverModule"),S=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:d,hasClientEntry:Bn(o.dir,"client","clientModule"),hasCards:(S.cards?.length??0)>0,...d?{moduleId:Un(Jt(o.dir))}:{}})}return n.sort((o,s)=>o.id.localeCompare(s.id))}function Ht(e){return D(e).ownership}function F(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Kn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:S,vendorConfigKeys:l,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:O,ownership:x,installedModuleIds:p}=e,a=d?new Set(d):void 0;for(let c of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(i).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,y,A,I)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof y.provider=="string"&&typeof y.implementation=="string")return i[le(y.provider,y.implementation)]?.credentialType;let M=y.provider?.credentialType;if(typeof M=="string")return M;if(!s)return;let N=I??Object.keys(y.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,N,s,x);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(k||g)for(let[c,y]of Object.entries(t.services))for(let[A,I]of Object.entries(y.instances??{})){if(I.enabled===!1)continue;let M=I.credentialRef??y.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof M!="string"||!M.startsWith("secret://"))continue;let N=M.slice(9);k?.[N]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${N}(${c}@${A} effective ref=${M};档内 config/credentials/ 无此文件)`});let j=g?.[N];if(j){let P=h(c,y,I,A);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${N}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let u=(c,y)=>{if(!a)return;let A=Kn(c,y,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,y])=>y.instances!=null&&y.instances["*"]==null).map(([y])=>y);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,y]of Object.entries(t.services)){if(!o[c]&&x?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof y.provider=="string"?typeof y.implementation=="string"&&!i[le(y.provider,y.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${y.provider}/${y.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):y.provider!==void 0&&!K(y.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),S){let I=h(c,y);I&&S[I]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${I} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof y.provider=="object"&&typeof y.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[I,M]of Object.entries(y.instances??{})){u(I,`services.${c}.instances`);let N=M.provider!==void 0,j=M.implementation!==void 0;if(j&&!N&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:I,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${I}——impl-only 禁止,provider 是绑定组头)`}),N&&j){let P=M.provider,L=M.implementation;typeof P=="string"&&typeof L=="string"?i[le(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:I,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${I})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:I,message:`integrations: 实例级内联 provider 超受控形状(${c}@${I})`})}}}for(let[c,y]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,I])=>[`modules.${A}`,I?.provider])])typeof y!="string"||y.length===0||m.has(y)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${y} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let c=y=>{let A=x?.[y],I=A!=null?t.modules?.[A]:void 0;if(typeof I?.provider=="string"&&I.provider)return{provider:I.provider,where:`modules.${A}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[y,A]of Object.entries(t.services)){if(typeof A.provider!="string"||!A.provider)continue;let I=c(y);!I||I.provider===A.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:y,module:I.where.startsWith("modules.")?I.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${A.provider} 优先于 ${I.where} 层默认 ${I.provider}(${y}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[c,y]of Object.entries(t.services)){let A=y.instances?Object.keys(y.instances):[""];for(let I of A){let M=r.resolveEffectiveService(t,c,I,s,x);M.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:I||void 0,message:`integrations: ${M.message}`})}}for(let[c,y]of Object.entries(t.services))y.implementation!==void 0&&y.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,y]of Object.entries(t.modules??{})){if(!(y?.provider!==void 0||y?.config!==void 0))continue;let I=p?!p.has(c):!1,M=0;if(x)for(let j of Object.values(x))j===c&&(M+=1);if(I||!(x===void 0)&&M===0){let j=I?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(l){let c=new Set,y=!1,A=I=>{typeof I!="string"||I.length===0||(l[I]&&c.add(I),!l[I]&&!R?.[I]&&(y=!0),R?.[I]&&(y=!0))};A(t.provider);for(let I of Object.values(t.modules??{}))A(I?.provider);for(let I of Object.values(t.services)){let M=I.provider;A(typeof I.provider=="string"?I.provider:M?.provider)}for(let I of c)l[I]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${I} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(c.size>0&&!y){let I=new Set;for(let j of c)for(let P of l[j]??[])I.add(P);let M=new Set;for(let j of c)for(let P of f?.[j]??[])M.add(P);let N=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??I).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};N(t.config,"root.config",void 0,M);for(let[j,P]of Object.entries(t.configByInstance??{}))N(P,`root.configByInstance[${j}]`,void 0,M);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=F(t,j).provider??void 0;if(L===void 0){N(P.config,`modules.${j}.config`,void 0,M);continue}let Z=l[L];if(!Z||R?.[L])continue;let q=f?.[L];N(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,y]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${y.owners.join(", ")})未配置${y.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let I=Object.entries(A.instances??{}).filter(([,M])=>M.enabled===!1).map(([M])=>M);I.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:I.join(", "),message:`integrations: ${c} 实例禁用(${I.join(", ")})`})}for(let[c,y]of Object.entries(t.modules??{})){let A=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[I,M]of Object.entries(y?.resources??{})){let N=M?.type;(typeof N!="string"||!r.RESOURCE_TYPE_IDS.includes(N))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${I} type 非法(${String(N)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(I)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${I} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function ue(e,n,r,t=process.env){let i={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[u,v]of Object.entries(n.catalog.services))o[u]={optional:v.optional,owners:[...v.owners]};let s={},d={},S={},l={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,y=d[v.provider]??=new Set;for(let I of Qt(w))c.add(I);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[I,M]of Object.entries(A))M&&typeof M=="object"&&M["x-tbox-global"]===!0&&y.add(I)}else S[v.provider]=!0}v.credentialSchema&&!Ye(ke(u.dir,v.credentialSchema))&&(l[v.credentialType]=!0)}}let R={},k=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let u of qt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);k.add(v);let w=zn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,O=[],x=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(C.services??{}))if(u&&typeof u=="object"){x(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&x(v.credentialRef)}for(let u of Object.values(C.credentialRefByInstance??{}))x(u);x(C.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[Gn(v)]===void 0&&(k.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,y]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=y&&typeof y=="object"&&typeof y.provider=="string"?y.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:l,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:S,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as Si}from"fs";import{join as hi,resolve as Ri}from"path";function He(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[d,S]of Object.entries(s))r[o][d]={provider:S.provider,implementation:S.implementation,credentialType:S.credentialType,owner:S.owner,...S.local?{local:!0}:{},...S.configSchema?{configSchema:S.configSchema}:{},...S.credentialSchema?{credentialSchema:S.credentialSchema}:{},services:[...S.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function G(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await T(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new E("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function pe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ae,readFileSync as rr}from"fs";import{join as Ce}from"path";function Hn(e,n,r){let t=[];if(n){let i=Q({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=Q({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Zn(e,n,r,t,i){let o=[];if(t){let s=Q({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,d]of Object.entries(i??{})){let S=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:S,ref:`secret://${S}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,W(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,W(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await T(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let g=Ue(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await Ze(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),d=new Set(Object.keys(s.catalog.providers)),S=s.ownership,l=structuredClone(r);l.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(l.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete l.modules[g.module])}else l.provider&&(f.push(`root.provider=${l.provider}`),delete l.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=l.modules??{};if(C[g.module]){let O=C[g.module],x=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${x.join("+")} 整节点)`),delete l.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=l.services[g.service];if(!C)continue;let O=S[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),O!==void 0?Ee(l.modules?.[O]?.provider):void 0,Ee(l.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete l.services[g.service]}else delete l.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(l.services).length===0&&delete l.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!l.provider&&Object.keys(l.services??{}).length===0&&Object.keys(l.config??{}).length===0&&Object.keys(l.configByInstance??{}).length===0&&!l.credentialRef&&Object.keys(l.credentialRefByInstance??{}).length===0&&(l.instances??[]).length===0&&l.defaultInstanceId==null&&Object.keys(l.modules??{}).length===0;if(!R&&(l.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(l)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):$(n,`${JSON.stringify(l,null,2)}
|
|
4
|
-
`),k=ne(e).map(
|
|
5
|
-
`),t?.invalidate([re(e,
|
|
6
|
-
`),t?.invalidate([re(e,
|
|
7
|
-
`)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation}
|
|
8
|
-
`)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var tn={provider:null,layer:null};function rn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:tn}function on(e){let n=rn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:tn,inherited:tn}}function Ve(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,i=F(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,l=>JSON.parse(l))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[S,l]of Object.entries(i)){if(!l||typeof l!="object"||Array.isArray(l))continue;let f=l,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),k=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=k??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...k!==void 0?{datasetId:k}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[S]=O}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function an(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,g)=>{let C=J(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(k=>o(k.service,k.optional===!1)),...[...new Set(t.ownedServices)].filter(k=>!i.has(k)).map(k=>o(k,!1))],d=e.integrations?.modules??{},S=d[n],l=S?{...typeof S.provider=="string"?{provider:S.provider}:{},...S.config&&typeof S.config=="object"&&!Array.isArray(S.config)?{config:S.config}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:l,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let l of Object.values(t))l.services.includes(r)&&o.push({implementation:l.implementation,credentialType:l.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let S=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:S,integrationSchemas:{configSchema:S}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?pn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function pn(e,n,r){if(!r)return null;let t=kr(n,r);if(!ft(t))return null;try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=pt(e,"config","schemas"),t=pt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ft(t))return null;let o,s;try{o=ut(r),s=ut(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(gt(t,"utf8"))}catch{return null}}function _e(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function mt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"];if(o&&o.provider!==void 0)return"instance";if(i?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&F(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,l=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,l,s),R=mt(n,e,l),k=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),x=g!==void 0&&O.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...x!==void 0?{supplied:x}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function Er(e,n,r){return De(e,n,r)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function ve(e,n,r){let t={};for(let i of me(e))r&&!r.includes(i)||(t[i]=fn(i,e));return{contracts:_e(e.contracts),resolutions:t,issues:n}}function gn(e,n,r){let t=yt(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),d=s.instances.map(x=>x.id),S=n.integrations?.services?.[e],l=S?.instances?Object.keys(S.instances):void 0,f=St(l,d),R=new Map;for(let x of f)R.set(x,vt(n,t,e,x,i));let k=f.map(x=>{let p=R.get(x);return{instanceId:x,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),O={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:g};return{contracts:_e(n.contracts),resolution:O,issues:r.filter(x=>x.service===e)}}function St(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function wt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],d=s!==void 0?F(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...d.layer==="module"&&d.provider?{provider:d.provider}:{}},{layer:"service",...typeof i?.provider=="string"?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}},{layer:"instance",...o?.provider?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function ht(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function $e(e,n,r){let t=B(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=B(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return St(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Nr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Tr(e){let n=e.map(t=>Nr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=oe(e[0].subschema);return e.every(i=>oe(i.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>jr(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let d=s.configSchema;if(d===null){n.push(o);continue}if(!d||typeof d!="object"||Array.isArray(d))continue;let S=d;S.additionalProperties===!1&&(r=!1);let l=S.properties;if(!l||typeof l!="object"||Array.isArray(l))continue;let f=Array.isArray(S.required)?S.required:[];for(let R of Object.keys(l)){let k=t.get(R)??[];k.push({service:o,subschema:l[R],required:f.includes(R)}),t.set(R,k)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Tr(s),sources:s.map(({service:d,required:S})=>({service:d,required:S})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:F(n.integrations,t.id).provider}var It={integrationSchemas:null,integrationFieldRegistry:null};function kt(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=yn("app",e);if(n===null)return It;let r=vn(e,n,de(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:kt(Fe(r))}}function wn(e,n){let r=yn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return It;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=vn(e,r,i.filter(s=>De(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:kt(Fe(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return wn(e,n).integrationSchemas}function Dr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return F(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=ce(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function Rn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:i}of n?.instances??[]){let o=n?.credentialRefByInstance?.[i];o!==void 0&&(r.byInstance[i]=Se(e.appDir,o)??null)}let t={};for(let[i,o]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,o.credentialRef)??null,byInstance:{}};for(let[d,S]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,S.credentialRef)??null;t[i]=s}return{app:r,services:t}}function In(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let i=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:i?pn(e.appDir,i.packageDir,i.credentialSchema):null}})}}import _r from"path";var $r={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function kn(e,n){if(!n||n.length===0)return new Set;let r=$r[e],t=[...new Set(n)].filter(i=>!r.includes(i));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Fr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function d(p){return at(i,p)}function S(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function l(){let p=await T(e),a=d(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},u=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let k={async loadModules(p){let a=await T(e);return sn(d(a),p)},async loadModule(p,a){let m=kn("module",a?.include),h=await T(e),u=d(h),v=Oe(u.walk,p),w=an(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(y=>y.service)])];w.serviceResolutions=ye(h)?await l().then(y=>ve(u,y,c)):$e(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await T(e),h=d(m),u=cn(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await l().then(v=>ve(h,v)):$e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=kn("service",a?.include),h=await T(e),u=d(h),v=Y(u.walk,S(u),p),w=dn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(u,v)),w},async loadServiceResolutions(p){let a=await T(e),m=d(a);if(!ye(a))return $e(m,a,p);let h=await l();return ve(m,h,p)},async loadServiceResolution(p){let a=await T(e),m=d(a),h=Y(m.walk,S(m),p);if(!ye(a))return Rt(h,m,a);let u=await l();return gn(h,m,u)},async loadProviders(){let p=await T(e);return ln(d(p))},async loadProviderSupply(p,a){Fr(a);let m=await T(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await T(e),h=d(m),u=Y(h.walk,S(h),a);return un(h,p,u)},async loadCredentials(){let p=await T(e);return Rn(d(p))},async loadCredentialTypes(p){let a=await T(e);return In(d(a),p)}},g=en(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(p,a){await g.warmup();let m=await T(e);return o(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=Oe(d(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await T(e);return o(h),R(()=>{let u=d(h),v=Y(u.walk,S(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await T(e);return o(a),R(()=>{let m=d(a),h=Y(m.walk,S(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return T(e)},walkManifests(){return x(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await T(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function x(p){return D(p,r)}return{...k,...C,...O}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");$(t,`${JSON.stringify(n,null,2)}
|
|
9
|
-
`),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,
|
|
1
|
+
import{a as We,b as se,c as V,d as Ue}from"./chunk-K5FIGT5A.js";import{z as b}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,Ct=b.object({cardType:b.string(),schemaVersion:b.number().optional()}),An=b.object({route:b.string(),component:b.string()}),Cn=b.object({route:b.string(),label:b.string().optional(),icon:b.string().optional(),order:b.number().optional()}),En=b.object({id:b.string(),range:b.string().optional(),required:b.boolean().default(!0)}),On=b.object({service:b.string(),provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string(),credentialType:b.string(),local:b.boolean().optional(),configSchema:b.string().optional(),credentialSchema:b.string().optional()}),xn=b.object({service:b.string(),optional:b.boolean().default(!0),defaults:b.array(b.object({provider:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:b.string()})).default([]),name:b.string().optional(),description:b.string().optional()}),Mn=b.object({service:b.string()}).strict(),jn=b.object({id:b.string(),type:b.string()}),Nn=b.object({$comment:b.union([b.string(),b.record(b.string(),b.unknown())]).optional(),$schema:b.string().optional(),schemaVersion:b.number().default(1),id:b.string(),name:b.string().optional(),description:b.string().optional(),hidden:b.boolean().optional(),version:b.string().default("0.0.0"),kind:b.enum(["platform","business","third-party"]).default("business"),risk:b.object({level:b.enum(["high","medium","low"]).default("low"),writeBoundary:b.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:b.object({defaultMode:b.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:b.object({handlers:b.array(b.string()).default([]),tools:b.array(b.string()).default([]),cards:b.array(Ct).default([]),routes:b.array(b.string()).default([]),pages:b.array(An).default([]),tabs:b.array(Cn).default([]),providers:b.object({id:b.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:b.array(On).default([])}).default({}),owns:b.array(Mn).default([]),consumes:b.array(xn).default([]),resources:b.array(jn).default([])}).default({}),dependencies:b.object({modules:b.array(En).default([])}).default({}),env:b.array(b.string()).default([])}).strict();function Et(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let i=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,o=Array.isArray(i?.consumes)&&i.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||o)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ae(e){let n=Et(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=Nn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Ot=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function Tn(e){return JSON.stringify(e).slice(1,-1)}function Ke(e,n=process.env){let r=[],t=e.replace(Ot,(i,o,s)=>{if(i.startsWith("$$"))return i.slice(1);let c=n[o];return c!==void 0?Tn(c):s!==void 0?Tn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as xt,existsSync as Pn,readFileSync as Mt,writeFileSync as jt}from"fs";import{dirname as Nt,join as Vn}from"path";function he(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var O=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function Re(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new O("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function X(e){if(Re("provider",e.provider),Re("service",e.service),Re("instanceId",e.instanceId),Re("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 Tt(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Vn(e,W(n));if(!Pn(r))return null;try{let t=JSON.parse(Mt(r,"utf8"));if(typeof t.type!="string")return null;let{type:i,...o}=t,s={};for(let[c,w]of Object.entries(o))typeof w=="string"&&(s[c]=w);return{type:i,values:s}}catch{return null}}function ze(e,n,r){let t=Vn(e,W(n)),i=Pn(t);return xt(Nt(t),{recursive:!0}),jt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
|
|
2
|
+
`,"utf8"),i}import{mkdirSync as Pt,renameSync as Vt,writeFileSync as Dt}from"fs";import{dirname as _t}from"path";function F(e,n){Dn(_t(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;Dt(r,n,"utf8"),Vt(r,e)}function Dn(e){Pt(e,{recursive:!0})}import{existsSync as _,readdirSync as ke,readFileSync as Y}from"fs";import{join as P}from"path";import{existsSync as _n,readFileSync as Ge,mkdirSync as $t,writeFileSync as Ft}from"fs";import $n from"path";function Ie(e){return $n.join(e,".tbox","app.json")}function Fn(e){let n=Ie(e);if(!_n(n))return null;try{let r=JSON.parse(Ge(n,"utf8")),t=r?.templateVersion,i=r?.appKind;return typeof t!="string"||t.trim().length===0||i!==void 0&&i!=="agent"&&i!=="web"||r?.schemaVersion!==void 0&&r.schemaVersion!==1?null:{...r,templateVersion:t.trim(),npmModules:Array.isArray(r?.npmModules)?r.npmModules:[],...i==="agent"||i==="web"?{appKind:i}:{},...r?.schemaVersion===1?{schemaVersion:1}:{}}}catch{return null}}function Lt(e,n){let r=Ie(e);$t($n.dirname(r),{recursive:!0});let t={};if(_n(r))try{let o=JSON.parse(Ge(r,"utf8"));o&&typeof o=="object"&&!Array.isArray(o)&&(t=o)}catch{t={}}let i={...t,...n};Array.isArray(i.npmModules)&&i.npmModules.length===0&&delete i.npmModules,Array.isArray(i.miniappContainers)&&i.miniappContainers.length===0&&delete i.miniappContainers,Ft(r,`${JSON.stringify(i,null,2)}
|
|
3
|
+
`,"utf8")}function Je(e){let n=Fn(e);if(n===null)return null;let r=Ie(e);try{let t=JSON.parse(Ge(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Bt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Wt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function Ut(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Kt(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Ln(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function zt(e,n){if(!Ln(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function Bn(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:c}=o,w={};typeof s=="string"&&s.length>0&&(w.name=s),typeof c=="string"&&c.length>0&&(w.description=c),(w.name!==void 0||w.description!==void 0)&&(t[i]=w)}return{slots:r,meta:t}}catch{return null}}function de(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(Y(e,"utf8"))}catch{return null}}function Gt(e){let n=P(e,".tbox","app.json");if(!_(n))return[];try{let r=JSON.parse(Y(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 Wn(e){let n=P(e,".tbox-dev.local"),r=P(n,"dev-manifest.json");if(!_(r))return[];try{let t=JSON.parse(Y(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:P(n,s)});return i}catch{return[]}}function Kn(e,n){let r=[],t=[e];for(let c of["apps","packages"]){let w=P(e,c);if(_(w))try{for(let u of ke(w,{withFileTypes:!0}))u.isDirectory()&&t.push(P(w,u.name))}catch{}}let i=new Set,o=(c,w,u)=>{let g=n?n.read(w,Bn):Bn(Y(w,"utf8"));g!=null&&r.push({dir:c,slots:g.slots,meta:g.meta,via:u})},s=P(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let c of t){let w=P(c,"node_modules","@tbox.cn");if(!_(w))continue;let u=[];try{u=ke(w)}catch{continue}for(let g of u){let R=P(w,g);if(i.has(R))continue;i.add(R);let k=P(R,"service-slots.json"),v=P(R,"src","service-slots.json");_(k)?o(R,k,"package"):_(v)&&o(R,v,"package")}}for(let c of t)for(let w of[P(c,"service-slots.json"),P(c,"src","service-slots.json")])_(w)&&o(c,w,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},c=new Set,w=(m,d,p,y,a)=>{for(let l of m){let I=a===void 0||a===l.provider;I&&(t.vendorMeta[l.provider]??={owner:d,...y?.name?{name:y.name}:{},...y?.description?{description:y.description}:{}});let S=t.providers[l.provider]??={},E=S[l.implementation];E?E.services.includes(l.service)||E.services.push(l.service):(S[l.implementation]={provider:l.provider,implementation:l.implementation,credentialType:l.credentialType,owner:d,...I&&y?.name?{name:y.name}:{},...I&&y?.description?{description:y.description}:{},...l.local?{local:!0}:{},...l.configSchema?{configSchema:l.configSchema}:{},...l.credentialSchema?{credentialSchema:l.credentialSchema}:{},services:[l.service]},t.credentialTypes[l.credentialType]??={owner:d,packageDir:p,...l.credentialSchema?{credentialSchema:l.credentialSchema}:{}});let N=`${l.provider}\0${l.service}`;i[N]||(i[N]={...l.configSchema?{configSchema:l.configSchema}:{},...l.credentialSchema?{credentialSchema:l.credentialSchema}:{},packageDir:p})}},u=(m,d,p)=>{t.providers[m]??={},t.vendorMeta[m]??={owner:d,...p?.name?{name:p.name}:{},...p?.description?{description:p.description}:{}}},g=m=>m.kind==="strict"?{name:m.descriptor.name,description:m.descriptor.description}:void 0,R=(m,d)=>{for(let p of m){let y=s[p];y===void 0?s[p]=d:y!==d&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:d,message:`服务 ${p} 归属冲突:${y} 与 ${d} 均声明 owns(先声明 ${y} 胜出)——修正 manifest declare.owns 互斥`})}},k=(m,d)=>{m.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:d,message:`${d}:${m.detail}`})},v=m=>m.kind==="strict"||m.kind==="loose"?m.declare:null,C=(m,d)=>{let p=m.optional!==!1,y=m.defaults??[],a=t.services[m.service];if(a){a.optional=a.optional&&p;let l=new Set(a.defaults.map(I=>`${I.provider}\0${I.implementation}`));for(let I of y){let S=`${I.provider}\0${I.implementation}`;l.has(S)||(a.defaults.push(I),l.add(S))}a.owners.includes(d)||a.owners.push(d);return}t.services[m.service]={optional:p,defaults:[...y],...m.name?{name:m.name}:{},...m.description?{description:m.description}:{},owners:[d]}},x=P(e,"modules"),j=new Set(Wn(e).map(m=>m.dir));if(_(x)){let m=[];try{m=ke(x,{withFileTypes:!0}).filter(d=>d.isDirectory()).map(d=>d.name)}catch{}for(let d of m){if(c.has(d))continue;let p=P(x,d);if(j.has(p))continue;let y=de(P(p,"tbox.module.json"),n);if(y?.kind==="legacy"){k(y,d),c.add(d);continue}if(!y)continue;let a=y.id??d;if(c.has(a))continue;c.add(a);let l=v(y),I=`@app/${a}`;try{let T=P(p,"package.json");if(_(T)){let $=JSON.parse(Y(T,"utf8"));typeof $.name=="string"&&$.name.length>0&&(I=$.name)}}catch{}y.kind==="strict"&&r.push({id:a,dir:p,pkg:I,descriptor:y.descriptor});let S=l?.providers?.slots??[],E=l?.providers?.id;E&&u(E,I,g(y)),S.length&&w(S,I,p,g(y),E);let N=l?.consumes??[];for(let T of N)C(T,I);let M=y.kind==="strict"?y.descriptor.declare.owns:[];M.length&&R(M.map(T=>T.service),a)}}for(let m of Gt(e)){if(c.has(m.id))continue;let d=P(e,"packages",m.id),p=P(e,"node_modules",...m.package.split("/")),y=de(P(d,"tbox.module.json"),n)??de(P(p,"tbox.module.json"),n);if(y?.kind==="legacy"){k(y,m.id),c.add(m.id);continue}if(!y)continue;c.add(m.id);let a=_(P(d,"tbox.module.json"))?d:p,l=v(y);y.kind==="strict"&&r.push({id:m.id,dir:a,pkg:m.mode==="sdk"?m.package:`@app/${m.id}`,descriptor:y.descriptor});let I=l?.providers?.slots??[],S=l?.providers?.id;S&&u(S,m.package,g(y)),I.length&&w(I,m.package,a,g(y),S);let E=l?.consumes??[];for(let M of E)C(M,m.package);let N=y.kind==="strict"?y.descriptor.declare.owns:[];N.length&&R(N.map(M=>M.service),m.id)}for(let{pkg:m,dir:d}of Wn(e)){let p=de(P(d,"tbox.module.json"),n);if(p?.kind==="legacy"){k(p,m);continue}if(!p?.id||c.has(p.id))continue;c.add(p.id);let y=v(p),a=y?.providers?.slots??[],l=y?.providers?.id;l&&u(l,m,g(p)),a.length&&w(a,m,d,g(p),l);let I=y?.consumes??[];for(let E of I)C(E,m);let S=p.kind==="strict"?p.descriptor.declare.owns:[];S.length&&R(S.map(E=>E.service),p.id)}let f=P(e,"packages");if(_(f)){let m=[];try{m=ke(f,{withFileTypes:!0}).filter(d=>d.isDirectory()).map(d=>d.name)}catch{}for(let d of m){if(c.has(d))continue;let p=P(f,d),y=de(P(p,"tbox.module.json"),n);if(y?.kind==="legacy"){k(y,d),c.add(d);continue}if(!y)continue;let a=y.id??d;if(c.has(a))continue;c.add(a);let l=v(y);y.kind==="strict"&&r.push({id:a,dir:p,pkg:`@app/${a}`,descriptor:y.descriptor});let I=l?.providers?.slots??[],S=l?.providers?.id;S&&u(S,`@app/${a}`,g(y)),I.length&&w(I,`@app/${a}`,p,g(y),S);let E=l?.consumes??[];for(let M of E)C(M,`@app/${a}`);let N=y.kind==="strict"?y.descriptor.declare.owns:[];N.length&&R(N.map(M=>M.service),a)}}let h=new Set,A={};for(let m of Kn(e,n)){for(let d of m.slots)h.add(d);for(let[d,p]of Object.entries(m.meta))A[d]===void 0&&(A[d]=p)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...h].sort(),slotMeta:A,ownership:s,declarationIssues:o}}function Un(e,n,r){let t=P(e,"src",n,"index.ts");if(!_(t))return!1;try{let i=Y(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(i)}catch{return!1}}function Jt(e){let n=P(e,"src","server","index.ts");if(!_(n))return"";try{return Y(n,"utf8")}catch{return""}}function zn(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Yt(e){let n=[],r=D(e),t=Je(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",c=Un(o.dir,"server","serverModule"),w=o.descriptor.declare;n.push({id:o.id,pkg:s==="sdk"?o.pkg:`@app/${o.id}`,mode:s,hasServerEntry:c,hasClientEntry:Un(o.dir,"client","clientModule"),hasCards:(w.cards?.length??0)>0,...c?{moduleId:zn(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 U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function le(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(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 Gn(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 Ye(e,n){let r=new Set(n),t=[],i=(o,s)=>{let c=Gn(o,s,r);c&&t.push(c)};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 c of Object.keys(s.instances??{}))i(c,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:c,credentialSchemaMissing:w,vendorConfigKeys:u,vendorGlobalConfigKeys:g,vendorConfigSchemaMissing:R,credentialFileMissing:k,credentialFileType:v,realmSwitchHints:C,moduleResourceNeeds:x,ownership:j,installedModuleIds:f}=e,h=c?new Set(c):void 0;for(let a of C??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:a});let A=new Set(Object.keys(i).map(a=>a.slice(0,a.indexOf("\0"))).filter(a=>a.length>0)),m=(a,l,I,S)=>{if(typeof I?.provider=="string"&&typeof I.implementation=="string"&&I.provider&&I.implementation)return i[ue(I.provider,I.implementation)]?.credentialType;if(typeof l.provider=="string"&&typeof l.implementation=="string")return i[ue(l.provider,l.implementation)]?.credentialType;let E=l.provider?.credentialType;if(typeof E=="string")return E;if(!s)return;let N=S??Object.keys(l.instances??{})[0]??"",M=r.resolveEffectiveService(t,a,N,s,j);if(!(M.status!=="ok"||typeof M.effective.provider!="string"))return i[ue(M.effective.provider,M.effective.implementation)]?.credentialType};if(k||v)for(let[a,l]of Object.entries(t.services))for(let[I,S]of Object.entries(l.instances??{})){if(S.enabled===!1)continue;let E=S.credentialRef??l.credentialRef??t.credentialRefByInstance?.[I]??t.credentialRef;if(typeof E!="string"||!E.startsWith("secret://"))continue;let N=E.slice(9);k?.[N]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:a,instance:I,message:`integrations: 凭据文件缺失 ${N}(${a}@${I} effective ref=${E};档内 config/credentials/ 无此文件)`});let M=v?.[N];if(M){let T=m(a,l,S,I);T&&M!==T&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:a,instance:I,message:`integrations: 凭据文件 ${N}.json type=${M} 与绑定 credentialType ${T} 不一致(${a}@${I}——transport 创建期将按 type 选策略)`})}}let d=(a,l)=>{if(!h)return;let I=Gn(a,l,h);I&&n.push(I)};for(let[a]of Object.entries(t.configByInstance??{}))d(a,"configByInstance");for(let[a]of Object.entries(t.credentialRefByInstance??{}))d(a,"credentialRefByInstance");let p=Object.entries(t.services).filter(([,a])=>a.instances==null||a.instances["*"]!=null).map(([a])=>a);if(p.length>0){let a=Object.entries(t.services).filter(([,l])=>l.instances!=null&&l.instances["*"]==null).map(([l])=>l);a.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${p.join(", ")};显式键集:${a.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let y=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});y.instances.length>=2&&y.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${y.instances.length} 个部署实例(${y.instances.map(a=>a.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[a,l]of Object.entries(t.services)){if(!o[a]&&j?.[a]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:a,message:`integrations: 服务槽 ${a} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof l.provider=="string"?typeof l.implementation=="string"&&!i[ue(l.provider,l.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:a,message:`integrations: provider ${l.provider}/${l.implementation} 未命中已装供给(${a} 槽级)——装对应 provider 包或改绑`}):l.provider!==void 0&&!K(l.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:a,message:`integrations: 内联 provider 超受控形状(${a} 槽级;允许键 provider/credentialType/configSchema)`}),w){let S=m(a,l);S&&w[S]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:a,message:`integrations: credentialType ${S} 的 schema 引用不存在(${a};manifest 声明指向缺失文件)`})}typeof l.provider=="object"&&typeof l.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,message:`integrations: 内联厂商声明必须同时提供 implementation(${a} 槽级)`});for(let[S,E]of Object.entries(l.instances??{})){d(S,`services.${a}.instances`);let N=E.provider!==void 0,M=E.implementation!==void 0;if(M&&!N&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,instance:S,message:`integrations: 实例级 implementation 需伴随 provider(${a}@${S}——impl-only 禁止,provider 是绑定组头)`}),N&&M){let T=E.provider,$=E.implementation;typeof T=="string"&&typeof $=="string"?i[ue(T,$)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:a,instance:S,message:`integrations: 实例级 provider 覆盖 ${T}/${$} 未命中已装供给(${a}@${S})`}):K(T)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:a,instance:S,message:`integrations: 实例级内联 provider 超受控形状(${a}@${S})`})}}}for(let[a,l]of[["root",t.provider],...Object.entries(t.modules??{}).map(([I,S])=>[`modules.${I}`,S?.provider])])typeof l!="string"||l.length===0||A.has(l)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:a.startsWith("modules.")?a.slice(8):void 0,message:`integrations: ${a} provider ${l} 未命中已装供给——装对应 provider 包或 provider use 改绑(自声明厂商另查其包内 tbox.module.json declare.providers.slots——补槽声明前不在供给集)`});{let a=l=>{let I=j?.[l],S=I!=null?t.modules?.[I]:void 0;if(typeof S?.provider=="string"&&S.provider)return{provider:S.provider,where:`modules.${I}`};if(typeof t.provider=="string"&&t.provider)return{provider:t.provider,where:"root"}};for(let[l,I]of Object.entries(t.services)){if(typeof I.provider!="string"||!I.provider)continue;let S=a(l);!S||S.provider===I.provider||n.push({severity:"warning",code:"BINDING_SHADOWED",service:l,module:S.where.startsWith("modules.")?S.where.slice(8):void 0,message:`integrations: 槽级显式绑定 ${I.provider} 优先于 ${S.where} 层默认 ${S.provider}(${l}——绑定组层序 inst > slot > modules > root)——接入切换残留请剥离槽级 provider(改槽为 {} 激活节点或逐槽 provider bind 覆盖);有意差异化请忽略`})}}if(s)for(let[a,l]of Object.entries(t.services)){let I=l.instances?Object.keys(l.instances):[""];for(let S of I){let E=r.resolveEffectiveService(t,a,S,s,j);E.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:a,instance:S||void 0,message:`integrations: ${E.message}`})}}for(let[a,l]of Object.entries(t.services))l.implementation!==void 0&&l.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:a,message:`integrations: 槽级 implementation 需伴随 provider(${a}——impl-only 禁止,provider 是绑定组头)`});for(let[a,l]of Object.entries(t.modules??{})){if(!(l?.provider!==void 0||l?.config!==void 0))continue;let S=f?!f.has(a):!1,E=0;if(j)for(let M of Object.values(j))M===a&&(E+=1);if(S||!(j===void 0)&&E===0){let M=S?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:a,message:`integrations: modules.${a} 携带 provider/config 但模块${M}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(u){let a=new Set,l=!1,I=S=>{typeof S!="string"||S.length===0||(u[S]&&a.add(S),!u[S]&&!R?.[S]&&(l=!0),R?.[S]&&(l=!0))};I(t.provider);for(let S of Object.values(t.modules??{}))I(S?.provider);for(let S of Object.values(t.services)){let E=S.provider;I(typeof S.provider=="string"?S.provider:E?.provider)}for(let S of a)u[S]?.has("mallId")&&n.push({severity:"warning",code:"MALL_IDENTITY_IN_CONFIG_SCHEMA",message:`integrations: 厂商 ${S} configSchema 声明商场身份键 mallId——商场身份恒来自会话 scope(mallId),不应作 config 键/参数模板;厂商独立编号用语义前缀键(如 parkingMallId)按实例差异化(见 npx --yes @tbox.cn/app-cli skills get provider-custom「商场身份单源」)`});if(a.size>0&&!l){let S=new Set;for(let M of a)for(let T of u[M]??[])S.add(T);let E=new Set;for(let M of a)for(let T of g?.[M]??[])E.add(T);let N=(M,T,$,q)=>{for(let[Q]of Object.entries(M??{}))($??S).has(Q)?q&&q.size>0&&!q.has(Q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${T} 键 ${Q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${T} 键 ${Q} 不在引用厂商(${[...a].join("/")})任何槽 schema properties 内(死配置)`})};N(t.config,"root.config",void 0,E);for(let[M,T]of Object.entries(t.configByInstance??{}))N(T,`root.configByInstance[${M}]`,void 0,E);for(let[M,T]of Object.entries(t.modules??{})){if(!T?.config)continue;let $=L(t,M).provider??void 0;if($===void 0){N(T.config,`modules.${M}.config`,void 0,E);continue}let q=u[$];if(!q||R?.[$])continue;let Q=g?.[$];N(T.config,`modules.${M}.config`,new Set(q),Q)}}}for(let[a,l]of Object.entries(o)){let I=t.services[a];if(!I){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:a,message:`integrations: 服务槽 ${a}(需求方 ${l.owners.join(", ")})未配置${l.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let S=Object.entries(I.instances??{}).filter(([,E])=>E.enabled===!1).map(([E])=>E);S.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:a,instance:S.join(", "),message:`integrations: ${a} 实例禁用(${S.join(", ")})`})}for(let[a,l]of Object.entries(t.modules??{})){let I=x?.[a];x&&!(a in x)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:a,message:`integrations: modules.${a} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[S,E]of Object.entries(l?.resources??{})){let N=E?.type;(typeof N!="string"||!r.RESOURCE_TYPE_IDS.includes(N))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:a,message:`integrations: modules.${a}.resources.${S} type 非法(${String(N)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),I&&I.size>0&&!I.has(S)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:a,message:`integrations: modules.${a}.resources.${S} 未被模块 manifest declare.resources 声明`})}}return n}function ue(e,n){return`${e}\0${n}`}import{existsSync as He,readFileSync as Zt,readdirSync as qt}from"fs";import{join as be}from"path";function Yn(e){return e.replaceAll("-","_").toUpperCase()}function Jn(e){if(!He(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 pe(e,n,r,t=process.env){let i={};for(let[d,p]of Object.entries(n.catalog.providers))for(let[y,a]of Object.entries(p))i[`${d}\0${y}`]={services:[...a.services],owner:a.owner,credentialType:a.credentialType};let o={};for(let[d,p]of Object.entries(n.catalog.services))o[d]={optional:p.optional,owners:[...p.owners]};let s={},c={},w={},u={},g={};for(let d of n.modules){g[d.id]=new Set((d.descriptor.declare.resources??[]).map(p=>p.id));for(let p of d.descriptor.declare.providers?.slots??[]){if(p.configSchema){let y=Jn(be(d.dir,p.configSchema));if(y){let a=s[p.provider]??=new Set,l=c[p.provider]??=new Set;for(let S of Qt(y))a.add(S);let I=y.properties;if(I&&typeof I=="object"&&!Array.isArray(I))for(let[S,E]of Object.entries(I))E&&typeof E=="object"&&E["x-tbox-global"]===!0&&l.add(S)}else w[p.provider]=!0}p.credentialSchema&&!He(be(d.dir,p.credentialSchema))&&(u[p.credentialType]=!0)}}let R={},k=new Set,v=be(e,"config","credentials");if(He(v))for(let d of qt(v)){if(!d.endsWith(".json"))continue;let p=d.slice(0,-5);k.add(p);let y=Jn(be(v,d));y&&typeof y.type=="string"&&(R[p]=y.type)}let C=r,x=[],j=d=>{typeof d=="string"&&d.startsWith("secret://")&&x.push(d)};for(let d of Object.values(C.services??{}))if(d&&typeof d=="object"){j(d.credentialRef);for(let p of Object.values(d.instances??{}))p&&typeof p=="object"&&j(p.credentialRef)}for(let d of Object.values(C.credentialRefByInstance??{}))j(d);j(C.credentialRef);let f={};for(let d of x){let p=d.slice(9);t[Yn(p)]===void 0&&(k.has(p)||(f[p]=!0))}let h=[];for(let[d,p]of Object.entries(C.services??{})){let y=p&&typeof p=="object"&&typeof p.provider=="string"?p.provider:void 0;for(let[a,l]of Object.entries((p&&typeof p=="object"?p.instances:void 0)??{})){let I=l&&typeof l=="object"&&typeof l.provider=="string"?l.provider:void 0;y&&I&&I!==y&&h.push(`integrations: ${d}@${a} 实现覆盖跨厂商(${y} → ${I})——凭据域切换,确认该 mall 对应凭据在场`)}}let m=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(d=>d&&typeof d=="object"&&typeof d.id=="string"?d.id:void 0).filter(d=>typeof d=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:f,credentialFileType:R,credentialSchemaMissing:u,vendorConfigKeys:s,vendorGlobalConfigKeys:c,vendorConfigSchemaMissing:w,realmSwitchHints:h,moduleResourceNeeds:g,...m.length>0?{malls:m}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(d=>d.id),...new Set(Object.values(n.ownership))])}}import{existsSync as yi,readFileSync as wi}from"fs";import{join as hi,resolve as Ri}from"path";function Ze(e){return D(e).catalog}function Ae(e){let n=D(e).catalog,r={};for(let[o,s]of Object.entries(n.providers)){r[o]={};for(let[c,w]of Object.entries(s))r[o][c]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:w.owner,...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[...w.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(c=>({...c})),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 qe(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(Ae(e)),c=pe(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...c})}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 Hn}from"path";var nr=Hn("config","integrations.json");function G(e,n){let r=Hn(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 Zn(e,n){let r=await V(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(i){if(i instanceof Error&&Array.isArray(i.issues)){let o=i.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new O("VALIDATION_FAILED",400,"integrations.json 校验失败",o.length>0?o:void 0)}throw new O("VALIDATION_FAILED",400,i instanceof Error?i.message:String(i))}return{config:t,strict:!1,contracts:r}}function fe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as tr,existsSync as Ce,readFileSync as rr}from"fs";import{join as Ee}from"path";function qn(e,n,r){let t=[];if(n){let i=X({provider:e});t.push({stem:i,ref:`secret://${i}`,input:n})}for(let[i,o]of Object.entries(r??{})){let s=X({provider:e,instanceId:i});t.push({instanceId:i,stem:s,ref:`secret://${s}`,input:o})}return t}function Qn(e,n,r,t,i){let o=[];if(t){let s=X({provider:e,service:n});o.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,c]of Object.entries(i??{})){let w=X({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:w,ref:`secret://${w}`,input:c})}return o}function Xe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ce(Ee(e,W(t.stem))):ze(e,t.stem,t.input)}))}function ir(e,n){return Ce(Ee(e,W(n)))}function Qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)Qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))Qe(r,n)}function ne(e){let n=Ee(e,"config","credentials"),r=new Set,t=Ee(e,"config","integrations.json");if(Ce(t))try{Qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ce(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 c=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Oe(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await V(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let i;try{let v=Ke(JSON.stringify(r),process.env);if(v.missing.length>0||v.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};i=JSON.parse(v.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let o;try{o=await qe(e,i,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),c=new Set(Object.keys(s.catalog.providers)),w=s.ownership,u=structuredClone(r);u.services??={};let g=[];for(let v of o)if(v.severity==="error"){if(v.code==="VENDOR_NOT_INSTALLED")if(v.module){let x=(u.modules??{})[v.module];x?.provider&&(g.push(`modules.${v.module}.provider=${String(x.provider)}`),delete x.provider,Object.keys(x).length===0&&delete u.modules[v.module])}else u.provider&&(g.push(`root.provider=${u.provider}`),delete u.provider);else if(v.code==="MODULE_CONFIG_DEAD"&&v.module){let C=u.modules??{};if(C[v.module]){let x=C[v.module],j=[x.provider!==void 0?"provider":void 0,x.config!==void 0?"config":void 0,x.resources!==void 0?"resources":void 0].filter(Boolean);g.push(`modules.${v.module}(${j.join("+")} 整节点)`),delete u.modules[v.module]}}else if(v.code==="BINDING_UNRESOLVED"&&v.service){let C=u.services[v.service];if(!C)continue;let x=w[v.service];if([v.instance?Oe(C.instances?.[v.instance]?.provider):void 0,Oe(C.provider),x!==void 0?Oe(u.modules?.[x]?.provider):void 0,Oe(u.provider)].filter(f=>typeof f=="string").some(f=>c.has(f)))continue;if(v.instance){let f=C.instances;if(!f||!(v.instance in f))continue;delete f[v.instance],g.push(`services.${v.service}.instances.${v.instance}`),Object.keys(f).length===0&&delete C.instances,Object.keys(C).length===0&&delete u.services[v.service]}else delete u.services[v.service],g.push(`services.${v.service}`)}}if(Object.keys(u.services).length===0&&delete u.services,g.length===0)return{removed:g,orphanCredentials:[]};let R=!u.provider&&Object.keys(u.services??{}).length===0&&Object.keys(u.config??{}).length===0&&Object.keys(u.configByInstance??{}).length===0&&!u.credentialRef&&Object.keys(u.credentialRefByInstance??{}).length===0&&(u.instances??[]).length===0&&u.defaultInstanceId==null&&Object.keys(u.modules??{}).length===0;if(!R&&(u.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(u)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let k=[];return R?or(n)&&sr(n,{force:!0}):F(n,`${JSON.stringify(u,null,2)}
|
|
4
|
+
`),k=ne(e).map(v=>v.message),{removed:g,orphanCredentials:k}}function xe(e,n){let r=e.modules.find(i=>i.id===n);if(r)return r;let t=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new O("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new O("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function H(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let c of Object.values(s))for(let w of c.services)t.add(w);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&o(s);for(let[s,c]of Object.entries(e.catalog.services))c.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new O("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new O("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as ot,readFileSync as st}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],Me=["provider","config"],Xn=["provider","implementation","config","credentialRef","instances"],et=["provider","implementation","config","credentialRef","enabled"];var Z=re("config","integrations.json");function ge(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>ge(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(i=>ge(e[i],n[i]))}return!1}var at=["$comment","$schema"];function je(e,n){if(n)for(let r of at)!(r in e)&&r in n&&(e[r]=n[r])}function nt(e){if(e===null)return null;let n={...e};for(let r of at)delete n[r];return n}function tt(e,n){return ge(nt(e),nt(n))}function Ve(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new O("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Ve(t,`${n}.${r}`)}}function Ne(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new O("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function rt(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!z.test(s))throw new O("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),Ne(e.configByInstance,"root.configByInstance",!1),Ne(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else Ne(e.instances,"services.instances",!0);Ne(n.credentialsByInstance,"credentialsByInstance",!1)}function Te(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new O("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Pe(e,n){let r=re(e,Z),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!ot(r))return null;try{return t(st(r,"utf8"))}catch{return null}}function en(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Ye(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let c of Object.values(o))(r===void 0||c.services.includes(r))&&s.add(c.credentialType);return s.size===1?[...s][0]:void 0}function it(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new O("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new O("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:c}=D(e,o),w=c[`${n}\0${r}`];if(!w?.credentialSchema)return;let u=dr(w.packageDir,w.credentialSchema);if(ot(u))try{let R=new lr({allErrors:!0}).compile(JSON.parse(st(u,"utf8")));if(!R({type:t.type,...t.values})){let k=(R.errors??[]).map(v=>`credentials.values.${String(v.instancePath||v.params?.missingProperty||"").replace(/^\//,"")}`);throw new O("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",k)}}catch(g){if(g instanceof O)throw g}}function nn(e,n={}){let{onApplied:r,cache:t}=n;function i(u,g,R,k){let v=u!==null,C=g.length>0,x=!k&&v,j=!k&&C;x&&(F(re(e,Z),`${JSON.stringify(u,null,2)}
|
|
5
|
+
`),t?.invalidate([re(e,Z)]));let f=x||j;f&&R.push(...ne(e));let h=f&&r!==void 0;h&&r?.();let A=[];return v&&A.push(Z),C&&A.push(...g.map(m=>W(m.stem))),{written:f,restartScheduled:h,files:A,credentials:g,issues:R}}let o;async function s(){o=await V(e)}function c(u,g){return u.filter(R=>Array.isArray(R.path)).map(R=>{let k=R.path.map(String).join(".");return g!==""&&k.startsWith(g)&&k.length>g.length?k.slice(g.length):k}).filter(R=>R.length>0)}function w(u,g,R){if(!o)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let k=se(o);if(k==="blocked")throw new O("CONTRACTS_NOT_RESOLVED",503,B(o));if(k==="degraded"){g.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(o)});return}try{o.module.parseIntegrationsConfig(u)}catch(v){throw v instanceof Error&&Array.isArray(v.issues)?new O("VALIDATION_FAILED",400,"节点 schema 校验失败",c(v.issues,R)):new O("VALIDATION_FAILED",400,v instanceof Error?v.message:String(v))}}return{warmup:s,applyApp(u,g={}){Ve(u,"root"),rt(u,g,"root"),Te(u,te,"root");let R=[],k=Pe(e,t),v=k??{services:{}};k===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...v};for(let p of te)p in u||delete C[p];for(let[p,y]of Object.entries(u))C[p]=y;let x=typeof C.provider=="string"?C.provider:"app",j=qn(x,g.credentials,g.credentialsByInstance);for(let p of j)it(e,x,void 0,p.input,void 0,t);let f=j.find(p=>p.instanceId===void 0);if(g.credentials&&f&&(C.credentialRef=f.ref),g.credentialsByInstance){let p={...C.credentialRefByInstance??{}};for(let y of j)y.instanceId!==void 0&&(p[y.instanceId]=y.ref);C.credentialRefByInstance=p}je(C,k);let h=g.credentials!==void 0||g.credentialsByInstance!==void 0,A=tt(k,C);if(A&&!h)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};w(C,R,"");let m=g.dryRun===!0,d=Xe(e,j,m);return R.push(...en(C)),i(A?null:C,d,R,g.dryRun)},applyModule(u,g,R={}){Ve(g,"root");let{modules:k,catalog:v,ownership:C}=D(e,t),x=k.find(a=>a.id===u);if(!x)throw new O("MODULE_NOT_FOUND",404,`模块 ${u} 非已装模块`);if(!U({modules:k,catalog:v,ownership:C},x).writable)throw new O("VALIDATION_FAILED",400,`模块 ${u} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let f=[],h=Pe(e,t);if(h===null&&Object.keys(g).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};h===null&&f.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let A=h??{services:{}},m={...A.modules??{}},d={...m[u]??{}};Te(g,Me,`modules.${u}`);let p={...d};for(let a of Me){let l=g[a];l==null||l===""||typeof l=="object"&&!Array.isArray(l)&&Object.keys(l).length===0?delete p[a]:p[a]=l}Object.keys(p).length===0?delete m[u]:m[u]=p;let y={...A,modules:m};return je(y,h),ge(h,y)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f}:(w(y,f,`modules.${u}.`),f.push(...en(y)),i(y,[],f,R.dryRun))},applyService(u,g,R={}){Ve(g,"root"),rt(g,R,"slot"),Te(g,Xn,`services.${u}`);for(let[N,M]of Object.entries(g.instances??{}))Te(M,et,`services.${u}.instances.${N}`);let k=[],v=Pe(e,t),C=D(e,t);if(!fe(C.vocabulary,Object.keys(v?.services??{}),u,Object.keys(C.ownership)))throw new O("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);v===null&&k.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let x=v??{services:{}},j={...x.services??{}},f={...x,services:j};je(f,v),j[u]={...g};let h=g.provider,A=h!==null&&typeof h=="object"?h:void 0,m=typeof h=="string"?h:typeof A?.provider=="string"?A.provider:"app",d=u.includes(".")?u.slice(0,u.indexOf(".")):u,p=Qn(m,u,d,R.credentials,R.credentialsByInstance);for(let N of p)it(e,m,u,N.input,typeof A?.credentialType=="string"?A.credentialType:void 0,t);let y=j[u],a=p.find(N=>N.instanceId===void 0);if(R.credentials&&a&&(y.credentialRef=a.ref),R.credentialsByInstance){let N={...y.instances??{}};for(let M of p){if(M.instanceId===void 0)continue;let T={...N[M.instanceId]??{}};T.credentialRef=M.ref,N[M.instanceId]=T}y.instances=N}je(f,v);let l=R.credentials!==void 0||R.credentialsByInstance!==void 0,I=tt(v,f);if(I&&!l)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:k};w(f,k,`services.${u}.`);let S=R.dryRun===!0,E=Xe(e,p,S);return k.push(...en(f)),i(I?null:f,E,k,R.dryRun)},deleteService(u){let g=[],R=Pe(e,t),k=D(e,t);if(!fe(k.vocabulary,Object.keys(R?.services??{}),u,Object.keys(k.ownership)))throw new O("SERVICE_NOT_FOUND",404,`服务 ${u} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let v={...R?.services??{}};if(!(u in v))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:g};delete v[u];let C={...R??{services:{}},services:v};F(re(e,Z),`${JSON.stringify(C,null,2)}
|
|
6
|
+
`),t?.invalidate([re(e,Z)]),g.push(...ne(e));let x=r!==void 0;return x&&r?.(),{written:!0,restartScheduled:x,files:[Z],credentials:[],issues:g}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var ct=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...ct]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of ct)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function tn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let c of s.descriptor.declare.providers?.slots??[])c.local===!0&&t.push({service:c.service,provider:c.provider,implementation:c.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let c of t)i[c.service]={};F(n,`${JSON.stringify({...r,provider:s,services:i},null,2)}
|
|
7
|
+
`)}else{for(let s of t)i[s.service]={provider:s.provider,implementation:s.implementation};F(n,`${JSON.stringify({...r,services:i},null,2)}
|
|
8
|
+
`)}return{generated:!0,reason:"generated",services:t.map(s=>s.service).sort()}}var rn={provider:null,layer:null};function on(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:rn}function sn(e){let n=on(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:rn,inherited:rn}}function De(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?on(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function me(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?De(e,o).effective:on(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as wr}from"fs";import{join as pt}from"path";function dt(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function lt(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 _e(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var Sr=pt("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=pt(e.appDir,Sr),s={};if(yr(o))try{s=(e.cache?.read(o,u=>JSON.parse(u))??JSON.parse(wr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let c={};for(let[w,u]of Object.entries(i)){if(!u||typeof u!="object"||Array.isArray(u))continue;let g=u,R=g.type==="knowledge"?"knowledge":String(g.type??"knowledge"),k=typeof g.datasetId=="string"&&g.datasetId!==""?g.datasetId:void 0,v=typeof g.ref=="string"&&g.ref!==""?g.ref:void 0,C=k??(v!==void 0&&typeof s[v]?.datasetId=="string"?s[v].datasetId:null),x={type:R,...k!==void 0?{datasetId:k}:{},...v!==void 0?{ref:v}:{},resolvedDatasetId:C,...typeof g.topK=="number"?{topK:g.topK}:{},...typeof g.scoreThreshold=="number"?{scoreThreshold:g.scoreThreshold}:{}};c[w]=x}return Object.keys(c).length>0?c:null}function ut(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return ut(e.id).startsWith("provider-")||ut(e.pkg).startsWith("provider-")}function an(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 cn(e,n){let r=e.walk.modules.find(k=>k.id===n);if(!r)throw new O("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(k=>k.service)),o=(k,v)=>{let C=J(e.walk,k);return{service:k,name:C.name,...C.description!==void 0?{description:C.description}:{},required:v}},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))],c=e.integrations?.modules??{},w=c[n],u=w?{...typeof w.provider=="string"?{provider:w.provider}:{},...w.config&&typeof w.config=="object"&&!Array.isArray(w.config)?{config:w.config}:{}}:null,g=De(e.integrations,n),R={configured:g.configured,effective:g.effective,inherited:g.inherited,provider:g.effective.provider,layer:g.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,c),binding:R,configEditable:t.writable,services:s}}function dn(e){let n=lt(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:sn(t)}}function ln(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!fe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new O("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:me(e.integrations,e.walk,n)}}import{existsSync as mt,readFileSync as vt,realpathSync as ft}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as gt,sep as Ar}from"path";function un(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 pn(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,c=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!c)throw t?new O("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new O("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&c&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:c.credentialType});let w=ie(e,n,r,c?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:w,integrationSchemas:{configSchema:w}}}function ie(e,n,r,t){let i=e.walk.serviceSchemas[`${n}\0${r}`];return i?fn(e.appDir,i.packageDir,i.configSchema):typeof t=="string"?Cr(e.appDir,t):null}function fn(e,n,r){if(!r)return null;let t=kr(n,r);if(!mt(t))return null;try{return JSON.parse(vt(t,"utf8"))}catch{return null}}function Cr(e,n){let r=gt(e,"config","schemas"),t=gt(e,n),i=br(r,t);if(i===""||i.startsWith("..")||Ir(i))throw new O("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!mt(t))return null;let o,s;try{o=ft(r),s=ft(t)}catch{return null}if(s!==o&&!s.startsWith(o+Ar))throw new O("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(vt(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 yt(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 wt(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,c=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:c,implementation:o.effective.implementation,effective:{provider:c,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:yt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function St(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new O("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function gn(e,n,r){let t=St(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),c=i,u=t.normalizeInstances({instances:c?.instances,defaultInstanceId:c?.defaultInstanceId}).defaultInstanceId??"*",g=r?.evaluation??wt(n,t,e,u,s),R=yt(n,e,u),k=n.integrations?.services?.[e]?.provider,v=g.provider??(typeof k=="string"?k:typeof k=="object"&&k?String(k.provider):void 0),C={provider:v??null,layer:R??null},x=new Set(Object.keys(n.catalog.providers)),j=v!==void 0&&x.has(v)?Er(n.catalog,v,e):void 0,f=o.services[e],h=f!==void 0?!f.optional:void 0,A=n.walk.ownership[e];return{status:g.status,...g.statusMessage?{statusMessage:g.statusMessage}:{},binding:C,...v!==void 0?{provider:v}:{},...v!==void 0&&R!==null?{layer:R}:{},...j!==void 0?{supplied:j}:{},...A!==void 0?{module:A}:{},...h!==void 0?{required:h}:{}}}function Er(e,n,r){return _e(e,n,r)}function ve(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 ye(e,n,r){let t={};for(let i of ve(e))r&&!r.includes(i)||(t[i]=gn(i,e));return{contracts:$e(e.contracts),resolutions:t,issues:n}}function mn(e,n,r){let t=St(n),i=t.buildSupplyLookup(n.catalog),o=n.integrations,s=t.normalizeInstances({instances:o?.instances,defaultInstanceId:o?.defaultInstanceId}),c=s.instances.map(j=>j.id),w=n.integrations?.services?.[e],u=w?.instances?Object.keys(w.instances):void 0,g=ht(u,c),R=new Map;for(let j of g)R.set(j,wt(n,t,e,j,i));let k=g.map(j=>{let f=R.get(j);return{instanceId:j,status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},...f.effective?{effective:f.effective}:{}}}),v=Rt(n,e,s.defaultInstanceId??"*"),x={...gn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:k,inheritance:v};return{contracts:$e(n.contracts),resolution:x,issues:r.filter(j=>j.service===e)}}function ht(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 Rt(e,n,r){let t=e.integrations,i=t?.services?.[n],o=i?.instances?.[r]??i?.instances?.["*"],s=e.walk.ownership[n],c=s!==void 0?L(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...c.layer==="module"&&c.provider?{provider:c.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 we(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function It(e,n,r){let t=e.catalog.services[n],i=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:me(e.integrations,e.walk,n).effective,...i!==void 0?{module:i}:{},...t!==void 0?{required:!t.optional}:{}}}function Fe(e,n,r){let t=B(n),i={};for(let o of ve(e))r&&!r.includes(o)||(i[o]=It(e,o,t));return{contracts:$e(n),resolutions:i,issues:[]}}function kt(e,n,r){let t=B(r),i={...It(n,e,t),instances:Or(n,e),inheritance:Rt(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 ht(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 vn(e,n,r){if(!(n in e.catalog.providers))throw new O("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=ve(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new O("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(le(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function yn(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 Le(e){let n=[],r=!0,t=new Map;for(let[o,s]of Object.entries(e.services)){let c=s.configSchema;if(c===null){n.push(o);continue}if(!c||typeof c!="object"||Array.isArray(c))continue;let w=c;w.additionalProperties===!1&&(r=!1);let u=w.properties;if(!u||typeof u!="object"||Array.isArray(u))continue;let g=Array.isArray(w.required)?w.required:[];for(let R of Object.keys(u)){let k=t.get(R)??[];k.push({service:o,subschema:u[R],required:g.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:c,required:w})=>({service:c,required:w})),global:s.some(c=>!!c.subschema&&typeof c.subschema=="object"&&c.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function wn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:L(n.integrations,t.id).provider}var bt={integrationSchemas:null,integrationFieldRegistry:null};function At(e){return{...e,fields:e.fields.filter(n=>n.global)}}function Sn(e){let n=wn("app",e);if(n===null)return bt;let r=yn(e,n,le(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:At(Le(r))}}function hn(e,n){let r=wn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return bt;let i=(t.descriptor.declare.owns??[]).map(s=>s.service),o=yn(e,r,i.filter(s=>_e(e.catalog,r,s)));return{integrationSchemas:o,integrationFieldRegistry:At(Le(o))}}function Pr(e){return Sn(e).integrationSchemas}function Vr(e,n){return hn(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 Be(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function Rn(e,n){let r=Be(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Le(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:he(t.values)}}function In(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[c,w]of Object.entries(o.instances??{}))s.byInstance[c]=Se(e.appDir,w.credentialRef)??null;t[i]=s}return{app:r,services:t}}function kn(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?fn(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 bn(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 O("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 O("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new O("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new O("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=We(),t=Promise.resolve(),i={appDir:e,cache:r};function o(f){if(se(f)==="blocked")throw new O("CONTRACTS_NOT_RESOLVED",503,B(f))}function s(f){if(se(f)!=="ok")throw new O("CONTRACTS_NOT_RESOLVED",503,B(f))}function c(f){return dt(i,f)}function w(f){let h=f.integrations?.services;return h&&typeof h=="object"?Object.keys(h):[]}async function u(){let f=await V(e),h=c(f),A=h.integrations;if(A===null)return[];let m={resolveEffectiveService:g(f.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:g(f.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:g(f.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:f.module.RESOURCE_TYPE_IDS??[]},d=pe(e,h.walk,A,process.env);return ee({contracts:m,integrations:A,supplies:m.buildSupplyLookup(h.catalog),...d})}function g(f,h){if(typeof f!="function")throw new O("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${h} 缺席(形态异常)`);return f}function R(f){let h=t.then(f,f);return t=h.catch(()=>{}),h}let k={async loadModules(f){let h=await V(e);return an(c(h),f)},async loadModule(f,h){let A=bn("module",h?.include),m=await V(e),d=c(m),p=xe(d.walk,f),y=cn(d,p.id);if(A.has("serviceResolutions")){let a=[...new Set([...y.ownedServices,...y.services.map(l=>l.service)])];y.serviceResolutions=we(m)?await u().then(l=>ye(d,l,a)):Fe(d,m,a)}if(A.has("integrationSchemas")||A.has("integrationFieldRegistry")){let a=hn(d,p.id);A.has("integrationSchemas")&&(y.integrationSchemas=a.integrationSchemas),A.has("integrationFieldRegistry")&&(y.integrationFieldRegistry=a.integrationFieldRegistry)}return y},async loadApp(f){let h=bn("app",f?.include),A=await V(e),m=c(A),d=dn(m);if(h.has("serviceResolutions")&&(d.serviceResolutions=we(A)?await u().then(p=>ye(m,p)):Fe(m,A)),h.has("integrationSchemas")||h.has("integrationFieldRegistry")){let p=Sn(m);h.has("integrationSchemas")&&(d.integrationSchemas=p.integrationSchemas),h.has("integrationFieldRegistry")&&(d.integrationFieldRegistry=p.integrationFieldRegistry)}return d},async loadService(f,h){let A=bn("service",h?.include),m=await V(e),d=c(m),p=H(d.walk,w(d),f),y=ln(d,p);return A.has("integrationSchemas")&&(y.integrationSchemas=Be(d,p)),A.has("integrationFieldRegistry")&&(y.integrationFieldRegistry=Rn(d,p)),y},async loadServiceResolutions(f){let h=await V(e),A=c(h);if(!we(h))return Fe(A,h,f);let m=await u();return ye(A,m,f)},async loadServiceResolution(f){let h=await V(e),A=c(h),m=H(A.walk,w(A),f);if(!we(h))return kt(m,A,h);let d=await u();return mn(m,A,d)},async loadProviders(){let f=await V(e);return un(c(f))},async loadProviderSupply(f,h){Fr(h);let A=await V(e);return vn(c(A),f,h)},async loadProviderService(f,h){let A=await V(e),m=c(A),d=H(m.walk,w(m),h);return pn(m,f,d)},async loadCredentials(){let f=await V(e);return In(c(f))},async loadCredentialTypes(f){let h=await V(e);return kn(c(h),f)}},v=nn(e,{onApplied:n.onApplied,cache:r}),C={async writeAppIntegration(f,h){await v.warmup();let A=await V(e);return o(A),R(()=>v.applyApp(f,h))},async writeModuleIntegration(f,h,A){await v.warmup();let m=await V(e);return o(m),R(()=>{let d=xe(c(m).walk,f);return v.applyModule(d.id,h,A)})},async writeServiceIntegration(f,h,A){await v.warmup();let m=await V(e);return o(m),R(()=>{let d=c(m),p=H(d.walk,w(d),f);return v.applyService(p,h,A)})},async deleteServiceIntegration(f){await v.warmup();let h=await V(e);return o(h),R(()=>{let A=c(h),m=H(A.walk,w(A),f);return v.deleteService(m)})}},x={invalidate(){r.invalidate(),Ue(e)},async resolveContracts(){return V(e)},walkManifests(){return j(e)},parseModuleDescriptor(f){return ae(f)},loadProviderCatalogRaw(){return Ze(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(f){return R(()=>Br(e,f,r))},async ensureMockBindings(){return R(()=>tn(e))},async evaluateIntegrationServices(f){await v.warmup();let h=await V(e);s(h);let A={resolveEffectiveService:g(h.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:g(h.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:g(h.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:h.module.RESOURCE_TYPE_IDS??[]};return ee({...f,contracts:A})}};function j(f){return D(f,r)}return{...k,...C,...x}}function Br(e,n,r){let t=_r.join(e,"config","integrations.json");F(t,`${JSON.stringify(n,null,2)}
|
|
9
|
+
`),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,O as AppToolkitError,Me as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,sn as appProviderBinding,zt as assertValidModuleId,Le as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,pe as buildPredicateAssembly,Ye as checkInstanceKeys,Yt as collectDeclaredModules,B as contractsNotResolvedMessage,Lr as createAppToolkit,We as createFileCache,nn as createWriteCore,ir as credentialArtifactExists,ge as deepEqual,X as deriveStem,Kn as discoverContractPackages,Se as echoForRef,Dn as ensureDir,tn as ensureMockBindings,qe as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ke as expandEnvVars,zn as extractModuleIdFromSource,wn as formProviderOf,Ue as invalidateContractsResolver,K as isControlledInlineProvider,Ln as isValidModuleId,Pr as loadAppIntegrationSchemas,dn as loadAppView,kn as loadCredentialTypesView,In as loadCredentialsView,cn as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,an as loadModulesView,Ae as loadProviderCatalog,Ze as loadProviderCatalogRaw,pn as loadProviderServiceDetailView,vn as loadProviderSupplyView,un as loadProvidersView,ln as loadServiceDetailView,Rn as loadServiceFieldRegistry,Be as loadServiceIntegrationSchemas,mn as loadServiceResolutionDetail,ye as loadServiceResolutionsView,Ie as manifestPath,he as maskCredentialValues,En as moduleDependencySchema,Nn as moduleDescriptorSchema,U as moduleOwnershipWritable,De as moduleProviderBinding,An as pageContribSchema,ae as parseModuleDescriptor,le as providerFootprint,On as providerSlotContribSchema,cr as pruneIntegrationBindings,Fn as readAppManifest,Je as readAppManifestFull,ce as readCredentialFile,G as readIntegrationsConfig,Zn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Yn as refToEnvKey,Wt as removeNpmModule,ve as resolutionKeys,V as resolveContractsForApp,V as resolveContractsForAppExport,yn as resolveLayerIntegrationSchemas,L as resolveModuleBinding,xe as resolveModuleKey,H as resolveServiceKey,gn as resolveServiceSummary,jn as resourceNeedContribSchema,xn as serviceConsumeContribSchema,Mn as serviceOwnContribSchema,me as serviceProviderBinding,W as stemToFilePath,Tt as stemToRef,Cn as tabContribSchema,Kt as updateNpmModule,Ut as upsertMiniappContainer,Bt as upsertNpmModule,D as walkManifests,Lt as writeAppManifest,F as writeAtomic,ze as writeCredentialFile};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tbox.cn/app-toolkit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "1.0.0-alpha.1",
|
|
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.
|
|
21
|
+
"@tbox.cn/app-contracts": "1.0.0-alpha.1",
|
|
22
22
|
"typescript": "5.9.3",
|
|
23
23
|
"tsup": "8.5.1",
|
|
24
24
|
"vitest": "4.1.10",
|
|
@@ -2,12 +2,13 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
|
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
|
-
* .tbox/app.json
|
|
6
|
-
*
|
|
7
|
-
*
|
|
5
|
+
* .tbox/app.json manifest 读写(自 CLI manifest.ts 迁入——assembly 层目录知识单源)。
|
|
6
|
+
*
|
|
7
|
+
* 1.0 兼容面:appKind / schemaVersion 为 additive optional;写回保留未知字段。
|
|
8
8
|
*/
|
|
9
9
|
|
|
10
10
|
export type ModuleMode = 'local' | 'sdk' | 'codegen';
|
|
11
|
+
export type AppKind = 'agent' | 'web';
|
|
11
12
|
|
|
12
13
|
export interface NpmModuleEntry {
|
|
13
14
|
/** 模块短 id(如 "module-member"),装配别名来源 */
|
|
@@ -20,17 +21,18 @@ export interface NpmModuleEntry {
|
|
|
20
21
|
mode: ModuleMode;
|
|
21
22
|
/** 3-way merge 基线(codegen 模式) */
|
|
22
23
|
baseVersion?: string;
|
|
23
|
-
/**
|
|
24
|
-
* 条目类别(单一模板统一化):'ui-kit' = 壳 UI 组件包——create 全量继承后
|
|
25
|
-
* 不再承担保留判据(模板 manifest = 出厂装配真源);现职 = update 三方合并锚 +
|
|
26
|
-
* sync-agent-ui-kit 副本 identity 标记(由该脚本派生维护)。
|
|
27
|
-
*/
|
|
24
|
+
/** 条目类别 */
|
|
28
25
|
kind?: 'ui-kit';
|
|
29
26
|
}
|
|
30
27
|
|
|
31
28
|
export interface AppManifest {
|
|
32
29
|
templateVersion: string;
|
|
33
30
|
npmModules: NpmModuleEntry[];
|
|
31
|
+
/** 1.0:应用类型;旧 manifest 缺席(按 agent 兼容读,不写回)。 */
|
|
32
|
+
appKind?: AppKind;
|
|
33
|
+
/** 1.0:manifest schema 版本。 */
|
|
34
|
+
schemaVersion?: 1;
|
|
35
|
+
[key: string]: unknown;
|
|
34
36
|
}
|
|
35
37
|
|
|
36
38
|
export function manifestPath(appDir: string): string {
|
|
@@ -42,40 +44,55 @@ export function readAppManifest(appDir: string): AppManifest | null {
|
|
|
42
44
|
const file = manifestPath(appDir);
|
|
43
45
|
if (!existsSync(file)) return null;
|
|
44
46
|
try {
|
|
45
|
-
const raw = JSON.parse(readFileSync(file, 'utf8'))
|
|
47
|
+
const raw = JSON.parse(readFileSync(file, 'utf8')) as Record<string, unknown>;
|
|
46
48
|
const templateVersion = raw?.templateVersion;
|
|
49
|
+
const appKind = raw?.appKind;
|
|
47
50
|
if (typeof templateVersion !== 'string' || templateVersion.trim().length === 0) return null;
|
|
51
|
+
if (appKind !== undefined && appKind !== 'agent' && appKind !== 'web') return null;
|
|
52
|
+
if (raw?.schemaVersion !== undefined && raw.schemaVersion !== 1) return null;
|
|
48
53
|
return {
|
|
54
|
+
...raw,
|
|
49
55
|
templateVersion: templateVersion.trim(),
|
|
50
|
-
npmModules: Array.isArray(raw?.npmModules) ? raw.npmModules : [],
|
|
56
|
+
npmModules: Array.isArray(raw?.npmModules) ? (raw.npmModules as NpmModuleEntry[]) : [],
|
|
57
|
+
...(appKind === 'agent' || appKind === 'web' ? { appKind } : {}),
|
|
58
|
+
...(raw?.schemaVersion === 1 ? { schemaVersion: 1 as const } : {}),
|
|
51
59
|
};
|
|
52
60
|
} catch {
|
|
53
61
|
return null;
|
|
54
62
|
}
|
|
55
63
|
}
|
|
56
64
|
|
|
57
|
-
/** 写应用 manifest
|
|
65
|
+
/** 写应用 manifest(目录缺席物化;同步——写核心串行队列内使用;保留未知字段) */
|
|
58
66
|
export function writeAppManifest(appDir: string, manifest: AppManifest): void {
|
|
59
67
|
const file = manifestPath(appDir);
|
|
60
68
|
mkdirSync(path.dirname(file), { recursive: true });
|
|
61
|
-
|
|
69
|
+
let existing: Record<string, unknown> = {};
|
|
70
|
+
if (existsSync(file)) {
|
|
71
|
+
try {
|
|
72
|
+
const parsed = JSON.parse(readFileSync(file, 'utf8')) as unknown;
|
|
73
|
+
if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) existing = parsed as Record<string, unknown>;
|
|
74
|
+
} catch {
|
|
75
|
+
existing = {};
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
const output: Record<string, unknown> = { ...existing, ...manifest };
|
|
79
|
+
// 1.0 最小 manifest:空 npmModules / miniappContainers 不落盘(readAppManifest 仍归一为 [])。
|
|
80
|
+
if (Array.isArray(output.npmModules) && output.npmModules.length === 0) delete output.npmModules;
|
|
81
|
+
if (Array.isArray(output.miniappContainers) && output.miniappContainers.length === 0) delete output.miniappContainers;
|
|
82
|
+
writeFileSync(file, `${JSON.stringify(output, null, 2)}\n`, 'utf8');
|
|
62
83
|
}
|
|
63
84
|
|
|
64
85
|
// ── CLI manifest 全表面(C5 迁入——upsert/remove/miniapp 容器/模块 id 合法性)──
|
|
65
86
|
|
|
66
87
|
/** 小程序容器登记项(miniapp-container init 写入;与 npmModules 正交,不参与装配/doctor) */
|
|
67
88
|
export interface MiniappContainerEntry {
|
|
68
|
-
/** 平台 id:'alipay' / 'weapp'(= CLI platform 参数,展开目录名后缀) */
|
|
69
89
|
id: string;
|
|
70
|
-
/** 源包名(@tbox.cn/app-miniapp-container-*) */
|
|
71
90
|
package: string;
|
|
72
91
|
version: string;
|
|
73
|
-
/** 展开目录(相对应用根,如 'apps/miniapp-container-alipay') */
|
|
74
92
|
dir: string;
|
|
75
93
|
}
|
|
76
94
|
|
|
77
95
|
export interface AppManifestFull extends AppManifest {
|
|
78
|
-
/** 已初始化的小程序容器(可选——旧 manifest 无此字段,读侧归一为 []) */
|
|
79
96
|
miniappContainers?: MiniappContainerEntry[];
|
|
80
97
|
}
|
|
81
98
|
|
|
@@ -122,15 +139,10 @@ export function updateNpmModule(
|
|
|
122
139
|
};
|
|
123
140
|
}
|
|
124
141
|
|
|
125
|
-
/**
|
|
126
|
-
* 模块 id 合法性:小写字母/数字开头,单词段以单个中划线分隔(无连续/尾部中划线),
|
|
127
|
-
* 防路径穿越/目录注入,并保证 camelCaseId 派生别名唯一(a-b 与 a--b 不允许共存碰撞)。
|
|
128
|
-
*/
|
|
129
142
|
export function isValidModuleId(id: string): boolean {
|
|
130
143
|
return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(id) && !id.includes('..');
|
|
131
144
|
}
|
|
132
145
|
|
|
133
|
-
/** 校验失败抛出(统一错误信息) */
|
|
134
146
|
export function assertValidModuleId(id: string, source: string): void {
|
|
135
147
|
if (!isValidModuleId(id)) {
|
|
136
148
|
throw new Error(`非法模块 id "${id}"(来自 ${source}):仅允许小写字母/数字/中划线`);
|
|
@@ -459,6 +459,56 @@ export function walkManifests(appDir: string, cache?: FileCache): WalkManifestsR
|
|
|
459
459
|
};
|
|
460
460
|
};
|
|
461
461
|
|
|
462
|
+
|
|
463
|
+
// 通道 0:modules/* 源码根(1.0 A-lite;优先于 packages/node_modules)
|
|
464
|
+
const modulesRoot = join(appDir, 'modules');
|
|
465
|
+
const devRedirectDirs = new Set(readDevManifestRedirects(appDir).map((redirect) => redirect.dir));
|
|
466
|
+
if (existsSync(modulesRoot)) {
|
|
467
|
+
let entries: string[] = [];
|
|
468
|
+
try {
|
|
469
|
+
entries = readdirSync(modulesRoot, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
|
|
470
|
+
} catch {
|
|
471
|
+
/* ignore */
|
|
472
|
+
}
|
|
473
|
+
for (const name of entries) {
|
|
474
|
+
if (seen.has(name)) continue;
|
|
475
|
+
const dir = join(modulesRoot, name);
|
|
476
|
+
if (devRedirectDirs.has(dir)) continue;
|
|
477
|
+
const manifest = readManifestFile(join(dir, 'tbox.module.json'), cache);
|
|
478
|
+
if (manifest?.kind === 'legacy') {
|
|
479
|
+
pushLegacyIssue(manifest, name);
|
|
480
|
+
seen.add(name);
|
|
481
|
+
continue;
|
|
482
|
+
}
|
|
483
|
+
if (!manifest) continue;
|
|
484
|
+
const modId = manifest.id ?? name;
|
|
485
|
+
if (seen.has(modId)) continue;
|
|
486
|
+
seen.add(modId);
|
|
487
|
+
const declare = declareOf(manifest);
|
|
488
|
+
let pkg = `@app/${modId}`;
|
|
489
|
+
try {
|
|
490
|
+
const pkgFile = join(dir, 'package.json');
|
|
491
|
+
if (existsSync(pkgFile)) {
|
|
492
|
+
const parsed = JSON.parse(readFileSync(pkgFile, 'utf8')) as { name?: unknown };
|
|
493
|
+
if (typeof parsed.name === 'string' && parsed.name.length > 0) pkg = parsed.name;
|
|
494
|
+
}
|
|
495
|
+
} catch {
|
|
496
|
+
/* ignore */
|
|
497
|
+
}
|
|
498
|
+
if (manifest.kind === 'strict') {
|
|
499
|
+
modules.push({ id: modId, dir, pkg, descriptor: manifest.descriptor });
|
|
500
|
+
}
|
|
501
|
+
const slots = declare?.providers?.slots ?? [];
|
|
502
|
+
const selfId = declare?.providers?.id;
|
|
503
|
+
if (selfId) ensureSelfVendor(selfId, pkg, modMetaOf(manifest));
|
|
504
|
+
if (slots.length) addSlots(slots, pkg, dir, modMetaOf(manifest), selfId);
|
|
505
|
+
const consumes = declare?.consumes ?? [];
|
|
506
|
+
for (const need of consumes) addServiceConsume(need, pkg);
|
|
507
|
+
const owns = manifest.kind === 'strict' ? manifest.descriptor.declare.owns : [];
|
|
508
|
+
if (owns.length) addOwns(owns.map((o) => o.service), modId);
|
|
509
|
+
}
|
|
510
|
+
}
|
|
511
|
+
|
|
462
512
|
// 通道 1:npmModules 登记(packages/<id> 本地优先 → node_modules/<pkg>)
|
|
463
513
|
for (const entry of readNpmModules(appDir)) {
|
|
464
514
|
if (seen.has(entry.id)) continue;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { readFileSync } from 'node:fs';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import * as toolkit from '../src/index.js';
|
|
5
|
+
|
|
6
|
+
describe('app-toolkit API compatibility', () => {
|
|
7
|
+
it('root exports match the frozen snapshot', () => {
|
|
8
|
+
const snapshot = JSON.parse(readFileSync(join(__dirname, '..', 'api.snapshot.json'), 'utf8')) as {
|
|
9
|
+
rootExports: string[];
|
|
10
|
+
};
|
|
11
|
+
expect(Object.keys(toolkit).sort()).toEqual(snapshot.rootExports);
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
it('AppManifest keeps appKind write-back compatibility', async () => {
|
|
15
|
+
const { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync } = await import('node:fs');
|
|
16
|
+
const { tmpdir } = await import('node:os');
|
|
17
|
+
const root = mkdtempSync(join(tmpdir(), 'tbox-toolkit-api-'));
|
|
18
|
+
try {
|
|
19
|
+
mkdirSync(join(root, '.tbox'), { recursive: true });
|
|
20
|
+
writeFileSync(join(root, '.tbox/app.json'), JSON.stringify({ templateVersion: '1.0.0', appKind: 'web', schemaVersion: 1, npmModules: [], extra: 1 }));
|
|
21
|
+
const manifest = toolkit.readAppManifest(root);
|
|
22
|
+
expect(manifest?.appKind).toBe('web');
|
|
23
|
+
toolkit.writeAppManifest(root, manifest!);
|
|
24
|
+
const raw = JSON.parse(readFileSync(join(root, '.tbox/app.json'), 'utf8')) as Record<string, unknown>;
|
|
25
|
+
expect(raw.appKind).toBe('web');
|
|
26
|
+
expect(raw.schemaVersion).toBe(1);
|
|
27
|
+
expect(raw.extra).toBe(1);
|
|
28
|
+
} finally {
|
|
29
|
+
rmSync(root, { recursive: true, force: true });
|
|
30
|
+
}
|
|
31
|
+
});
|
|
32
|
+
});
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { describe, it, expect, afterEach } from 'vitest';
|
|
2
|
+
import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync } from 'node:fs';
|
|
3
|
+
import { tmpdir } from 'node:os';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { walkManifests } from '../src/assembly/walk-manifests.js';
|
|
6
|
+
import { readAppManifest, writeAppManifest } from '../src/assembly/app-manifest.js';
|
|
7
|
+
|
|
8
|
+
const roots: string[] = [];
|
|
9
|
+
afterEach(() => {
|
|
10
|
+
for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true });
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
function write(file: string, content: string): void {
|
|
14
|
+
mkdirSync(join(file, '..'), { recursive: true });
|
|
15
|
+
writeFileSync(file, content);
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
function makeApp(): string {
|
|
19
|
+
const root = mkdtempSync(join(tmpdir(), 'tbox-toolkit-v1-'));
|
|
20
|
+
roots.push(root);
|
|
21
|
+
write(join(root, '.tbox/app.json'), JSON.stringify({ templateVersion: '1.0.0', appKind: 'agent', schemaVersion: 1, npmModules: [], customField: 'keep' }, null, 2));
|
|
22
|
+
mkdirSync(join(root, 'modules'), { recursive: true });
|
|
23
|
+
return root;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function descriptor(id: string): string {
|
|
27
|
+
return JSON.stringify({ schemaVersion: 1, id, version: '1.0.0', declare: {}, dependencies: { modules: [] }, env: [] }, null, 2);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
describe('app-toolkit 1.0 compatibility', () => {
|
|
31
|
+
it('discovers modules/<id> without package.json', () => {
|
|
32
|
+
const root = makeApp();
|
|
33
|
+
write(join(root, 'modules/refund/tbox.module.json'), descriptor('refund'));
|
|
34
|
+
const walk = walkManifests(root);
|
|
35
|
+
expect(walk.modules.map((m) => m.id)).toEqual(['refund']);
|
|
36
|
+
expect(walk.modules[0]?.pkg).toBe('@app/refund');
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
it('prefers modules/ over packages/ for the same id', () => {
|
|
40
|
+
const root = makeApp();
|
|
41
|
+
write(join(root, 'modules/refund/tbox.module.json'), descriptor('refund'));
|
|
42
|
+
write(join(root, 'packages/refund/tbox.module.json'), descriptor('refund'));
|
|
43
|
+
const walk = walkManifests(root);
|
|
44
|
+
expect(walk.modules).toHaveLength(1);
|
|
45
|
+
expect(walk.modules[0]?.dir).toContain('/modules/refund');
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
it('reads and preserves appKind and unknown fields when writing', () => {
|
|
49
|
+
const root = makeApp();
|
|
50
|
+
const before = readAppManifest(root);
|
|
51
|
+
expect(before?.appKind).toBe('agent');
|
|
52
|
+
expect(before?.schemaVersion).toBe(1);
|
|
53
|
+
writeAppManifest(root, { ...before!, npmModules: [] });
|
|
54
|
+
const raw = JSON.parse(readFileSync(join(root, '.tbox/app.json'), 'utf8')) as Record<string, unknown>;
|
|
55
|
+
expect(raw.appKind).toBe('agent');
|
|
56
|
+
expect(raw.schemaVersion).toBe(1);
|
|
57
|
+
expect(raw.customField).toBe('keep');
|
|
58
|
+
});
|
|
59
|
+
});
|