[{"data":1,"prerenderedAt":1620},["ShallowReactive",2],{"navigation_docs":3,"-api-server-utils":152,"-api-server-utils-surround":1615},[4,42,68,110,131],{"title":5,"path":6,"stem":7,"children":8,"icon":11},"Getting Started","/getting-started","1.getting-started/0.index",[9,12,17,22,27,32,37],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-sparkles",{"title":13,"path":14,"stem":15,"icon":16},"Installation","/getting-started/installation","1.getting-started/1.installation","i-lucide-download",{"title":18,"path":19,"stem":20,"icon":21},"Configuration","/getting-started/configuration","1.getting-started/2.configuration","i-lucide-settings",{"title":23,"path":24,"stem":25,"icon":26},"Client Setup","/getting-started/client-setup","1.getting-started/3.client-setup","i-lucide-monitor",{"title":28,"path":29,"stem":30,"icon":31},"Type Augmentation","/getting-started/type-augmentation","1.getting-started/4.type-augmentation","i-lucide-type",{"title":33,"path":34,"stem":35,"icon":36},"Schema Generation (NuxtHub)","/getting-started/schema-generation","1.getting-started/5.schema-generation","i-lucide-database",{"title":38,"path":39,"stem":40,"icon":41},"How It Works","/getting-started/how-it-works","1.getting-started/6.how-it-works","i-lucide-workflow",{"title":43,"path":44,"stem":45,"children":46,"page":67},"Core Concepts","/core-concepts","2.core-concepts",[47,51,55,59,63],{"title":48,"path":49,"stem":50},"serverAuth()","/core-concepts/server-auth","2.core-concepts/1.server-auth",{"title":52,"path":53,"stem":54},"Sessions","/core-concepts/sessions","2.core-concepts/2.sessions",{"title":56,"path":57,"stem":58},"Route Protection","/core-concepts/route-protection","2.core-concepts/3.route-protection",{"title":60,"path":61,"stem":62},"Auto‑Imports and Aliases","/core-concepts/auto-imports-aliases","2.core-concepts/4.auto-imports-aliases",{"title":64,"path":65,"stem":66},"Security & Caveats","/core-concepts/security-caveats","2.core-concepts/5.security-caveats",false,{"title":69,"path":70,"stem":71,"children":72,"page":67},"Guides","/guides","3.guides",[73,77,81,85,89,94,98,102,106],{"title":74,"path":75,"stem":76},"Role‑Based Access","/guides/role-based-access","3.guides/1.role-based-access",{"title":78,"path":79,"stem":80},"OAuth Providers","/guides/oauth-providers","3.guides/2.oauth-providers",{"title":82,"path":83,"stem":84},"Custom Database","/guides/custom-database","3.guides/3.custom-database",{"title":86,"path":87,"stem":88},"Database-less Mode","/guides/database-less-mode","3.guides/4.database-less-mode",{"title":90,"path":91,"stem":92,"icon":93},"External Auth Backend","/guides/external-auth-backend","3.guides/5.external-auth-backend","i-lucide-server",{"title":95,"path":96,"stem":97},"Migrating from nuxt-auth-utils","/guides/migrate-from-nuxt-auth-utils","3.guides/6.migrate-from-nuxt-auth-utils",{"title":99,"path":100,"stem":101},"Two-Factor Authentication (TOTP + Backup Codes)","/guides/two-factor-auth","3.guides/7.two-factor-auth",{"title":103,"path":104,"stem":105},"Testing","/guides/testing","3.guides/8.testing",{"title":107,"path":108,"stem":109},"Production Deployment","/guides/production-deployment","3.guides/9.production-deployment",{"title":111,"path":112,"stem":113,"children":114,"page":67},"Integrations","/integrations","4.integrations",[115,119,123,127],{"title":116,"path":117,"stem":118},"NuxtHub","/integrations/nuxthub","4.integrations/1.nuxthub",{"title":120,"path":121,"stem":122},"DevTools","/integrations/devtools","4.integrations/2.devtools",{"title":124,"path":125,"stem":126},"Convex","/integrations/convex","4.integrations/3.convex",{"title":128,"path":129,"stem":130},"i18n","/integrations/i18n","4.integrations/4.i18n",{"title":132,"path":133,"stem":134,"children":135,"page":67},"API Reference","/api","5.api",[136,140,144,148],{"title":137,"path":138,"stem":139},"Composables","/api/composables","5.api/1.composables",{"title":141,"path":142,"stem":143},"Server Utilities","/api/server-utils","5.api/2.server-utils",{"title":145,"path":146,"stem":147},"Components","/api/components","5.api/3.components",{"title":149,"path":150,"stem":151},"Types","/api/types","5.api/4.types",{"id":153,"title":141,"body":154,"description":1609,"extension":1610,"links":1611,"meta":1612,"navigation":311,"path":142,"seo":1613,"stem":143,"__hash__":1614},"docs/5.api/2.server-utils.md",{"type":155,"value":156,"toc":1594},"minimark",[157,161,175,180,183,393,396,459,470,474,477,553,562,567,583,587,593,666,673,689,696,712,925,928,932,935,1057,1060,1064,1067,1159,1162,1168,1172,1182,1223,1247,1250,1262,1266,1271,1313,1318,1378,1382,1570,1574,1590],[158,159,160],"p",{},"Use this page when you need exact behavior for the auto-imported server helpers registered by the module.",[162,163,164,165,169,170,174],"warning",{},"These utilities are only available in ",[166,167,168],"strong",{},"full mode",". In ",[171,172,173],"a",{"href":91},"clientOnly mode",", there is no local auth server, so these utilities are not registered.",[176,177,179],"h2",{"id":178},"serverauth","serverAuth",[158,181,182],{},"Returns the initialized Better Auth instance (module-level singleton). Pass the event for accurate URL detection on first initialization.",[184,185,191],"pre",{"className":186,"code":187,"filename":188,"language":189,"meta":190,"style":190},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","export default defineEventHandler(async (event) => {\n  const auth = serverAuth(event)\n  const session = await auth.api.getSession({ headers: event.headers })\n\n  if (!session) {\n    throw createError({ statusCode: 401 })\n  }\n\n  return { user: session.user }\n})\n","server/api/admin/users.get.ts","ts","",[192,193,194,234,259,306,313,331,353,359,364,387],"code",{"__ignoreMap":190},[195,196,199,203,207,211,215,218,221,225,228,231],"span",{"class":197,"line":198},"line",1,[195,200,202],{"class":201},"sqe1H","export",[195,204,206],{"class":205},"sKg8T"," default",[195,208,210],{"class":209},"sfT9l"," defineEventHandler",[195,212,214],{"class":213},"s17Py","(",[195,216,217],{"class":201},"async",[195,219,220],{"class":213}," (",[195,222,224],{"class":223},"sgisi","event",[195,226,227],{"class":213},") ",[195,229,230],{"class":201},"=>",[195,232,233],{"class":213}," {\n",[195,235,237,240,244,248,251,253,256],{"class":197,"line":236},2,[195,238,239],{"class":201},"  const",[195,241,243],{"class":242},"s6Rhl"," auth",[195,245,247],{"class":246},"sQBpM"," =",[195,249,250],{"class":209}," serverAuth",[195,252,214],{"class":213},[195,254,224],{"class":255},"sYvLG",[195,257,258],{"class":213},")\n",[195,260,262,264,267,269,272,275,278,281,283,286,289,292,296,299,301,303],{"class":197,"line":261},3,[195,263,239],{"class":201},[195,265,266],{"class":242}," session",[195,268,247],{"class":246},[195,270,271],{"class":201}," await",[195,273,243],{"class":274},"svFNh",[195,276,277],{"class":213},".",[195,279,280],{"class":255},"api",[195,282,277],{"class":213},[195,284,285],{"class":209},"getSession",[195,287,288],{"class":213},"({ ",[195,290,291],{"class":255},"headers",[195,293,295],{"class":294},"sVnqq",":",[195,297,298],{"class":274}," event",[195,300,277],{"class":213},[195,302,291],{"class":255},[195,304,305],{"class":213}," })\n",[195,307,309],{"class":197,"line":308},4,[195,310,312],{"emptyLinePlaceholder":311},true,"\n",[195,314,316,319,321,325,328],{"class":197,"line":315},5,[195,317,318],{"class":201},"  if",[195,320,220],{"class":213},[195,322,324],{"class":323},"sn-Jc","!",[195,326,327],{"class":255},"session",[195,329,330],{"class":213},") {\n",[195,332,334,337,340,342,345,347,351],{"class":197,"line":333},6,[195,335,336],{"class":201},"    throw",[195,338,339],{"class":209}," createError",[195,341,288],{"class":213},[195,343,344],{"class":255},"statusCode",[195,346,295],{"class":294},[195,348,350],{"class":349},"s3ZNE"," 401",[195,352,305],{"class":213},[195,354,356],{"class":197,"line":355},7,[195,357,358],{"class":213},"  }\n",[195,360,362],{"class":197,"line":361},8,[195,363,312],{"emptyLinePlaceholder":311},[195,365,367,370,373,376,378,380,382,384],{"class":197,"line":366},9,[195,368,369],{"class":201},"  return",[195,371,372],{"class":213}," { ",[195,374,375],{"class":255},"user",[195,377,295],{"class":294},[195,379,266],{"class":274},[195,381,277],{"class":213},[195,383,375],{"class":255},[195,385,386],{"class":213}," }\n",[195,388,390],{"class":197,"line":389},10,[195,391,392],{"class":213},"})\n",[158,394,395],{},"You can also pass query options to bypass cookie cache / refresh behavior:",[184,397,399],{"className":186,"code":398,"language":189,"meta":190,"style":190},"await auth.api.getSession({\n  headers: event.headers,\n  query: { disableCookieCache: true },\n})\n",[192,400,401,419,435,455],{"__ignoreMap":190},[195,402,403,406,408,410,412,414,416],{"class":197,"line":198},[195,404,405],{"class":201},"await",[195,407,243],{"class":274},[195,409,277],{"class":213},[195,411,280],{"class":255},[195,413,277],{"class":213},[195,415,285],{"class":209},[195,417,418],{"class":213},"({\n",[195,420,421,424,426,428,430,432],{"class":197,"line":236},[195,422,423],{"class":255},"  headers",[195,425,295],{"class":294},[195,427,298],{"class":274},[195,429,277],{"class":213},[195,431,291],{"class":255},[195,433,434],{"class":213},",\n",[195,436,437,440,442,444,447,449,452],{"class":197,"line":261},[195,438,439],{"class":255},"  query",[195,441,295],{"class":294},[195,443,372],{"class":213},[195,445,446],{"class":255},"disableCookieCache",[195,448,295],{"class":294},[195,450,451],{"class":349}," true",[195,453,454],{"class":213}," },\n",[195,456,457],{"class":197,"line":308},[195,458,392],{"class":213},[460,461,462,463,466,467,469],"note",{},"Use ",[192,464,465],{},"serverAuth(event)"," in request handlers to access advanced Better Auth features not exposed by the helper wrappers. In non-request contexts, you can call ",[192,468,48],{}," without an event.",[176,471,473],{"id":472},"getusersession","getUserSession",[158,475,476],{},"Retrieves the current session from the request context without throwing an error if unauthenticated.",[184,478,481],{"className":186,"code":479,"filename":480,"language":189,"meta":190,"style":190},"export default defineEventHandler(async (event) => {\n  const session = await getUserSession(event)\n  \n  if (session) {\n    // ...\n  }\n})\n","server/api/example.ts",[192,482,483,505,524,529,539,545,549],{"__ignoreMap":190},[195,484,485,487,489,491,493,495,497,499,501,503],{"class":197,"line":198},[195,486,202],{"class":201},[195,488,206],{"class":205},[195,490,210],{"class":209},[195,492,214],{"class":213},[195,494,217],{"class":201},[195,496,220],{"class":213},[195,498,224],{"class":223},[195,500,227],{"class":213},[195,502,230],{"class":201},[195,504,233],{"class":213},[195,506,507,509,511,513,515,518,520,522],{"class":197,"line":236},[195,508,239],{"class":201},[195,510,266],{"class":242},[195,512,247],{"class":246},[195,514,271],{"class":201},[195,516,517],{"class":209}," getUserSession",[195,519,214],{"class":213},[195,521,224],{"class":255},[195,523,258],{"class":213},[195,525,526],{"class":197,"line":261},[195,527,528],{"class":213},"  \n",[195,530,531,533,535,537],{"class":197,"line":308},[195,532,318],{"class":201},[195,534,220],{"class":213},[195,536,327],{"class":255},[195,538,330],{"class":213},[195,540,541],{"class":197,"line":315},[195,542,544],{"class":543},"st7cf","    // ...\n",[195,546,547],{"class":197,"line":333},[195,548,358],{"class":213},[195,550,551],{"class":197,"line":355},[195,552,392],{"class":213},[158,554,555,557,558,561],{},[192,556,473],{}," does not create request-cache entries by itself. Use ",[192,559,560],{},"getRequestSession(event)"," when you need request-lifetime caching across middleware/handlers.",[158,563,564],{},[166,565,566],{},"Returns:",[568,569,570,577],"ul",{},[571,572,573,576],"li",{},[192,574,575],{},"{ user: AuthUser, session: AuthSession }"," if authenticated.",[571,578,579,582],{},[192,580,581],{},"null"," if unauthenticated.",[176,584,586],{"id":585},"getrequestsession","getRequestSession",[158,588,589,590,277],{},"Retrieves the current session and memoizes it for the lifetime of the current request. In Nuxt and Nitro handlers, the helper stores the memoized value on ",[192,591,592],{},"event.context.requestSession",[184,594,596],{"className":186,"code":595,"filename":480,"language":189,"meta":190,"style":190},"export default defineEventHandler(async (event) => {\n  const requestSession = await getRequestSession(event)\n  const sameRequestSession = await getRequestSession(event) // cached\n})\n",[192,597,598,620,640,662],{"__ignoreMap":190},[195,599,600,602,604,606,608,610,612,614,616,618],{"class":197,"line":198},[195,601,202],{"class":201},[195,603,206],{"class":205},[195,605,210],{"class":209},[195,607,214],{"class":213},[195,609,217],{"class":201},[195,611,220],{"class":213},[195,613,224],{"class":223},[195,615,227],{"class":213},[195,617,230],{"class":201},[195,619,233],{"class":213},[195,621,622,624,627,629,631,634,636,638],{"class":197,"line":236},[195,623,239],{"class":201},[195,625,626],{"class":242}," requestSession",[195,628,247],{"class":246},[195,630,271],{"class":201},[195,632,633],{"class":209}," getRequestSession",[195,635,214],{"class":213},[195,637,224],{"class":255},[195,639,258],{"class":213},[195,641,642,644,647,649,651,653,655,657,659],{"class":197,"line":261},[195,643,239],{"class":201},[195,645,646],{"class":242}," sameRequestSession",[195,648,247],{"class":246},[195,650,271],{"class":201},[195,652,633],{"class":209},[195,654,214],{"class":213},[195,656,224],{"class":255},[195,658,227],{"class":213},[195,660,661],{"class":543},"// cached\n",[195,663,664],{"class":197,"line":308},[195,665,392],{"class":213},[158,667,668,669,672],{},"Use this helper when multiple handlers/middleware in the same request need session access without repeating ",[192,670,671],{},"auth.api.getSession()"," calls.",[460,674,675,677,678,681,682,685,686,277],{},[192,676,586],{}," stays type-compatible in projects that use narrowed ",[192,679,680],{},"h3"," typings where ",[192,683,684],{},"H3Event"," does not explicitly declare ",[192,687,688],{},"context",[176,690,692,693],{"id":691},"session-enrichment-with-custom-session","Session Enrichment with ",[192,694,695],{},"custom-session",[158,697,698,699,701,702,705,706,708,709,711],{},"Use Better Auth's ",[192,700,695],{}," plugin when your app needs computed fields in the session payload returned by server helpers. Define the enrichment in ",[192,703,704],{},"server/auth.config.ts",", and ",[192,707,473],{}," or ",[192,710,586],{}," will return the enriched shape.",[184,713,715],{"className":186,"code":714,"filename":704,"language":189,"meta":190,"style":190},"import { customSession } from 'better-auth/plugins'\nimport { defineServerAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineServerAuth({\n  plugins: [\n    customSession(async ({ user, session }) => {\n      return {\n        user: {\n          ...user,\n          role: user.email?.endsWith('@company.com') ? 'member' : 'guest',\n        },\n        session: {\n          ...session,\n        },\n      }\n    }),\n  ],\n})\n",[192,716,717,737,753,757,768,778,804,811,820,829,872,878,888,897,902,908,914,920],{"__ignoreMap":190},[195,718,719,722,724,727,730,733],{"class":197,"line":198},[195,720,721],{"class":201},"import",[195,723,372],{"class":213},[195,725,726],{"class":255},"customSession",[195,728,729],{"class":213}," } ",[195,731,732],{"class":201},"from",[195,734,736],{"class":735},"sPAZv"," 'better-auth/plugins'\n",[195,738,739,741,743,746,748,750],{"class":197,"line":236},[195,740,721],{"class":201},[195,742,372],{"class":213},[195,744,745],{"class":255},"defineServerAuth",[195,747,729],{"class":213},[195,749,732],{"class":201},[195,751,752],{"class":735}," '@onmax/nuxt-better-auth/config'\n",[195,754,755],{"class":197,"line":261},[195,756,312],{"emptyLinePlaceholder":311},[195,758,759,761,763,766],{"class":197,"line":308},[195,760,202],{"class":201},[195,762,206],{"class":205},[195,764,765],{"class":209}," defineServerAuth",[195,767,418],{"class":213},[195,769,770,773,775],{"class":197,"line":315},[195,771,772],{"class":255},"  plugins",[195,774,295],{"class":294},[195,776,777],{"class":213}," [\n",[195,779,780,783,785,787,790,792,795,797,800,802],{"class":197,"line":333},[195,781,782],{"class":209},"    customSession",[195,784,214],{"class":213},[195,786,217],{"class":201},[195,788,789],{"class":213}," ({ ",[195,791,375],{"class":223},[195,793,794],{"class":213},", ",[195,796,327],{"class":223},[195,798,799],{"class":213}," }) ",[195,801,230],{"class":201},[195,803,233],{"class":213},[195,805,806,809],{"class":197,"line":355},[195,807,808],{"class":201},"      return",[195,810,233],{"class":213},[195,812,813,816,818],{"class":197,"line":361},[195,814,815],{"class":255},"        user",[195,817,295],{"class":294},[195,819,233],{"class":213},[195,821,822,825,827],{"class":197,"line":366},[195,823,824],{"class":323},"          ...",[195,826,375],{"class":255},[195,828,434],{"class":213},[195,830,831,834,836,839,841,845,848,851,853,856,858,861,864,867,870],{"class":197,"line":389},[195,832,833],{"class":255},"          role",[195,835,295],{"class":294},[195,837,838],{"class":274}," user",[195,840,277],{"class":213},[195,842,844],{"class":843},"sjaJz","email",[195,846,847],{"class":213},"?.",[195,849,850],{"class":209},"endsWith",[195,852,214],{"class":213},[195,854,855],{"class":735},"'@company.com'",[195,857,227],{"class":213},[195,859,860],{"class":323},"?",[195,862,863],{"class":735}," 'member'",[195,865,866],{"class":323}," :",[195,868,869],{"class":735}," 'guest'",[195,871,434],{"class":213},[195,873,875],{"class":197,"line":874},11,[195,876,877],{"class":213},"        },\n",[195,879,881,884,886],{"class":197,"line":880},12,[195,882,883],{"class":255},"        session",[195,885,295],{"class":294},[195,887,233],{"class":213},[195,889,891,893,895],{"class":197,"line":890},13,[195,892,824],{"class":323},[195,894,327],{"class":255},[195,896,434],{"class":213},[195,898,900],{"class":197,"line":899},14,[195,901,877],{"class":213},[195,903,905],{"class":197,"line":904},15,[195,906,907],{"class":213},"      }\n",[195,909,911],{"class":197,"line":910},16,[195,912,913],{"class":213},"    }),\n",[195,915,917],{"class":197,"line":916},17,[195,918,919],{"class":213},"  ],\n",[195,921,923],{"class":197,"line":922},18,[195,924,392],{"class":213},[460,926,927],{},"This uses Better Auth's plugin API and does not require a module-specific option.",[176,929,931],{"id":930},"createsession","createSession",[158,933,934],{},"Creates a Better Auth session for a user and returns the created session record. Use this helper in custom server-side authentication flows after your handler verifies the user identity.",[184,936,939],{"className":186,"code":937,"filename":938,"language":189,"meta":190,"style":190},"export default defineEventHandler(async (event) => {\n  const userId = await verifyCustomLoginAndReturnUserId(event)\n  const session = await createSession(event, userId)\n\n  return {\n    sessionId: session.id,\n    token: session.token,\n  }\n})\n","server/api/custom-auth.post.ts",[192,940,941,963,983,1007,1011,1017,1033,1049,1053],{"__ignoreMap":190},[195,942,943,945,947,949,951,953,955,957,959,961],{"class":197,"line":198},[195,944,202],{"class":201},[195,946,206],{"class":205},[195,948,210],{"class":209},[195,950,214],{"class":213},[195,952,217],{"class":201},[195,954,220],{"class":213},[195,956,224],{"class":223},[195,958,227],{"class":213},[195,960,230],{"class":201},[195,962,233],{"class":213},[195,964,965,967,970,972,974,977,979,981],{"class":197,"line":236},[195,966,239],{"class":201},[195,968,969],{"class":242}," userId",[195,971,247],{"class":246},[195,973,271],{"class":201},[195,975,976],{"class":209}," verifyCustomLoginAndReturnUserId",[195,978,214],{"class":213},[195,980,224],{"class":255},[195,982,258],{"class":213},[195,984,985,987,989,991,993,996,998,1000,1002,1005],{"class":197,"line":261},[195,986,239],{"class":201},[195,988,266],{"class":242},[195,990,247],{"class":246},[195,992,271],{"class":201},[195,994,995],{"class":209}," createSession",[195,997,214],{"class":213},[195,999,224],{"class":255},[195,1001,794],{"class":213},[195,1003,1004],{"class":255},"userId",[195,1006,258],{"class":213},[195,1008,1009],{"class":197,"line":308},[195,1010,312],{"emptyLinePlaceholder":311},[195,1012,1013,1015],{"class":197,"line":315},[195,1014,369],{"class":201},[195,1016,233],{"class":213},[195,1018,1019,1022,1024,1026,1028,1031],{"class":197,"line":333},[195,1020,1021],{"class":255},"    sessionId",[195,1023,295],{"class":294},[195,1025,266],{"class":274},[195,1027,277],{"class":213},[195,1029,1030],{"class":255},"id",[195,1032,434],{"class":213},[195,1034,1035,1038,1040,1042,1044,1047],{"class":197,"line":355},[195,1036,1037],{"class":255},"    token",[195,1039,295],{"class":294},[195,1041,266],{"class":274},[195,1043,277],{"class":213},[195,1045,1046],{"class":255},"token",[195,1048,434],{"class":213},[195,1050,1051],{"class":197,"line":361},[195,1052,358],{"class":213},[195,1054,1055],{"class":197,"line":366},[195,1056,392],{"class":213},[158,1058,1059],{},"Pair this helper with your preferred cookie strategy. When you also use the module cookie helper, you can set the returned token on the response after creating the session.",[176,1061,1063],{"id":1062},"setsessioncookie","setSessionCookie",[158,1065,1066],{},"Sets the Better Auth session token cookie on the current response. Use this helper in custom server-side authentication flows after you obtain or create a valid Better Auth session token.",[184,1068,1070],{"className":186,"code":1069,"filename":938,"language":189,"meta":190,"style":190},"export default defineEventHandler(async (event) => {\n  const token = await verifyCustomLoginAndReturnSessionToken(event)\n\n  await setSessionCookie(event, token)\n\n  return { ok: true }\n})\n",[192,1071,1072,1094,1114,1118,1136,1140,1155],{"__ignoreMap":190},[195,1073,1074,1076,1078,1080,1082,1084,1086,1088,1090,1092],{"class":197,"line":198},[195,1075,202],{"class":201},[195,1077,206],{"class":205},[195,1079,210],{"class":209},[195,1081,214],{"class":213},[195,1083,217],{"class":201},[195,1085,220],{"class":213},[195,1087,224],{"class":223},[195,1089,227],{"class":213},[195,1091,230],{"class":201},[195,1093,233],{"class":213},[195,1095,1096,1098,1101,1103,1105,1108,1110,1112],{"class":197,"line":236},[195,1097,239],{"class":201},[195,1099,1100],{"class":242}," token",[195,1102,247],{"class":246},[195,1104,271],{"class":201},[195,1106,1107],{"class":209}," verifyCustomLoginAndReturnSessionToken",[195,1109,214],{"class":213},[195,1111,224],{"class":255},[195,1113,258],{"class":213},[195,1115,1116],{"class":197,"line":261},[195,1117,312],{"emptyLinePlaceholder":311},[195,1119,1120,1123,1126,1128,1130,1132,1134],{"class":197,"line":308},[195,1121,1122],{"class":201},"  await",[195,1124,1125],{"class":209}," setSessionCookie",[195,1127,214],{"class":213},[195,1129,224],{"class":255},[195,1131,794],{"class":213},[195,1133,1046],{"class":255},[195,1135,258],{"class":213},[195,1137,1138],{"class":197,"line":315},[195,1139,312],{"emptyLinePlaceholder":311},[195,1141,1142,1144,1146,1149,1151,1153],{"class":197,"line":333},[195,1143,369],{"class":201},[195,1145,372],{"class":213},[195,1147,1148],{"class":255},"ok",[195,1150,295],{"class":294},[195,1152,451],{"class":349},[195,1154,386],{"class":213},[195,1156,1157],{"class":197,"line":355},[195,1158,392],{"class":213},[158,1160,1161],{},"The helper signs the cookie with your Better Auth secret and uses the configured cookie name and attributes from your server auth config.",[460,1163,1164,1167],{},[192,1165,1166],{},"setSessionCookie(event, token)"," sets the session token cookie only. It does not try to recreate every internal Better Auth sign-in side effect.",[176,1169,1171],{"id":1170},"requireusersession","requireUserSession",[158,1173,1174,1175,708,1178,1181],{},"Ensures the user is authenticated and optionally matches specific criteria. Throws a ",[192,1176,1177],{},"401 Unauthorized",[192,1179,1180],{},"403 Forbidden"," error if checks fail.",[184,1183,1185],{"className":186,"code":1184,"language":189,"meta":190,"style":190},"const { user, session } = await requireUserSession(event, options?)\n",[192,1186,1187],{"__ignoreMap":190},[195,1188,1189,1192,1194,1196,1198,1200,1202,1205,1207,1210,1212,1214,1216,1219,1221],{"class":197,"line":198},[195,1190,1191],{"class":201},"const",[195,1193,372],{"class":213},[195,1195,375],{"class":242},[195,1197,794],{"class":213},[195,1199,327],{"class":242},[195,1201,729],{"class":213},[195,1203,1204],{"class":246},"=",[195,1206,271],{"class":201},[195,1208,1209],{"class":209}," requireUserSession",[195,1211,214],{"class":213},[195,1213,224],{"class":274},[195,1215,794],{"class":213},[195,1217,1218],{"class":274},"options",[195,1220,860],{"class":323},[195,1222,258],{"class":213},[460,1224,1225,1227,1228,1231,1232,1235,1236,1239,1240,1242,1243,1246],{},[192,1226,1171],{}," uses ",[192,1229,1230],{},"AuthUser"," and ",[192,1233,1234],{},"AuthSession"," from ",[192,1237,1238],{},"#nuxt-better-auth"," for both the returned value and option callbacks (",[192,1241,375],{}," match + ",[192,1244,1245],{},"rule",").",[680,1248,1249],{"id":1218},"Options",[1251,1252,1253,1258],"field-group",{},[1254,1255,1257],"field",{"name":375,"type":1256},"UserMatch","Object matching user properties (see Route Protection).",[1254,1259,1261],{"name":1245,"type":1260},"(ctx) => boolean | Promise\u003Cboolean>","Custom validation callback.",[680,1263,1265],{"id":1264},"examples","Examples",[158,1267,1268],{},[166,1269,1270],{},"Role Check:",[184,1272,1275],{"className":186,"code":1273,"filename":1274,"language":189,"meta":190,"style":190},"await requireUserSession(event, {\n  user: { role: 'admin' }\n})\n","server/api/admin/dashboard.ts",[192,1276,1277,1290,1309],{"__ignoreMap":190},[195,1278,1279,1281,1283,1285,1287],{"class":197,"line":198},[195,1280,405],{"class":201},[195,1282,1209],{"class":209},[195,1284,214],{"class":213},[195,1286,224],{"class":274},[195,1288,1289],{"class":213},", {\n",[195,1291,1292,1295,1297,1299,1302,1304,1307],{"class":197,"line":236},[195,1293,1294],{"class":255},"  user",[195,1296,295],{"class":294},[195,1298,372],{"class":213},[195,1300,1301],{"class":255},"role",[195,1303,295],{"class":294},[195,1305,1306],{"class":735}," 'admin'",[195,1308,386],{"class":213},[195,1310,1311],{"class":197,"line":261},[195,1312,392],{"class":213},[158,1314,1315],{},[166,1316,1317],{},"Custom Rule:",[184,1319,1321],{"className":186,"code":1320,"filename":1274,"language":189,"meta":190,"style":190},"await requireUserSession(event, {\n  rule: ({ user }) => {\n    return user.points > 100\n  }\n})\n",[192,1322,1323,1335,1352,1370,1374],{"__ignoreMap":190},[195,1324,1325,1327,1329,1331,1333],{"class":197,"line":198},[195,1326,405],{"class":201},[195,1328,1209],{"class":209},[195,1330,214],{"class":213},[195,1332,224],{"class":274},[195,1334,1289],{"class":213},[195,1336,1337,1340,1342,1344,1346,1348,1350],{"class":197,"line":236},[195,1338,1339],{"class":209},"  rule",[195,1341,295],{"class":294},[195,1343,789],{"class":213},[195,1345,375],{"class":223},[195,1347,799],{"class":213},[195,1349,230],{"class":201},[195,1351,233],{"class":213},[195,1353,1354,1357,1359,1361,1364,1367],{"class":197,"line":261},[195,1355,1356],{"class":201},"    return",[195,1358,838],{"class":274},[195,1360,277],{"class":213},[195,1362,1363],{"class":255},"points",[195,1365,1366],{"class":323}," >",[195,1368,1369],{"class":349}," 100\n",[195,1371,1372],{"class":197,"line":308},[195,1373,358],{"class":213},[195,1375,1376],{"class":197,"line":315},[195,1377,392],{"class":213},[176,1379,1381],{"id":1380},"combining-user-matching-with-rules","Combining User Matching with Rules",[184,1383,1386],{"className":186,"code":1384,"filename":1385,"language":189,"meta":190,"style":190},"export default defineEventHandler(async (event) => {\n  const { teamId } = getRouterParams(event)\n\n  // Require admin role AND membership in the specific team\n  await requireUserSession(event, {\n    user: { role: 'admin' },\n    rule: async (session) => {\n      const membership = await getTeamMembership(session.user.id, teamId)\n      return membership?.role === 'owner'\n    }\n  })\n\n  return getTeamSettings(teamId)\n})\n","server/api/team/[teamId]/settings.ts",[192,1387,1388,1410,1432,1436,1441,1453,1470,1490,1523,1539,1544,1549,1553,1566],{"__ignoreMap":190},[195,1389,1390,1392,1394,1396,1398,1400,1402,1404,1406,1408],{"class":197,"line":198},[195,1391,202],{"class":201},[195,1393,206],{"class":205},[195,1395,210],{"class":209},[195,1397,214],{"class":213},[195,1399,217],{"class":201},[195,1401,220],{"class":213},[195,1403,224],{"class":223},[195,1405,227],{"class":213},[195,1407,230],{"class":201},[195,1409,233],{"class":213},[195,1411,1412,1414,1416,1419,1421,1423,1426,1428,1430],{"class":197,"line":236},[195,1413,239],{"class":201},[195,1415,372],{"class":213},[195,1417,1418],{"class":242},"teamId",[195,1420,729],{"class":213},[195,1422,1204],{"class":246},[195,1424,1425],{"class":209}," getRouterParams",[195,1427,214],{"class":213},[195,1429,224],{"class":255},[195,1431,258],{"class":213},[195,1433,1434],{"class":197,"line":261},[195,1435,312],{"emptyLinePlaceholder":311},[195,1437,1438],{"class":197,"line":308},[195,1439,1440],{"class":543},"  // Require admin role AND membership in the specific team\n",[195,1442,1443,1445,1447,1449,1451],{"class":197,"line":315},[195,1444,1122],{"class":201},[195,1446,1209],{"class":209},[195,1448,214],{"class":213},[195,1450,224],{"class":255},[195,1452,1289],{"class":213},[195,1454,1455,1458,1460,1462,1464,1466,1468],{"class":197,"line":333},[195,1456,1457],{"class":255},"    user",[195,1459,295],{"class":294},[195,1461,372],{"class":213},[195,1463,1301],{"class":255},[195,1465,295],{"class":294},[195,1467,1306],{"class":735},[195,1469,454],{"class":213},[195,1471,1472,1475,1477,1480,1482,1484,1486,1488],{"class":197,"line":355},[195,1473,1474],{"class":209},"    rule",[195,1476,295],{"class":294},[195,1478,1479],{"class":201}," async",[195,1481,220],{"class":213},[195,1483,327],{"class":223},[195,1485,227],{"class":213},[195,1487,230],{"class":201},[195,1489,233],{"class":213},[195,1491,1492,1495,1498,1500,1502,1505,1507,1509,1511,1513,1515,1517,1519,1521],{"class":197,"line":361},[195,1493,1494],{"class":201},"      const",[195,1496,1497],{"class":242}," membership",[195,1499,247],{"class":246},[195,1501,271],{"class":201},[195,1503,1504],{"class":209}," getTeamMembership",[195,1506,214],{"class":213},[195,1508,327],{"class":274},[195,1510,277],{"class":213},[195,1512,375],{"class":255},[195,1514,277],{"class":213},[195,1516,1030],{"class":255},[195,1518,794],{"class":213},[195,1520,1418],{"class":255},[195,1522,258],{"class":213},[195,1524,1525,1527,1529,1531,1533,1536],{"class":197,"line":366},[195,1526,808],{"class":201},[195,1528,1497],{"class":274},[195,1530,847],{"class":213},[195,1532,1301],{"class":255},[195,1534,1535],{"class":323}," ===",[195,1537,1538],{"class":735}," 'owner'\n",[195,1540,1541],{"class":197,"line":389},[195,1542,1543],{"class":213},"    }\n",[195,1545,1546],{"class":197,"line":874},[195,1547,1548],{"class":213},"  })\n",[195,1550,1551],{"class":197,"line":880},[195,1552,312],{"emptyLinePlaceholder":311},[195,1554,1555,1557,1560,1562,1564],{"class":197,"line":890},[195,1556,369],{"class":201},[195,1558,1559],{"class":209}," getTeamSettings",[195,1561,214],{"class":213},[195,1563,1418],{"class":255},[195,1565,258],{"class":213},[195,1567,1568],{"class":197,"line":899},[195,1569,392],{"class":213},[176,1571,1573],{"id":1572},"related-pages","Related pages",[568,1575,1576,1581,1586],{},[571,1577,1578],{},[171,1579,1580],{"href":49},"Server auth concept",[571,1582,1583],{},[171,1584,1585],{"href":57},"Route protection",[571,1587,1588],{},[171,1589,149],{"href":150},[1591,1592,1593],"style",{},"html pre.shiki code .sqe1H, html code.shiki .sqe1H{--shiki-light:#A626A4;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .sKg8T, html code.shiki .sKg8T{--shiki-light:#E45649;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .sfT9l, html code.shiki .sfT9l{--shiki-light:#4078F2;--shiki-default:#36F9F6;--shiki-dark:#36F9F6}html pre.shiki code .s17Py, html code.shiki .s17Py{--shiki-light:#383A42;--shiki-default:#BBBBBB;--shiki-dark:#BBBBBB}html pre.shiki code .sgisi, html code.shiki .sgisi{--shiki-light:#383A42;--shiki-light-font-style:inherit;--shiki-default:#FF7EDB;--shiki-default-font-style:italic;--shiki-dark:#FF7EDB;--shiki-dark-font-style:italic}html pre.shiki code .s6Rhl, html code.shiki .s6Rhl{--shiki-light:#986801;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sQBpM, html code.shiki .sQBpM{--shiki-light:#0184BC;--shiki-default:#FFFFFFEE;--shiki-dark:#FFFFFFEE}html pre.shiki code .sYvLG, html code.shiki .sYvLG{--shiki-light:#E45649;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .svFNh, html code.shiki .svFNh{--shiki-light:#383A42;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sVnqq, html code.shiki .sVnqq{--shiki-light:#0184BC;--shiki-default:#B6B1B1;--shiki-dark:#B6B1B1}html pre.shiki code .sn-Jc, html code.shiki .sn-Jc{--shiki-light:#0184BC;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .s3ZNE, html code.shiki .s3ZNE{--shiki-light:#986801;--shiki-default:#F97E72;--shiki-dark:#F97E72}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .st7cf, html code.shiki .st7cf{--shiki-light:#A0A1A7;--shiki-light-font-style:italic;--shiki-default:#848BBD;--shiki-default-font-style:italic;--shiki-dark:#848BBD;--shiki-dark-font-style:italic}html pre.shiki code .sPAZv, html code.shiki .sPAZv{--shiki-light:#50A14F;--shiki-default:#FF8B39;--shiki-dark:#FF8B39}html pre.shiki code .sjaJz, html code.shiki .sjaJz{--shiki-light:#C18401;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}",{"title":190,"searchDepth":236,"depth":236,"links":1595},[1596,1597,1598,1599,1601,1602,1603,1607,1608],{"id":178,"depth":236,"text":179},{"id":472,"depth":236,"text":473},{"id":585,"depth":236,"text":586},{"id":691,"depth":236,"text":1600},"Session Enrichment with custom-session",{"id":930,"depth":236,"text":931},{"id":1062,"depth":236,"text":1063},{"id":1170,"depth":236,"text":1171,"children":1604},[1605,1606],{"id":1218,"depth":261,"text":1249},{"id":1264,"depth":261,"text":1265},{"id":1380,"depth":236,"text":1381},{"id":1572,"depth":236,"text":1573},"API reference for server-side helpers available in Nitro event handlers.","md",null,{},{"title":141,"description":1609},"o9t7Bv-iQrmPnF_Dh-0kv5RDQ4TbgUVkz1W8R5gGy4g",[1616,1618],{"title":137,"path":138,"stem":139,"description":1617,"children":-1},"API reference for client-side composables.",{"title":145,"path":146,"stem":147,"description":1619,"children":-1},"Built‑in UI helpers.",1777450762563]