feat: expose a req/res context for API implementation

[hexcowboy]

Currently I'm unable to authenticate user requests since doing so with NextAuth requires the Request and Response objects to check auth.

I'd like to propose an API similar to this, exposing a ctx object:

// pages/api/message.swr.tsx
import { query } from "@next-fetch/swr";
import z from "zod";

import { authOptions } from 'pages/api/auth/[...nextauth]';
import { unstable_getServerSession } from "next-auth/next";

export const useMessage = query(
  async function ({ ctx }) {
    const session = await unstable_getServerSession(ctx.req, ctx.res, authOptions)
    return { hello: `world, ${session.user.name}` };
  }
);

Additionally, the documentation is misleading:

export const useMessage = query(
  // use zod or other input validation libraries
  z.object({
    name: z.string(),
  }),
  async function ({ name }) {
    // this.request is a `Request` instance            <------------ this.request is not available here
    return { hello: "world, " + name };
  }
);

[prichodko]

Agreed with exposing the response object.

Btw, make sure that you are passing a normal function and not an arrow function. Arrow function this behaves differently. Normal function works for me.