Skip to content

Endpoint v2 declaration#298

Merged
confused-Techie merged 5 commits intov1.2from
v2-endpoint-declaration
Jan 22, 2026
Merged

Endpoint v2 declaration#298
confused-Techie merged 5 commits intov1.2from
v2-endpoint-declaration

Conversation

@confused-Techie
Copy link
Member

This PR introduces a v2 endpoint version, as well as enables handling of multiple different endpoint versions when building endpoints.

The intention of this new declaration format is to enable easier to build endpoints, simpler declarations, and of course closing the gap between intended behavior and actual behavior on the endpoint.

You may notice that this idea is a re-implementation of #293 as I've had time to think about that PR and find other ways to improve upon it.

My example for testing this functionality is again by adding support for the Server-Timing specification to a single endpoint (/api/owners/:ownerName).

Since this capability very much shows how closely linked we can make the endpoint main logic, the instantiated context, and the end HTTP result.

Better than my previous version I've added some documentation to help explain the differences, and properly define them.

The modification to the endpoint builder means we can upgrade this new behavior per endpoint as needed without breaking the rest of the codebase or requiring huge updates across the board like we've had to in the past.

The intention of this PR is to build towards #297 as I've been doing elsewhere

@confused-Techie
Copy link
Member Author

Gonna go ahead and merge this one as it's just to a feature branch

@confused-Techie confused-Techie merged commit 41ff076 into v1.2 Jan 22, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant