fix: add types for 'preRewrite'.

Author: mn4367

README.md

@@ -203,6 +203,18 @@ A function that will be executed before rewriting the URL. It receives the URL,
 
 The function cannot return a promise.
 
+```javascript
+// `/api/abc` will be proxied to `http://api-upstream.com/api2/xyz`
+fastify.register(proxy, {
+  upstream: `http://api-upstream.com`,
+  prefix: '/api',
+  rewritePrefix: '/api2/',
+  preRewrite (url, params, prefix) {
+    return url.replace('abc', 'xyz');
+  }
+})
+```
+
 ### `websocket`
 
 This module has _partial_ support for forwarding websockets by passing a

types/index.d.ts

@@ -53,6 +53,12 @@ type FastifyHttpProxy = FastifyPluginCallback<
 >
 
 declare namespace fastifyHttpProxy {
+  type preRewriteHookHandler = (
+    url: string,
+    params: unknown,
+    prefix: string
+  ) => string
+
   type QueryStringFunction = (
     search: string | undefined,
     reqUrl: string,
@@ -67,6 +73,7 @@ declare namespace fastifyHttpProxy {
     preHandler?: preHandlerHookHandler;
     beforeHandler?: preHandlerHookHandler;
     preValidation?: preValidationHookHandler;
+    preRewrite?: preRewriteHookHandler;
     config?: Object;
     replyOptions?: FastifyReplyFromHooks;
     wsClientOptions?: ClientOptions & { queryString?: { [key: string]: unknown } | QueryStringFunction; };

types/index.test-d.ts

@@ -34,6 +34,12 @@ app.register(fastifyHttpProxy, {
     expectType<RawRequestDefaultExpression>(request.raw)
     expectType<RawReplyDefaultExpression>(reply.raw)
   },
+  preRewrite: (url, params, prefix): string => {
+    expectType<string>(url)
+    expectType<unknown>(params)
+    expectType<string>(prefix)
+    return ''
+  },
   base: 'whatever',
   cacheURLs: 10,
   undici: {