chore: rename session from verify to fetch

Author: atinux

README.md

@@ -195,12 +195,15 @@ We leverage hooks to let you extend the session data with your own data or to lo
 ```ts
 // server/plugins/session.ts
 export default defineNitroPlugin(() => {
-  sessionHooks.hook('verify', async (session, event) => {
+  // Called when the session is fetched during SSR for the Vue composable (/api/_auth/session)
+  // Or when we call useUserSession().fetch()
+  sessionHooks.hook('fetch', async (session, event) => {
     // extend User Session by calling your database
     // or
     // throw createError({ ... }) if session is invalid for example
   })
 
+  // Called when we call useServerSession().clear() or clearUserSession(event)
   sessionHooks.hook('clear', async (session, event) => {
     // Log that user logged out
   })

playground/server/plugins/session.ts

@@ -1,14 +1,15 @@
 export default defineNitroPlugin(() => {
-  sessionHooks.hook('verify', async (session) => {
+  sessionHooks.hook('fetch', async (session) => {
     // Extend User Session
     // Or throw createError({ ... }) if session is invalid
     session.extended = {
       fromHooks: true
     }
   })
 
-  sessionHooks.hook('clear', async () => {
+  sessionHooks.hook('clear', async (session) => {
     // Log that user logged out
+    console.log('User logged out')
   })
 })
 

src/runtime/server/api/session.get.ts

@@ -4,7 +4,7 @@ import { requireUserSession, sessionHooks } from '../utils/session'
 export default eventHandler(async (event) => {
   const session = await requireUserSession(event)
 
-  await sessionHooks.callHookParallel('verify', session, event)
+  await sessionHooks.callHookParallel('fetch', session, event)
 
   return session
 })

src/runtime/server/utils/session.ts

@@ -11,7 +11,7 @@ export interface SessionHooks {
    * - Add extra properties to the session
    * - Throw an error if the session could not be verified (with a database for example)
    */
-  'verify': (session: UserSession, event: H3Event) => void | Promise<void>
+  'fetch': (session: UserSession, event: H3Event) => void | Promise<void>
   /**
    * Called before clearing the session
    */