[{"data":1,"prerenderedAt":608},["ShallowReactive",2],{"navigation_docs":3,"-core-concepts-auto-imports-aliases":152,"-core-concepts-auto-imports-aliases-surround":603},[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":60,"body":154,"description":597,"extension":598,"links":599,"meta":600,"navigation":184,"path":61,"seo":601,"stem":62,"__hash__":602},"docs/2.core-concepts/4.auto-imports-aliases.md",{"type":155,"value":156,"toc":588},"minimark",[157,216,220,225,231,255,260,292,296,303,307,316,437,449,457,461,530,541,545,584],[158,159,160],"code-collapse",{},[161,162,168],"pre",{"className":163,"code":164,"filename":165,"language":166,"meta":167,"style":167},"language-txt shiki shiki-themes one-light synthwave-84 synthwave-84","Use auto-imported utilities from @onmax/nuxt-better-auth.\n\n- Client (auto-imported in Vue): `useUserSession()`, `useUserSessionState()`, `useSignIn()`, `useSignUp()`\n- Server (auto-imported in `server/`): `serverAuth(event?)`, `getRequestSession(event)`, `getUserSession(event)`, `createSession(event, userId)`, `setSessionCookie(event, token)`, `requireUserSession(event, options?)`\n- Component: `\u003CBetterAuthState>` for auth-ready rendering\n- Alias `#nuxt-better-auth` exports types: `AuthUser`, `AuthSession`, `AuthSocialProviderId`\n- Use `getRequestSession(event)` over repeated `getUserSession(event)` calls — it caches per request\n","Prompt","txt","",[169,170,171,179,186,192,198,204,210],"code",{"__ignoreMap":167},[172,173,176],"span",{"class":174,"line":175},"line",1,[172,177,178],{},"Use auto-imported utilities from @onmax/nuxt-better-auth.\n",[172,180,182],{"class":174,"line":181},2,[172,183,185],{"emptyLinePlaceholder":184},true,"\n",[172,187,189],{"class":174,"line":188},3,[172,190,191],{},"- Client (auto-imported in Vue): `useUserSession()`, `useUserSessionState()`, `useSignIn()`, `useSignUp()`\n",[172,193,195],{"class":174,"line":194},4,[172,196,197],{},"- Server (auto-imported in `server/`): `serverAuth(event?)`, `getRequestSession(event)`, `getUserSession(event)`, `createSession(event, userId)`, `setSessionCookie(event, token)`, `requireUserSession(event, options?)`\n",[172,199,201],{"class":174,"line":200},5,[172,202,203],{},"- Component: `\u003CBetterAuthState>` for auth-ready rendering\n",[172,205,207],{"class":174,"line":206},6,[172,208,209],{},"- Alias `#nuxt-better-auth` exports types: `AuthUser`, `AuthSession`, `AuthSocialProviderId`\n",[172,211,213],{"class":174,"line":212},7,[172,214,215],{},"- Use `getRequestSession(event)` over repeated `getUserSession(event)` calls — it caches per request\n",[217,218,219],"p",{},"Use this page when you want a quick inventory of what the module registers for you and where each helper is available.",[221,222,224],"h2",{"id":223},"autoimports","Auto‑imports",[217,226,227],{},[228,229,230],"strong",{},"Client",[232,233,234,240,245,250],"ul",{},[235,236,237],"li",{},[169,238,239],{},"useUserSession()",[235,241,242],{},[169,243,244],{},"useUserSessionState()",[235,246,247],{},[169,248,249],{},"useSignIn()",[235,251,252],{},[169,253,254],{},"useSignUp()",[217,256,257],{},[228,258,259],{},"Server",[232,261,262,267,272,277,282,287],{},[235,263,264],{},[169,265,266],{},"serverAuth(event?)",[235,268,269],{},[169,270,271],{},"getRequestSession(event)",[235,273,274],{},[169,275,276],{},"getUserSession(event)",[235,278,279],{},[169,280,281],{},"createSession(event, userId)",[235,283,284],{},[169,285,286],{},"setSessionCookie(event, token)",[235,288,289],{},[169,290,291],{},"requireUserSession(event, options?)",[217,293,294],{},[228,295,145],{},[232,297,298],{},[235,299,300],{},[169,301,302],{},"\u003CBetterAuthState>",[221,304,306],{"id":305},"usage-examples","Usage Examples",[308,309,311,312,315],"h3",{"id":310},"server-utils-auto-imported-in-server","Server Utils (auto-imported in ",[169,313,314],{},"server/",")",[161,317,322],{"className":318,"code":319,"filename":320,"language":321,"meta":167,"style":167},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","export default defineEventHandler(async (event) => {\n  // These are auto-imported, no import statement needed\n  const requestSession = await getRequestSession(event)\n  const session = await getUserSession(event)\n  const auth = serverAuth(event)\n})\n","server/api/profile.ts","ts",[169,323,324,361,367,394,414,432],{"__ignoreMap":167},[172,325,326,330,334,338,342,345,348,352,355,358],{"class":174,"line":175},[172,327,329],{"class":328},"sqe1H","export",[172,331,333],{"class":332},"sKg8T"," default",[172,335,337],{"class":336},"sfT9l"," defineEventHandler",[172,339,341],{"class":340},"s17Py","(",[172,343,344],{"class":328},"async",[172,346,347],{"class":340}," (",[172,349,351],{"class":350},"sgisi","event",[172,353,354],{"class":340},") ",[172,356,357],{"class":328},"=>",[172,359,360],{"class":340}," {\n",[172,362,363],{"class":174,"line":181},[172,364,366],{"class":365},"st7cf","  // These are auto-imported, no import statement needed\n",[172,368,369,372,376,380,383,386,388,391],{"class":174,"line":188},[172,370,371],{"class":328},"  const",[172,373,375],{"class":374},"s6Rhl"," requestSession",[172,377,379],{"class":378},"sQBpM"," =",[172,381,382],{"class":328}," await",[172,384,385],{"class":336}," getRequestSession",[172,387,341],{"class":340},[172,389,351],{"class":390},"sYvLG",[172,392,393],{"class":340},")\n",[172,395,396,398,401,403,405,408,410,412],{"class":174,"line":194},[172,397,371],{"class":328},[172,399,400],{"class":374}," session",[172,402,379],{"class":378},[172,404,382],{"class":328},[172,406,407],{"class":336}," getUserSession",[172,409,341],{"class":340},[172,411,351],{"class":390},[172,413,393],{"class":340},[172,415,416,418,421,423,426,428,430],{"class":174,"line":200},[172,417,371],{"class":328},[172,419,420],{"class":374}," auth",[172,422,379],{"class":378},[172,424,425],{"class":336}," serverAuth",[172,427,341],{"class":340},[172,429,351],{"class":390},[172,431,393],{"class":340},[172,433,434],{"class":174,"line":206},[172,435,436],{"class":340},"})\n",[217,438,439,440,442,443,445,446,448],{},"Use ",[169,441,271],{}," when multiple handlers or middleware in the same request need session data. The helper should be preferred over repeated ",[169,444,276],{}," calls in the same request chain.\n",[169,447,276],{}," does not memoize by itself.",[217,450,439,451,453,454,456],{},[169,452,281],{}," when a custom server handler finishes its own verification logic and needs a Better Auth session record without reaching into module internals.\nUse ",[169,455,286],{}," when a custom server handler completes its own verification step and needs to attach a Better Auth session cookie to the response.",[308,458,460],{"id":459},"client-composables-auto-imported-in-vue-components","Client Composables (auto-imported in Vue components)",[161,462,467],{"className":463,"code":464,"filename":465,"language":466,"meta":167,"style":167},"language-vue shiki shiki-themes one-light synthwave-84 synthwave-84","\u003Cscript setup>\n// Auto-imported, no import statement needed\nconst { user, loggedIn } = useUserSession()\n\u003C/script>\n","pages/dashboard.vue","vue",[169,468,469,486,491,521],{"__ignoreMap":167},[172,470,471,475,479,483],{"class":174,"line":175},[172,472,474],{"class":473},"sL9le","\u003C",[172,476,478],{"class":477},"stweg","script",[172,480,482],{"class":481},"s0frj"," setup",[172,484,485],{"class":473},">\n",[172,487,488],{"class":174,"line":181},[172,489,490],{"class":365},"// Auto-imported, no import statement needed\n",[172,492,493,496,500,503,506,509,512,515,518],{"class":174,"line":188},[172,494,495],{"class":328},"const",[172,497,499],{"class":498},"sEEOt"," { ",[172,501,502],{"class":374},"user",[172,504,505],{"class":498},", ",[172,507,508],{"class":374},"loggedIn",[172,510,511],{"class":498}," } ",[172,513,514],{"class":378},"=",[172,516,517],{"class":336}," useUserSession",[172,519,520],{"class":498},"()\n",[172,522,523,526,528],{"class":174,"line":194},[172,524,525],{"class":473},"\u003C/",[172,527,478],{"class":477},[172,529,485],{"class":473},[217,531,532,533,536,537,540],{},"For app code, prefer the auto-imports. For published reusable packages or Nuxt modules, import composables from ",[169,534,535],{},"@onmax/nuxt-better-auth/composables"," instead of ",[169,538,539],{},"#imports",".",[221,542,544],{"id":543},"aliases","Aliases",[546,547,548,561],"table",{},[549,550,551],"thead",{},[552,553,554,558],"tr",{},[555,556,557],"th",{},"Alias",[555,559,560],{},"Resolves to",[562,563,564],"tbody",{},[552,565,566,572],{},[567,568,569],"td",{},[169,570,571],{},"#nuxt-better-auth",[567,573,574,575,505,578,505,581,315],{},"Module types (",[169,576,577],{},"AuthUser",[169,579,580],{},"AuthSession",[169,582,583],{},"AuthSocialProviderId",[585,586,587],"style",{},"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 .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 .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 .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 .sL9le, html code.shiki .sL9le{--shiki-light:#383A42;--shiki-default:#36F9F6;--shiki-dark:#36F9F6}html pre.shiki code .stweg, html code.shiki .stweg{--shiki-light:#E45649;--shiki-default:#72F1B8;--shiki-dark:#72F1B8}html pre.shiki code .s0frj, html code.shiki .s0frj{--shiki-light:#986801;--shiki-light-font-style:inherit;--shiki-default:#FEDE5D;--shiki-default-font-style:italic;--shiki-dark:#FEDE5D;--shiki-dark-font-style:italic}html pre.shiki code .sEEOt, html code.shiki .sEEOt{--shiki-light:#383A42;--shiki-default:#FFFFFFEE;--shiki-dark:#FFFFFFEE}",{"title":167,"searchDepth":181,"depth":181,"links":589},[590,591,596],{"id":223,"depth":181,"text":224},{"id":305,"depth":181,"text":306,"children":592},[593,595],{"id":310,"depth":188,"text":594},"Server Utils (auto-imported in server/)",{"id":459,"depth":188,"text":460},{"id":543,"depth":181,"text":544},"What the module registers for you.","md",null,{},{"title":60,"description":597},"4UC8C6Xo9IHzTQE13KBm_rGFqqbdB01aYjt-QQonVmE",[604,606],{"title":56,"path":57,"stem":58,"description":605,"children":-1},"Learn how to protect your pages and API routes using a layered approach.",{"title":64,"path":65,"stem":66,"description":607,"children":-1},"What is enforced where, and what you should not assume.",1777803090056]