docs(tests): clarify integration request counts and fixture lifecycle

2026-11-12 18:10:04 +08:00
parent a582052a1e
commit bf89a1da2e
3 changed files with 7 additions and 1 deletions
@@ -70,7 +70,7 @@ try{
  const assetReceipt=await fetch(`http://127.0.0.1:${port}/api/foundry/${receiptPath}`);assert.equal(assetReceipt.status,200);assert.deepEqual(await assetReceipt.json(),{id:'fixture'});
  const metadata=await fetch(`http://127.0.0.1:${port}/api/foundry/${receiptPath.replace('/operations/','/metadata/')}`,{headers:{'X-Expected-Account':account,Cookie:'foundry_session=fixture-session'}});assert.equal(metadata.status,200);assert.deepEqual(await metadata.json(),{id:'fixture'});assert.match(metadata.headers.get('cache-control'),/no-store/);const metadataRequest=received.find(item=>item.path.includes('/assets/metadata/'));assert.equal(metadataRequest.headers['x-expected-account'],account);assert.equal(metadataRequest.headers.authorization,'Bearer fixture-session');
  console.log('PASS asset metadata JSON uses the actual authenticated Next proxy without image-body validation or caching');
-  // FormData 自带 boundary，检查代理保留 multipart 字节及 X-Resource-Id，而不自行重新编码文件。
+  // FormData 自带 boundary；下面核对文件内容片段、Content-Type 和资源/幂等身份头，未逐字节比较整份 multipart 包。
  const multipart=new FormData();multipart.append('image',new Blob(['immutable file'],{type:'image/png'}),'fixture.png');
  const assetPath=receiptPath.split('/operations/')[0],resourceId='10000000-0000-4000-8000-000000000006';
  const uploaded=await fetch(`http://127.0.0.1:${port}/api/foundry/${assetPath}`,{method:'POST',body:multipart,headers:{'X-Resource-Id':resourceId,'Idempotency-Key':key,'X-Expected-Account':account}});await uploaded.text();assert.equal(uploaded.status,200);
@@ -91,6 +91,7 @@ try{
  // 上游尾部仍挂起时读取第一块，随后释放并核对余下字节，验证端到端增量转发。
  const streamed=await fetch(`http://127.0.0.1:${port}/api/foundry/${path.replace('/operations','')}`,{headers:{Accept:'application/vnd.foundry.canvas-model+ndjson;version=1'}});
  assert.equal(streamed.headers.get('content-type'),'application/vnd.foundry.canvas-model+ndjson;version=1');
+  // 尾部 gate 尚未放开就等待首块，才能区分增量转发和整条缓冲；随后放开并排空剩余 body。
  const reader=streamed.body.getReader(),first=await reader.read();assert.equal(new TextDecoder().decode(first.value),streamPrefix);streamRelease();let rest='';while(true){const next=await reader.read();if(next.done)break;rest+=new TextDecoder().decode(next.value);}assert.equal(rest,streamTail);reader.releaseLock();
  console.log('PASS negotiated canonical NDJSON and first chunk cross the actual Next proxy before the gated tail');
  // 多余路径段应在代理 allowlist 被拒绝，不能发到上游再依赖上游返回错误。