[{"data":1,"prerenderedAt":519},["ShallowReactive",2],{"navigation_docs":3,"-errors-nuxt-auth-invalid-plugin-source":208,"-errors-nuxt-auth-invalid-plugin-source-surround":514},[4,42,68,115,136,157],{"title":5,"path":6,"stem":7,"children":8,"icon":11},"Getting Started","\u002Fgetting-started","1.getting-started\u002F0.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","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F1.installation","i-lucide-download",{"title":18,"path":19,"stem":20,"icon":21},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F2.configuration","i-lucide-settings",{"title":23,"path":24,"stem":25,"icon":26},"Client Setup","\u002Fgetting-started\u002Fclient-setup","1.getting-started\u002F3.client-setup","i-lucide-monitor",{"title":28,"path":29,"stem":30,"icon":31},"Type Augmentation","\u002Fgetting-started\u002Ftype-augmentation","1.getting-started\u002F4.type-augmentation","i-lucide-type",{"title":33,"path":34,"stem":35,"icon":36},"Schema Generation (NuxtHub)","\u002Fgetting-started\u002Fschema-generation","1.getting-started\u002F5.schema-generation","i-lucide-database",{"title":38,"path":39,"stem":40,"icon":41},"How It Works","\u002Fgetting-started\u002Fhow-it-works","1.getting-started\u002F6.how-it-works","i-lucide-workflow",{"title":43,"path":44,"stem":45,"children":46,"page":67},"Core Concepts","\u002Fcore-concepts","2.core-concepts",[47,51,55,59,63],{"title":48,"path":49,"stem":50},"serverAuth()","\u002Fcore-concepts\u002Fserver-auth","2.core-concepts\u002F1.server-auth",{"title":52,"path":53,"stem":54},"Sessions","\u002Fcore-concepts\u002Fsessions","2.core-concepts\u002F2.sessions",{"title":56,"path":57,"stem":58},"Route Protection","\u002Fcore-concepts\u002Froute-protection","2.core-concepts\u002F3.route-protection",{"title":60,"path":61,"stem":62},"Auto‑Imports and Aliases","\u002Fcore-concepts\u002Fauto-imports-aliases","2.core-concepts\u002F4.auto-imports-aliases",{"title":64,"path":65,"stem":66},"Security & Caveats","\u002Fcore-concepts\u002Fsecurity-caveats","2.core-concepts\u002F5.security-caveats",false,{"title":69,"path":70,"stem":71,"children":72,"page":67},"Guides","\u002Fguides","3.guides",[73,77,82,86,90,94,99,103,107,111],{"title":74,"path":75,"stem":76},"Role‑Based Access","\u002Fguides\u002Frole-based-access","3.guides\u002F1.role-based-access",{"title":78,"path":79,"stem":80,"icon":81},"Setup diagnostics","\u002Fguides\u002Fdiagnostics","3.guides\u002F10.diagnostics","i-lucide-circle-alert",{"title":83,"path":84,"stem":85},"OAuth Providers","\u002Fguides\u002Foauth-providers","3.guides\u002F2.oauth-providers",{"title":87,"path":88,"stem":89},"Custom Database","\u002Fguides\u002Fcustom-database","3.guides\u002F3.custom-database",{"title":91,"path":92,"stem":93},"Database-less Mode","\u002Fguides\u002Fdatabase-less-mode","3.guides\u002F4.database-less-mode",{"title":95,"path":96,"stem":97,"icon":98},"External Auth Backend","\u002Fguides\u002Fexternal-auth-backend","3.guides\u002F5.external-auth-backend","i-lucide-server",{"title":100,"path":101,"stem":102},"Migrating from nuxt-auth-utils","\u002Fguides\u002Fmigrate-from-nuxt-auth-utils","3.guides\u002F6.migrate-from-nuxt-auth-utils",{"title":104,"path":105,"stem":106},"Two-Factor Authentication (TOTP + Backup Codes)","\u002Fguides\u002Ftwo-factor-auth","3.guides\u002F7.two-factor-auth",{"title":108,"path":109,"stem":110},"Testing","\u002Fguides\u002Ftesting","3.guides\u002F8.testing",{"title":112,"path":113,"stem":114},"Production Deployment","\u002Fguides\u002Fproduction-deployment","3.guides\u002F9.production-deployment",{"title":116,"path":117,"stem":118,"children":119,"page":67},"Integrations","\u002Fintegrations","4.integrations",[120,124,128,132],{"title":121,"path":122,"stem":123},"NuxtHub","\u002Fintegrations\u002Fnuxthub","4.integrations\u002F1.nuxthub",{"title":125,"path":126,"stem":127},"DevTools","\u002Fintegrations\u002Fdevtools","4.integrations\u002F2.devtools",{"title":129,"path":130,"stem":131},"Convex","\u002Fintegrations\u002Fconvex","4.integrations\u002F3.convex",{"title":133,"path":134,"stem":135},"i18n","\u002Fintegrations\u002Fi18n","4.integrations\u002F4.i18n",{"title":137,"path":138,"stem":139,"children":140,"page":67},"API Reference","\u002Fapi","5.api",[141,145,149,153],{"title":142,"path":143,"stem":144},"Composables","\u002Fapi\u002Fcomposables","5.api\u002F1.composables",{"title":146,"path":147,"stem":148},"Server Utilities","\u002Fapi\u002Fserver-utils","5.api\u002F2.server-utils",{"title":150,"path":151,"stem":152},"Components","\u002Fapi\u002Fcomponents","5.api\u002F3.components",{"title":154,"path":155,"stem":156},"Types","\u002Fapi\u002Ftypes","5.api\u002F4.types",{"title":158,"path":159,"stem":160,"children":161,"icon":81},"Errors","\u002Ferrors","6.errors\u002F0.index",[162,164,168,172,176,180,184,188,192,196,200,204],{"title":163,"path":159,"stem":160},"Overview",{"title":165,"path":166,"stem":167},"Auth configuration failed to load","\u002Ferrors\u002Fnuxt-auth-config-load-failed","6.errors\u002Fnuxt-auth-config-load-failed",{"title":169,"path":170,"stem":171},"Schema generator returned no code","\u002Ferrors\u002Fnuxt-auth-empty-schema","6.errors\u002Fnuxt-auth-empty-schema",{"title":173,"path":174,"stem":175},"Invalid server auth config export","\u002Ferrors\u002Fnuxt-auth-invalid-config-export","6.errors\u002Fnuxt-auth-invalid-config-export",{"title":177,"path":178,"stem":179},"Auth plugin path must be absolute","\u002Ferrors\u002Fnuxt-auth-invalid-plugin-source","6.errors\u002Fnuxt-auth-invalid-plugin-source",{"title":181,"path":182,"stem":183},"Missing auth configuration","\u002Ferrors\u002Fnuxt-auth-missing-config","6.errors\u002Fnuxt-auth-missing-config",{"title":185,"path":186,"stem":187},"NuxtHub database alias is missing","\u002Ferrors\u002Fnuxt-auth-missing-hub-db","6.errors\u002Fnuxt-auth-missing-hub-db",{"title":189,"path":190,"stem":191},"No database provider is enabled","\u002Ferrors\u002Fnuxt-auth-no-database-provider","6.errors\u002Fnuxt-auth-no-database-provider",{"title":193,"path":194,"stem":195},"Auth schema generation failed","\u002Ferrors\u002Fnuxt-auth-schema-generation-failed","6.errors\u002Fnuxt-auth-schema-generation-failed",{"title":197,"path":198,"stem":199},"Custom session storage is missing","\u002Ferrors\u002Fnuxt-auth-schema-storage-required","6.errors\u002Fnuxt-auth-schema-storage-required",{"title":201,"path":202,"stem":203},"Secondary storage in client-only mode","\u002Ferrors\u002Fnuxt-auth-storage-client-only","6.errors\u002Fnuxt-auth-storage-client-only",{"title":205,"path":206,"stem":207},"Unsupported database dialect","\u002Ferrors\u002Fnuxt-auth-unsupported-dialect","6.errors\u002Fnuxt-auth-unsupported-dialect",{"id":209,"title":210,"body":211,"description":506,"extension":507,"links":508,"meta":509,"navigation":511,"path":178,"seo":512,"stem":179,"__hash__":513},"docs\u002F6.errors\u002Fnuxt-auth-invalid-plugin-source.md","NUXT_AUTH_INVALID_PLUGIN_SOURCE: Auth plugin path must be absolute",{"type":212,"value":213,"toc":501},"minimark",[214,232,237,241,245,248,251,472,479,483,486,497],[215,216,222],"pre",{"className":217,"code":218,"filename":219,"language":220,"meta":221,"style":221},"language-txt shiki shiki-themes one-light synthwave-84 synthwave-84","[NUXT_AUTH_INVALID_PLUGIN_SOURCE] Modules must register absolute plugin source paths. Received: .\u002Fruntime\u002Fauth-plugin.ts\n","Example error","txt","",[223,224,225],"code",{"__ignoreMap":221},[226,227,230],"span",{"class":228,"line":229},"line",1,[226,231,218],{},[233,234,236],"h2",{"id":235},"why-this-happens","Why this happens",[238,239,240],"p",{},"A Nuxt module contributed a relative path through better-auth:plugins:extend. Relative paths depend on the consuming app directory, so the auth module requires each contributor to resolve its own plugin files.",[233,242,244],{"id":243},"how-to-fix-it","How to fix it",[238,246,247],{},"Resolve the plugin source with createResolver(import.meta.url).resolve(...) before registering it.",[238,249,250],{},"Resolve the path relative to the module that owns the plugin:",[215,252,257],{"className":253,"code":254,"filename":255,"language":256,"meta":221,"style":221},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","import { createResolver, defineNuxtModule } from '@nuxt\u002Fkit'\n\nexport default defineNuxtModule({\n  setup(_options, nuxt) {\n    const resolver = createResolver(import.meta.url)\n    nuxt.hook('better-auth:plugins:extend', (plugins) => {\n      plugins.server ||= []\n      plugins.server.push(resolver.resolve('.\u002Fruntime\u002Fauth-plugin.ts'))\n    })\n  },\n})\n","modules\u002Fauth-extension.ts","ts",[223,258,259,289,296,313,334,369,401,422,454,460,466],{"__ignoreMap":221},[226,260,261,265,269,273,276,279,282,285],{"class":228,"line":229},[226,262,264],{"class":263},"sqe1H","import",[226,266,268],{"class":267},"s17Py"," { ",[226,270,272],{"class":271},"sYvLG","createResolver",[226,274,275],{"class":267},", ",[226,277,278],{"class":271},"defineNuxtModule",[226,280,281],{"class":267}," } ",[226,283,284],{"class":263},"from",[226,286,288],{"class":287},"sPAZv"," '@nuxt\u002Fkit'\n",[226,290,292],{"class":228,"line":291},2,[226,293,295],{"emptyLinePlaceholder":294},true,"\n",[226,297,299,302,306,310],{"class":228,"line":298},3,[226,300,301],{"class":263},"export",[226,303,305],{"class":304},"sKg8T"," default",[226,307,309],{"class":308},"sfT9l"," defineNuxtModule",[226,311,312],{"class":267},"({\n",[226,314,316,319,322,326,328,331],{"class":228,"line":315},4,[226,317,318],{"class":308},"  setup",[226,320,321],{"class":267},"(",[226,323,325],{"class":324},"sgisi","_options",[226,327,275],{"class":267},[226,329,330],{"class":324},"nuxt",[226,332,333],{"class":267},") {\n",[226,335,337,340,344,348,351,353,355,358,361,363,366],{"class":228,"line":336},5,[226,338,339],{"class":263},"    const",[226,341,343],{"class":342},"s6Rhl"," resolver",[226,345,347],{"class":346},"sQBpM"," =",[226,349,350],{"class":308}," createResolver",[226,352,321],{"class":267},[226,354,264],{"class":263},[226,356,357],{"class":267},".",[226,359,360],{"class":271},"meta",[226,362,357],{"class":267},[226,364,365],{"class":271},"url",[226,367,368],{"class":267},")\n",[226,370,372,376,378,381,383,386,389,392,395,398],{"class":228,"line":371},6,[226,373,375],{"class":374},"svFNh","    nuxt",[226,377,357],{"class":267},[226,379,380],{"class":308},"hook",[226,382,321],{"class":267},[226,384,385],{"class":287},"'better-auth:plugins:extend'",[226,387,388],{"class":267},", (",[226,390,391],{"class":324},"plugins",[226,393,394],{"class":267},") ",[226,396,397],{"class":263},"=>",[226,399,400],{"class":267}," {\n",[226,402,404,407,409,412,416,419],{"class":228,"line":403},7,[226,405,406],{"class":374},"      plugins",[226,408,357],{"class":267},[226,410,411],{"class":271},"server",[226,413,415],{"class":414},"sn-Jc"," ||",[226,417,418],{"class":346},"=",[226,420,421],{"class":267}," []\n",[226,423,425,427,429,431,433,436,438,441,443,446,448,451],{"class":228,"line":424},8,[226,426,406],{"class":374},[226,428,357],{"class":267},[226,430,411],{"class":271},[226,432,357],{"class":267},[226,434,435],{"class":308},"push",[226,437,321],{"class":267},[226,439,440],{"class":374},"resolver",[226,442,357],{"class":267},[226,444,445],{"class":308},"resolve",[226,447,321],{"class":267},[226,449,450],{"class":287},"'.\u002Fruntime\u002Fauth-plugin.ts'",[226,452,453],{"class":267},"))\n",[226,455,457],{"class":228,"line":456},9,[226,458,459],{"class":267},"    })\n",[226,461,463],{"class":228,"line":462},10,[226,464,465],{"class":267},"  },\n",[226,467,469],{"class":228,"line":468},11,[226,470,471],{"class":267},"})\n",[238,473,474,475,478],{},"Use ",[223,476,477],{},"plugins.client"," for a client auth plugin. The referenced file must exist and export the plugin expected by the auth configuration.",[233,480,482],{"id":481},"verify-the-fix","Verify the fix",[238,484,485],{},"Run pnpm exec nuxt prepare. The registered path should be absolute and the contributed plugin should appear in the generated auth configuration.",[238,487,488,489,493,494,357],{},"See ",[490,491,492],"a",{"href":49},"Configure server auth"," or return to the ",[490,495,496],{"href":159},"error reference",[498,499,500],"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 .s17Py, html code.shiki .s17Py{--shiki-light:#383A42;--shiki-default:#BBBBBB;--shiki-dark:#BBBBBB}html pre.shiki code .sYvLG, html code.shiki .sYvLG{--shiki-light:#E45649;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sPAZv, html code.shiki .sPAZv{--shiki-light:#50A14F;--shiki-default:#FF8B39;--shiki-dark:#FF8B39}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 .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 .svFNh, html code.shiki .svFNh{--shiki-light:#383A42;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sn-Jc, html code.shiki .sn-Jc{--shiki-light:#0184BC;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}",{"title":221,"searchDepth":291,"depth":291,"links":502},[503,504,505],{"id":235,"depth":291,"text":236},{"id":243,"depth":291,"text":244},{"id":481,"depth":291,"text":482},"Resolve plugin file paths before registering them with better-auth:plugins:extend.","md",null,{"editPath":510},"diagnostics\u002Fpages.ts",{"title":177},{"title":210,"description":506},"qEFr8V-FHEjAJn8mUd6vBoqb_yJtBbkAsRbZJOEg5Xo",[515,517],{"title":173,"path":174,"stem":175,"description":516,"children":-1},"Export defineServerAuth(...) as the default export of your server auth config.",{"title":181,"path":182,"stem":183,"description":518,"children":-1},"Create the server or client auth config file that Nuxt Better Auth could not find.",1789181451713]