feature: Nextjs 13 App Directory Utility Methods

[siddhsuresh]

Continues #4079

What are the changes and their implications?

🔧 New Blitz Auth Hook useAuthenticatedBlitzContext

This hook is implemented as the replacement of the BlitzPage seurity auth utilities provided for the pages directory to work with React Server Components in the Nextjs 13 app directory
It can be used in any asynchronous server component be it in page.ts or in the layouts in layout.ts
It uses the new redirect function to provide the required authorization in server side

API

useAuthenticatedBlitzContext({
  redirectTo,
  redirectAuthenticatedTo,
  role,
}: {
  redirectTo?: string | RouteUrlObject
  redirectAuthenticatedTo?: string | RouteUrlObject | ((ctx: Ctx) => string | RouteUrlObject)
  role?: string | string[]
}): Promise<void>

Usage

Example Usage in React Server Component in app directory in Next 13

import {getAppSession, useAuthenticatedBlitzContext} from "src/blitz-server"
...
await useAuthenticatedBlitzContext({
    redirectTo: "/auth/login",
    role: ["admin"],
    redirectAuthenticatedTo: "/dashboard",
})

🔧 New Blitz RPC Hook invokeResolver

API

invokeResolver<T extends (...args: any) => any, TInput = FirstParam<T>>(
  queryFn: T,
  params: TInput,
): Promise<PromiseReturnType<T>> 

Example Usage

...
import {invokeResolver, useAuthenticatedBlitzContext} from "../src/blitz-server"
import getCurrentUser from "../src/users/queries/getCurrentUser"

export default async function Home() {
  await useAuthenticatedBlitzContext({
    redirectTo: "/auth/login",
  })
  const user = await invokeResolver(getCurrentUser, null)
...

Feature Checklist

• Changeset added (run pnpm changeset in the root directory)
• Integration test added (see test docs if needed)
• Documentation added/updated (submit PR to blitzjs.com repo main branch)

[changeset-bot]

🦋 Changeset detected

Latest commit: 7ca46ac

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages

Name	Type
next-blitz-auth	Patch
@blitzjs/auth	Patch
@blitzjs/rpc	Patch
blitz	Patch
@blitzjs/next	Patch
@blitzjs/codemod	Patch
@blitzjs/config	Patch
@blitzjs/generator	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR