refactor(middleware)!: standardize middleware naming

[halvaradop]

Description

This pull request standardizes middleware naming by replacing the middlewares property with use. The change aligns the API with common conventions in backend frameworks such as Express, Hono, and Fastify, where use is the standard keyword for registering middleware. The underlying middleware behavior and execution model remain unchanged.

Note

BREAKING CHANGE: Middleware configuration has been renamed. Update all imports and usage from middlewares to use.

Summary by CodeRabbit

Release Notes

• Breaking Changes

  • Renamed the middlewares configuration option to use across all routing configuration paths (router configuration, endpoint configuration, and endpoint configs)

• Documentation

  • Updated all examples and documentation to reflect the new use property name throughout the API

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
router	Ready	Preview, Comment	Feb 24, 2026 3:16pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8889864 and 9e0d251.

📒 Files selected for processing (14)

• CHANGELOG.md
• docs/src/content/docs/create-endpoint-config.mdx
• docs/src/content/docs/create-endpoint.mdx
• docs/src/content/docs/create-router.mdx
• docs/src/content/docs/index.mdx
• docs/src/content/docs/middlewares.mdx
• src/endpoint.ts
• src/middlewares.ts
• src/router.ts
• src/types.ts
• test/client.test.ts
• test/endpoint.test.ts
• test/router.test.ts
• test/type.test-d.ts

---

📝 Walkthrough

Walkthrough

This PR renames the public configuration option middlewares to use across router, endpoint, and endpoint configuration APIs. The behavior and functionality remain unchanged; only the property name is updated throughout type definitions, implementation, documentation, and tests.

Changes

Cohort / File(s)	Summary
Type Definitions src/types.ts	Renamed middlewares to use in both EndpointConfig and RouterConfig public interfaces.
Implementation src/middlewares.ts, src/router.ts, src/endpoint.ts	Updated middleware execution functions and router configuration access to reference the renamed use property instead of middlewares. Added null/undefined guards for the new property name.
Documentation docs/src/content/docs/create-router.mdx, docs/src/content/docs/create-endpoint.mdx, docs/src/content/docs/create-endpoint-config.mdx, docs/src/content/docs/index.mdx, docs/src/content/docs/middlewares.mdx	Updated all code examples and configuration references to use use instead of middlewares. Also updated RouteEndpoint generic to accept `HTTPMethod
Tests test/endpoint.test.ts, test/router.test.ts, test/type.test-d.ts, test/client.test.ts	Updated test configurations and type expectations to use use instead of middlewares. Converted async fetch mock to synchronous function in client tests.
CHANGELOG CHANGELOG.md	Added BREAKING CHANGES entry documenting the rename from middlewares to use.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• feat(endpoint): add multi-method support to endpoints #36: Modifies RouteEndpoint generic type constraint to accept single HTTPMethod or array of HTTPMethods, enabling multi-method endpoint declarations (related through shared type-level API changes in router configuration).

Suggested labels

enhancement

Poem

🐰 Middleware hops with a newer name,
From middlewares to use—still the same game,
Configuration refined with a sleeker call,
Hopping through endpoints, routers, and all! ✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch refactor/update-middleware-naming

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}