@tbox.cn/app-toolkit 0.8.2 → 0.8.3

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
@@ -159,6 +159,8 @@ declare const resourceNeedContribSchema: z.ZodObject<{
159
159
  id: string;
160
160
  }>;
161
161
  declare const moduleDescriptorSchema: z.ZodObject<{
162
+ $comment: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
163
+ $schema: z.ZodOptional<z.ZodString>;
162
164
  schemaVersion: z.ZodDefault<z.ZodNumber>;
163
165
  id: z.ZodString;
164
166
  name: z.ZodOptional<z.ZodString>;
@@ -519,12 +521,16 @@ declare const moduleDescriptorSchema: z.ZodObject<{
519
521
  env: string[];
520
522
  name?: string | undefined;
521
523
  description?: string | undefined;
524
+ $comment?: string | Record<string, unknown> | undefined;
525
+ $schema?: string | undefined;
522
526
  hidden?: boolean | undefined;
523
527
  }, {
524
528
  id: string;
525
529
  schemaVersion?: number | undefined;
526
530
  name?: string | undefined;
527
531
  description?: string | undefined;
532
+ $comment?: string | Record<string, unknown> | undefined;
533
+ $schema?: string | undefined;
528
534
  hidden?: boolean | undefined;
529
535
  version?: string | undefined;
530
536
  kind?: "platform" | "business" | "third-party" | undefined;
@@ -950,6 +956,9 @@ interface EvaluationExports {
950
956
  RESOURCE_TYPE_IDS: readonly string[];
951
957
  /** 严格 zod 面(0.9+ 可选)——strictValidation 门控判据;缺席 = 求值/写 503 */
952
958
  parseIntegrationsConfig?: (raw: unknown) => IntegrationsConfig;
959
+ /** integrations.json 根 zod schema(additive;`schema` 命令生成形状文档用——不并入
960
+ * evaluation/strict 判据,旧 contracts 缺席时仅形状文档降级) */
961
+ integrationsSchema?: unknown;
953
962
  }
954
963
  /** resolver 运行时产物类型(动态 import 的命名导出子集) */
955
964
  type ResolvedModule = Partial<EvaluationExports>;
@@ -1242,6 +1251,9 @@ interface ServiceResolutionDetail {
1242
1251
  }
1243
1252
  /** root 节点 */
1244
1253
  interface AppIntegrationNode {
1254
+ /** 元键(类型可选、行为惰性——文档指针;GET 回显、PUT 仅保活,noDiff 排除) */
1255
+ $comment?: string | Record<string, unknown>;
1256
+ $schema?: string;
1245
1257
  /** 恒字符串(app/module 级无内联形态) */
1246
1258
  provider?: string;
1247
1259
  config?: Record<string, unknown>;
@@ -1259,7 +1271,7 @@ interface AppIntegrationNode {
1259
1271
  /** AppIntegrationNode 键集单源(runtime const——write applyApp 全量替换白名单
1260
1272
  * (缺席根键删除;services/modules 域不在其中;v6 domains 键退役)+ views/app 投影
1261
1273
  * (GET 预填 ≡ PUT body,/L1——文件含 services/modules 但 root 节点投影只含本键集)) */
1262
- declare const APP_INTEGRATION_NODE_KEYS: readonly ["provider", "config", "configByInstance", "credentialRef", "credentialRefByInstance", "instances", "defaultInstanceId"];
1274
+ declare const APP_INTEGRATION_NODE_KEYS: readonly ["$comment", "$schema", "provider", "config", "configByInstance", "credentialRef", "credentialRefByInstance", "instances", "defaultInstanceId"];
1263
1275
  /** 模块集成位节点(v6——provider 绑定默认 + config 级联层;resources 不投影不写——
1264
1276
  * 集成位编辑恒保全资源节,N2) */
1265
1277
  interface ModuleIntegrationNode {
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- import{a as Le,b as ae,c as N,d as Be}from"./chunk-K5FIGT5A.js";import{z as k}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,wt=k.object({cardType:k.string(),schemaVersion:k.number().optional()}),kn=k.object({route:k.string(),component:k.string()}),bn=k.object({route:k.string(),label:k.string().optional(),icon:k.string().optional(),order:k.number().optional()}),Cn=k.object({id:k.string(),range:k.string().optional(),required:k.boolean().default(!0)}),An=k.object({service:k.string(),provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string(),credentialType:k.string(),local:k.boolean().optional(),configSchema:k.string().optional(),credentialSchema:k.string().optional()}),En=k.object({service:k.string(),optional:k.boolean().default(!0),defaults:k.array(k.object({provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string()})).default([]),name:k.string().optional(),description:k.string().optional()}),On=k.object({service:k.string()}).strict(),xn=k.object({id:k.string(),type:k.string()}),Mn=k.object({schemaVersion:k.number().default(1),id:k.string(),name:k.string().optional(),description:k.string().optional(),hidden:k.boolean().optional(),version:k.string().default("0.0.0"),kind:k.enum(["platform","business","third-party"]).default("business"),risk:k.object({level:k.enum(["high","medium","low"]).default("low"),writeBoundary:k.enum(["sdk-enforced","source"]).default("source")}).default({}),distribution:k.object({defaultMode:k.enum(["hybrid","sdk","codegen","local"]).default("codegen")}).default({}),declare:k.object({handlers:k.array(k.string()).default([]),tools:k.array(k.string()).default([]),cards:k.array(wt).default([]),routes:k.array(k.string()).default([]),pages:k.array(kn).default([]),tabs:k.array(bn).default([]),providers:k.object({id:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").optional(),slots:k.array(An).default([])}).default({}),owns:k.array(On).default([]),consumes:k.array(En).default([]),resources:k.array(xn).default([])}).default({}),dependencies:k.object({modules:k.array(Cn).default([])}).default({}),env:k.array(k.string()).default([])}).strict();function ht(e){if(!e||typeof e!="object"||Array.isArray(e))return[];let n=[],r=e;"contributes"in r&&n.push("(root): manifest 旧键 `contributes` 已更名 `declare`(v6 声明面)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let t=r.declare;t&&typeof t=="object"&&!Array.isArray(t)&&"services"in t&&n.push("declare: manifest 旧键 `declare.services` 已更名 `declare.consumes`(消费关系定向化)——同上三路径升级"),!("id"in r)&&"name"in r&&n.push("(root): manifest 标识键 `name` 已更名 `id`(v7 词汇统一)——codegen 副本经 `module update --source` 重新生成 / sdk 模式升级模块包 / 手改两键");let o=t&&typeof t=="object"&&!Array.isArray(t)?t:void 0,i=Array.isArray(o?.consumes)&&o.consumes.some(s=>s!==null&&typeof s=="object"&&"title"in s);return("title"in r||i)&&n.push("(root): manifest 展示名键 `title` 已更名 `name`(v7 词汇统一;declare.consumes[].title 同步改 name)——同上三路径升级"),n}function ce(e){let n=ht(e);if(n.length>0)return{ok:!1,errors:n,legacy:!0};let r=Mn.safeParse(e);return r.success?{ok:!0,value:r.data}:{ok:!1,errors:r.error.issues.map(t=>`${t.path.join(".")||"(root)"}: ${t.message}`)}}var Rt=/\$\$?\{([A-Z][A-Z0-9_]*)(?::-([^}]*))?\}/g;function jn(e){return JSON.stringify(e).slice(1,-1)}function We(e,n=process.env){let r=[],t=e.replace(Rt,(o,i,s)=>{if(o.startsWith("$$"))return o.slice(1);let l=n[i];return l!==void 0?jn(l):s!==void 0?jn(s):(r.push(i),o)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as It,existsSync as Tn,readFileSync as kt,writeFileSync as bt}from"fs";import{dirname as Ct,join as Nn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,o){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=o}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function At(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function de(e,n){let r=Nn(e,W(n));if(!Tn(r))return null;try{let t=JSON.parse(kt(r,"utf8"));if(typeof t.type!="string")return null;let{type:o,...i}=t,s={};for(let[l,y]of Object.entries(i))typeof y=="string"&&(s[l]=y);return{type:o,values:s}}catch{return null}}function Ue(e,n,r){let t=Nn(e,W(n)),o=Tn(t);return It(Ct(t),{recursive:!0}),bt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
- `,"utf8"),o}import{mkdirSync as Et,renameSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt}from"path";function F(e,n){Pn(Mt(e));let r=`${e}.tmp-${process.pid}-${Date.now()}`;xt(r,n,"utf8"),Ot(r,e)}function Pn(e){Et(e,{recursive:!0})}import{existsSync as _,readdirSync as ze,readFileSync as X}from"fs";import{join as V}from"path";import{existsSync as jt,readFileSync as Vn,mkdirSync as Tt,writeFileSync as Nt}from"fs";import Dn from"path";function Re(e){return Dn.join(e,".tbox","app.json")}function _n(e){let n=Re(e);if(!jt(n))return null;try{let r=JSON.parse(Vn(n,"utf8")),t=r?.templateVersion;return typeof t!="string"||t.trim().length===0?null:{templateVersion:t.trim(),npmModules:Array.isArray(r?.npmModules)?r.npmModules:[]}}catch{return null}}function Pt(e,n){let r=Re(e);Tt(Dn.dirname(r),{recursive:!0}),Nt(r,`${JSON.stringify(n,null,2)}
3
- `,"utf8")}function Ke(e){let n=_n(e);if(n===null)return null;let r=Re(e);try{let t=JSON.parse(Vn(r,"utf8"));return{...n,miniappContainers:Array.isArray(t?.miniappContainers)?t.miniappContainers:[]}}catch{return{...n,miniappContainers:[]}}}function Vt(e,n){let r=e.npmModules.filter(t=>t.id!==n.id);return{...e,npmModules:[...r,n]}}function Dt(e,n){return{...e,npmModules:e.npmModules.filter(r=>r.id!==n)}}function _t(e,n){let r=(e.miniappContainers??[]).filter(t=>t.id!==n.id);return{...e,miniappContainers:[...r,n]}}function Ft(e,n,r){return{...e,npmModules:e.npmModules.map(t=>t.id===n?{...t,...r}:t)}}function Fn(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function $t(e,n){if(!Fn(e))throw new Error(`非法模块 id "${e}"(来自 ${n}):仅允许小写字母/数字/中划线`)}function $n(e){try{let n=JSON.parse(e);if(!Array.isArray(n.slots))return null;let r=n.slots.filter(o=>typeof o=="string"),t={};if(n.meta&&typeof n.meta=="object"&&!Array.isArray(n.meta))for(let[o,i]of Object.entries(n.meta)){if(!i||typeof i!="object"||Array.isArray(i))continue;let{name:s,description:l}=i,y={};typeof s=="string"&&s.length>0&&(y.name=s),typeof l=="string"&&l.length>0&&(y.description=l),(y.name!==void 0||y.description!==void 0)&&(t[o]=y)}return{slots:r,meta:t}}catch{return null}}function Ie(e,n){let r=t=>{try{let o=JSON.parse(t),i=ce(o);if(i.ok)return{kind:"strict",id:i.value.id,version:i.value.version,descriptor:i.value,declare:i.value.declare};if(i.legacy)return{kind:"legacy",detail:i.errors.join("; ")};if(o&&typeof o=="object"&&"declare"in o){let s=o;return{kind:"loose",...typeof s.id=="string"?{id:s.id}:{},declare:{providers:s.declare?.providers,consumes:s.declare?.consumes}}}return null}catch{return null}};if(n)return n.read(e,r)??null;if(!_(e))return null;try{return r(X(e,"utf8"))}catch{return null}}function Lt(e){let n=V(e,".tbox","app.json");if(!_(n))return[];try{let r=JSON.parse(X(n,"utf8"));return Array.isArray(r.npmModules)?r.npmModules.filter(t=>!!t&&typeof t=="object"&&typeof t.id=="string"&&typeof t.package=="string"):[]}catch{return[]}}function Bt(e){let n=V(e,".tbox-dev.local"),r=V(n,"dev-manifest.json");if(!_(r))return[];try{let t=JSON.parse(X(r,"utf8")),o=[];for(let[i,s]of Object.entries(t.redirects??{}))typeof s!="string"||!i.startsWith("@tbox.cn/app-")||o.push({pkg:i,dir:V(n,s)});return o}catch{return[]}}function Bn(e,n){let r=[],t=[e];for(let l of["apps","packages"]){let y=V(e,l);if(_(y))try{for(let d of ze(y,{withFileTypes:!0}))d.isDirectory()&&t.push(V(y,d.name))}catch{}}let o=new Set,i=(l,y,d)=>{let f=n?n.read(y,$n):$n(X(y,"utf8"));f!=null&&r.push({dir:l,slots:f.slots,meta:f.meta,via:d})},s=V(e,"config","service-slots.json");_(s)&&i(e,s,"config-override");for(let l of t){let y=V(l,"node_modules","@tbox.cn");if(!_(y))continue;let d=[];try{d=ze(y)}catch{continue}for(let f of d){let R=V(y,f);if(o.has(R))continue;o.add(R);let I=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(I)?i(R,I,"package"):_(g)&&i(R,g,"package")}}for(let l of t)for(let y of[V(l,"service-slots.json"),V(l,"src","service-slots.json")])_(y)&&i(l,y,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},o={},i=[],s={},l=new Set,y=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let S=t.providers[w.provider]??={},C=S[w.implementation];C?C.services.includes(w.service)||C.services.push(w.service):(S[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let b=`${w.provider}\0${w.service}`;o[b]||(o[b]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},d=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&i.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},I=(a,m)=>{a.kind==="legacy"&&i.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,A=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let S=`${c.provider}\0${c.implementation}`;w.has(S)||(v.defaults.push(c),w.add(S))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of Lt(e)){if(l.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,a.id),l.add(a.id);continue}if(!u)continue;l.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&d(S,a.package,f(u)),c.length&&y(c,a.package,v,f(u),S);let C=w?.consumes??[];for(let x of C)A(x,a.package);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),a.id)}for(let{pkg:a,dir:m}of Bt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){I(h,a);continue}if(!h?.id||l.has(h.id))continue;l.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&d(w,a,f(h)),v.length&&y(v,a,m,f(h),w);let c=u?.consumes??[];for(let C of c)A(C,a);let S=h.kind==="strict"?h.descriptor.declare.owns:[];S.length&&R(S.map(C=>C.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=ze(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(l.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,m),l.add(m);continue}if(!u)continue;let v=u.id??m;if(l.has(v))continue;l.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&d(S,`@app/${v}`,f(u)),c.length&&y(c,`@app/${v}`,h,f(u),S);let C=w?.consumes??[];for(let x of C)A(x,`@app/${v}`);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),v)}}let M=new Set,p={};for(let a of Bn(e,n)){for(let m of a.slots)M.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:o,vocabulary:[...M].sort(),slotMeta:p,ownership:s,declarationIssues:i}}function Ln(e,n,r){let t=V(e,"src",n,"index.ts");if(!_(t))return!1;try{let o=X(t,"utf8");return new RegExp(`export\\s+const\\s+${r}\\b`).test(o)}catch{return!1}}function Wt(e){let n=V(e,"src","server","index.ts");if(!_(n))return"";try{return X(n,"utf8")}catch{return""}}function Wn(e){return e.match(/declaration\s*:\s*\{[\s\S]*?moduleId\s*:\s*['"]([^'"]+)['"]/)?.[1]}function Ut(e){let n=[],r=D(e),t=Ke(e),o=new Map;for(let i of t?.npmModules??[])o.set(i.id,i.mode);for(let i of r.modules){let s=o.get(i.id)??"local",l=Ln(i.dir,"server","serverModule"),y=i.descriptor.declare;n.push({id:i.id,pkg:s==="sdk"?i.pkg:`@app/${i.id}`,mode:s,hasServerEntry:l,hasClientEntry:Ln(i.dir,"client","clientModule"),hasCards:(y.cards?.length??0)>0,...l?{moduleId:Wn(Wt(i.dir))}:{}})}return n.sort((i,s)=>i.id.localeCompare(s.id))}function Kt(e){return D(e).ownership}function $(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function le(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(o=>r.has(o)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Un(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Ge(e,n){let r=new Set(n),t=[],o=(i,s)=>{let l=Un(i,s,r);l&&t.push(l)};for(let i of Object.keys(e.configByInstance??{}))o(i,"configByInstance");for(let i of Object.keys(e.credentialRefByInstance??{}))o(i,"credentialRefByInstance");for(let[i,s]of Object.entries(e.services??{}))for(let l of Object.keys(s.instances??{}))o(l,`services.${i}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:o,demandedServices:i,supplies:s,malls:l,credentialSchemaMissing:y,vendorConfigKeys:d,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:I,credentialFileType:g,realmSwitchHints:A,moduleResourceNeeds:O,ownership:M,installedModuleIds:p}=e,a=l?new Set(l):void 0;for(let c of A??[])n.push({severity:"warning",code:"REALM_SWITCH_HINT",message:c});let m=new Set(Object.keys(o).map(c=>c.slice(0,c.indexOf("\0"))).filter(c=>c.length>0)),h=(c,S,C,b)=>{if(typeof C?.provider=="string"&&typeof C.implementation=="string"&&C.provider&&C.implementation)return o[ue(C.provider,C.implementation)]?.credentialType;if(typeof S.provider=="string"&&typeof S.implementation=="string")return o[ue(S.provider,S.implementation)]?.credentialType;let x=S.provider?.credentialType;if(typeof x=="string")return x;if(!s)return;let T=b??Object.keys(S.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,M);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return o[ue(j.effective.provider,j.effective.implementation)]?.credentialType};if(I||g)for(let[c,S]of Object.entries(t.services))for(let[C,b]of Object.entries(S.instances??{})){if(b.enabled===!1)continue;let x=b.credentialRef??S.credentialRef??t.credentialRefByInstance?.[C]??t.credentialRef;if(typeof x!="string"||!x.startsWith("secret://"))continue;let T=x.slice(9);I?.[T]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:C,message:`integrations: 凭据文件缺失 ${T}(${c}@${C} effective ref=${x};档内 config/credentials/ 无此文件)`});let j=g?.[T];if(j){let P=h(c,S,b,C);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:C,message:`integrations: 凭据文件 ${T}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${C}——transport 创建期将按 type 选策略)`})}}let u=(c,S)=>{if(!a)return;let C=Un(c,S,a);C&&n.push(C)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,S])=>S.instances!=null&&S.instances["*"]==null).map(([S])=>S);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,S]of Object.entries(t.services)){if(!i[c]&&M?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof S.provider=="string"?typeof S.implementation=="string"&&!o[ue(S.provider,S.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${S.provider}/${S.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):S.provider!==void 0&&!K(S.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),y){let b=h(c,S);b&&y[b]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${b} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof S.provider=="object"&&typeof S.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[b,x]of Object.entries(S.instances??{})){u(b,`services.${c}.instances`);let T=x.provider!==void 0,j=x.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:b,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${b}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=x.provider,L=x.implementation;typeof P=="string"&&typeof L=="string"?o[ue(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:b,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${b})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:b,message:`integrations: 实例级内联 provider 超受控形状(${c}@${b})`})}}}for(let[c,S]of[["root",t.provider],...Object.entries(t.modules??{}).map(([C,b])=>[`modules.${C}`,b?.provider])])typeof S!="string"||S.length===0||m.has(S)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${S} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[c,S]of Object.entries(t.services)){let C=S.instances?Object.keys(S.instances):[""];for(let b of C){let x=r.resolveEffectiveService(t,c,b,s,M);x.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:b||void 0,message:`integrations: ${x.message}`})}}for(let[c,S]of Object.entries(t.services))S.implementation!==void 0&&S.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,S]of Object.entries(t.modules??{})){if(!(S?.provider!==void 0||S?.config!==void 0))continue;let b=p?!p.has(c):!1,x=0;if(M)for(let j of Object.values(M))j===c&&(x+=1);if(b||!(M===void 0)&&x===0){let j=b?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(d){let c=new Set,S=!1,C=b=>{typeof b!="string"||b.length===0||(d[b]&&c.add(b),!d[b]&&!R?.[b]&&(S=!0),R?.[b]&&(S=!0))};C(t.provider);for(let b of Object.values(t.modules??{}))C(b?.provider);for(let b of Object.values(t.services)){let x=b.provider;C(typeof b.provider=="string"?b.provider:x?.provider)}if(c.size>0&&!S){let b=new Set;for(let j of c)for(let P of d[j]??[])b.add(P);let x=new Set;for(let j of c)for(let P of f?.[j]??[])x.add(P);let T=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??b).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};T(t.config,"root.config",void 0,x);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,x);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=$(t,j).provider??void 0;if(L===void 0){T(P.config,`modules.${j}.config`,void 0,x);continue}let Z=d[L];if(!Z||R?.[L])continue;let q=f?.[L];T(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,S]of Object.entries(i)){let C=t.services[c];if(!C){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${S.owners.join(", ")})未配置${S.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let b=Object.entries(C.instances??{}).filter(([,x])=>x.enabled===!1).map(([x])=>x);b.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:b.join(", "),message:`integrations: ${c} 实例禁用(${b.join(", ")})`})}for(let[c,S]of Object.entries(t.modules??{})){let C=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[b,x]of Object.entries(S?.resources??{})){let T=x?.type;(typeof T!="string"||!r.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${b} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),C&&C.size>0&&!C.has(b)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${b} 未被模块 manifest declare.resources 声明`})}}return n}function ue(e,n){return`${e}\0${n}`}import{existsSync as Je,readFileSync as zt,readdirSync as Gt}from"fs";import{join as ke}from"path";function zn(e){return e.replaceAll("-","_").toUpperCase()}function Kn(e){if(!Je(e))return null;try{let n=JSON.parse(zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Jt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function pe(e,n,r,t=process.env){let o={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))o[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let i={};for(let[u,v]of Object.entries(n.catalog.services))i[u]={optional:v.optional,owners:[...v.owners]};let s={},l={},y={},d={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=Kn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,S=l[v.provider]??=new Set;for(let b of Jt(w))c.add(b);let C=w.properties;if(C&&typeof C=="object"&&!Array.isArray(C))for(let[b,x]of Object.entries(C))x&&typeof x=="object"&&x["x-tbox-global"]===!0&&S.add(b)}else y[v.provider]=!0}v.credentialSchema&&!Je(ke(u.dir,v.credentialSchema))&&(d[v.credentialType]=!0)}}let R={},I=new Set,g=ke(e,"config","credentials");if(Je(g))for(let u of Gt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);I.add(v);let w=Kn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let A=r,O=[],M=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(A.services??{}))if(u&&typeof u=="object"){M(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&M(v.credentialRef)}for(let u of Object.values(A.credentialRefByInstance??{}))M(u);M(A.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[zn(v)]===void 0&&(I.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(A.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,S]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let C=S&&typeof S=="object"&&typeof S.provider=="string"?S.provider:void 0;w&&C&&C!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${C})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(A.instances)?A.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:o,demandedServices:i,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:d,vendorConfigKeys:s,vendorGlobalConfigKeys:l,vendorConfigSchemaMissing:y,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as li,readFileSync as ui}from"fs";import{join as fi,resolve as gi}from"path";function Ye(e){return D(e).catalog}function be(e){let n=D(e).catalog,r={};for(let[i,s]of Object.entries(n.providers)){r[i]={};for(let[l,y]of Object.entries(s))r[i][l]={provider:y.provider,implementation:y.implementation,credentialType:y.credentialType,owner:y.owner,...y.local?{local:!0}:{},...y.configSchema?{configSchema:y.configSchema}:{},...y.credentialSchema?{credentialSchema:y.credentialSchema}:{},services:[...y.services]}}let t={};for(let[i,s]of Object.entries(n.services))t[i]={optional:s.optional,defaults:s.defaults.map(l=>({...l})),owners:[...s.owners]};let o={};for(let[i,s]of Object.entries(n.credentialTypes))o[i]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:o}}async function He(e,n,r,t=process.env){let o=r.module,i=D(e),s=o.buildSupplyLookup(be(e)),l=pe(e,i,n,t);return ee({contracts:o,integrations:n,supplies:s,...l})}import{existsSync as er,rmSync as nr}from"fs";import{join as tr}from"path";import{existsSync as Yt,readFileSync as Ht}from"fs";import{join as Gn}from"path";var Zt=Gn("config","integrations.json");function G(e,n){let r=Gn(e,Zt),t=o=>JSON.parse(o);if(n)return n.read(r,t)??null;if(!Yt(r))return null;try{return t(Ht(r,"utf8"))}catch{return null}}async function Jn(e,n){let r=await N(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(o){if(o instanceof Error&&Array.isArray(o.issues)){let i=o.issues.filter(s=>Array.isArray(s.path)).map(s=>s.path.map(String).join(".")).filter(s=>s.length>0);throw new E("VALIDATION_FAILED",400,"integrations.json 校验失败",i.length>0?i:void 0)}throw new E("VALIDATION_FAILED",400,o instanceof Error?o.message:String(o))}return{config:t,strict:!1,contracts:r}}function fe(e,n,r,t){return e.includes(r)||n.includes(r)||t.includes(r)}import{readdirSync as qt,existsSync as Ce,readFileSync as Qt}from"fs";import{join as Ae}from"path";function Yn(e,n,r){let t=[];if(n){let o=Q({provider:e});t.push({stem:o,ref:`secret://${o}`,input:n})}for(let[o,i]of Object.entries(r??{})){let s=Q({provider:e,instanceId:o});t.push({instanceId:o,stem:s,ref:`secret://${s}`,input:i})}return t}function Hn(e,n,r,t,o){let i=[];if(t){let s=Q({provider:e,service:n});i.push({stem:s,ref:`secret://${s}`,input:t})}for(let[s,l]of Object.entries(o??{})){let y=Q({provider:e,instanceId:s,domain:r});i.push({instanceId:s,stem:y,ref:`secret://${y}`,input:l})}return i}function qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ce(Ae(e,W(t.stem))):Ue(e,t.stem,t.input)}))}function Xt(e,n){return Ce(Ae(e,W(n)))}function Ze(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)Ze(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))Ze(r,n)}function ne(e){let n=Ae(e,"config","credentials"),r=new Set,t=Ae(e,"config","integrations.json");if(Ce(t))try{Ze(JSON.parse(Qt(t,"utf8")),r)}catch{}let o=[];if(!Ce(n))return o;let i=[];try{i=qt(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return o}for(let s of i.sort()){if(r.has(s))continue;let l=de(e,s);o.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return o}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function rr(e){let n=tr(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await N(e);if(!t.strictValidation)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};let o;try{let g=We(JSON.stringify(r),process.env);if(g.missing.length>0||g.text===void 0)return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"};o=JSON.parse(g.text)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let i;try{i=await He(e,o,t,process.env)}catch{return{removed:[],orphanCredentials:[],skipped:"predicate-unavailable"}}let s=D(e),l=new Set(Object.keys(s.catalog.providers)),y=s.ownership,d=structuredClone(r);d.services??={};let f=[];for(let g of i)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(d.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete d.modules[g.module])}else d.provider&&(f.push(`root.provider=${d.provider}`),delete d.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let A=d.modules??{};if(A[g.module]){let O=A[g.module],M=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${M.join("+")} 整节点)`),delete d.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let A=d.services[g.service];if(!A)continue;let O=y[g.service];if([g.instance?Ee(A.instances?.[g.instance]?.provider):void 0,Ee(A.provider),O!==void 0?Ee(d.modules?.[O]?.provider):void 0,Ee(d.provider)].filter(p=>typeof p=="string").some(p=>l.has(p)))continue;if(g.instance){let p=A.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete A.instances,Object.keys(A).length===0&&delete d.services[g.service]}else delete d.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(d.services).length===0&&delete d.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!d.provider&&Object.keys(d.services??{}).length===0&&Object.keys(d.config??{}).length===0&&Object.keys(d.configByInstance??{}).length===0&&!d.credentialRef&&Object.keys(d.credentialRefByInstance??{}).length===0&&(d.instances??[]).length===0&&d.defaultInstanceId==null&&Object.keys(d.modules??{}).length===0;if(!R&&(d.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(d)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let I=[];return R?er(n)&&nr(n,{force:!0}):F(n,`${JSON.stringify(d,null,2)}
4
- `),I=ne(e).map(g=>g.message),{removed:f,orphanCredentials:I}}function Oe(e,n){let r=e.modules.find(o=>o.id===n);if(r)return r;let t=e.modules.filter(o=>(o.descriptor.name??o.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(o=>`${o.descriptor.name}(id=${o.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Y(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let l of Object.values(s))for(let y of l.services)t.add(y);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let o=[],i=s=>{o.includes(s)||o.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&i(s);for(let[s,l]of Object.entries(e.catalog.services))l.name===r&&i(s);if(o.length===1)return o[0];throw o.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${o.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as et,readFileSync as nt}from"fs";import{join as re,resolve as ir}from"path";import or from"ajv";var te=["provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],Zn=["provider","implementation","config","credentialRef","instances"],qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function ie(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>ie(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(o=>ie(e[o],n[o]))}return!1}function Ne(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Ne(t,`${n}.${r}`)}}function Me(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function Qn(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((o,i)=>{let s=o&&typeof o=="object"?o.id:void 0;if(typeof s=="string"&&!z.test(s))throw new E("VALIDATION_FAILED",400,`instances[${i}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${i}].id`])}),Me(e.configByInstance,"root.configByInstance",!1),Me(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else Me(e.instances,"services.instances",!0);Me(n.credentialsByInstance,"credentialsByInstance",!1)}function je(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Te(e,n){let r=re(e,H),t=o=>JSON.parse(o);if(n)return n.read(r,t)??null;if(!et(r))return null;try{return t(nt(r,"utf8"))}catch{return null}}function Qe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Ge(e,n)}function sr(e,n,r,t){let{catalog:o}=D(e,t),i=o.providers[n];if(!i)return;let s=new Set;for(let l of Object.values(i))(r===void 0||l.services.includes(r))&&s.add(l.credentialType);return s.size===1?[...s][0]:void 0}function Xn(e,n,r,t,o,i){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=o??sr(e,n,r,i);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:l}=D(e,i),y=l[`${n}\0${r}`];if(!y?.credentialSchema)return;let d=ir(y.packageDir,y.credentialSchema);if(et(d))try{let R=new or({allErrors:!0}).compile(JSON.parse(nt(d,"utf8")));if(!R({type:t.type,...t.values})){let I=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",I)}}catch(f){if(f instanceof E)throw f}}function Xe(e,n={}){let{onApplied:r,cache:t}=n;function o(d,f,R,I){let g=d!==null,A=f.length>0,O=!I&&g,M=!I&&A;O&&(F(re(e,H),`${JSON.stringify(d,null,2)}
5
- `),t?.invalidate([re(e,H)]));let p=O||M;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),A&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let i;async function s(){i=await N(e)}function l(d,f){return d.filter(R=>Array.isArray(R.path)).map(R=>{let I=R.path.map(String).join(".");return f!==""&&I.startsWith(f)&&I.length>f.length?I.slice(f.length):I}).filter(R=>R.length>0)}function y(d,f,R){if(!i)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let I=ae(i);if(I==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(i));if(I==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(i)});return}try{i.module.parseIntegrationsConfig(d)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",l(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(d,f={}){Ne(d,"root"),Qn(d,f,"root"),je(d,te,"root");let R=[],I=Te(e,t),g=I??{services:{}};I===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let A={...g};for(let v of te)v in d||delete A[v];for(let[v,w]of Object.entries(d))A[v]=w;let O=typeof A.provider=="string"?A.provider:"app",M=Yn(O,f.credentials,f.credentialsByInstance);for(let v of M)Xn(e,O,void 0,v.input,void 0,t);let p=M.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(A.credentialRef=p.ref),f.credentialsByInstance){let v={...A.credentialRefByInstance??{}};for(let w of M)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);A.credentialRefByInstance=v}let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=ie(I,A);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};y(A,R,"");let h=f.dryRun===!0,u=qe(e,M,h);return R.push(...Qe(A)),o(m?null:A,u,R,f.dryRun)},applyModule(d,f,R={}){Ne(f,"root");let{modules:I,catalog:g,ownership:A}=D(e,t),O=I.find(c=>c.id===d);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${d} 非已装模块`);if(!U({modules:I,catalog:g,ownership:A},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${d} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Te(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},u={...h[d]??{}};je(f,xe,`modules.${d}`);let v={...u};for(let c of xe){let S=f[c];S==null||S===""||typeof S=="object"&&!Array.isArray(S)&&Object.keys(S).length===0?delete v[c]:v[c]=S}Object.keys(v).length===0?delete h[d]:h[d]=v;let w={...m,modules:h};return ie(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(y(w,p,`modules.${d}.`),p.push(...Qe(w)),o(w,[],p,R.dryRun))},applyService(d,f,R={}){Ne(f,"root"),Qn(f,R,"slot"),je(f,Zn,`services.${d}`);for(let[T,j]of Object.entries(f.instances??{}))je(j,qn,`services.${d}.instances.${T}`);let I=[],g=Te(e,t),A=D(e,t);if(!fe(A.vocabulary,Object.keys(g?.services??{}),d,Object.keys(A.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&I.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},M={...O.services??{}},p={...O,services:M};M[d]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",u=d.includes(".")?d.slice(0,d.indexOf(".")):d,v=Hn(h,d,u,R.credentials,R.credentialsByInstance);for(let T of v)Xn(e,h,d,T.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=M[d],c=v.find(T=>T.instanceId===void 0);if(R.credentials&&c&&(w.credentialRef=c.ref),R.credentialsByInstance){let T={...w.instances??{}};for(let j of v){if(j.instanceId===void 0)continue;let P={...T[j.instanceId]??{}};P.credentialRef=j.ref,T[j.instanceId]=P}w.instances=T}let S=R.credentials!==void 0||R.credentialsByInstance!==void 0,C=ie(g,p);if(C&&!S)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:I};y(p,I,`services.${d}.`);let b=R.dryRun===!0,x=qe(e,v,b);return I.push(...Qe(p)),o(C?null:p,x,I,R.dryRun)},deleteService(d){let f=[],R=Te(e,t),I=D(e,t);if(!fe(I.vocabulary,Object.keys(R?.services??{}),d,Object.keys(I.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${d} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(d in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[d];let A={...R??{services:{}},services:g};F(re(e,H),`${JSON.stringify(A,null,2)}
6
- `),t?.invalidate([re(e,H)]),f.push(...ne(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[H],credentials:[],issues:f}}}}import{existsSync as ar}from"fs";import{join as cr}from"path";function en(e){let n=cr(e,"config","integrations.json");if(ar(n))return{generated:!1,reason:"in-place",services:[]};let r=[];for(let i of D(e).modules)for(let s of i.descriptor.declare.providers?.slots??[])s.local===!0&&r.push({service:s.service,provider:s.provider,implementation:s.implementation});if(r.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let t={},o=new Set(r.map(i=>i.provider));if(o.size===1){let[i]=o;for(let s of r)t[s.service]={};F(n,`${JSON.stringify({provider:i,services:t},null,2)}
7
- `)}else{for(let i of r)t[i.service]={provider:i.provider,implementation:i.implementation};F(n,`${JSON.stringify({services:t},null,2)}
8
- `)}return{generated:!0,reason:"generated",services:r.map(i=>i.service).sort()}}var nn={provider:null,layer:null};function tn(e){let n=e?.provider;return typeof n=="string"&&n.length>0?{provider:n,layer:"app"}:nn}function rn(e){let n=tn(e).provider;return{configured:n,effective:n!==null?{provider:n,layer:"app"}:nn,inherited:nn}}function Pe(e,n){let r=e?.modules?.[n]?.provider,t=typeof r=="string"&&r.length>0?r:null,o=$(e,n),i={provider:o.provider,layer:o.layer};return{configured:t,effective:i,inherited:t!==null?tn(e):i}}function dr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,o=dr(t),i=n.ownership[r],s=i!==void 0?Pe(e,i).effective:tn(e);return{configured:o,effective:o!==null?{provider:o,layer:"service"}:s,inherited:s}}import{existsSync as lr,readFileSync as ur}from"fs";import{join as ot}from"path";function tt(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function rt(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function Ve(e,n,r){let t=e.providers[n];return t?Object.values(t).some(o=>o.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],o=r?.name??t?.name??n,i=r?.description??t?.description;return{name:o,...i!==void 0?{description:i}:{}}}var pr=ot("config","knowledge.json");function fr(e,n,r){let o=r[n]?.resources;if(!o||typeof o!="object"||Array.isArray(o))return null;let i=ot(e.appDir,pr),s={};if(lr(i))try{s=(e.cache?.read(i,d=>JSON.parse(d))??JSON.parse(ur(i,"utf8"))).knowledge_bases??{}}catch{s={}}let l={};for(let[y,d]of Object.entries(o)){if(!d||typeof d!="object"||Array.isArray(d))continue;let f=d,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),I=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,A=I??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...I!==void 0?{datasetId:I}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:A,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};l[y]=O}return Object.keys(l).length>0?l:null}function it(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function gr(e){return it(e.id).startsWith("provider-")||it(e.pkg).startsWith("provider-")}function on(e,n={}){return{modules:e.walk.modules.filter(t=>!gr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,o)=>t.id.localeCompare(o.id))}}function sn(e,n){let r=e.walk.modules.find(I=>I.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),o=new Set((r.descriptor.declare.consumes??[]).map(I=>I.service)),i=(I,g)=>{let A=J(e.walk,I);return{service:I,name:A.name,...A.description!==void 0?{description:A.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(I=>i(I.service,I.optional===!1)),...[...new Set(t.ownedServices)].filter(I=>!o.has(I)).map(I=>i(I,!1))],l=e.integrations?.modules??{},y=l[n],d=y?{...typeof y.provider=="string"?{provider:y.provider}:{},...y.config&&typeof y.config=="object"&&!Array.isArray(y.config)?{config:y.config}:{}}:null,f=Pe(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:d,resources:fr(e,n,l),binding:R,configEditable:t.writable,services:s}}function an(e){let n=rt(e.walk),r=e.walk.vocabulary.filter(i=>!n.has(i)).map(i=>{let s=J(e.walk,i);return{service:i,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,o=null;if(t){let i={};for(let s of te)s in t&&(i[s]=t[s]);o=i}return{services:r,integration:o,binding:rn(t)}}function cn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!fe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let o=r[n]??null,i=J(e.walk,n);return{service:n,name:i.name,...i.description!==void 0?{description:i.description}:{},required:t?!t.optional:!1,integration:o,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ct,readFileSync as dt,realpathSync as st}from"fs";import{isAbsolute as mr,join as vr,relative as yr,resolve as at,sep as Sr}from"path";function dn(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let o=Object.values(t),i=e.catalog.vendorMeta[r];o.length===0&&!i||n.push({provider:r,local:o.length>0&&o.every(s=>s.local===!0),...i?.name?{name:i.name}:o[0]?.name?{name:o[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function ln(e,n,r){let t=e.catalog.providers[n],o=e.integrations?.services??{},i=[];if(t)for(let d of Object.values(t))d.services.includes(r)&&i.push({implementation:d.implementation,credentialType:d.credentialType});let s=o[r]?.provider,l=s&&typeof s=="object"&&s.provider===n?s:void 0;if(i.length===0&&!l)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);i.length===0&&l&&i.push({implementation:o[r]?.implementation??`${n}-inline@1`,credentialType:l.credentialType});let y=oe(e,n,r,l?s?.configSchema:void 0);return{provider:n,service:r,implementations:i,configSchema:y,integrationSchemas:{configSchema:y}}}function oe(e,n,r,t){let o=e.walk.serviceSchemas[`${n}\0${r}`];return o?un(e.appDir,o.packageDir,o.configSchema):typeof t=="string"?wr(e.appDir,t):null}function un(e,n,r){if(!r)return null;let t=vr(n,r);if(!ct(t))return null;try{return JSON.parse(dt(t,"utf8"))}catch{return null}}function wr(e,n){let r=at(e,"config","schemas"),t=at(e,n),o=yr(r,t);if(o===""||o.startsWith("..")||mr(o))throw new E("VALIDATION_FAILED",400,"configSchema 引用必须落在 config/schemas/ 内(禁路径逃逸)",["provider.configSchema"]);if(!ct(t))return null;let i,s;try{i=st(r),s=st(t)}catch{return null}if(s!==i&&!s.startsWith(i+Sr))throw new E("VALIDATION_FAILED",400,"configSchema 引用经 symlink 逃逸出 config/schemas/(realpath 复核拒绝)",["provider.configSchema"]);try{return JSON.parse(dt(t,"utf8"))}catch{return null}}function De(e){return{version:e.version,evaluation:e.evaluation,strictValidation:e.strictValidation,ownershipBindingV6:e.ownershipBindingV6,notes:[...e.notes]}}function lt(e,n,r){let t=e.integrations,o=t?.services?.[n],i=o?.instances?.[r]??o?.instances?.["*"];if(i&&i.provider!==void 0)return"instance";if(o?.provider!==void 0)return"service";let s=e.walk.ownership[n];return s!==void 0&&$(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function ut(e,n,r,t,o){let i=n.resolveEffectiveService(e.integrations??{services:{}},r,t,o,e.walk.ownership);if(i.status==="ok"&&i.effective){let s=i.effective.provider,l=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:l,implementation:i.effective.implementation,effective:{provider:l,implementation:i.effective.implementation,...i.effective.config!==void 0?{config:{...i.effective.config}}:{},...i.effective.credentialRef!==void 0?{credentialRef:i.effective.credentialRef}:{},layer:lt(e,r,t)??"app"}}}return i.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:i.message}:{status:i.status}}function pt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function pn(e,n,r){let t=pt(n),{integrations:o,catalog:i}=n,s=r?.supplies??t.buildSupplyLookup(i),l=o,d=t.normalizeInstances({instances:l?.instances,defaultInstanceId:l?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??ut(n,t,e,d,s),R=lt(n,e,d),I=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof I=="string"?I:typeof I=="object"&&I?String(I.provider):void 0),A={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),M=g!==void 0&&O.has(g)?hr(n.catalog,g,e):void 0,p=i.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:A,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...M!==void 0?{supplied:M}:{},...m!==void 0?{module:m}:{},...a!==void 0?{required:a}:{}}}function hr(e,n,r){return Ve(e,n,r)}function me(e){let n=new Set([...e.walk.vocabulary,...Object.keys(e.catalog.services),...Object.keys(e.walk.ownership)]),r=e.integrations?.services??{};for(let t of Object.keys(r))n.add(t);return[...n].sort()}function ve(e,n,r){let t={};for(let o of me(e))r&&!r.includes(o)||(t[o]=pn(o,e));return{contracts:De(e.contracts),resolutions:t,issues:n}}function fn(e,n,r){let t=pt(n),o=t.buildSupplyLookup(n.catalog),i=n.integrations,s=t.normalizeInstances({instances:i?.instances,defaultInstanceId:i?.defaultInstanceId}),l=s.instances.map(M=>M.id),y=n.integrations?.services?.[e],d=y?.instances?Object.keys(y.instances):void 0,f=ft(d,l),R=new Map;for(let M of f)R.set(M,ut(n,t,e,M,o));let I=f.map(M=>{let p=R.get(M);return{instanceId:M,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=gt(n,e,s.defaultInstanceId??"*"),O={...pn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:o}:void 0),instances:I,inheritance:g};return{contracts:De(n.contracts),resolution:O,issues:r.filter(M=>M.service===e)}}function ft(e,n){if(n.length>0){let r=[...n];return e?.includes("*")&&r.push("*"),r}return e!==void 0&&e.length>0?e.includes("*")?["*"]:e:[]}function gt(e,n,r){let t=e.integrations,o=t?.services?.[n],i=o?.instances?.[r]??o?.instances?.["*"],s=e.walk.ownership[n],l=s!==void 0?$(t,s):{provider:null,layer:null};return[{layer:"app",...t?.provider?{provider:t.provider}:{}},{layer:"module",...l.layer==="module"&&l.provider?{provider:l.provider}:{}},{layer:"service",...typeof o?.provider=="string"?{provider:o.provider}:{},...o?.implementation?{implementation:o.implementation}:{}},{layer:"instance",...i?.provider?{provider:i.provider}:{},...i?.implementation?{implementation:i.implementation}:{}}]}function ye(e){return e.evaluation&&e.strictValidation&&e.ownershipBindingV6}function mt(e,n,r){let t=e.catalog.services[n],o=e.walk.ownership[n];return{status:"evaluation-unavailable",statusMessage:r,binding:ge(e.integrations,e.walk,n).effective,...o!==void 0?{module:o}:{},...t!==void 0?{required:!t.optional}:{}}}function _e(e,n,r){let t=B(n),o={};for(let i of me(e))r&&!r.includes(i)||(o[i]=mt(e,i,t));return{contracts:De(n),resolutions:o,issues:[]}}function vt(e,n,r){let t=B(r),o={...mt(n,e,t),instances:Rr(n,e),inheritance:gt(n,e,Ir(n))};return{contracts:De(r),resolution:o,issues:[]}}function Rr(e,n){let r=e.integrations?.services?.[n],t=e.integrations,o=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],i=r?.instances?Object.keys(r.instances):void 0;return ft(i,o).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function Ir(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function gn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let i=e.walk.modules.find(s=>s.id===r.module);if(!i)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,i).ownedServices}else t=[r.service];let o=new Set(le(e.catalog,n));return{provider:n,scope:r,services:t.map(i=>({service:i,name:J(e.walk,i).name,supplied:o.has(i)}))}}function mn(e,n,r){if(n===null)return null;let t={};for(let o of r)t[o]={configSchema:oe(e,n,o)};return{provider:n,services:t}}function se(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(se).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${se(e[r])}`).join(",")}}`}var kr="\0no-enum";function br(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(se))].sort().join(",")}]`:kr}function Cr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:se(n)}function Ar(e){let n=e.map(t=>Cr(t.subschema));if(n.some(t=>t===null)||new Set(n).size>1)return null;if(n[0]==='"object"'){let t=se(e[0].subschema);return e.every(o=>se(o.subschema)===t)?e[0].subschema:null}return new Set(e.map(t=>br(t.subschema))).size===1?e[0].subschema:null}function Fe(e){let n=[],r=!0,t=new Map;for(let[i,s]of Object.entries(e.services)){let l=s.configSchema;if(l===null){n.push(i);continue}if(!l||typeof l!="object"||Array.isArray(l))continue;let y=l;y.additionalProperties===!1&&(r=!1);let d=y.properties;if(!d||typeof d!="object"||Array.isArray(d))continue;let f=Array.isArray(y.required)?y.required:[];for(let R of Object.keys(d)){let I=t.get(R)??[];I.push({service:i,subschema:d[R],required:f.includes(R)}),t.set(R,I)}}let o=[];for(let[i,s]of t)o.push({key:i,schema:Ar(s),sources:s.map(({service:l,required:y})=>({service:l,required:y})),global:s.some(l=>!!l.subschema&&typeof l.subschema=="object"&&l.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:o}}function vn(e,n,r){if(e==="app"){let i=n.integrations?.provider;return typeof i=="string"&&i.length>0?i:null}let t=n.walk.modules.find(i=>i.id===r);return!t||!U(n.walk,t).writable?null:$(n.integrations,t.id).provider}var yt={integrationSchemas:null,integrationFieldRegistry:null};function St(e){return{...e,fields:e.fields.filter(n=>n.global)}}function yn(e){let n=vn("app",e);if(n===null)return yt;let r=mn(e,n,le(e.catalog,n));return{integrationSchemas:r,integrationFieldRegistry:St(Fe(r))}}function Sn(e,n){let r=vn("module",e,n),t=e.walk.modules.find(s=>s.id===n);if(r===null||!t)return yt;let o=(t.descriptor.declare.owns??[]).map(s=>s.service),i=mn(e,r,o.filter(s=>Ve(e.catalog,r,s)));return{integrationSchemas:i,integrationFieldRegistry:St(Fe(i))}}function Er(e){return yn(e).integrationSchemas}function Or(e,n){return Sn(e,n).integrationSchemas}function xr(e,n){let r=e.walk.ownership[n];if(r!==void 0)return $(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function $e(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=xr(e,n);return t===null?null:{provider:t,configSchema:oe(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:oe(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:oe(e,t.provider,n,t.configSchema)}}return null}function wn(e,n){let r=$e(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return Fe(t)}function Se(e,n){if(n===void 0||!n.startsWith("secret://"))return;let r=n.slice(9),t=de(e,r);if(t)return{type:t.type,ref:n,masked:we(t.values)}}function hn(e){let n=e.integrations,r={credential:Se(e.appDir,typeof n?.credentialRef=="string"?n.credentialRef:void 0)??null,byInstance:{}};for(let{id:o}of n?.instances??[]){let i=n?.credentialRefByInstance?.[o];i!==void 0&&(r.byInstance[o]=Se(e.appDir,i)??null)}let t={};for(let[o,i]of Object.entries(n?.services??{})){let s={credential:Se(e.appDir,i.credentialRef)??null,byInstance:{}};for(let[l,y]of Object.entries(i.instances??{}))s.byInstance[l]=Se(e.appDir,y.credentialRef)??null;t[o]=s}return{app:r,services:t}}function Rn(e,n){return{types:(n===void 0?Object.keys(e.catalog.credentialTypes):[...new Set(Object.values(e.catalog.providers[n]??{}).map(t=>t.credentialType))]).sort().map(t=>{let o=e.catalog.credentialTypes[t];return{credentialType:t,credentialSchema:o?un(e.appDir,o.packageDir,o.credentialSchema):null}})}}import Mr from"path";var jr={app:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],module:["serviceResolutions","integrationSchemas","integrationFieldRegistry"],service:["integrationSchemas","integrationFieldRegistry"]};function In(e,n){if(!n||n.length===0)return new Set;let r=jr[e],t=[...new Set(n)].filter(o=>!r.includes(o));if(t.length>0)throw new E("VALIDATION_FAILED",400,`include 含未知或不适用于本端点的键:${t.join("、")}(白名单:${r.join("、")})`,["include"]);return new Set(n)}function Tr(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Nr(e,n={}){let r=Le(),t=Promise.resolve(),o={appDir:e,cache:r};function i(p){if(ae(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(ae(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function l(p){return tt(o,p)}function y(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function d(){let p=await N(e),a=l(p),m=a.integrations;if(m===null)return[];let h={resolveEffectiveService:f(p.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(p.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(p.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:p.module.RESOURCE_TYPE_IDS??[]},u=pe(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let I={async loadModules(p){let a=await N(e);return on(l(a),p)},async loadModule(p,a){let m=In("module",a?.include),h=await N(e),u=l(h),v=Oe(u.walk,p),w=sn(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(S=>S.service)])];w.serviceResolutions=ye(h)?await d().then(S=>ve(u,S,c)):_e(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=Sn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=In("app",p?.include),m=await N(e),h=l(m),u=an(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await d().then(v=>ve(h,v)):_e(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=yn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=In("service",a?.include),h=await N(e),u=l(h),v=Y(u.walk,y(u),p),w=cn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=$e(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=wn(u,v)),w},async loadServiceResolutions(p){let a=await N(e),m=l(a);if(!ye(a))return _e(m,a,p);let h=await d();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=l(a),h=Y(m.walk,y(m),p);if(!ye(a))return vt(h,m,a);let u=await d();return fn(h,m,u)},async loadProviders(){let p=await N(e);return dn(l(p))},async loadProviderSupply(p,a){Tr(a);let m=await N(e);return gn(l(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=l(m),u=Y(h.walk,y(h),a);return ln(h,p,u)},async loadCredentials(){let p=await N(e);return hn(l(p))},async loadCredentialTypes(p){let a=await N(e);return Rn(l(a),p)}},g=Xe(e,{onApplied:n.onApplied,cache:r}),A={async writeAppIntegration(p,a){await g.warmup();let m=await N(e);return i(m),R(()=>g.applyApp(p,a))},async writeModuleIntegration(p,a,m){await g.warmup();let h=await N(e);return i(h),R(()=>{let u=Oe(l(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return i(h),R(()=>{let u=l(h),v=Y(u.walk,y(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return i(a),R(()=>{let m=l(a),h=Y(m.walk,y(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),Be(e)},async resolveContracts(){return N(e)},walkManifests(){return M(e)},parseModuleDescriptor(p){return ce(p)},loadProviderCatalogRaw(){return Ye(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Pr(e,p,r))},async ensureMockBindings(){return R(()=>en(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function M(p){return D(p,r)}return{...I,...A,...O}}function Pr(e,n,r){let t=Mr.join(e,"config","integrations.json");F(t,`${JSON.stringify(n,null,2)}
9
- `),r.invalidate([t])}export{te as APP_INTEGRATION_NODE_KEYS,E as AppToolkitError,xe as MODULE_INTEGRATION_NODE_KEYS,z as SAFE_NAME_PATTERN,rn as appProviderBinding,$t as assertValidModuleId,Fe as buildIntegrationFieldRegistry,Kt as buildOwnershipMap,pe as buildPredicateAssembly,Ge as checkInstanceKeys,Ut as collectDeclaredModules,B as contractsNotResolvedMessage,Nr as createAppToolkit,Le as createFileCache,Xe as createWriteCore,Xt as credentialArtifactExists,ie as deepEqual,Q as deriveStem,Bn as discoverContractPackages,Se as echoForRef,Pn as ensureDir,en as ensureMockBindings,He as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,We as expandEnvVars,Wn as extractModuleIdFromSource,vn as formProviderOf,Be as invalidateContractsResolver,K as isControlledInlineProvider,Fn as isValidModuleId,Er as loadAppIntegrationSchemas,an as loadAppView,Rn as loadCredentialTypesView,hn as loadCredentialsView,sn as loadModuleDetailView,Or as loadModuleIntegrationSchemas,on as loadModulesView,be as loadProviderCatalog,Ye as loadProviderCatalogRaw,ln as loadProviderServiceDetailView,gn as loadProviderSupplyView,dn as loadProvidersView,cn as loadServiceDetailView,wn as loadServiceFieldRegistry,$e as loadServiceIntegrationSchemas,fn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,Mn as moduleDescriptorSchema,U as moduleOwnershipWritable,Pe as moduleProviderBinding,kn as pageContribSchema,ce as parseModuleDescriptor,le as providerFootprint,An as providerSlotContribSchema,rr as pruneIntegrationBindings,_n as readAppManifest,Ke as readAppManifestFull,de as readCredentialFile,G as readIntegrationsConfig,Jn as readIntegrationsStrict,ne as reconcileOrphanCredentials,zn as refToEnvKey,Dt as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,mn as resolveLayerIntegrationSchemas,$ as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,pn as resolveServiceSummary,xn as resourceNeedContribSchema,En as serviceConsumeContribSchema,On as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,At as stemToRef,bn as tabContribSchema,Ft as updateNpmModule,_t as upsertMiniappContainer,Vt as upsertNpmModule,D as walkManifests,Pt as writeAppManifest,F as writeAtomic,Ue as writeCredentialFile};
1
+ import{a as Be,b as se,c as N,d as We}from"./chunk-K5FIGT5A.js";import{z as k}from"zod";var z=/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,bt=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(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string(),credentialType:k.string(),local:k.boolean().optional(),configSchema:k.string().optional(),credentialSchema:k.string().optional()}),On=k.object({service:k.string(),optional:k.boolean().default(!0),defaults:k.array(k.object({provider:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)"),implementation:k.string()})).default([]),name:k.string().optional(),description:k.string().optional()}),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(bt).default([]),routes:k.array(k.string()).default([]),pages:k.array(bn).default([]),tabs:k.array(An).default([]),providers:k.object({id:k.string().regex(z,"provider 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)").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 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 Tn(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?Tn(d):s!==void 0?Tn(s):(r.push(o),i)});return r.length>0?{missing:r}:{text:t,missing:[]}}import{mkdirSync as Et,existsSync as Nn,readFileSync as Ot,writeFileSync as xt}from"fs";import{dirname as Mt,join as Pn}from"path";function we(e){let n={};for(let[r,t]of Object.entries(e)){if(typeof t!="string"){n[r]=null;continue}n[r]=t.length<=4?"****":`${t.slice(0,2)}****`}return n}var E=class extends Error{code;httpStatus;fields;constructor(n,r,t,i){super(t),this.name="AppToolkitError",this.code=n,this.httpStatus=r,this.fields=i}};function B(e){return e.notes.length>0?e.notes[0]:e.version===null?"contracts 不可解析(未安装)——检查应用依赖安装后重试":e.strictValidation?e.ownershipBindingV6===!1?`contracts ${e.version??"(版本未知)"} 不支持 v6 modules 绑定形状(OWNERSHIP_BINDING_V6 标记缺席)——升级应用 @tbox.cn/app-contracts 依赖后可用`:"contracts workspace 源码态未构建——执行 pnpm --filter @tbox.cn/app-contracts build 后重试":`contracts ${e.version} 无严格校验面(需 ≥0.9.0)——升级应用 @tbox.cn/app-contracts 依赖后可用`}function he(e,n){if(n!==void 0&&(n.includes("/")||n.includes("\\")||n.includes("..")))throw new E("VALIDATION_FAILED",400,`凭据 stem 派生输入含路径敌对字符(${e})——拒绝派生`)}function Q(e){if(he("provider",e.provider),he("service",e.service),he("instanceId",e.instanceId),he("domain",e.domain),e.instanceId!==void 0){let n=e.domain??e.service??"global";return`${e.provider}-${e.instanceId}-${n}`}return e.service!==void 0?`${e.provider}-${e.service}`:`${e.provider}-global`}function jt(e){return`secret://${e}`}function W(e){return`config/credentials/${e}.json`}function ce(e,n){let r=Pn(e,W(n));if(!Nn(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,y]of Object.entries(o))typeof y=="string"&&(s[d]=y);return{type:i,values:s}}catch{return null}}function Ke(e,n,r){let t=Pn(e,W(n)),i=Nn(t);return Et(Mt(t),{recursive:!0}),xt(t,`${JSON.stringify({type:r.type,...r.values},null,2)}
2
+ `,"utf8"),i}import{mkdirSync as Tt,renameSync as Nt,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"),Nt(r,e)}function Vn(e){Tt(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 Ft}from"fs";import _n from"path";function Re(e){return _n.join(e,".tbox","app.json")}function Fn(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 $t(e,n){let r=Re(e);_t(_n.dirname(r),{recursive:!0}),Ft(r,`${JSON.stringify(n,null,2)}
3
+ `,"utf8")}function ze(e){let n=Fn(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 $n(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)&&!e.includes("..")}function Kt(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 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,y={};typeof s=="string"&&s.length>0&&(y.name=s),typeof d=="string"&&d.length>0&&(y.description=d),(y.name!==void 0||y.description!==void 0)&&(t[i]=y)}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 y=V(e,d);if(_(y))try{for(let l of Ge(y,{withFileTypes:!0}))l.isDirectory()&&t.push(V(y,l.name))}catch{}}let i=new Set,o=(d,y,l)=>{let f=n?n.read(y,Ln):Ln(X(y,"utf8"));f!=null&&r.push({dir:d,slots:f.slots,meta:f.meta,via:l})},s=V(e,"config","service-slots.json");_(s)&&o(e,s,"config-override");for(let d of t){let y=V(d,"node_modules","@tbox.cn");if(!_(y))continue;let l=[];try{l=Ge(y)}catch{continue}for(let f of l){let R=V(y,f);if(i.has(R))continue;i.add(R);let I=V(R,"service-slots.json"),g=V(R,"src","service-slots.json");_(I)?o(R,I,"package"):_(g)&&o(R,g,"package")}}for(let d of t)for(let y of[V(d,"service-slots.json"),V(d,"src","service-slots.json")])_(y)&&o(d,y,"local");return r}function D(e,n){let r=[],t={providers:{},services:{},credentialTypes:{},vendorMeta:{}},i={},o=[],s={},d=new Set,y=(a,m,h,u,v)=>{for(let w of a){let c=v===void 0||v===w.provider;c&&(t.vendorMeta[w.provider]??={owner:m,...u?.name?{name:u.name}:{},...u?.description?{description:u.description}:{}});let S=t.providers[w.provider]??={},A=S[w.implementation];A?A.services.includes(w.service)||A.services.push(w.service):(S[w.implementation]={provider:w.provider,implementation:w.implementation,credentialType:w.credentialType,owner:m,...c&&u?.name?{name:u.name}:{},...c&&u?.description?{description:u.description}:{},...w.local?{local:!0}:{},...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},services:[w.service]},t.credentialTypes[w.credentialType]??={owner:m,packageDir:h,...w.credentialSchema?{credentialSchema:w.credentialSchema}:{}});let b=`${w.provider}\0${w.service}`;i[b]||(i[b]={...w.configSchema?{configSchema:w.configSchema}:{},...w.credentialSchema?{credentialSchema:w.credentialSchema}:{},packageDir:h})}},l=(a,m,h)=>{t.providers[a]??={},t.vendorMeta[a]??={owner:m,...h?.name?{name:h.name}:{},...h?.description?{description:h.description}:{}}},f=a=>a.kind==="strict"?{name:a.descriptor.name,description:a.descriptor.description}:void 0,R=(a,m)=>{for(let h of a){let u=s[h];u===void 0?s[h]=m:u!==m&&o.push({severity:"error",code:"OWNERSHIP_CONFLICT",module:m,message:`服务 ${h} 归属冲突:${u} 与 ${m} 均声明 owns(先声明 ${u} 胜出)——修正 manifest declare.owns 互斥`})}},I=(a,m)=>{a.kind==="legacy"&&o.push({severity:"error",code:"OLD_MANIFEST_KEY",module:m,message:`${m}:${a.detail}`})},g=a=>a.kind==="strict"||a.kind==="loose"?a.declare:null,C=(a,m)=>{let h=a.optional!==!1,u=a.defaults??[],v=t.services[a.service];if(v){v.optional=v.optional&&h;let w=new Set(v.defaults.map(c=>`${c.provider}\0${c.implementation}`));for(let c of u){let S=`${c.provider}\0${c.implementation}`;w.has(S)||(v.defaults.push(c),w.add(S))}v.owners.includes(m)||v.owners.push(m);return}t.services[a.service]={optional:h,defaults:[...u],...a.name?{name:a.name}:{},...a.description?{description:a.description}:{},owners:[m]}};for(let a of zt(e)){if(d.has(a.id))continue;let m=V(e,"packages",a.id),h=V(e,"node_modules",...a.package.split("/")),u=Ie(V(m,"tbox.module.json"),n)??Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,a.id),d.add(a.id);continue}if(!u)continue;d.add(a.id);let v=_(V(m,"tbox.module.json"))?m:h,w=g(u);u.kind==="strict"&&r.push({id:a.id,dir:v,pkg:a.mode==="sdk"?a.package:`@app/${a.id}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&l(S,a.package,f(u)),c.length&&y(c,a.package,v,f(u),S);let A=w?.consumes??[];for(let x of A)C(x,a.package);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),a.id)}for(let{pkg:a,dir:m}of Gt(e)){let h=Ie(V(m,"tbox.module.json"),n);if(h?.kind==="legacy"){I(h,a);continue}if(!h?.id||d.has(h.id))continue;d.add(h.id);let u=g(h),v=u?.providers?.slots??[],w=u?.providers?.id;w&&l(w,a,f(h)),v.length&&y(v,a,m,f(h),w);let c=u?.consumes??[];for(let A of c)C(A,a);let S=h.kind==="strict"?h.descriptor.declare.owns:[];S.length&&R(S.map(A=>A.service),h.id)}let O=V(e,"packages");if(_(O)){let a=[];try{a=Ge(O,{withFileTypes:!0}).filter(m=>m.isDirectory()).map(m=>m.name)}catch{}for(let m of a){if(d.has(m))continue;let h=V(O,m),u=Ie(V(h,"tbox.module.json"),n);if(u?.kind==="legacy"){I(u,m),d.add(m);continue}if(!u)continue;let v=u.id??m;if(d.has(v))continue;d.add(v);let w=g(u);u.kind==="strict"&&r.push({id:v,dir:h,pkg:`@app/${v}`,descriptor:u.descriptor});let c=w?.providers?.slots??[],S=w?.providers?.id;S&&l(S,`@app/${v}`,f(u)),c.length&&y(c,`@app/${v}`,h,f(u),S);let A=w?.consumes??[];for(let x of A)C(x,`@app/${v}`);let b=u.kind==="strict"?u.descriptor.declare.owns:[];b.length&&R(b.map(x=>x.service),v)}}let M=new Set,p={};for(let a of Wn(e,n)){for(let m of a.slots)M.add(m);for(let[m,h]of Object.entries(a.meta))p[m]===void 0&&(p[m]=h)}return{modules:r,catalog:t,serviceSchemas:i,vocabulary:[...M].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"),y=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:(y.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 $(e,n){let r=e?.modules?.[n]?.provider;if(typeof r=="string"&&r.length>0)return{provider:r,layer:"module"};let t=e?.provider;return typeof t=="string"&&t.length>0?{provider:t,layer:"app"}:{provider:null,layer:null}}function U(e,n){let r=(n.descriptor.declare.owns??[]).map(t=>t.service).sort();return r.length===0?{writable:!1,reason:"zero-ownership",ownedServices:[]}:{writable:!0,ownedServices:r}}function de(e,n){return[...new Set(Object.values(e.providers[n]??{}).flatMap(r=>r.services))].sort()}function K(e){if(!e||typeof e!="object")return!1;let n=Object.keys(e),r=new Set(["provider","credentialType","configSchema"]);if(!n.every(i=>r.has(i)))return!1;let t=e;return typeof t.provider=="string"&&t.provider.length>0&&typeof t.credentialType=="string"&&t.credentialType.length>0&&(t.configSchema===void 0||typeof t.configSchema=="string")}function Kn(e,n,r){return e==="*"||r.has(e)?null:{severity:"error",code:"INSTANCE_KEY_NOT_REGISTERED",instance:e,message:`integrations: ${n} 键 ${e} 不在 malls 白名单内(${[...r].join(", ")})`}}function Je(e,n){let r=new Set(n),t=[],i=(o,s)=>{let d=Kn(o,s,r);d&&t.push(d)};for(let o of Object.keys(e.configByInstance??{}))i(o,"configByInstance");for(let o of Object.keys(e.credentialRefByInstance??{}))i(o,"credentialRefByInstance");for(let[o,s]of Object.entries(e.services??{}))for(let d of Object.keys(s.instances??{}))i(d,`services.${o}.instances`);return t}function ee(e){let n=[],r=e.contracts,{integrations:t,suppliedProviders:i,demandedServices:o,supplies:s,malls:d,credentialSchemaMissing:y,vendorConfigKeys:l,vendorGlobalConfigKeys:f,vendorConfigSchemaMissing:R,credentialFileMissing:I,credentialFileType:g,realmSwitchHints:C,moduleResourceNeeds:O,ownership:M,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,S,A,b)=>{if(typeof A?.provider=="string"&&typeof A.implementation=="string"&&A.provider&&A.implementation)return i[le(A.provider,A.implementation)]?.credentialType;if(typeof S.provider=="string"&&typeof S.implementation=="string")return i[le(S.provider,S.implementation)]?.credentialType;let x=S.provider?.credentialType;if(typeof x=="string")return x;if(!s)return;let T=b??Object.keys(S.instances??{})[0]??"",j=r.resolveEffectiveService(t,c,T,s,M);if(!(j.status!=="ok"||typeof j.effective.provider!="string"))return i[le(j.effective.provider,j.effective.implementation)]?.credentialType};if(I||g)for(let[c,S]of Object.entries(t.services))for(let[A,b]of Object.entries(S.instances??{})){if(b.enabled===!1)continue;let x=b.credentialRef??S.credentialRef??t.credentialRefByInstance?.[A]??t.credentialRef;if(typeof x!="string"||!x.startsWith("secret://"))continue;let T=x.slice(9);I?.[T]===!0&&n.push({severity:"error",code:"CREDENTIAL_FILE_MISSING",service:c,instance:A,message:`integrations: 凭据文件缺失 ${T}(${c}@${A} effective ref=${x};档内 config/credentials/ 无此文件)`});let j=g?.[T];if(j){let P=h(c,S,b,A);P&&j!==P&&n.push({severity:"error",code:"CREDENTIAL_TYPE_MISMATCH",service:c,instance:A,message:`integrations: 凭据文件 ${T}.json type=${j} 与绑定 credentialType ${P} 不一致(${c}@${A}——transport 创建期将按 type 选策略)`})}}let u=(c,S)=>{if(!a)return;let A=Kn(c,S,a);A&&n.push(A)};for(let[c]of Object.entries(t.configByInstance??{}))u(c,"configByInstance");for(let[c]of Object.entries(t.credentialRefByInstance??{}))u(c,"credentialRefByInstance");let v=Object.entries(t.services).filter(([,c])=>c.instances==null||c.instances["*"]!=null).map(([c])=>c);if(v.length>0){let c=Object.entries(t.services).filter(([,S])=>S.instances!=null&&S.instances["*"]==null).map(([S])=>S);c.length>0&&n.push({severity:"warning",code:"WILDCARD_ALIGNMENT",message:`integrations: 激活形态不对称(通配:${v.join(", ")};显式键集:${c.join(", ")})——动态 mallId 将在显式键集槽上 INSTANCE_NOT_FOUND(provider 业务限制表达位),确认是否齐步`})}let w=r.normalizeInstances({instances:t.instances,defaultInstanceId:t.defaultInstanceId});w.instances.length>=2&&w.defaultInstanceId===null&&n.push({severity:"warning",code:"MULTI_INSTANCE_NO_DEFAULT",message:`integrations: ${w.instances.length} 个部署实例(${w.instances.map(c=>c.id).join(", ")})均无 defaultInstanceId——无 scope 参数访问将落全局会话(默认商圈不注入)`});for(let[c,S]of Object.entries(t.services)){if(!o[c]&&M?.[c]===void 0&&n.push({severity:"warning",code:"SLOT_NOT_DECLARED",service:c,message:`integrations: 服务槽 ${c} 无消费方声明(拼写错误或需求方未安装)——若为拆分前旧槽位词汇(member.main/parking.main/promotion.read/shopping-guide.main),参照 cookbook·app-config 槽位迁移配方展开为新槽`}),typeof S.provider=="string"?typeof S.implementation=="string"&&!i[le(S.provider,S.implementation)]&&n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,message:`integrations: provider ${S.provider}/${S.implementation} 未命中已装供给(${c} 槽级)——装对应 provider 包或改绑`}):S.provider!==void 0&&!K(S.provider)&&n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,message:`integrations: 内联 provider 超受控形状(${c} 槽级;允许键 provider/credentialType/configSchema)`}),y){let b=h(c,S);b&&y[b]===!0&&n.push({severity:"error",code:"SCHEMA_FILE_MISSING",service:c,message:`integrations: credentialType ${b} 的 schema 引用不存在(${c};manifest 声明指向缺失文件)`})}typeof S.provider=="object"&&typeof S.implementation!="string"&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 内联厂商声明必须同时提供 implementation(${c} 槽级)`});for(let[b,x]of Object.entries(S.instances??{})){u(b,`services.${c}.instances`);let T=x.provider!==void 0,j=x.implementation!==void 0;if(j&&!T&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,instance:b,message:`integrations: 实例级 implementation 需伴随 provider(${c}@${b}——impl-only 禁止,provider 是绑定组头)`}),T&&j){let P=x.provider,L=x.implementation;typeof P=="string"&&typeof L=="string"?i[le(P,L)]||n.push({severity:"error",code:"INSTANCE_SUPPLY_UNMATCHED",service:c,instance:b,message:`integrations: 实例级 provider 覆盖 ${P}/${L} 未命中已装供给(${c}@${b})`}):K(P)||n.push({severity:"error",code:"INLINE_PROVIDER_INVALID",service:c,instance:b,message:`integrations: 实例级内联 provider 超受控形状(${c}@${b})`})}}}for(let[c,S]of[["root",t.provider],...Object.entries(t.modules??{}).map(([A,b])=>[`modules.${A}`,b?.provider])])typeof S!="string"||S.length===0||m.has(S)||n.push({severity:"error",code:"VENDOR_NOT_INSTALLED",module:c.startsWith("modules.")?c.slice(8):void 0,message:`integrations: ${c} provider ${S} 未命中已装供给——装对应 provider 包或 provider use 改绑`});if(s)for(let[c,S]of Object.entries(t.services)){let A=S.instances?Object.keys(S.instances):[""];for(let b of A){let x=r.resolveEffectiveService(t,c,b,s,M);x.status==="binding-unresolved"&&n.push({severity:"error",code:"BINDING_UNRESOLVED",service:c,instance:b||void 0,message:`integrations: ${x.message}`})}}for(let[c,S]of Object.entries(t.services))S.implementation!==void 0&&S.provider===void 0&&n.push({severity:"error",code:"IMPL_WITHOUT_PROVIDER",service:c,message:`integrations: 槽级 implementation 需伴随 provider(${c}——impl-only 禁止,provider 是绑定组头)`});for(let[c,S]of Object.entries(t.modules??{})){if(!(S?.provider!==void 0||S?.config!==void 0))continue;let b=p?!p.has(c):!1,x=0;if(M)for(let j of Object.values(M))j===c&&(x+=1);if(b||!(M===void 0)&&x===0){let j=b?"未安装(键 = install id)":"未声明任何 owns(无模块级配置位)";n.push({severity:"error",code:"MODULE_CONFIG_DEAD",module:c,message:`integrations: modules.${c} 携带 provider/config 但模块${j}(MODULE_CONFIG_DEAD——模块级集成位作用于 declare.owns 服务,改 declare.owns 或删除该节点)`})}}if(l){let c=new Set,S=!1,A=b=>{typeof b!="string"||b.length===0||(l[b]&&c.add(b),!l[b]&&!R?.[b]&&(S=!0),R?.[b]&&(S=!0))};A(t.provider);for(let b of Object.values(t.modules??{}))A(b?.provider);for(let b of Object.values(t.services)){let x=b.provider;A(typeof b.provider=="string"?b.provider:x?.provider)}if(c.size>0&&!S){let b=new Set;for(let j of c)for(let P of l[j]??[])b.add(P);let x=new Set;for(let j of c)for(let P of f?.[j]??[])x.add(P);let T=(j,P,L,Z)=>{for(let[q]of Object.entries(j??{}))(L??b).has(q)?Z&&Z.size>0&&!Z.has(q)&&n.push({severity:"warning",code:"GLOBAL_FIELD_UNDECLARED",message:`integrations: ${P} 键 ${q} 过 schema 校验但未声明 x-tbox-global(不进应用/模块全局表单;已配置值照常生效——如需全局编辑请在 provider schema 标记)`}):n.push({severity:"error",code:"DOMAIN_CONFIG_INVALID",message:`integrations: ${P} 键 ${q} 不在引用厂商(${[...c].join("/")})任何槽 schema properties 内(死配置)`})};T(t.config,"root.config",void 0,x);for(let[j,P]of Object.entries(t.configByInstance??{}))T(P,`root.configByInstance[${j}]`,void 0,x);for(let[j,P]of Object.entries(t.modules??{})){if(!P?.config)continue;let L=$(t,j).provider??void 0;if(L===void 0){T(P.config,`modules.${j}.config`,void 0,x);continue}let Z=l[L];if(!Z||R?.[L])continue;let q=f?.[L];T(P.config,`modules.${j}.config`,new Set(Z),q)}}}for(let[c,S]of Object.entries(o)){let A=t.services[c];if(!A){n.push({severity:"warning",code:"SLOT_NOT_CONFIGURED",service:c,message:`integrations: 服务槽 ${c}(需求方 ${S.owners.join(", ")})未配置${S.optional?"(可选槽)":"(必需槽——模块将走降级链)"}`});continue}let b=Object.entries(A.instances??{}).filter(([,x])=>x.enabled===!1).map(([x])=>x);b.length>0&&n.push({severity:"warning",code:"INSTANCE_DISABLED",service:c,instance:b.join(", "),message:`integrations: ${c} 实例禁用(${b.join(", ")})`})}for(let[c,S]of Object.entries(t.modules??{})){let A=O?.[c];O&&!(c in O)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c} 未命中已装模块(键 = install id——检查 .tbox/app.json entry.id / packages/ 目录名)`});for(let[b,x]of Object.entries(S?.resources??{})){let T=x?.type;(typeof T!="string"||!r.RESOURCE_TYPE_IDS.includes(T))&&n.push({severity:"error",code:"RESOURCE_TYPE_UNKNOWN",module:c,message:`integrations: modules.${c}.resources.${b} type 非法(${String(T)};词汇表 = ${r.RESOURCE_TYPE_IDS.join("/")})`}),A&&A.size>0&&!A.has(b)&&n.push({severity:"warning",code:"RESOURCE_NOT_DECLARED",module:c,message:`integrations: modules.${c}.resources.${b} 未被模块 manifest declare.resources 声明`})}}return n}function le(e,n){return`${e}\0${n}`}import{existsSync as Ye,readFileSync as Zt,readdirSync as qt}from"fs";import{join as ke}from"path";function Gn(e){return e.replaceAll("-","_").toUpperCase()}function zn(e){if(!Ye(e))return null;try{let n=JSON.parse(Zt(e,"utf8"));return n&&typeof n=="object"?n:null}catch{return null}}function Qt(e){let n=new Set,r=e.properties;if(r&&typeof r=="object"&&!Array.isArray(r))for(let t of Object.keys(r))n.add(t);return n}function ue(e,n,r,t=process.env){let i={};for(let[u,v]of Object.entries(n.catalog.providers))for(let[w,c]of Object.entries(v))i[`${u}\0${w}`]={services:[...c.services],owner:c.owner,credentialType:c.credentialType};let o={};for(let[u,v]of Object.entries(n.catalog.services))o[u]={optional:v.optional,owners:[...v.owners]};let s={},d={},y={},l={},f={};for(let u of n.modules){f[u.id]=new Set((u.descriptor.declare.resources??[]).map(v=>v.id));for(let v of u.descriptor.declare.providers?.slots??[]){if(v.configSchema){let w=zn(ke(u.dir,v.configSchema));if(w){let c=s[v.provider]??=new Set,S=d[v.provider]??=new Set;for(let b of Qt(w))c.add(b);let A=w.properties;if(A&&typeof A=="object"&&!Array.isArray(A))for(let[b,x]of Object.entries(A))x&&typeof x=="object"&&x["x-tbox-global"]===!0&&S.add(b)}else y[v.provider]=!0}v.credentialSchema&&!Ye(ke(u.dir,v.credentialSchema))&&(l[v.credentialType]=!0)}}let R={},I=new Set,g=ke(e,"config","credentials");if(Ye(g))for(let u of qt(g)){if(!u.endsWith(".json"))continue;let v=u.slice(0,-5);I.add(v);let w=zn(ke(g,u));w&&typeof w.type=="string"&&(R[v]=w.type)}let C=r,O=[],M=u=>{typeof u=="string"&&u.startsWith("secret://")&&O.push(u)};for(let u of Object.values(C.services??{}))if(u&&typeof u=="object"){M(u.credentialRef);for(let v of Object.values(u.instances??{}))v&&typeof v=="object"&&M(v.credentialRef)}for(let u of Object.values(C.credentialRefByInstance??{}))M(u);M(C.credentialRef);let p={};for(let u of O){let v=u.slice(9);t[Gn(v)]===void 0&&(I.has(v)||(p[v]=!0))}let a=[];for(let[u,v]of Object.entries(C.services??{})){let w=v&&typeof v=="object"&&typeof v.provider=="string"?v.provider:void 0;for(let[c,S]of Object.entries((v&&typeof v=="object"?v.instances:void 0)??{})){let A=S&&typeof S=="object"&&typeof S.provider=="string"?S.provider:void 0;w&&A&&A!==w&&a.push(`integrations: ${u}@${c} 实现覆盖跨厂商(${w} → ${A})——凭据域切换,确认该 mall 对应凭据在场`)}}let h=((Array.isArray(C.instances)?C.instances:void 0)??[]).map(u=>u&&typeof u=="object"&&typeof u.id=="string"?u.id:void 0).filter(u=>typeof u=="string");return{suppliedProviders:i,demandedServices:o,credentialFileMissing:p,credentialFileType:R,credentialSchemaMissing:l,vendorConfigKeys:s,vendorGlobalConfigKeys:d,vendorConfigSchemaMissing:y,realmSwitchHints:a,moduleResourceNeeds:f,...h.length>0?{malls:h}:{},ownership:n.ownership,installedModuleIds:new Set([...n.modules.map(u=>u.id),...new Set(Object.values(n.ownership))])}}import{existsSync as 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,y]of Object.entries(s))r[o][d]={provider:y.provider,implementation:y.implementation,credentialType:y.credentialType,owner:y.owner,...y.local?{local:!0}:{},...y.configSchema?{configSchema:y.configSchema}:{},...y.credentialSchema?{credentialSchema:y.credentialSchema}:{},services:[...y.services]}}let t={};for(let[o,s]of Object.entries(n.services))t[o]={optional:s.optional,defaults:s.defaults.map(d=>({...d})),owners:[...s.owners]};let i={};for(let[o,s]of Object.entries(n.credentialTypes))i[o]={owner:s.owner,...s.credentialSchema?{credentialSchema:s.credentialSchema}:{}};return{providers:r,services:t,credentialTypes:i}}async function Ze(e,n,r,t=process.env){let i=r.module,o=D(e),s=i.buildSupplyLookup(be(e)),d=ue(e,o,n,t);return ee({contracts:i,integrations:n,supplies:s,...d})}import{existsSync as or,rmSync as sr}from"fs";import{join as ar}from"path";import{existsSync as Xt,readFileSync as er}from"fs";import{join as Jn}from"path";var nr=Jn("config","integrations.json");function G(e,n){let r=Jn(e,nr),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!Xt(r))return null;try{return t(er(r,"utf8"))}catch{return null}}async function Yn(e,n){let r=await N(e),t=G(e,n);if(t===null)return{config:null,strict:!1,contracts:r};if(r.strictValidation&&r.module.parseIntegrationsConfig)try{return{config:r.module.parseIntegrationsConfig(t),strict:!0,contracts:r}}catch(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 y=Q({provider:e,instanceId:s,domain:r});o.push({instanceId:s,stem:y,ref:`secret://${y}`,input:d})}return o}function Qe(e,n,r){return n.map(t=>({stem:t.stem,ref:t.ref,overwrote:r?Ae(Ce(e,W(t.stem))):Ke(e,t.stem,t.input)}))}function ir(e,n){return Ae(Ce(e,W(n)))}function qe(e,n){if(typeof e=="string"){e.startsWith("secret://")&&n.add(e.slice(9));return}if(Array.isArray(e)){for(let r of e)qe(r,n);return}if(e&&typeof e=="object")for(let r of Object.values(e))qe(r,n)}function ne(e){let n=Ce(e,"config","credentials"),r=new Set,t=Ce(e,"config","integrations.json");if(Ae(t))try{qe(JSON.parse(rr(t,"utf8")),r)}catch{}let i=[];if(!Ae(n))return i;let o=[];try{o=tr(n).filter(s=>s.endsWith(".json")).map(s=>s.slice(0,-5))}catch{return i}for(let s of o.sort()){if(r.has(s))continue;let d=ce(e,s);i.push({severity:"warning",code:"ORPHANED_CREDENTIAL",message:`${W(s)} 不再被引用(凭据文件保留,可手动清理)`})}return i}function Ee(e){if(typeof e=="string")return e.length>0?e:void 0;if(e&&typeof e=="object"&&K(e)){let n=e.provider;return n.length>0?n:void 0}}async function cr(e){let n=ar(e,"config","integrations.json"),r=G(e);if(r===null)return{removed:[],orphanCredentials:[],skipped:"not-configured"};let t=await 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)),y=s.ownership,l=structuredClone(r);l.services??={};let f=[];for(let g of o)if(g.severity==="error"){if(g.code==="VENDOR_NOT_INSTALLED")if(g.module){let O=(l.modules??{})[g.module];O?.provider&&(f.push(`modules.${g.module}.provider=${String(O.provider)}`),delete O.provider,Object.keys(O).length===0&&delete l.modules[g.module])}else l.provider&&(f.push(`root.provider=${l.provider}`),delete l.provider);else if(g.code==="MODULE_CONFIG_DEAD"&&g.module){let C=l.modules??{};if(C[g.module]){let O=C[g.module],M=[O.provider!==void 0?"provider":void 0,O.config!==void 0?"config":void 0,O.resources!==void 0?"resources":void 0].filter(Boolean);f.push(`modules.${g.module}(${M.join("+")} 整节点)`),delete l.modules[g.module]}}else if(g.code==="BINDING_UNRESOLVED"&&g.service){let C=l.services[g.service];if(!C)continue;let O=y[g.service];if([g.instance?Ee(C.instances?.[g.instance]?.provider):void 0,Ee(C.provider),O!==void 0?Ee(l.modules?.[O]?.provider):void 0,Ee(l.provider)].filter(p=>typeof p=="string").some(p=>d.has(p)))continue;if(g.instance){let p=C.instances;if(!p||!(g.instance in p))continue;delete p[g.instance],f.push(`services.${g.service}.instances.${g.instance}`),Object.keys(p).length===0&&delete C.instances,Object.keys(C).length===0&&delete l.services[g.service]}else delete l.services[g.service],f.push(`services.${g.service}`)}}if(Object.keys(l.services).length===0&&delete l.services,f.length===0)return{removed:f,orphanCredentials:[]};let R=!l.provider&&Object.keys(l.services??{}).length===0&&Object.keys(l.config??{}).length===0&&Object.keys(l.configByInstance??{}).length===0&&!l.credentialRef&&Object.keys(l.credentialRefByInstance??{}).length===0&&(l.instances??[]).length===0&&l.defaultInstanceId==null&&Object.keys(l.modules??{}).length===0;if(!R&&(l.services??={},typeof t.module.parseIntegrationsConfig=="function"))try{t.module.parseIntegrationsConfig(l)}catch{return{removed:[],orphanCredentials:[],skipped:"validation-failed"}}let I=[];return R?or(n)&&sr(n,{force:!0}):F(n,`${JSON.stringify(l,null,2)}
4
+ `),I=ne(e).map(g=>g.message),{removed:f,orphanCredentials:I}}function Oe(e,n){let r=e.modules.find(i=>i.id===n);if(r)return r;let t=e.modules.filter(i=>(i.descriptor.name??i.descriptor.id)===n);if(t.length===1)return t[0];throw t.length>1?new E("MODULE_NOT_FOUND",404,`模块展示名「${n}」命中多个模块:${t.map(i=>`${i.descriptor.name}(id=${i.id})`).join(" / ")}——请改用模块 id 寻址`):new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块(id / 展示名均未命中)`)}function Y(e,n,r){let t=new Set;for(let s of Object.values(e.catalog.providers))for(let d of Object.values(s))for(let y of d.services)t.add(y);if(e.vocabulary.includes(r)||Object.hasOwn(e.catalog.services,r)||t.has(r)||n.includes(r)||Object.hasOwn(e.ownership,r))return r;let i=[],o=s=>{i.includes(s)||i.push(s)};for(let s of e.vocabulary)(e.slotMeta[s]?.name??e.catalog.services[s]?.name)===r&&o(s);for(let[s,d]of Object.entries(e.catalog.services))d.name===r&&o(s);if(i.length===1)return i[0];throw i.length>1?new E("SERVICE_NOT_FOUND",404,`服务展示名「${r}」命中多个服务:${i.join(" / ")}——请改用服务 id 寻址`):new E("SERVICE_NOT_FOUND",404,`服务 ${r} 不在服务词汇(已装契约包 ∪ 已配置)`)}import{existsSync as rt,readFileSync as it}from"fs";import{join as re,resolve as dr}from"path";import lr from"ajv";var te=["$comment","$schema","provider","config","configByInstance","credentialRef","credentialRefByInstance","instances","defaultInstanceId"],xe=["provider","config"],qn=["provider","implementation","config","credentialRef","instances"],Qn=["provider","implementation","config","credentialRef","enabled"];var H=re("config","integrations.json");function fe(e,n){if(e===n)return!0;if(Array.isArray(e)&&Array.isArray(n))return e.length!==n.length?!1:e.every((r,t)=>fe(r,n[t]));if(e&&n&&typeof e=="object"&&typeof n=="object"){let r=Object.keys(e),t=Object.keys(n);return r.length!==t.length?!1:r.every(i=>fe(e[i],n[i]))}return!1}var ot=["$comment","$schema"];function Me(e,n){if(n)for(let r of ot)!(r in e)&&r in n&&(e[r]=n[r])}function Xn(e){if(e===null)return null;let n={...e};for(let r of ot)delete n[r];return n}function et(e,n){return fe(Xn(e),Xn(n))}function Pe(e,n){if(typeof e!="string"&&e&&typeof e=="object")for(let[r,t]of Object.entries(e)){if((r==="provider"||r==="instanceId")&&typeof t=="string"&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${r} 名含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`${n}.${r}`]);Pe(t,`${n}.${r}`)}}function je(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!(r&&(t==="*"||t==="**"))&&!z.test(t))throw new E("VALIDATION_FAILED",400,`${n} 键 ${t} 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)——进凭据 stem 派生,防路径逃逸`,[n])}}function nt(e,n,r){if(r==="root"){let t=e.instances;Array.isArray(t)&&t.forEach((i,o)=>{let s=i&&typeof i=="object"?i.id:void 0;if(typeof s=="string"&&!z.test(s))throw new E("VALIDATION_FAILED",400,`instances[${o}].id 含非法字符(需 /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)`,[`root.instances[${o}].id`])}),je(e.configByInstance,"root.configByInstance",!1),je(e.credentialRefByInstance,"root.credentialRefByInstance",!1)}else je(e.instances,"services.instances",!0);je(n.credentialsByInstance,"credentialsByInstance",!1)}function Te(e,n,r){if(!(!e||typeof e!="object"||Array.isArray(e))){for(let t of Object.keys(e))if(!n.includes(t))throw new E("VALIDATION_FAILED",400,`${r} 仅接受 ${n.join("/")} 键(收到 ${t})`,[t])}}function Ne(e,n){let r=re(e,H),t=i=>JSON.parse(i);if(n)return n.read(r,t)??null;if(!rt(r))return null;try{return t(it(r,"utf8"))}catch{return null}}function Xe(e){let n=(e.instances??[]).map(r=>r.id);return n.length===0?[]:Je(e,n)}function ur(e,n,r,t){let{catalog:i}=D(e,t),o=i.providers[n];if(!o)return;let s=new Set;for(let d of Object.values(o))(r===void 0||d.services.includes(r))&&s.add(d.credentialType);return s.size===1?[...s][0]:void 0}function tt(e,n,r,t,i,o){if(typeof t.type!="string"||t.type.length===0)throw new E("VALIDATION_FAILED",400,"凭据 type 缺失或为空字符串",["credentials.type"]);let s=i??ur(e,n,r,o);if(s!==void 0&&s!=="-"&&t.type!==s)throw new E("VALIDATION_FAILED",400,`凭据 type=${t.type} 与绑定 credentialType ${s} 不一致`,["credentials.type"]);if(r===void 0)return;let{serviceSchemas:d}=D(e,o),y=d[`${n}\0${r}`];if(!y?.credentialSchema)return;let l=dr(y.packageDir,y.credentialSchema);if(rt(l))try{let R=new lr({allErrors:!0}).compile(JSON.parse(it(l,"utf8")));if(!R({type:t.type,...t.values})){let I=(R.errors??[]).map(g=>`credentials.values.${String(g.instancePath||g.params?.missingProperty||"").replace(/^\//,"")}`);throw new E("VALIDATION_FAILED",400,"凭据字段校验失败(ajv 字段级)",I)}}catch(f){if(f instanceof E)throw f}}function en(e,n={}){let{onApplied:r,cache:t}=n;function i(l,f,R,I){let g=l!==null,C=f.length>0,O=!I&&g,M=!I&&C;O&&(F(re(e,H),`${JSON.stringify(l,null,2)}
5
+ `),t?.invalidate([re(e,H)]));let p=O||M;p&&R.push(...ne(e));let a=p&&r!==void 0;a&&r?.();let m=[];return g&&m.push(H),C&&m.push(...f.map(h=>W(h.stem))),{written:p,restartScheduled:a,files:m,credentials:f,issues:R}}let o;async function s(){o=await N(e)}function d(l,f){return l.filter(R=>Array.isArray(R.path)).map(R=>{let I=R.path.map(String).join(".");return f!==""&&I.startsWith(f)&&I.length>f.length?I.slice(f.length):I}).filter(R=>R.length>0)}function y(l,f,R){if(!o)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 严格校验面不可用——写路径门控失败(工厂边缘断言应先行拦截)");let I=se(o);if(I==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(o));if(I==="degraded"){f.push({severity:"warning",code:"STRICT_VALIDATION_SKIPPED",message:B(o)});return}try{o.module.parseIntegrationsConfig(l)}catch(g){throw g instanceof Error&&Array.isArray(g.issues)?new E("VALIDATION_FAILED",400,"节点 schema 校验失败",d(g.issues,R)):new E("VALIDATION_FAILED",400,g instanceof Error?g.message:String(g))}}return{warmup:s,applyApp(l,f={}){Pe(l,"root"),nt(l,f,"root"),Te(l,te,"root");let R=[],I=Ne(e,t),g=I??{services:{}};I===null&&R.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let C={...g};for(let v of te)v in l||delete C[v];for(let[v,w]of Object.entries(l))C[v]=w;let O=typeof C.provider=="string"?C.provider:"app",M=Hn(O,f.credentials,f.credentialsByInstance);for(let v of M)tt(e,O,void 0,v.input,void 0,t);let p=M.find(v=>v.instanceId===void 0);if(f.credentials&&p&&(C.credentialRef=p.ref),f.credentialsByInstance){let v={...C.credentialRefByInstance??{}};for(let w of M)w.instanceId!==void 0&&(v[w.instanceId]=w.ref);C.credentialRefByInstance=v}Me(C,I);let a=f.credentials!==void 0||f.credentialsByInstance!==void 0,m=et(I,C);if(m&&!a)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:R};y(C,R,"");let h=f.dryRun===!0,u=Qe(e,M,h);return R.push(...Xe(C)),i(m?null:C,u,R,f.dryRun)},applyModule(l,f,R={}){Pe(f,"root");let{modules:I,catalog:g,ownership:C}=D(e,t),O=I.find(c=>c.id===l);if(!O)throw new E("MODULE_NOT_FOUND",404,`模块 ${l} 非已装模块`);if(!U({modules:I,catalog:g,ownership:C},O).writable)throw new E("VALIDATION_FAILED",400,`模块 ${l} 未声明任何 declare.owns——无模块级配置位(模块级 provider/config 作用于归属服务)`);let p=[],a=Ne(e,t);if(a===null&&Object.keys(f).length===0)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p};a===null&&p.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let m=a??{services:{}},h={...m.modules??{}},u={...h[l]??{}};Te(f,xe,`modules.${l}`);let v={...u};for(let c of xe){let S=f[c];S==null||S===""||typeof S=="object"&&!Array.isArray(S)&&Object.keys(S).length===0?delete v[c]:v[c]=S}Object.keys(v).length===0?delete h[l]:h[l]=v;let w={...m,modules:h};return Me(w,a),fe(a,w)?{written:!1,restartScheduled:!1,files:[],credentials:[],issues:p}:(y(w,p,`modules.${l}.`),p.push(...Xe(w)),i(w,[],p,R.dryRun))},applyService(l,f,R={}){Pe(f,"root"),nt(f,R,"slot"),Te(f,qn,`services.${l}`);for(let[T,j]of Object.entries(f.instances??{}))Te(j,Qn,`services.${l}.instances.${T}`);let I=[],g=Ne(e,t),C=D(e,t);if(!pe(C.vocabulary,Object.keys(g?.services??{}),l,Object.keys(C.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);g===null&&I.push({severity:"warning",code:"SKELETON_MATERIALIZED",message:"config/integrations.json 缺席——已物化骨架(写时自动初始化; 语义翻转提示)"});let O=g??{services:{}},M={...O.services??{}},p={...O,services:M};Me(p,g),M[l]={...f};let a=f.provider,m=a!==null&&typeof a=="object"?a:void 0,h=typeof a=="string"?a:typeof m?.provider=="string"?m.provider:"app",u=l.includes(".")?l.slice(0,l.indexOf(".")):l,v=Zn(h,l,u,R.credentials,R.credentialsByInstance);for(let T of v)tt(e,h,l,T.input,typeof m?.credentialType=="string"?m.credentialType:void 0,t);let w=M[l],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 S=R.credentials!==void 0||R.credentialsByInstance!==void 0,A=et(g,p);if(A&&!S)return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:I};y(p,I,`services.${l}.`);let b=R.dryRun===!0,x=Qe(e,v,b);return I.push(...Xe(p)),i(A?null:p,x,I,R.dryRun)},deleteService(l){let f=[],R=Ne(e,t),I=D(e,t);if(!pe(I.vocabulary,Object.keys(R?.services??{}),l,Object.keys(I.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${l} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let g={...R?.services??{}};if(!(l in g))return{written:!1,restartScheduled:!1,files:[],credentials:[],issues:f};delete g[l];let C={...R??{services:{}},services:g};F(re(e,H),`${JSON.stringify(C,null,2)}
6
+ `),t?.invalidate([re(e,H)]),f.push(...ne(e));let O=r!==void 0;return O&&r?.(),{written:!0,restartScheduled:O,files:[H],credentials:[],issues:f}}}}import{existsSync as pr,readFileSync as fr}from"fs";import{join as gr}from"path";var st=["$comment","$schema"];function mr(e){try{let n=JSON.parse(fr(e,"utf8"));if(!n||typeof n!="object"||Array.isArray(n))return{pristine:!1,meta:{}};let r=new Set(["services",...st]);if(Object.keys(n).some(o=>!r.has(o)))return{pristine:!1,meta:{}};let t=n.services;if(!t||typeof t!="object"||Array.isArray(t)||Object.keys(t).length>0)return{pristine:!1,meta:{}};let i={};for(let o of st)o in n&&(i[o]=n[o]);return{pristine:!0,meta:i}}catch{return{pristine:!1,meta:{}}}}function nn(e){let n=gr(e,"config","integrations.json"),r={};if(pr(n)){let s=mr(n);if(!s.pristine)return{generated:!1,reason:"in-place",services:[]};r=s.meta}let t=[];for(let s of D(e).modules)for(let d of s.descriptor.declare.providers?.slots??[])d.local===!0&&t.push({service:d.service,provider:d.provider,implementation:d.implementation});if(t.length===0)return{generated:!1,reason:"no-local-slots",services:[]};let i={},o=new Set(t.map(s=>s.provider));if(o.size===1){let[s]=o;for(let d of t)i[d.service]={};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=$(e,n),o={provider:i.provider,layer:i.layer};return{configured:t,effective:o,inherited:t!==null?rn(e):o}}function vr(e){return typeof e=="string"?e.length>0?e:null:K(e)?e.provider:null}function ge(e,n,r){let t=e?.services?.[r]?.provider,i=vr(t),o=n.ownership[r],s=o!==void 0?Ve(e,o).effective:rn(e);return{configured:i,effective:i!==null?{provider:i,layer:"service"}:s,inherited:s}}import{existsSync as yr,readFileSync as Sr}from"fs";import{join as lt}from"path";function at(e,n){let r=D(e.appDir,e.cache),t=G(e.appDir,e.cache);return{appDir:e.appDir,walk:r,catalog:r.catalog,integrations:t,contracts:n,...e.cache?{cache:e.cache}:{}}}function ct(e){let n=new Set;for(let r of e.modules){for(let t of r.descriptor.declare.owns??[])n.add(t.service);for(let t of r.descriptor.declare.consumes??[])n.add(t.service);for(let t of r.descriptor.declare.providers?.slots??[])n.add(t.service)}return n}function De(e,n,r){let t=e.providers[n];return t?Object.values(t).some(i=>i.services.includes(r)):!1}function J(e,n){let r=e.slotMeta[n],t=e.catalog.services[n],i=r?.name??t?.name??n,o=r?.description??t?.description;return{name:i,...o!==void 0?{description:o}:{}}}var wr=lt("config","knowledge.json");function hr(e,n,r){let i=r[n]?.resources;if(!i||typeof i!="object"||Array.isArray(i))return null;let o=lt(e.appDir,wr),s={};if(yr(o))try{s=(e.cache?.read(o,l=>JSON.parse(l))??JSON.parse(Sr(o,"utf8"))).knowledge_bases??{}}catch{s={}}let d={};for(let[y,l]of Object.entries(i)){if(!l||typeof l!="object"||Array.isArray(l))continue;let f=l,R=f.type==="knowledge"?"knowledge":String(f.type??"knowledge"),I=typeof f.datasetId=="string"&&f.datasetId!==""?f.datasetId:void 0,g=typeof f.ref=="string"&&f.ref!==""?f.ref:void 0,C=I??(g!==void 0&&typeof s[g]?.datasetId=="string"?s[g].datasetId:null),O={type:R,...I!==void 0?{datasetId:I}:{},...g!==void 0?{ref:g}:{},resolvedDatasetId:C,...typeof f.topK=="number"?{topK:f.topK}:{},...typeof f.scoreThreshold=="number"?{scoreThreshold:f.scoreThreshold}:{}};d[y]=O}return Object.keys(d).length>0?d:null}function dt(e){return e.replace(/^@tbox\.cn\/app-/,"").replace(/^@[^/]+\//,"")}function Rr(e){return dt(e.id).startsWith("provider-")||dt(e.pkg).startsWith("provider-")}function sn(e,n={}){return{modules:e.walk.modules.filter(t=>!Rr(t)).filter(t=>n.includeHidden===!0||t.descriptor.hidden!==!0).map(t=>({id:t.id,name:t.descriptor.name??t.descriptor.id,description:t.descriptor.description??"",...t.descriptor.hidden===!0?{hidden:!0}:{}})).sort((t,i)=>t.id.localeCompare(i.id))}}function an(e,n){let r=e.walk.modules.find(I=>I.id===n);if(!r)throw new E("MODULE_NOT_FOUND",404,`模块 ${n} 非已装模块`);let t=U(e.walk,r),i=new Set((r.descriptor.declare.consumes??[]).map(I=>I.service)),o=(I,g)=>{let C=J(e.walk,I);return{service:I,name:C.name,...C.description!==void 0?{description:C.description}:{},required:g}},s=[...(r.descriptor.declare.consumes??[]).map(I=>o(I.service,I.optional===!1)),...[...new Set(t.ownedServices)].filter(I=>!i.has(I)).map(I=>o(I,!1))],d=e.integrations?.modules??{},y=d[n],l=y?{...typeof y.provider=="string"?{provider:y.provider}:{},...y.config&&typeof y.config=="object"&&!Array.isArray(y.config)?{config:y.config}:{}}:null,f=Ve(e.integrations,n),R={configured:f.configured,effective:f.effective,inherited:f.inherited,provider:f.effective.provider,layer:f.effective.layer};return{name:r.descriptor.name??r.descriptor.id,description:r.descriptor.description??"",...r.descriptor.hidden===!0?{hidden:!0}:{},ownedServices:t.ownedServices,integration:l,resources:hr(e,n,d),binding:R,configEditable:t.writable,services:s}}function cn(e){let n=ct(e.walk),r=e.walk.vocabulary.filter(o=>!n.has(o)).map(o=>{let s=J(e.walk,o);return{service:o,name:s.name,...s.description!==void 0?{description:s.description}:{},required:!1}}),t=e.integrations,i=null;if(t){let o={};for(let s of te)s in t&&(o[s]=t[s]);i=o}return{services:r,integration:i,binding:on(t)}}function dn(e,n){let r=e.integrations?.services??{},t=e.catalog.services[n];if(!pe(e.walk.vocabulary,Object.keys(r),n,Object.keys(e.walk.ownership)))throw new E("SERVICE_NOT_FOUND",404,`服务 ${n} 不在服务词汇(已装契约包 ∪ 已配置 ∪ 归属)`);let i=r[n]??null,o=J(e.walk,n);return{service:n,name:o.name,...o.description!==void 0?{description:o.description}:{},required:t?!t.optional:!1,integration:i,binding:ge(e.integrations,e.walk,n)}}import{existsSync as ft,readFileSync as gt,realpathSync as ut}from"fs";import{isAbsolute as Ir,join as kr,relative as br,resolve as pt,sep as Ar}from"path";function ln(e){let n=[];for(let[r,t]of Object.entries(e.catalog.providers)){let i=Object.values(t),o=e.catalog.vendorMeta[r];i.length===0&&!o||n.push({provider:r,local:i.length>0&&i.every(s=>s.local===!0),...o?.name?{name:o.name}:i[0]?.name?{name:i[0].name}:{}})}return{providers:n.sort((r,t)=>r.provider.localeCompare(t.provider))}}function un(e,n,r){let t=e.catalog.providers[n],i=e.integrations?.services??{},o=[];if(t)for(let l of Object.values(t))l.services.includes(r)&&o.push({implementation:l.implementation,credentialType:l.credentialType});let s=i[r]?.provider,d=s&&typeof s=="object"&&s.provider===n?s:void 0;if(o.length===0&&!d)throw t?new E("SUPPLY_NOT_FOUND",404,`厂商 ${n} 未供给服务 ${r}(AI 帮我实现流:PUT 显式绑定后实施)`):new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 完全未知(不 ∈ catalog 且无任何内联声明)`);o.length===0&&d&&o.push({implementation:i[r]?.implementation??`${n}-inline@1`,credentialType:d.credentialType});let y=ie(e,n,r,d?s?.configSchema:void 0);return{provider:n,service:r,implementations:o,configSchema:y,integrationSchemas:{configSchema:y}}}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&&$(e.integrations,s).layer==="module"?"module":typeof t?.provider=="string"&&t.provider.length>0?"app":null}function vt(e,n,r,t,i){let o=n.resolveEffectiveService(e.integrations??{services:{}},r,t,i,e.walk.ownership);if(o.status==="ok"&&o.effective){let s=o.effective.provider,d=typeof s=="string"?s:String(s?.provider??"");return{status:"ok",provider:d,implementation:o.effective.implementation,effective:{provider:d,implementation:o.effective.implementation,...o.effective.config!==void 0?{config:{...o.effective.config}}:{},...o.effective.credentialRef!==void 0?{credentialRef:o.effective.credentialRef}:{},layer:mt(e,r,t)??"app"}}}return o.status==="binding-unresolved"?{status:"binding-unresolved",statusMessage:o.message}:{status:o.status}}function yt(e){let n=e.contracts.module;if(!n.resolveEffectiveService||!n.normalizeInstances)throw new E("CONTRACTS_NOT_RESOLVED",503,"contracts 求值面缺席(契约包形态异常)——重新安装或升级应用 @tbox.cn/app-contracts 后重试");return n}function fn(e,n,r){let t=yt(n),{integrations:i,catalog:o}=n,s=r?.supplies??t.buildSupplyLookup(o),d=i,l=t.normalizeInstances({instances:d?.instances,defaultInstanceId:d?.defaultInstanceId}).defaultInstanceId??"*",f=r?.evaluation??vt(n,t,e,l,s),R=mt(n,e,l),I=n.integrations?.services?.[e]?.provider,g=f.provider??(typeof I=="string"?I:typeof I=="object"&&I?String(I.provider):void 0),C={provider:g??null,layer:R??null},O=new Set(Object.keys(n.catalog.providers)),M=g!==void 0&&O.has(g)?Er(n.catalog,g,e):void 0,p=o.services[e],a=p!==void 0?!p.optional:void 0,m=n.walk.ownership[e];return{status:f.status,...f.statusMessage?{statusMessage:f.statusMessage}:{},binding:C,...g!==void 0?{provider:g}:{},...g!==void 0&&R!==null?{layer:R}:{},...M!==void 0?{supplied:M}:{},...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(M=>M.id),y=n.integrations?.services?.[e],l=y?.instances?Object.keys(y.instances):void 0,f=St(l,d),R=new Map;for(let M of f)R.set(M,vt(n,t,e,M,i));let I=f.map(M=>{let p=R.get(M);return{instanceId:M,status:p.status,...p.statusMessage?{statusMessage:p.statusMessage}:{},...p.effective?{effective:p.effective}:{}}}),g=wt(n,e,s.defaultInstanceId??"*"),O={...fn(e,n,R.has(s.defaultInstanceId??"*")?{evaluation:R.get(s.defaultInstanceId??"*"),supplies:i}:void 0),instances:I,inheritance:g};return{contracts:_e(n.contracts),resolution:O,issues:r.filter(M=>M.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?$(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 Fe(e,n,r){let t=B(n),i={};for(let o of me(e))r&&!r.includes(o)||(i[o]=ht(e,o,t));return{contracts:_e(n),resolutions:i,issues:[]}}function Rt(e,n,r){let t=B(r),i={...ht(n,e,t),instances:Or(n,e),inheritance:wt(n,e,xr(n))};return{contracts:_e(r),resolution:i,issues:[]}}function Or(e,n){let r=e.integrations?.services?.[n],t=e.integrations,i=Array.isArray(t?.instances)?t.instances.map(s=>s&&typeof s=="object"?s.id:void 0).filter(s=>typeof s=="string"):[],o=r?.instances?Object.keys(r.instances):void 0;return St(o,i).map(s=>({instanceId:s,status:"evaluation-unavailable"}))}function xr(e){let n=e.integrations;return typeof n?.defaultInstanceId=="string"&&n.defaultInstanceId.length>0?n.defaultInstanceId:"*"}function mn(e,n,r){if(!(n in e.catalog.providers))throw new E("PROVIDER_NOT_FOUND",404,`厂商 ${n} 不 ∈ catalog(内联声明厂商无包级档案——判定归求值轴 resolution.supplied)`);let t;if(r.kind==="app")t=me(e);else if(r.kind==="module"){let o=e.walk.modules.find(s=>s.id===r.module);if(!o)throw new E("MODULE_NOT_FOUND",404,`模块 ${r.module} 非已装模块`);t=U(e.walk,o).ownedServices}else t=[r.service];let i=new Set(de(e.catalog,n));return{provider:n,scope:r,services:t.map(o=>({service:o,name:J(e.walk,o).name,supplied:i.has(o)}))}}function vn(e,n,r){if(n===null)return null;let t={};for(let i of r)t[i]={configSchema:ie(e,n,i)};return{provider:n,services:t}}function oe(e){return e===null||typeof e!="object"?JSON.stringify(e??null):Array.isArray(e)?`[${e.map(oe).join(",")}]`:`{${Object.keys(e).sort().map(r=>`${JSON.stringify(r)}:${oe(e[r])}`).join(",")}}`}var Mr="\0no-enum";function jr(e){let n=e.enum;return Array.isArray(n)?`[${[...new Set(n.map(oe))].sort().join(",")}]`:Mr}function Tr(e){if(!e||typeof e!="object"||Array.isArray(e))return null;let n=e.type;return n===void 0?null:oe(n)}function Nr(e){let n=e.map(t=>Tr(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 $e(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 y=d;y.additionalProperties===!1&&(r=!1);let l=y.properties;if(!l||typeof l!="object"||Array.isArray(l))continue;let f=Array.isArray(y.required)?y.required:[];for(let R of Object.keys(l)){let I=t.get(R)??[];I.push({service:o,subschema:l[R],required:f.includes(R)}),t.set(R,I)}}let i=[];for(let[o,s]of t)i.push({key:o,schema:Nr(s),sources:s.map(({service:d,required:y})=>({service:d,required:y})),global:s.some(d=>!!d.subschema&&typeof d.subschema=="object"&&d.subschema["x-tbox-global"]===!0)});return{provider:e.provider,schemaless:n,additionalPropertiesAllowed:r,fields:i}}function yn(e,n,r){if(e==="app"){let o=n.integrations?.provider;return typeof o=="string"&&o.length>0?o:null}let t=n.walk.modules.find(o=>o.id===r);return!t||!U(n.walk,t).writable?null:$(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($e(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($e(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 $(e.integrations,r).provider;let t=e.integrations?.provider;return typeof t=="string"&&t.length>0?t:null}function Le(e,n){let r=e.integrations?.services?.[n]?.provider;if(r===void 0||r===""){let t=Dr(e,n);return t===null?null:{provider:t,configSchema:ie(e,t,n)}}if(typeof r=="string")return{provider:r,configSchema:ie(e,r,n)};if(K(r)){let t=r;return{provider:t.provider,configSchema:ie(e,t.provider,n,t.configSchema)}}return null}function hn(e,n){let r=Le(e,n);if(r===null)return null;let t={provider:r.provider,services:{[n]:{configSchema:r.configSchema}}};return $e(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,y]of Object.entries(o.instances??{}))s.byInstance[d]=Se(e.appDir,y.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 Fr={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=Fr[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 $r(e){let n=e?.kind;if(n!=="app"&&n!=="module"&&n!=="service")throw new E("VALIDATION_FAILED",400,"scope 必须为 app | module | service(显式请求参数)",["scope"]);if(n==="module"&&(typeof e.module!="string"||e.module.length===0))throw new E("VALIDATION_FAILED",400,"scope=module 需携带非空 module 参数",["module"]);if(n==="service"&&(typeof e.service!="string"||e.service.length===0))throw new E("VALIDATION_FAILED",400,"scope=service 需携带非空 service 参数",["service"])}function Lr(e,n={}){let r=Be(),t=Promise.resolve(),i={appDir:e,cache:r};function o(p){if(se(p)==="blocked")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function s(p){if(se(p)!=="ok")throw new E("CONTRACTS_NOT_RESOLVED",503,B(p))}function d(p){return at(i,p)}function y(p){let a=p.integrations?.services;return a&&typeof a=="object"?Object.keys(a):[]}async function l(){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??[]},u=ue(e,a.walk,m,process.env);return ee({contracts:h,integrations:m,supplies:h.buildSupplyLookup(a.catalog),...u})}function f(p,a){if(typeof p!="function")throw new E("CONTRACTS_NOT_RESOLVED",503,`contracts 求值面 ${a} 缺席(形态异常)`);return p}function R(p){let a=t.then(p,p);return t=a.catch(()=>{}),a}let I={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),u=d(h),v=Oe(u.walk,p),w=an(u,v.id);if(m.has("serviceResolutions")){let c=[...new Set([...w.ownedServices,...w.services.map(S=>S.service)])];w.serviceResolutions=ye(h)?await l().then(S=>ve(u,S,c)):Fe(u,h,c)}if(m.has("integrationSchemas")||m.has("integrationFieldRegistry")){let c=wn(u,v.id);m.has("integrationSchemas")&&(w.integrationSchemas=c.integrationSchemas),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=c.integrationFieldRegistry)}return w},async loadApp(p){let a=kn("app",p?.include),m=await N(e),h=d(m),u=cn(h);if(a.has("serviceResolutions")&&(u.serviceResolutions=ye(m)?await l().then(v=>ve(h,v)):Fe(h,m)),a.has("integrationSchemas")||a.has("integrationFieldRegistry")){let v=Sn(h);a.has("integrationSchemas")&&(u.integrationSchemas=v.integrationSchemas),a.has("integrationFieldRegistry")&&(u.integrationFieldRegistry=v.integrationFieldRegistry)}return u},async loadService(p,a){let m=kn("service",a?.include),h=await N(e),u=d(h),v=Y(u.walk,y(u),p),w=dn(u,v);return m.has("integrationSchemas")&&(w.integrationSchemas=Le(u,v)),m.has("integrationFieldRegistry")&&(w.integrationFieldRegistry=hn(u,v)),w},async loadServiceResolutions(p){let a=await N(e),m=d(a);if(!ye(a))return Fe(m,a,p);let h=await l();return ve(m,h,p)},async loadServiceResolution(p){let a=await N(e),m=d(a),h=Y(m.walk,y(m),p);if(!ye(a))return Rt(h,m,a);let u=await l();return gn(h,m,u)},async loadProviders(){let p=await N(e);return ln(d(p))},async loadProviderSupply(p,a){$r(a);let m=await N(e);return mn(d(m),p,a)},async loadProviderService(p,a){let m=await N(e),h=d(m),u=Y(h.walk,y(h),a);return un(h,p,u)},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 u=Oe(d(h).walk,p);return g.applyModule(u.id,a,m)})},async writeServiceIntegration(p,a,m){await g.warmup();let h=await N(e);return o(h),R(()=>{let u=d(h),v=Y(u.walk,y(u),p);return g.applyService(v,a,m)})},async deleteServiceIntegration(p){await g.warmup();let a=await N(e);return o(a),R(()=>{let m=d(a),h=Y(m.walk,y(m),p);return g.deleteService(h)})}},O={invalidate(){r.invalidate(),We(e)},async resolveContracts(){return N(e)},walkManifests(){return M(e)},parseModuleDescriptor(p){return ae(p)},loadProviderCatalogRaw(){return He(e)},async readIntegrationsConfig(){return G(e,r)},async writeIntegrationsConfig(p){return R(()=>Br(e,p,r))},async ensureMockBindings(){return R(()=>nn(e))},async evaluateIntegrationServices(p){await g.warmup();let a=await N(e);s(a);let m={resolveEffectiveService:f(a.module.resolveEffectiveService,"resolveEffectiveService"),buildSupplyLookup:f(a.module.buildSupplyLookup,"buildSupplyLookup"),normalizeInstances:f(a.module.normalizeInstances,"normalizeInstances"),RESOURCE_TYPE_IDS:a.module.RESOURCE_TYPE_IDS??[]};return ee({...p,contracts:m})}};function M(p){return D(p,r)}return{...I,...C,...O}}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,z as SAFE_NAME_PATTERN,on as appProviderBinding,Kt as assertValidModuleId,$e as buildIntegrationFieldRegistry,Ht as buildOwnershipMap,ue as buildPredicateAssembly,Je as checkInstanceKeys,Yt as collectDeclaredModules,B as contractsNotResolvedMessage,Lr as createAppToolkit,Be as createFileCache,en as createWriteCore,ir as credentialArtifactExists,fe as deepEqual,Q as deriveStem,Wn as discoverContractPackages,Se as echoForRef,Vn as ensureDir,nn as ensureMockBindings,Ze as evaluateAppIntegrationIssues,ee as evaluateIntegrationServices,Ue as expandEnvVars,Un as extractModuleIdFromSource,yn as formProviderOf,We as invalidateContractsResolver,K as isControlledInlineProvider,$n as isValidModuleId,Pr as loadAppIntegrationSchemas,cn as loadAppView,In as loadCredentialTypesView,Rn as loadCredentialsView,an as loadModuleDetailView,Vr as loadModuleIntegrationSchemas,sn as loadModulesView,be as loadProviderCatalog,He as loadProviderCatalogRaw,un as loadProviderServiceDetailView,mn as loadProviderSupplyView,ln as loadProvidersView,dn as loadServiceDetailView,hn as loadServiceFieldRegistry,Le as loadServiceIntegrationSchemas,gn as loadServiceResolutionDetail,ve as loadServiceResolutionsView,Re as manifestPath,we as maskCredentialValues,Cn as moduleDependencySchema,jn as moduleDescriptorSchema,U as moduleOwnershipWritable,Ve as moduleProviderBinding,bn as pageContribSchema,ae as parseModuleDescriptor,de as providerFootprint,En as providerSlotContribSchema,cr as pruneIntegrationBindings,Fn as readAppManifest,ze as readAppManifestFull,ce as readCredentialFile,G as readIntegrationsConfig,Yn as readIntegrationsStrict,ne as reconcileOrphanCredentials,Gn as refToEnvKey,Bt as removeNpmModule,me as resolutionKeys,N as resolveContractsForApp,N as resolveContractsForAppExport,vn as resolveLayerIntegrationSchemas,$ as resolveModuleBinding,Oe as resolveModuleKey,Y as resolveServiceKey,fn as resolveServiceSummary,Mn as resourceNeedContribSchema,On as serviceConsumeContribSchema,xn as serviceOwnContribSchema,ge as serviceProviderBinding,W as stemToFilePath,jt as stemToRef,An as tabContribSchema,Ut as updateNpmModule,Wt as upsertMiniappContainer,Lt as upsertNpmModule,D as walkManifests,$t as writeAppManifest,F as writeAtomic,Ke as writeCredentialFile};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbox.cn/app-toolkit",
3
- "version": "0.8.2",
3
+ "version": "0.8.3",
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.1",
21
+ "@tbox.cn/app-contracts": "0.13.3",
22
22
  "typescript": "5.9.3",
23
23
  "tsup": "8.5.1",
24
24
  "vitest": "4.1.10",
@@ -25,6 +25,9 @@ export interface EvaluationExports {
25
25
  RESOURCE_TYPE_IDS: readonly string[];
26
26
  /** 严格 zod 面(0.9+ 可选)——strictValidation 门控判据;缺席 = 求值/写 503 */
27
27
  parseIntegrationsConfig?: (raw: unknown) => IntegrationsConfig;
28
+ /** integrations.json 根 zod schema(additive;`schema` 命令生成形状文档用——不并入
29
+ * evaluation/strict 判据,旧 contracts 缺席时仅形状文档降级) */
30
+ integrationsSchema?: unknown;
28
31
  }
29
32
 
30
33
  /** resolver 运行时产物类型(动态 import 的命名导出子集) */
@@ -98,6 +98,9 @@ export const resourceNeedContribSchema = z.object({
98
98
 
99
99
  export const moduleDescriptorSchema = z
100
100
  .object({
101
+ // 元键(类型可选、行为惰性):供 CLI/schema 文档写入指针;strict 根形状下显式放行。
102
+ $comment: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
103
+ $schema: z.string().optional(),
101
104
  schemaVersion: z.number().default(1),
102
105
  // v7 词汇统一(标识/展示名分轴):id = 标识键(唯一、寻址,键 = install id 规约形态);
103
106
  // name = 展示名(中文、可选)——回退归视图层(name ?? id),schema 不灌值
package/src/dto.ts CHANGED
@@ -264,6 +264,9 @@ export interface ServiceResolutionDetail {
264
264
 
265
265
  /** root 节点 */
266
266
  export interface AppIntegrationNode {
267
+ /** 元键(类型可选、行为惰性——文档指针;GET 回显、PUT 仅保活,noDiff 排除) */
268
+ $comment?: string | Record<string, unknown>;
269
+ $schema?: string;
267
270
  /** 恒字符串(app/module 级无内联形态) */
268
271
  provider?: string;
269
272
  config?: Record<string, unknown>;
@@ -279,6 +282,8 @@ export interface AppIntegrationNode {
279
282
  * (缺席根键删除;services/modules 域不在其中;v6 domains 键退役)+ views/app 投影
280
283
  * (GET 预填 ≡ PUT body,/L1——文件含 services/modules 但 root 节点投影只含本键集)) */
281
284
  export const APP_INTEGRATION_NODE_KEYS = [
285
+ '$comment',
286
+ '$schema',
282
287
  'provider',
283
288
  'config',
284
289
  'configByInstance',
@@ -1,4 +1,4 @@
1
- import { existsSync } from 'node:fs';
1
+ import { existsSync, readFileSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import { walkManifests } from '../assembly/walk-manifests.js';
4
4
  import { writeAtomic } from '../core/fskit.js';
@@ -22,10 +22,40 @@ export interface MockBindingsResult {
22
22
  services: string[];
23
23
  }
24
24
 
25
+ /** 元键(create 种子可能预置 `$comment` 指针;生成绑定须保全——不可因派生覆盖丢失)。 */
26
+ const META_KEYS = ['$comment', '$schema'] as const;
27
+
28
+ /**
29
+ * pristine-empty 判定:文件在场但仍是 create 种子的空骨架(仅 services:{} + 可选元键)。
30
+ * 语义 = 视同缺席继续派生;任何用户事实(binding / modules / instances / credentialRef / config)
31
+ * 在场即 in-place 零侵入。坏 JSON 亦按用户文件处理(不覆盖)。
32
+ */
33
+ function isPristineEmpty(file: string): { pristine: boolean; meta: Record<string, unknown> } {
34
+ try {
35
+ const parsed = JSON.parse(readFileSync(file, 'utf8')) as Record<string, unknown> | null;
36
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return { pristine: false, meta: {} };
37
+ // 只认「services + 元键」白名单:任何未知键 = 用户内容(含拼错键与全部事实键),不得覆盖。
38
+ const allowed = new Set<string>(['services', ...META_KEYS]);
39
+ if (Object.keys(parsed).some((key) => !allowed.has(key))) return { pristine: false, meta: {} };
40
+ const services = parsed.services;
41
+ if (!services || typeof services !== 'object' || Array.isArray(services) || Object.keys(services).length > 0) {
42
+ return { pristine: false, meta: {} };
43
+ }
44
+ const meta: Record<string, unknown> = {};
45
+ for (const key of META_KEYS) if (key in parsed) meta[key] = parsed[key];
46
+ return { pristine: true, meta };
47
+ } catch {
48
+ return { pristine: false, meta: {} };
49
+ }
50
+ }
51
+
25
52
  export function ensureMockBindings(appDir: string): MockBindingsResult {
26
53
  const file = join(appDir, 'config', 'integrations.json');
54
+ let meta: Record<string, unknown> = {};
27
55
  if (existsSync(file)) {
28
- return { generated: false, reason: 'in-place', services: [] };
56
+ const state = isPristineEmpty(file);
57
+ if (!state.pristine) return { generated: false, reason: 'in-place', services: [] };
58
+ meta = state.meta;
29
59
  }
30
60
  const slots: Array<{ service: string; provider: string; implementation: string }> = [];
31
61
  for (const mod of walkManifests(appDir).modules) {
@@ -43,13 +73,13 @@ export function ensureMockBindings(appDir: string): MockBindingsResult {
43
73
  // 单一 local 厂商 → terse:root.provider 继承 + 空槽对象(instances 缺席 = 通配激活)
44
74
  const [vendor] = vendors;
45
75
  for (const s of slots) services[s.service] = {};
46
- writeAtomic(file, `${JSON.stringify({ provider: vendor, services }, null, 2)}\n`);
76
+ writeAtomic(file, `${JSON.stringify({ ...meta, provider: vendor, services }, null, 2)}\n`);
47
77
  } else {
48
78
  // 异构兜底:逐槽双字段(显式绑定组——无 root 继承位;同样零拓扑)
49
79
  for (const s of slots) {
50
80
  services[s.service] = { provider: s.provider, implementation: s.implementation };
51
81
  }
52
- writeAtomic(file, `${JSON.stringify({ services }, null, 2)}\n`);
82
+ writeAtomic(file, `${JSON.stringify({ ...meta, services }, null, 2)}\n`);
53
83
  }
54
84
  return { generated: true, reason: 'generated', services: slots.map((s) => s.service).sort() };
55
85
  }
@@ -85,6 +85,33 @@ export function deepEqual(a: unknown, b: unknown): boolean {
85
85
  return false;
86
86
  }
87
87
 
88
+ /** 根级元键($comment/$schema):类型可选、行为惰性(contracts strictObject 显式放行)。
89
+ * 写路径保活——全量替换语义下从 current 显式携带;noDiff 由 deepEqualIgnoringRootMeta 排除根级元键。
90
+ * 节点级元键不种入(节点 schema 未放行),因此只需根级单点。 */
91
+ const META_KEYS = ['$comment', '$schema'] as const;
92
+
93
+ function carryRootMeta(next: Record<string, unknown>, current: Record<string, unknown> | null): void {
94
+ if (!current) return;
95
+ for (const key of META_KEYS) {
96
+ if (!(key in next) && key in current) next[key] = current[key];
97
+ }
98
+ }
99
+
100
+ /** noDiff 比较排除根级元键(纯注释变化不触发写;实际注释由 carryRootMeta 保全)。 */
101
+ function withoutRootMeta(value: Record<string, unknown> | null): Record<string, unknown> | null {
102
+ if (value === null) return null;
103
+ const rest = { ...value };
104
+ for (const key of META_KEYS) delete rest[key];
105
+ return rest;
106
+ }
107
+
108
+ function deepEqualIgnoringRootMeta(
109
+ a: Record<string, unknown> | null,
110
+ b: Record<string, unknown> | null,
111
+ ): boolean {
112
+ return deepEqual(withoutRootMeta(a), withoutRootMeta(b));
113
+ }
114
+
88
115
  /** 输入约束①(安全钉子, 扩位):node 内 provider/instanceId 值位 + map 键位字符集校验
89
116
  * (第一道;deriveStem 断言为第二道)。违例 → 400 + fields 指向。 */
90
117
  function assertSafeNames(value: unknown, path: string): void {
@@ -396,8 +423,9 @@ export function createWriteCore(appDir: string, opts: WriteCoreOptions = {}): Wr
396
423
  }
397
424
  next.credentialRefByInstance = byInstance;
398
425
  }
426
+ carryRootMeta(next, current);
399
427
  const hasCredentialInput = writeOpts.credentials !== undefined || writeOpts.credentialsByInstance !== undefined;
400
- const noDiff = deepEqual(current, next);
428
+ const noDiff = deepEqualIgnoringRootMeta(current, next);
401
429
  if (noDiff && !hasCredentialInput) {
402
430
  return { written: false, restartScheduled: false, files: [], credentials: [], issues };
403
431
  }
@@ -462,6 +490,7 @@ export function createWriteCore(appDir: string, opts: WriteCoreOptions = {}): Wr
462
490
  modulesNode[moduleId] = nextNode;
463
491
  }
464
492
  const next: Record<string, unknown> = { ...base, modules: modulesNode };
493
+ carryRootMeta(next, current);
465
494
  if (deepEqual(current, next)) {
466
495
  return { written: false, restartScheduled: false, files: [], credentials: [], issues };
467
496
  }
@@ -498,6 +527,7 @@ export function createWriteCore(appDir: string, opts: WriteCoreOptions = {}): Wr
498
527
  const base: Record<string, unknown> = current ?? { services: {} };
499
528
  const services = { ...((base.services as Record<string, unknown>) ?? {}) };
500
529
  const next: Record<string, unknown> = { ...base, services };
530
+ carryRootMeta(next, current);
501
531
  // N3:服务节点 {} 不归一化(显式通配激活 = 合法 TIER0 态,与键缺席两义)——原样落位
502
532
  services[service] = { ...node };
503
533
  // 凭据纯派生 + 校验链(dryRun 也跑;内联声明 credentialType 为校验链输入)
@@ -523,8 +553,9 @@ export function createWriteCore(appDir: string, opts: WriteCoreOptions = {}): Wr
523
553
  }
524
554
  slotNode.instances = instances;
525
555
  }
556
+ carryRootMeta(next, current);
526
557
  const hasCredentialInput = writeOpts.credentials !== undefined || writeOpts.credentialsByInstance !== undefined;
527
- const noDiff = deepEqual(current, next);
558
+ const noDiff = deepEqualIgnoringRootMeta(current, next);
528
559
  if (noDiff && !hasCredentialInput) {
529
560
  return { written: false, restartScheduled: false, files: [], credentials: [], issues };
530
561
  }
@@ -44,7 +44,11 @@ describe.skipIf(parseIntegrationsConfig === undefined)('键集-zod 锁步(asse
44
44
  ? { 'mall-bj-01': 'secret://a-b-0' }
45
45
  : k === 'configByInstance'
46
46
  ? { 'mall-bj-01': {} }
47
- : {};
47
+ : k === '$comment'
48
+ ? 'meta'
49
+ : k === '$schema'
50
+ ? 'https://example.com/schema.json'
51
+ : {};
48
52
  }
49
53
  expectZodPass(full);
50
54
  expectZodReject({ services: {}, unknownKey: 1 });
@@ -197,3 +197,15 @@ describe('module-schema(descriptor zod 单源)', () => {
197
197
  }
198
198
  });
199
199
  });
200
+
201
+
202
+ describe('manifest 元键($comment / $schema)', () => {
203
+ it('元键两形态通过(行为惰性)', () => {
204
+ expect(parseModuleDescriptor({ ...BASE_MANIFEST, $comment: '形状: npx --yes @tbox.cn/app-cli schema tbox.module.json' }).ok).toBe(true);
205
+ expect(parseModuleDescriptor({ ...BASE_MANIFEST, $schema: 'x', $comment: { declare: '声明面' } }).ok).toBe(true);
206
+ });
207
+
208
+ it('拼错元键仍被 strict 拒', () => {
209
+ expect(parseModuleDescriptor({ ...BASE_MANIFEST, $coment: 'typo' }).ok).toBe(false);
210
+ });
211
+ });
@@ -53,6 +53,25 @@ describe('写核心管线(FX-1c)', () => {
53
53
  h.app.dispose();
54
54
  });
55
55
 
56
+ it('元键保活:种子 $comment 在写路径存活(noDiff 天然相等;根级单点)', async () => {
57
+ writeAppFile(h.app.appDir, INTEGRATIONS_FILE, JSON.stringify({
58
+ $comment: '形状: npx --yes @tbox.cn/app-cli schema config/integrations.json',
59
+ services: {},
60
+ }, null, 2));
61
+ const r = await h.tk.writeAppIntegration({ provider: 'mock-x' } as never);
62
+ expect(r.written).toBe(true);
63
+ const cfg = h.readConfig();
64
+ expect(cfg.$comment).toContain('schema');
65
+ expect(cfg.provider).toBe('mock-x');
66
+ // 同节点重放 → noDiff(元键不参与 diff)
67
+ const r2 = await h.tk.writeAppIntegration({ provider: 'mock-x' } as never);
68
+ expect(r2.written).toBe(false);
69
+ // 仅注释变化的 PUT → 也不写(注释由 current 保全)
70
+ const r3 = await h.tk.writeAppIntegration({ provider: 'mock-x', $comment: '新注释' } as never);
71
+ expect(r3.written).toBe(false);
72
+ expect(h.readConfig().$comment).toContain('schema');
73
+ });
74
+
56
75
  it('T1 writeAppIntegration 节点合并(B1 钉死):node 生效 + dryRun 无 dryRun 键注入 + 回读等价', async () => {
57
76
  const node = {
58
77
  provider: 'mock-x',