Summary

This patch release fixes several bugs and documentation issues across static serving, request/body handling, AWS Lambda event detection, and Bun WebSocket handling. It also includes minor packaging and dev-dependency updates. No explicit breaking changes were announced.

Key Points

• serve-static: treat an empty-string response body as a found resource to avoid false 404s.
• Request/raw headers docs: req.raw.headers is a property (not a method) — update any code calling it as a function.
• Content-Type normalization: body utils and validator now normalize media types for case-insensitive matching (e.g., "Application/JSON" vs "application/json").
• Circular import: fixed an import cycle between body.ts and request.ts to prevent runtime/ bundling issues.
• AWS Lambda: better detection of API Gateway V2 events by inspecting the request context instead of relying on rawPath alone.
• Bun WebSocket: WSContext.protocol now reports the requested subprotocol correctly.
• Packaging/dev: .tsbuildinfo files excluded from published package and devDependencies bumped.
• Contributor notes: three first-time contributors were merged in this release.

Upgrade notes / action items

• If you previously accessed req.raw.headers as a function, change it to use the property form (req.raw.headers).
• Check any custom Content-Type checks to rely on normalized media types (case-insensitive comparisons).
• If you encountered runtime errors from circular imports between body/request modules, update to this release to resolve them.

References

Release: v4.12.28 · published 2026-07-06T10:08:05.000Z