Files
KArtSell.Aegis/docs/Design/kbx-foundation-v36/scripts/validate-live-openapi.mjs
T

29 lines
1.7 KiB
JavaScript

import fs from 'node:fs'
const livePath=process.env.KBX_LIVE_OPENAPI || 'artifacts/openapi.json'
if(!fs.existsSync(livePath)){
console.log(`Live OpenAPI snapshot not found at ${livePath}; host DTO/schema gate is deferred until the .NET host is available.`)
process.exit(0)
}
const contract=JSON.parse(fs.readFileSync('generated/api-manifest.json','utf8'))
const live=JSON.parse(fs.readFileSync(livePath,'utf8'))
const actual=new Map()
for(const [path,item] of Object.entries(live.paths??{})){
for(const method of ['get','post','put','patch','delete']){
const op=item?.[method];if(!op)continue
if(op.operationId)actual.set(op.operationId,{method:method.toUpperCase(),path,op})
}
}
const errors=[]
const normalize=p=>p.replace(/\{([^}:]+):[^}]+\}/g,'{$1}').toLowerCase()
for(const expected of contract.operations){
const got=actual.get(expected.id)
if(!got){errors.push(`live OpenAPI missing operationId ${expected.id}`);continue}
if(got.method!==expected.method || normalize(got.path)!==normalize(expected.path))errors.push(`live route drift ${expected.id}: ${got.method} ${got.path}`)
if((got.op['x-kbx-permission']??null)!==(expected.permission??null))errors.push(`live permission drift ${expected.id}`)
if((got.op['x-kbx-idempotency']??'none')!==expected.idempotency)errors.push(`live idempotency drift ${expected.id}`)
for(const status of ['400','403','404','409','422','500'])if(!got.op.responses?.[status])errors.push(`live Problem response ${status} missing: ${expected.id}`)
}
if(errors.length){console.error(errors.map(x=>`LIVE OPENAPI ERROR: ${x}`).join('\n'));process.exit(1)}
console.log(`Live OpenAPI contract PASS: ${contract.operationCount} operations with KBX metadata/problem responses.`)