@tbox.cn/app-toolkit 0.8.6 → 0.8.7

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