Make http[verb] a partial applicable

[cloud-walker]

Hi! Reading this docs I had the idea to make a util myself that works the same way the http object works, but in a more partial applicable way, here is my implementation:

import {
  http,
  HttpHandler,
  type DefaultBodyType,
  type HttpResponseResolver,
  type PathParams,
  type RequestHandlerOptions,
} from 'msw'

type Verb = keyof typeof http

function makeHttpRequestHandler(verb: Verb) {
  function httpRequestHandler<
    TParams extends PathParams = PathParams,
    TRequest extends DefaultBodyType = DefaultBodyType,
    TResponse extends DefaultBodyType = DefaultBodyType,
  >(
    path: string,
  ): (
    resolver: HttpResponseResolver<TParams, TRequest, TResponse>,
    options?: RequestHandlerOptions,
  ) => HttpHandler
  function httpRequestHandler<
    TParams extends PathParams = PathParams,
    TRequest extends DefaultBodyType = DefaultBodyType,
    TResponse extends DefaultBodyType = DefaultBodyType,
  >(
    path: string,
    resolver: HttpResponseResolver<TParams, TRequest, TResponse>,
    options?: RequestHandlerOptions,
  ): HttpHandler
  function httpRequestHandler(
    path: string,
    resolver?: HttpResponseResolver,
    options?: RequestHandlerOptions,
  ) {
    if (!resolver) {
      return (resolver: HttpResponseResolver) =>
        http[verb](path, resolver, options)
    }
    return http[verb](path, resolver, options)
  }

  return httpRequestHandler
}

export const mock = {
  all: makeHttpRequestHandler('all'),
  head: makeHttpRequestHandler('head'),
  get: makeHttpRequestHandler('get'),
  post: makeHttpRequestHandler('post'),
  put: makeHttpRequestHandler('put'),
  delete: makeHttpRequestHandler('delete'),
  patch: makeHttpRequestHandler('patch'),
  options: makeHttpRequestHandler('options'),
} as const satisfies Record<Verb, unknown>

This way you can:

const makeUpdateTodoHandler = mock.put<
  {id: string},
  {body: string},
  {id: string; body: string; createdAt: Date; updatedAt: Date}
>('/todos/:id')

// later on

const updateTodoHandler = makeUpdateTodoHandler(({params, request}) => {
	// ...
})

I think that should be integrated directly inside msw

[kettanaito]

Hi, @cloud-walker. Thanks for sharing this!

I think this is perfect for the userland, and you are encouraged to make any custom utilities around request handling if they make sense in the context of your app. At the same time, I think this kind of abstraction doesn't belong in the core of MSW. I am of a strong belief that a tool should provide you with LEGO bricks and then you build what you want. I also believe there should be no more than 1 way to solve a problem so the consumer isn't stuck in the uncertainty of how to, say, intercept a request.

What I recommend is this: if you believe this is a helpful utility, publish it on NPM! This way, it will work in addition to MSW, be explicit, and anybody can enjoy it!