feat(http-specs): add HEAD payload scenario with response headers

[Copilot]

case from #9809

storage blob is https://github.com/Azure/azure-rest-api-specs/blob/7e31f1df6af1979b18eaf294d239c24e89c3ffd6/specification/storage/Microsoft.BlobStorage/routes.tsp#L819

---

Adds a new Spector scenario under payload/head covering a HEAD operation that returns Content-Type and x-ms-meta response headers — a pattern common in blob/storage-style APIs that was previously untested.

Changes

• specs/payload/head/main.tsp — defines Payload.Head service with a single contentTypeHeaderInResponse HEAD operation returning:
  • Content-Type: text/plain; charset=utf-8 header
  • x-ms-meta header via a shared MetadataHeaders alias

alias MetadataHeaders = {
  @header("x-ms-meta")
  metadata?: string;
};

@scenario
@head
@route("/content-type-header-in-response")
op contentTypeHeaderInResponse(): {
  @header("Content-Type")
  contentType?: string;
  ...MetadataHeaders;
};

• specs/payload/head/mockapi.ts — mock returns 200 with content-type: text/plain; charset=utf-8 and x-ms-meta: hello response headers, no body.
• spec-summary.md — regenerated to reflect the updated scenario name and endpoint.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@typespec/http-specs@10194

commit: 49cbf79

[weidongxu-microsoft]

@copilot

Validation seems has an error
https://github.com/microsoft/typespec/actions/runs/23729514485/job/69120607236?pr=10194

Maybe we can update in test and mockapi and summary to say return content-type is text/plain; charset=utf-8

[Copilot]

@copilot

Validation seems has an error
...

Fixed in 84089d7 — updated content-type to text/plain; charset=utf-8 in mockapi.ts, the @scenarioDoc, and regenerated spec-summary.md.

[azure-sdk]

You can try these changes here

🛝 Playground	🌐 Website	🛝 VSCode Extension

[github-actions]

All changed packages have been documented.

• ✅ @typespec/http-specs

Show changes

@typespec/http-specs - feature ✏️

Add HEAD payload e2e test scenario with Content-Type and x-ms-meta response headers