feat: wrap createContext in helperfunc to make it independent of req/res

.changeset/clever-pots-pump.md

@@ -0,0 +1,5 @@
+---
+"create-t3-app": minor
+---
+
+feat: wrap createContext with helper function to make it independent of req/res

cli/template/addons/trpc/auth-context.ts

@@ -1,24 +1,38 @@
 // src/server/router/context.ts
 import * as trpc from "@trpc/server";
 import * as trpcNext from "@trpc/server/adapters/next";
-import { unstable_getServerSession as getServerSession } from "next-auth";
-
+import {
+  Session,
+  unstable_getServerSession as getServerSession,
+} from "next-auth";
 import { authOptions as nextAuthOptions } from "../../pages/api/auth/[...nextauth]";
 
+type CreateContextOptions = {
+  session: Session | null;
+};
+
+/** Use this helper for:
+ *  - testing, where we dont have to Mock Next.js' req/res
+ *  - trpc's `createSSGHelpers` where we don't have req/res
+ */
+export const createContextInner = async (opts: CreateContextOptions) => {
+  return {
+    session: opts.session,
+  };
+};
+
+/**
+ * This is the actual context you'll use in your router
+ * @link https://trpc.io/docs/context
+ **/
 export const createContext = async (
-  opts?: trpcNext.CreateNextContextOptions,
+  opts: trpcNext.CreateNextContextOptions,
 ) => {
-  const req = opts?.req;
-  const res = opts?.res;
-
-  const session =
-    req && res && (await getServerSession(req, res, nextAuthOptions));
+  const session = await getServerSession(opts.req, opts.res, nextAuthOptions);
 
-  return {
-    req,
-    res,
+  return await createContextInner({
     session,
-  };
+  });
 };
 
 type Context = trpc.inferAsyncReturnType<typeof createContext>;

cli/template/addons/trpc/auth-prisma-context.ts

@@ -1,28 +1,42 @@
 // src/server/router/context.ts
 import * as trpc from "@trpc/server";
 import * as trpcNext from "@trpc/server/adapters/next";
-import { unstable_getServerSession as getServerSession } from "next-auth";
-
+import {
+  Session,
+  unstable_getServerSession as getServerSession,
+} from "next-auth";
 import { authOptions as nextAuthOptions } from "../../pages/api/auth/[...nextauth]";
 import { prisma } from "../db/client";
 
-export const createContext = async (
-  opts?: trpcNext.CreateNextContextOptions,
-) => {
-  const req = opts?.req;
-  const res = opts?.res;
-
-  const session =
-    req && res && (await getServerSession(req, res, nextAuthOptions));
+type CreateContextOptions = {
+  session: Session | null;
+};
 
+/** Use this helper for:
+ * - testing, where we dont have to Mock Next.js' req/res
+ * - trpc's `createSSGHelpers` where we don't have req/res
+ **/
+export const createContextInner = async (opts: CreateContextOptions) => {
   return {
-    req,
-    res,
-    session,
+    session: opts.session,
     prisma,
   };
 };
 
+/**
+ * This is the actual context you'll use in your router
+ * @link https://trpc.io/docs/context
+ **/
+export const createContext = async (
+  opts: trpcNext.CreateNextContextOptions,
+) => {
+  const session = await getServerSession(opts.req, opts.res, nextAuthOptions);
+
+  return await createContextInner({
+    session,
+  });
+};
+
 type Context = trpc.inferAsyncReturnType<typeof createContext>;
 
 export const createRouter = () => trpc.router<Context>();

cli/template/addons/trpc/base-context.ts

@@ -2,14 +2,24 @@
 import * as trpc from "@trpc/server";
 import * as trpcNext from "@trpc/server/adapters/next";
 
-export const createContext = (opts?: trpcNext.CreateNextContextOptions) => {
-  const req = opts?.req;
-  const res = opts?.res;
+type CreateContextOptions = {};
 
-  return {
-    req,
-    res,
-  };
+/** Use this helper for:
+ * - testing, where we dont have to Mock Next.js' req/res
+ * - trpc's `createSSGHelpers` where we don't have req/res
+ **/
+export const createContextInner = async (opts: CreateContextOptions) => {
+  return {};
+};
+
+/**
+ * This is the actual context you'll use in your router
+ * @link https://trpc.io/docs/context
+ **/
+export const createContext = async (
+  opts: trpcNext.CreateNextContextOptions,
+) => {
+  return await createContextInner({});
 };
 
 type Context = trpc.inferAsyncReturnType<typeof createContext>;

cli/template/addons/trpc/prisma-context.ts

@@ -3,17 +3,28 @@ import * as trpc from "@trpc/server";
 import * as trpcNext from "@trpc/server/adapters/next";
 import { prisma } from "../db/client";
 
-export const createContext = (opts?: trpcNext.CreateNextContextOptions) => {
-  const req = opts?.req;
-  const res = opts?.res;
+type CreateContextOptions = {};
 
+/** Use this helper for:
+ * - testing, where we dont have to Mock Next.js' req/res
+ * - trpc's `createSSGHelpers` where we don't have req/res
+ **/
+export const createContextInner = async (opts: CreateContextOptions) => {
   return {
-    req,
-    res,
     prisma,
   };
 };
 
+/**
+ * This is the actual context you'll use in your router
+ * @link https://trpc.io/docs/context
+ **/
+export const createContext = (opts: trpcNext.CreateNextContextOptions) => {
+  return createContextInner({
+    prisma,
+  });
+};
+
 type Context = trpc.inferAsyncReturnType<typeof createContext>;
 
 export const createRouter = () => trpc.router<Context>();