[{"data":1,"prerenderedAt":1500},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:docs:Qn_2LBqEXqfH4FCYG9q5dYO8OInfty3fnb8UaKyPqIw":651,"content-page-surround:docs:Qn_2LBqEXqfH4FCYG9q5dYO8OInfty3fnb8UaKyPqIw":1488,"i-logos:typescript-icon":1493,"i-lucide:clipboard":1497},[4,41,110,418,485,550,601,646],{"title":5,"page":6,"canonicalKey":7,"locale":8,"id":9,"draft":6,"icon":10,"sidebar":11,"children":12},"Learn",false,"1","en","content:docs:1.overview:.navigation.yml","i-lucide-book-open","section",[13,20,27,34],{"title":14,"id":15,"canonicalKey":16,"locale":8,"draft":6,"navigation":17,"icon":18,"path":19},"Better Convex Nuxt","content:docs:1.overview:1.introduction.md","1\u002F1",{"icon":18},"i-lucide-orbit","\u002Fdocs\u002Foverview\u002Fintroduction",{"title":21,"id":22,"canonicalKey":23,"locale":8,"draft":6,"navigation":24,"icon":25,"path":26},"Who it is for","content:docs:1.overview:2.who-it-is-for.md","1\u002F2",{"icon":25},"i-lucide-users","\u002Fdocs\u002Foverview\u002Fwho-it-is-for",{"title":28,"id":29,"canonicalKey":30,"locale":8,"draft":6,"navigation":31,"icon":32,"path":33},"Limitations and trade-offs","content:docs:1.overview:3.limitations.md","1\u002F3",{"icon":32},"i-lucide-triangle-alert","\u002Fdocs\u002Foverview\u002Flimitations",{"title":35,"id":36,"canonicalKey":37,"locale":8,"draft":6,"navigation":38,"icon":39,"path":40},"Compare Nuxt integrations","content:docs:1.overview:4.comparison.md","1\u002F4",{"icon":39},"i-lucide-scale","\u002Fdocs\u002Foverview\u002Fcomparison",{"title":42,"page":6,"canonicalKey":43,"locale":8,"id":44,"draft":6,"icon":45,"children":46},"Get started","2","content:docs:2.get-started:.navigation.yml","i-lucide-rocket",[47,54,61,68,75,82,89,96,103],{"title":48,"id":49,"canonicalKey":50,"locale":8,"draft":6,"navigation":51,"icon":52,"path":53},"Choose your path","content:docs:2.get-started:1.choose-your-path.md","2\u002F1",{"icon":52},"i-lucide-signpost","\u002Fdocs\u002Fget-started\u002Fchoose-your-path",{"title":55,"id":56,"canonicalKey":57,"locale":8,"draft":6,"navigation":58,"icon":59,"path":60},"Installation","content:docs:2.get-started:2.installation.md","2\u002F2",{"icon":59},"i-lucide-download","\u002Fdocs\u002Fget-started\u002Finstallation",{"title":62,"id":63,"canonicalKey":64,"locale":8,"draft":6,"navigation":65,"icon":66,"path":67},"First real-time page","content:docs:2.get-started:3.first-realtime-page.md","2\u002F3",{"icon":66},"i-lucide-radio","\u002Fdocs\u002Fget-started\u002Ffirst-realtime-page",{"title":69,"id":70,"canonicalKey":71,"locale":8,"draft":6,"navigation":72,"icon":73,"path":74},"Add a mutation","content:docs:2.get-started:4.add-a-mutation.md","2\u002F4",{"icon":73},"i-lucide-square-pen","\u002Fdocs\u002Fget-started\u002Fadd-a-mutation",{"title":76,"id":77,"canonicalKey":78,"locale":8,"draft":6,"navigation":79,"icon":80,"path":81},"Add authentication","content:docs:2.get-started:5.add-authentication.md","2\u002F5",{"icon":80},"i-lucide-log-in","\u002Fdocs\u002Fget-started\u002Fadd-authentication",{"title":83,"id":84,"canonicalKey":85,"locale":8,"draft":6,"navigation":86,"icon":87,"path":88},"Protect data","content:docs:2.get-started:6.protect-data.md","2\u002F6",{"icon":87},"i-lucide-shield-check","\u002Fdocs\u002Fget-started\u002Fprotect-data",{"title":90,"id":91,"canonicalKey":92,"locale":8,"draft":6,"navigation":93,"icon":94,"path":95},"Project structure","content:docs:2.get-started:7.project-structure.md","2\u002F7",{"icon":94},"i-lucide-folder-tree","\u002Fdocs\u002Fget-started\u002Fproject-structure",{"title":97,"id":98,"canonicalKey":99,"locale":8,"draft":6,"navigation":100,"icon":101,"path":102},"Next steps","content:docs:2.get-started:8.next-steps.md","2\u002F8",{"icon":101},"i-lucide-arrow-right","\u002Fdocs\u002Fget-started\u002Fnext-steps",{"title":104,"id":105,"canonicalKey":106,"locale":8,"draft":6,"navigation":107,"icon":108,"path":109},"Plain Vue and Vite","content:docs:2.get-started:9.plain-vue.md","2\u002F9",{"icon":108},"i-lucide-panels-top-left","\u002Fdocs\u002Fget-started\u002Fplain-vue",{"title":111,"page":6,"canonicalKey":112,"locale":8,"id":113,"draft":6,"icon":114,"sidebar":11,"children":115},"Build","3","content:docs:3.build:.navigation.yml","i-lucide-blocks",[116,154,199,292,324,349,388],{"title":117,"page":6,"canonicalKey":118,"locale":8,"children":119},"Queries","3\u002F1",[120,126,133,140,147],{"title":117,"id":121,"canonicalKey":122,"locale":8,"draft":6,"navigation":123,"icon":124,"path":125},"content:docs:3.build:1.queries:1.queries.md","3\u002F1\u002F1",{"icon":124},"i-lucide-database","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fqueries",{"title":127,"id":128,"canonicalKey":129,"locale":8,"draft":6,"navigation":130,"icon":131,"path":132},"Reactive arguments","content:docs:3.build:1.queries:2.reactive-arguments.md","3\u002F1\u002F2",{"icon":131},"i-lucide-sliders-horizontal","\u002Fdocs\u002Fbuild\u002Fqueries\u002Freactive-arguments",{"title":134,"id":135,"canonicalKey":136,"locale":8,"draft":6,"navigation":137,"icon":138,"path":139},"Loading and stale data","content:docs:3.build:1.queries:3.loading-and-stale-data.md","3\u002F1\u002F3",{"icon":138},"i-lucide-loader-circle","\u002Fdocs\u002Fbuild\u002Fqueries\u002Floading-and-stale-data",{"title":141,"id":142,"canonicalKey":143,"locale":8,"draft":6,"navigation":144,"icon":145,"path":146},"Query execution options","content:docs:3.build:1.queries:4.ssr-options.md","3\u002F1\u002F4",{"icon":145},"i-lucide-server-cog","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fssr-options",{"title":148,"id":149,"canonicalKey":150,"locale":8,"draft":6,"navigation":151,"icon":152,"path":153},"Pagination","content:docs:3.build:1.queries:6.pagination.md","3\u002F1\u002F6",{"icon":152},"i-lucide-list-plus","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fpagination",{"title":155,"page":6,"canonicalKey":156,"locale":8,"children":157},"Write Data","3\u002F2",[158,164,171,178,185,192],{"title":159,"id":160,"canonicalKey":161,"locale":8,"draft":6,"navigation":162,"icon":73,"path":163},"Mutations","content:docs:3.build:2.write-data:1.mutations.md","3\u002F2\u002F1",{"icon":73},"\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmutations",{"title":165,"id":166,"canonicalKey":167,"locale":8,"draft":6,"navigation":168,"icon":169,"path":170},"Actions","content:docs:3.build:2.write-data:2.actions.md","3\u002F2\u002F2",{"icon":169},"i-lucide-zap","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Factions",{"title":172,"id":173,"canonicalKey":174,"locale":8,"draft":6,"navigation":175,"icon":176,"path":177},"Optimistic updates","content:docs:3.build:2.write-data:3.optimistic-updates.md","3\u002F2\u002F3",{"icon":176},"i-lucide-gauge","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Foptimistic-updates",{"title":179,"id":180,"canonicalKey":181,"locale":8,"draft":6,"navigation":182,"icon":183,"path":184},"Concurrent operations","content:docs:3.build:2.write-data:4.concurrent-operations.md","3\u002F2\u002F4",{"icon":183},"i-lucide-git-fork","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fconcurrent-operations",{"title":186,"id":187,"canonicalKey":188,"locale":8,"draft":6,"navigation":189,"icon":190,"path":191},"Form submissions","content:docs:3.build:2.write-data:5.forms.md","3\u002F2\u002F5",{"icon":190},"i-lucide-list-checks","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fforms",{"title":193,"id":194,"canonicalKey":195,"locale":8,"draft":6,"navigation":196,"icon":197,"path":198},"Multi-step operations","content:docs:3.build:2.write-data:6.multi-step-operations.md","3\u002F2\u002F6",{"icon":197},"i-lucide-list-ordered","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmulti-step-operations",{"title":200,"page":6,"canonicalKey":201,"locale":8,"children":202},"Authentication","3\u002F3",[203,209,216,223,229,236,243,250,257,264,271,278,285],{"title":200,"id":204,"canonicalKey":205,"locale":8,"draft":6,"navigation":206,"icon":207,"path":208},"content:docs:3.build:3.authentication:1.overview.md","3\u002F3\u002F1",{"icon":207},"i-lucide-shield","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Foverview",{"title":210,"id":211,"canonicalKey":212,"locale":8,"draft":6,"navigation":213,"icon":214,"path":215},"Better Auth setup","content:docs:3.build:3.authentication:2.better-auth-setup.md","3\u002F3\u002F2",{"icon":214},"i-lucide-settings-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-setup",{"title":217,"id":218,"canonicalKey":219,"locale":8,"draft":6,"navigation":220,"icon":221,"path":222},"Auth state and user data","content:docs:3.build:3.authentication:3.auth-state-and-user.md","3\u002F3\u002F3",{"icon":221},"i-lucide-user-round","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fauth-state-and-user",{"title":224,"id":225,"canonicalKey":226,"locale":8,"draft":6,"navigation":227,"icon":80,"path":228},"Sign in and sign out","content:docs:3.build:3.authentication:4.sign-in-and-sign-out.md","3\u002F3\u002F4",{"icon":80},"\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsign-in-and-sign-out",{"title":230,"id":231,"canonicalKey":232,"locale":8,"draft":6,"navigation":233,"icon":234,"path":235},"Route protection","content:docs:3.build:3.authentication:5.route-protection.md","3\u002F3\u002F5",{"icon":234},"i-lucide-route","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Froute-protection",{"title":237,"id":238,"canonicalKey":239,"locale":8,"draft":6,"navigation":240,"icon":241,"path":242},"Backend authorization","content:docs:3.build:3.authentication:6.backend-authorization.md","3\u002F3\u002F6",{"icon":241},"i-lucide-lock-keyhole","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbackend-authorization",{"title":244,"id":245,"canonicalKey":246,"locale":8,"draft":6,"navigation":247,"icon":248,"path":249},"Better Auth plugins","content:docs:3.build:3.authentication:7.better-auth-plugins.md","3\u002F3\u002F7",{"icon":248},"i-lucide-plug","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugins",{"title":251,"id":252,"canonicalKey":253,"locale":8,"draft":6,"navigation":254,"icon":255,"path":256},"Custom user fields","content:docs:3.build:3.authentication:8.custom-user-fields.md","3\u002F3\u002F8",{"icon":255},"i-lucide-user-cog","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcustom-user-fields",{"title":258,"id":259,"canonicalKey":260,"locale":8,"draft":6,"navigation":261,"icon":262,"path":263},"User synchronization","content:docs:3.build:3.authentication:9.user-synchronization.md","3\u002F3\u002F9",{"icon":262},"i-lucide-refresh-ccw","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fuser-synchronization",{"title":265,"id":266,"canonicalKey":267,"locale":8,"draft":6,"navigation":268,"icon":269,"path":270},"Delegated OAuth and MCP","content:docs:3.build:3.authentication:10.delegated-oauth-and-mcp.md","3\u002F3\u002F10",{"icon":269},"i-lucide-bot","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fdelegated-oauth-and-mcp",{"title":272,"id":273,"canonicalKey":274,"locale":8,"draft":6,"navigation":275,"icon":276,"path":277},"Transactional auth email","content:docs:3.build:3.authentication:11.transactional-email.md","3\u002F3\u002F11",{"icon":276},"i-lucide-mail","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Ftransactional-email",{"title":279,"id":280,"canonicalKey":281,"locale":8,"draft":6,"navigation":282,"icon":283,"path":284},"Social sign-in","content:docs:3.build:3.authentication:12.social-sign-in.md","3\u002F3\u002F12",{"icon":283},"i-lucide-github","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsocial-sign-in",{"title":286,"id":287,"canonicalKey":288,"locale":8,"draft":6,"navigation":289,"icon":290,"path":291},"Better Auth plugin support","content:docs:3.build:3.authentication:13.better-auth-plugin-support.md","3\u002F3\u002F13",{"icon":290},"i-lucide-puzzle","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugin-support",{"title":293,"page":6,"canonicalKey":294,"locale":8,"children":295},"Server","3\u002F4",[296,303,310,317],{"title":297,"id":298,"canonicalKey":299,"locale":8,"draft":6,"navigation":300,"icon":301,"path":302},"serverConvex","content:docs:3.build:4.server:1.server-convex.md","3\u002F4\u002F1",{"icon":301},"i-lucide-server","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-convex",{"title":304,"id":305,"canonicalKey":306,"locale":8,"draft":6,"navigation":307,"icon":308,"path":309},"Server routes","content:docs:3.build:4.server:2.server-routes.md","3\u002F4\u002F2",{"icon":308},"i-lucide-waypoints","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-routes",{"title":311,"id":312,"canonicalKey":313,"locale":8,"draft":6,"navigation":314,"icon":315,"path":316},"Webhooks and jobs","content:docs:3.build:4.server:3.webhooks-and-jobs.md","3\u002F4\u002F3",{"icon":315},"i-lucide-webhook","\u002Fdocs\u002Fbuild\u002Fserver\u002Fwebhooks-and-jobs",{"title":318,"id":319,"canonicalKey":320,"locale":8,"draft":6,"navigation":321,"icon":322,"path":323},"Credentials and server security","content:docs:3.build:4.server:4.credentials-and-security.md","3\u002F4\u002F4",{"icon":322},"i-lucide-key-round","\u002Fdocs\u002Fbuild\u002Fserver\u002Fcredentials-and-security",{"title":325,"page":6,"canonicalKey":326,"locale":8,"children":327},"Files","3\u002F5",[328,335,342],{"title":329,"id":330,"canonicalKey":331,"locale":8,"draft":6,"navigation":332,"icon":333,"path":334},"Upload files","content:docs:3.build:5.files:1.upload-files.md","3\u002F5\u002F1",{"icon":333},"i-lucide-upload","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fupload-files",{"title":336,"id":337,"canonicalKey":338,"locale":8,"draft":6,"navigation":339,"icon":340,"path":341},"Storage URLs","content:docs:3.build:5.files:3.storage-urls.md","3\u002F5\u002F3",{"icon":340},"i-lucide-link","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fstorage-urls",{"title":343,"id":344,"canonicalKey":345,"locale":8,"draft":6,"navigation":346,"icon":347,"path":348},"File validation and deletion","content:docs:3.build:5.files:4.validation-and-deletion.md","3\u002F5\u002F4",{"icon":347},"i-lucide-file-x","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fvalidation-and-deletion",{"title":350,"page":6,"canonicalKey":351,"locale":8,"children":352},"Application Behavior","3\u002F6",[353,360,367,374,381],{"title":354,"id":355,"canonicalKey":356,"locale":8,"draft":6,"navigation":357,"icon":358,"path":359},"Connection state","content:docs:3.build:6.application-behavior:1.connection-state.md","3\u002F6\u002F1",{"icon":358},"i-lucide-wifi","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fconnection-state",{"title":361,"id":362,"canonicalKey":363,"locale":8,"draft":6,"navigation":364,"icon":365,"path":366},"Error handling","content:docs:3.build:6.application-behavior:2.error-handling.md","3\u002F6\u002F2",{"icon":365},"i-lucide-circle-alert","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Ferror-handling",{"title":368,"id":369,"canonicalKey":370,"locale":8,"draft":6,"navigation":371,"icon":372,"path":373},"Logging","content:docs:3.build:6.application-behavior:3.logging.md","3\u002F6\u002F3",{"icon":372},"i-lucide-scroll-text","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Flogging",{"title":375,"id":376,"canonicalKey":377,"locale":8,"draft":6,"navigation":378,"icon":379,"path":380},"DevTools","content:docs:3.build:6.application-behavior:4.devtools.md","3\u002F6\u002F4",{"icon":379},"i-lucide-wrench","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fdevtools",{"title":382,"id":383,"canonicalKey":384,"locale":8,"draft":6,"navigation":385,"icon":386,"path":387},"Performance","content:docs:3.build:6.application-behavior:5.performance.md","3\u002F6\u002F5",{"icon":386},"i-lucide-chart-no-axes-combined","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fperformance",{"title":389,"page":6,"canonicalKey":390,"locale":8,"id":391,"draft":6,"icon":269,"children":392},"Agents and MCP","3\u002F7","content:docs:3.build:7.agents:.navigation.yml",[393,400,406,412],{"title":394,"id":395,"canonicalKey":396,"locale":8,"draft":6,"navigation":397,"icon":398,"path":399},"MCP on Convex","content:docs:3.build:7.agents:1.mcp.md","3\u002F7\u002F1",{"icon":398},"i-lucide-plug-zap","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp",{"title":401,"id":402,"canonicalKey":403,"locale":8,"draft":6,"navigation":404,"icon":248,"path":405},"Add MCP to your application","content:docs:3.build:7.agents:2.mcp-application.md","3\u002F7\u002F2",{"icon":248},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-application",{"title":407,"id":408,"canonicalKey":409,"locale":8,"draft":6,"navigation":410,"icon":340,"path":411},"Connect ChatGPT and Claude","content:docs:3.build:7.agents:3.connect-chatgpt-and-claude.md","3\u002F7\u002F3",{"icon":340},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fconnect-chatgpt-and-claude",{"title":413,"id":414,"canonicalKey":415,"locale":8,"draft":6,"navigation":416,"icon":108,"path":417},"MCP Apps","content:docs:3.build:7.agents:4.mcp-apps.md","3\u002F7\u002F4",{"icon":108},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-apps",{"title":419,"page":6,"canonicalKey":420,"locale":8,"id":421,"draft":6,"icon":422,"children":423},"Recipes","4","content:docs:4.recipes:.navigation.yml","i-lucide-cooking-pot",[424,431,438,445,452,459,466,472,478],{"title":425,"id":426,"canonicalKey":427,"locale":8,"draft":6,"navigation":428,"icon":429,"path":430},"Protected dashboard","content:docs:4.recipes:1.protected-dashboard.md","4\u002F1",{"icon":429},"i-lucide-layout-dashboard","\u002Fdocs\u002Frecipes\u002Fprotected-dashboard",{"title":432,"id":433,"canonicalKey":434,"locale":8,"draft":6,"navigation":435,"icon":436,"path":437},"Real-time feed","content:docs:4.recipes:2.realtime-feed.md","4\u002F2",{"icon":436},"i-lucide-messages-square","\u002Fdocs\u002Frecipes\u002Frealtime-feed",{"title":439,"id":440,"canonicalKey":441,"locale":8,"draft":6,"navigation":442,"icon":443,"path":444},"Optimistic todo list","content:docs:4.recipes:3.optimistic-todo-list.md","4\u002F3",{"icon":443},"i-lucide-list-todo","\u002Fdocs\u002Frecipes\u002Foptimistic-todo-list",{"title":446,"id":447,"canonicalKey":448,"locale":8,"draft":6,"navigation":449,"icon":450,"path":451},"Infinite scroll","content:docs:4.recipes:4.infinite-scroll.md","4\u002F4",{"icon":450},"i-lucide-mouse","\u002Fdocs\u002Frecipes\u002Finfinite-scroll",{"title":453,"id":454,"canonicalKey":455,"locale":8,"draft":6,"navigation":456,"icon":457,"path":458},"File upload form","content:docs:4.recipes:5.file-upload-form.md","4\u002F5",{"icon":457},"i-lucide-file-up","\u002Fdocs\u002Frecipes\u002Ffile-upload-form",{"title":460,"id":461,"canonicalKey":462,"locale":8,"draft":6,"navigation":463,"icon":464,"path":465},"Organization permissions","content:docs:4.recipes:6.organization-permissions.md","4\u002F6",{"icon":464},"i-lucide-building-2","\u002Fdocs\u002Frecipes\u002Forganization-permissions",{"title":467,"id":468,"canonicalKey":469,"locale":8,"draft":6,"navigation":470,"icon":301,"path":471},"Authenticated server route","content:docs:4.recipes:7.authenticated-server-route.md","4\u002F7",{"icon":301},"\u002Fdocs\u002Frecipes\u002Fauthenticated-server-route",{"title":473,"id":474,"canonicalKey":475,"locale":8,"draft":6,"navigation":476,"icon":108,"path":477},"Public and private data","content:docs:4.recipes:8.public-and-private-data.md","4\u002F8",{"icon":108},"\u002Fdocs\u002Frecipes\u002Fpublic-and-private-data",{"title":479,"id":480,"canonicalKey":481,"locale":8,"draft":6,"navigation":482,"icon":483,"path":484},"Test signed-in screens","content:docs:4.recipes:9.component-testing.md","4\u002F9",{"icon":483},"i-lucide-flask-conical","\u002Fdocs\u002Frecipes\u002Fcomponent-testing",{"title":486,"page":6,"canonicalKey":487,"locale":8,"id":488,"draft":6,"icon":489,"children":490},"Concepts","5","content:docs:5.concepts:.navigation.yml","i-lucide-brain",[491,497,503,510,516,523,529,536,543],{"title":492,"id":493,"canonicalKey":494,"locale":8,"draft":6,"navigation":495,"icon":489,"path":496},"Mental model","content:docs:5.concepts:1.mental-model.md","5\u002F1",{"icon":489},"\u002Fdocs\u002Fconcepts\u002Fmental-model",{"title":498,"id":499,"canonicalKey":500,"locale":8,"draft":6,"navigation":501,"icon":234,"path":502},"Request lifecycle","content:docs:5.concepts:2.request-lifecycle.md","5\u002F2",{"icon":234},"\u002Fdocs\u002Fconcepts\u002Frequest-lifecycle",{"title":504,"id":505,"canonicalKey":506,"locale":8,"draft":6,"navigation":507,"icon":508,"path":509},"SSR, hydration, and real-time","content:docs:5.concepts:3.ssr-hydration-realtime.md","5\u002F3",{"icon":508},"i-lucide-refresh-cw","\u002Fdocs\u002Fconcepts\u002Fssr-hydration-realtime",{"title":511,"id":512,"canonicalKey":513,"locale":8,"draft":6,"navigation":514,"icon":124,"path":515},"Query ownership and caching","content:docs:5.concepts:4.query-ownership-and-caching.md","5\u002F4",{"icon":124},"\u002Fdocs\u002Fconcepts\u002Fquery-ownership-and-caching",{"title":517,"id":518,"canonicalKey":519,"locale":8,"draft":6,"navigation":520,"icon":521,"path":522},"Authentication and identity","content:docs:5.concepts:5.authentication-and-identity.md","5\u002F5",{"icon":521},"i-lucide-fingerprint","\u002Fdocs\u002Fconcepts\u002Fauthentication-and-identity",{"title":524,"id":525,"canonicalKey":526,"locale":8,"draft":6,"navigation":527,"icon":108,"path":528},"Server and client boundaries","content:docs:5.concepts:6.server-and-client-boundaries.md","5\u002F6",{"icon":108},"\u002Fdocs\u002Fconcepts\u002Fserver-and-client-boundaries",{"title":530,"id":531,"canonicalKey":532,"locale":8,"draft":6,"navigation":533,"icon":534,"path":535},"Errors and failures","content:docs:5.concepts:7.errors-and-failures.md","5\u002F7",{"icon":534},"i-lucide-circle-x","\u002Fdocs\u002Fconcepts\u002Ferrors-and-failures",{"title":537,"id":538,"canonicalKey":539,"locale":8,"draft":6,"navigation":540,"icon":541,"path":542},"Design decisions","content:docs:5.concepts:8.design-decisions.md","5\u002F8",{"icon":541},"i-lucide-git-branch","\u002Fdocs\u002Fconcepts\u002Fdesign-decisions",{"title":544,"id":545,"canonicalKey":546,"locale":8,"draft":6,"navigation":547,"icon":548,"path":549},"Glossary","content:docs:5.concepts:9.glossary.md","5\u002F9",{"icon":548},"i-lucide-book-a","\u002Fdocs\u002Fconcepts\u002Fglossary",{"title":551,"page":6,"canonicalKey":552,"locale":8,"id":553,"draft":6,"icon":214,"children":554},"Operations","6","content:docs:6.operations:.navigation.yml",[555,561,568,575,581,588,594],{"title":556,"id":557,"canonicalKey":558,"locale":8,"draft":6,"navigation":559,"icon":45,"path":560},"Deployment","content:docs:6.operations:1.deployment.md","6\u002F1",{"icon":45},"\u002Fdocs\u002Foperations\u002Fdeployment",{"title":562,"id":563,"canonicalKey":564,"locale":8,"draft":6,"navigation":565,"icon":566,"path":567},"Environment variables","content:docs:6.operations:2.environment-variables.md","6\u002F2",{"icon":566},"i-lucide-variable","\u002Fdocs\u002Foperations\u002Fenvironment-variables",{"title":569,"id":570,"canonicalKey":571,"locale":8,"draft":6,"navigation":572,"icon":573,"path":574},"Deploy to Vercel","content:docs:6.operations:3.deploy-to-vercel.md","6\u002F3",{"icon":573},"i-lucide-triangle","\u002Fdocs\u002Foperations\u002Fdeploy-to-vercel",{"title":576,"id":577,"canonicalKey":578,"locale":8,"draft":6,"navigation":579,"icon":379,"path":580},"Troubleshooting","content:docs:6.operations:4.troubleshooting.md","6\u002F4",{"icon":379},"\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":582,"id":583,"canonicalKey":584,"locale":8,"draft":6,"navigation":585,"icon":586,"path":587},"Release compatibility","content:docs:6.operations:5.release-compatibility.md","6\u002F5",{"icon":586},"i-lucide-badge-check","\u002Fdocs\u002Foperations\u002Frelease-compatibility",{"title":589,"id":590,"canonicalKey":591,"locale":8,"draft":6,"navigation":592,"icon":87,"path":593},"Security model","content:docs:6.operations:6.security-model.md","6\u002F6",{"icon":87},"\u002Fdocs\u002Foperations\u002Fsecurity-model",{"title":595,"id":596,"canonicalKey":597,"locale":8,"draft":6,"navigation":598,"icon":599,"path":600},"Upgrade to 1.0","content:docs:6.operations:7.upgrade-to-1-0.md","6\u002F7",{"icon":599},"i-lucide-arrow-up-circle","\u002Fdocs\u002Foperations\u002Fupgrade-to-1-0",{"title":602,"page":6,"canonicalKey":603,"locale":8,"id":604,"draft":6,"icon":605,"children":606},"Reference","7","content:docs:7.reference:.navigation.yml","i-lucide-braces",[607,613,619,625,632,639],{"title":608,"id":609,"canonicalKey":610,"locale":8,"draft":6,"navigation":611,"icon":605,"path":612},"Composables","content:docs:7.reference:1.composables.md","7\u002F1",{"icon":605},"\u002Fdocs\u002Freference\u002Fcomposables",{"title":614,"id":615,"canonicalKey":616,"locale":8,"draft":6,"navigation":617,"icon":301,"path":618},"Server API","content:docs:7.reference:3.server-api.md","7\u002F3",{"icon":301},"\u002Fdocs\u002Freference\u002Fserver-api",{"title":620,"id":621,"canonicalKey":622,"locale":8,"draft":6,"navigation":623,"icon":534,"path":624},"Error types","content:docs:7.reference:4.error-types.md","7\u002F4",{"icon":534},"\u002Fdocs\u002Freference\u002Ferror-types",{"title":626,"id":627,"canonicalKey":628,"locale":8,"draft":6,"navigation":629,"icon":630,"path":631},"Module configuration","content:docs:7.reference:5.module-configuration.md","7\u002F5",{"icon":630},"i-lucide-settings","\u002Fdocs\u002Freference\u002Fmodule-configuration",{"title":633,"id":634,"canonicalKey":635,"locale":8,"draft":6,"navigation":636,"icon":637,"path":638},"Package exports","content:docs:7.reference:6.package-exports.md","7\u002F6",{"icon":637},"i-lucide-package-open","\u002Fdocs\u002Freference\u002Fpackage-exports",{"title":640,"id":641,"canonicalKey":642,"locale":8,"draft":6,"navigation":643,"icon":644,"path":645},"API surface","content:docs:7.reference:7.api-surface.md","7\u002F7",{"icon":644},"i-lucide-list","\u002Fdocs\u002Freference\u002Fapi-surface",{"title":647,"id":648,"canonicalKey":649,"locale":8,"draft":6,"path":650},"Better Convex documentation","content:docs:index.md","\u002F","\u002Fdocs",{"title":517,"description":652,"navigation":653,"body":654,"type":1475,"id":518,"canonicalKey":519,"draft":6,"partial":6,"locale":8,"collection":1476,"navigationFile":6,"file":1477,"route":1483,"resolution":1485},"Understand auth state, query auth modes, identity isolation, and client replacement.",{"icon":521},{"type":655,"children":656,"toc":1463},"root",[657,665,672,677,697,792,814,820,926,969,1211,1228,1234,1239,1280,1285,1310,1315,1328,1339,1375,1393,1424,1430,1435,1440,1446,1451],{"type":658,"tag":659,"props":660,"children":661},"element","p",{},[662],{"type":663,"value":664},"text","Authentication answers “which session is valid?” Identity isolation answers “which query state is safe to keep?” They are related but not interchangeable.",{"type":658,"tag":666,"props":667,"children":669},"h2",{"id":668},"better-auth-owns-the-session",[670],{"type":663,"value":671},"Better Auth owns the session",{"type":658,"tag":659,"props":673,"children":674},{},[675],{"type":663,"value":676},"Better Auth resolves the session, performs sign-in and sign-out, and exposes configured plugin methods. Better Convex Nuxt observes the public session state and coordinates the identity used by Convex.",{"type":658,"tag":659,"props":678,"children":679},{},[680,682,688,690,695],{"type":663,"value":681},"An explicit ",{"type":658,"tag":683,"props":684,"children":685},"code",{},[686],{"type":663,"value":687},"convex.auth",{"type":663,"value":689}," object installs ",{"type":658,"tag":683,"props":691,"children":692},{},[693],{"type":663,"value":694},"useConvexAuth()",{"type":663,"value":696},", which exposes the current usable state. A build that omits auth has no auth composable or disabled runtime state.",{"type":658,"tag":698,"props":699,"children":700},"table",{},[701,723],{"type":658,"tag":702,"props":703,"children":704},"thead",{},[705],{"type":658,"tag":706,"props":707,"children":708},"tr",{},[709,718],{"type":658,"tag":710,"props":711,"children":712},"th",{},[713],{"type":658,"tag":683,"props":714,"children":715},{},[716],{"type":663,"value":717},"status",{"type":658,"tag":710,"props":719,"children":720},{},[721],{"type":663,"value":722},"Meaning",{"type":658,"tag":724,"props":725,"children":726},"tbody",{},[727,744,760,776],{"type":658,"tag":706,"props":728,"children":729},{},[730,739],{"type":658,"tag":731,"props":732,"children":733},"td",{},[734],{"type":658,"tag":683,"props":735,"children":736},{},[737],{"type":663,"value":738},"loading",{"type":658,"tag":731,"props":740,"children":741},{},[742],{"type":663,"value":743},"The first auth state is not known yet",{"type":658,"tag":706,"props":745,"children":746},{},[747,755],{"type":658,"tag":731,"props":748,"children":749},{},[750],{"type":658,"tag":683,"props":751,"children":752},{},[753],{"type":663,"value":754},"authenticated",{"type":658,"tag":731,"props":756,"children":757},{},[758],{"type":663,"value":759},"A usable signed-in identity exists",{"type":658,"tag":706,"props":761,"children":762},{},[763,771],{"type":658,"tag":731,"props":764,"children":765},{},[766],{"type":658,"tag":683,"props":767,"children":768},{},[769],{"type":663,"value":770},"error",{"type":658,"tag":731,"props":772,"children":773},{},[774],{"type":663,"value":775},"The first auth check failed, and no user is signed in",{"type":658,"tag":706,"props":777,"children":778},{},[779,787],{"type":658,"tag":731,"props":780,"children":781},{},[782],{"type":658,"tag":683,"props":783,"children":784},{},[785],{"type":663,"value":786},"anonymous",{"type":658,"tag":731,"props":788,"children":789},{},[790],{"type":663,"value":791},"Auth finished without a signed-in identity",{"type":658,"tag":659,"props":793,"children":794},{},[795,800,802,806,808,812],{"type":658,"tag":683,"props":796,"children":797},{},[798],{"type":663,"value":799},"pending",{"type":663,"value":801}," is separate. A background refresh can be pending while ",{"type":658,"tag":683,"props":803,"children":804},{},[805],{"type":663,"value":717},{"type":663,"value":807}," remains ",{"type":658,"tag":683,"props":809,"children":810},{},[811],{"type":663,"value":754},{"type":663,"value":813},".",{"type":658,"tag":666,"props":815,"children":817},{"id":816},"queries-choose-an-auth-policy",[818],{"type":663,"value":819},"Queries choose an auth policy",{"type":658,"tag":698,"props":821,"children":822},{},[823,849],{"type":658,"tag":702,"props":824,"children":825},{},[826],{"type":658,"tag":706,"props":827,"children":828},{},[829,834,839,844],{"type":658,"tag":710,"props":830,"children":831},{},[832],{"type":663,"value":833},"Mode",{"type":658,"tag":710,"props":835,"children":836},{},[837],{"type":663,"value":838},"During initial auth loading",{"type":658,"tag":710,"props":840,"children":841},{},[842],{"type":663,"value":843},"Authenticated",{"type":658,"tag":710,"props":845,"children":846},{},[847],{"type":663,"value":848},"Anonymous",{"type":658,"tag":724,"props":850,"children":851},{},[852,878,902],{"type":658,"tag":706,"props":853,"children":854},{},[855,863,868,873],{"type":658,"tag":731,"props":856,"children":857},{},[858],{"type":658,"tag":683,"props":859,"children":860},{},[861],{"type":663,"value":862},"required",{"type":658,"tag":731,"props":864,"children":865},{},[866],{"type":663,"value":867},"Wait",{"type":658,"tag":731,"props":869,"children":870},{},[871],{"type":663,"value":872},"Run with identity",{"type":658,"tag":731,"props":874,"children":875},{},[876],{"type":663,"value":877},"Stay idle",{"type":658,"tag":706,"props":879,"children":880},{},[881,889,893,897],{"type":658,"tag":731,"props":882,"children":883},{},[884],{"type":658,"tag":683,"props":885,"children":886},{},[887],{"type":663,"value":888},"optional",{"type":658,"tag":731,"props":890,"children":891},{},[892],{"type":663,"value":867},{"type":658,"tag":731,"props":894,"children":895},{},[896],{"type":663,"value":872},{"type":658,"tag":731,"props":898,"children":899},{},[900],{"type":663,"value":901},"Run anonymously",{"type":658,"tag":706,"props":903,"children":904},{},[905,913,918,922],{"type":658,"tag":731,"props":906,"children":907},{},[908],{"type":658,"tag":683,"props":909,"children":910},{},[911],{"type":663,"value":912},"none",{"type":658,"tag":731,"props":914,"children":915},{},[916],{"type":663,"value":917},"Do not wait",{"type":658,"tag":731,"props":919,"children":920},{},[921],{"type":663,"value":901},{"type":658,"tag":731,"props":923,"children":924},{},[925],{"type":663,"value":901},{"type":658,"tag":659,"props":927,"children":928},{},[929,931,935,937,942,944,948,950,954,956,960,962,967],{"type":663,"value":930},"The default is ",{"type":658,"tag":683,"props":932,"children":933},{},[934],{"type":663,"value":888},{"type":663,"value":936},". An application can set ",{"type":658,"tag":683,"props":938,"children":939},{},[940],{"type":663,"value":941},"convex.auth.defaultQueryAuth",{"type":663,"value":943}," (",{"type":658,"tag":683,"props":945,"children":946},{},[947],{"type":663,"value":888},{"type":663,"value":949},", ",{"type":658,"tag":683,"props":951,"children":952},{},[953],{"type":663,"value":862},{"type":663,"value":955},", or ",{"type":658,"tag":683,"props":957,"children":958},{},[959],{"type":663,"value":912},{"type":663,"value":961},"). A call site's ",{"type":658,"tag":683,"props":963,"children":964},{},[965],{"type":663,"value":966},"auth",{"type":663,"value":968}," option always wins. Server rendering and the browser use the same value.",{"type":658,"tag":970,"props":971,"children":974},"pre",{"language":972,"class":973},"ts","shiki shiki-themes light-plus dark-plus dark:dark-plus",[975],{"type":658,"tag":683,"props":976,"children":978},{"class":977},"language-ts",[979,1014,1016,1048,1049,1057,1058,1066,1067,1085,1086,1094,1095,1103,1104,1107,1108,1132,1133,1162,1163,1170,1171,1178,1179,1195,1196,1203,1204],{"type":658,"tag":980,"props":981,"children":984},"span",{"class":982,"style":983},"line","display: inline",[985,991,997,1003,1009],{"type":658,"tag":980,"props":986,"children":988},{"style":987},"color:#0000FF;--shiki-dark:#569CD6",[989],{"type":663,"value":990},"const",{"type":658,"tag":980,"props":992,"children":994},{"style":993},"color:#0070C1;--shiki-dark:#4FC1FF",[995],{"type":663,"value":996}," account",{"type":658,"tag":980,"props":998,"children":1000},{"style":999},"color:#000000;--shiki-dark:#D4D4D4",[1001],{"type":663,"value":1002}," = ",{"type":658,"tag":980,"props":1004,"children":1006},{"style":1005},"color:#795E26;--shiki-dark:#DCDCAA",[1007],{"type":663,"value":1008},"useConvexQuery",{"type":658,"tag":980,"props":1010,"children":1011},{"style":999},[1012],{"type":663,"value":1013},"(",{"type":663,"value":1015},"\n",{"type":658,"tag":980,"props":1017,"children":1018},{"class":982,"style":983},[1019,1025,1029,1034,1038,1043],{"type":658,"tag":980,"props":1020,"children":1022},{"style":1021},"color:#001080;--shiki-dark:#9CDCFE",[1023],{"type":663,"value":1024},"  api",{"type":658,"tag":980,"props":1026,"children":1027},{"style":999},[1028],{"type":663,"value":813},{"type":658,"tag":980,"props":1030,"children":1031},{"style":1021},[1032],{"type":663,"value":1033},"accounts",{"type":658,"tag":980,"props":1035,"children":1036},{"style":999},[1037],{"type":663,"value":813},{"type":658,"tag":980,"props":1039,"children":1040},{"style":1021},[1041],{"type":663,"value":1042},"current",{"type":658,"tag":980,"props":1044,"children":1045},{"style":999},[1046],{"type":663,"value":1047},",",{"type":663,"value":1015},{"type":658,"tag":980,"props":1050,"children":1051},{"class":982,"style":983},[1052],{"type":658,"tag":980,"props":1053,"children":1054},{"style":999},[1055],{"type":663,"value":1056},"  {},",{"type":663,"value":1015},{"type":658,"tag":980,"props":1059,"children":1060},{"class":982,"style":983},[1061],{"type":658,"tag":980,"props":1062,"children":1063},{"style":999},[1064],{"type":663,"value":1065},"  {",{"type":663,"value":1015},{"type":658,"tag":980,"props":1068,"children":1069},{"class":982,"style":983},[1070,1075,1081],{"type":658,"tag":980,"props":1071,"children":1072},{"style":1021},[1073],{"type":663,"value":1074},"    auth:",{"type":658,"tag":980,"props":1076,"children":1078},{"style":1077},"color:#A31515;--shiki-dark:#CE9178",[1079],{"type":663,"value":1080}," 'required'",{"type":658,"tag":980,"props":1082,"children":1083},{"style":999},[1084],{"type":663,"value":1047},{"type":663,"value":1015},{"type":658,"tag":980,"props":1087,"children":1088},{"class":982,"style":983},[1089],{"type":658,"tag":980,"props":1090,"children":1091},{"style":999},[1092],{"type":663,"value":1093},"  },",{"type":663,"value":1015},{"type":658,"tag":980,"props":1096,"children":1097},{"class":982,"style":983},[1098],{"type":658,"tag":980,"props":1099,"children":1100},{"style":999},[1101],{"type":663,"value":1102},")",{"type":663,"value":1015},{"type":658,"tag":980,"props":1105,"children":1106},{"class":982,"style":983},[],{"type":663,"value":1015},{"type":658,"tag":980,"props":1109,"children":1110},{"class":982,"style":983},[1111,1115,1120,1124,1128],{"type":658,"tag":980,"props":1112,"children":1113},{"style":987},[1114],{"type":663,"value":990},{"type":658,"tag":980,"props":1116,"children":1117},{"style":993},[1118],{"type":663,"value":1119}," marketing",{"type":658,"tag":980,"props":1121,"children":1122},{"style":999},[1123],{"type":663,"value":1002},{"type":658,"tag":980,"props":1125,"children":1126},{"style":1005},[1127],{"type":663,"value":1008},{"type":658,"tag":980,"props":1129,"children":1130},{"style":999},[1131],{"type":663,"value":1013},{"type":663,"value":1015},{"type":658,"tag":980,"props":1134,"children":1135},{"class":982,"style":983},[1136,1140,1144,1149,1153,1158],{"type":658,"tag":980,"props":1137,"children":1138},{"style":1021},[1139],{"type":663,"value":1024},{"type":658,"tag":980,"props":1141,"children":1142},{"style":999},[1143],{"type":663,"value":813},{"type":658,"tag":980,"props":1145,"children":1146},{"style":1021},[1147],{"type":663,"value":1148},"pages",{"type":658,"tag":980,"props":1150,"children":1151},{"style":999},[1152],{"type":663,"value":813},{"type":658,"tag":980,"props":1154,"children":1155},{"style":1021},[1156],{"type":663,"value":1157},"home",{"type":658,"tag":980,"props":1159,"children":1160},{"style":999},[1161],{"type":663,"value":1047},{"type":663,"value":1015},{"type":658,"tag":980,"props":1164,"children":1165},{"class":982,"style":983},[1166],{"type":658,"tag":980,"props":1167,"children":1168},{"style":999},[1169],{"type":663,"value":1056},{"type":663,"value":1015},{"type":658,"tag":980,"props":1172,"children":1173},{"class":982,"style":983},[1174],{"type":658,"tag":980,"props":1175,"children":1176},{"style":999},[1177],{"type":663,"value":1065},{"type":663,"value":1015},{"type":658,"tag":980,"props":1180,"children":1181},{"class":982,"style":983},[1182,1186,1191],{"type":658,"tag":980,"props":1183,"children":1184},{"style":1021},[1185],{"type":663,"value":1074},{"type":658,"tag":980,"props":1187,"children":1188},{"style":1077},[1189],{"type":663,"value":1190}," 'none'",{"type":658,"tag":980,"props":1192,"children":1193},{"style":999},[1194],{"type":663,"value":1047},{"type":663,"value":1015},{"type":658,"tag":980,"props":1197,"children":1198},{"class":982,"style":983},[1199],{"type":658,"tag":980,"props":1200,"children":1201},{"style":999},[1202],{"type":663,"value":1093},{"type":663,"value":1015},{"type":658,"tag":980,"props":1205,"children":1206},{"class":982,"style":983},[1207],{"type":658,"tag":980,"props":1208,"children":1209},{"style":999},[1210],{"type":663,"value":1102},{"type":658,"tag":659,"props":1212,"children":1213},{},[1214,1216,1220,1222,1226],{"type":663,"value":1215},"Use ",{"type":658,"tag":683,"props":1217,"children":1218},{},[1219],{"type":663,"value":912},{"type":663,"value":1221}," only when the function must never receive identity. In an auth-enabled app, live ",{"type":658,"tag":683,"props":1223,"children":1224},{},[1225],{"type":663,"value":912},{"type":663,"value":1227}," queries use a dedicated client that is never authenticated.",{"type":658,"tag":666,"props":1229,"children":1231},{"id":1230},"identity-changes-are-hard-boundaries",[1232],{"type":663,"value":1233},"Identity changes are hard boundaries",{"type":658,"tag":659,"props":1235,"children":1236},{},[1237],{"type":663,"value":1238},"Consider this browser sequence:",{"type":658,"tag":970,"props":1240,"children":1241},{"language":663,"class":973},[1242],{"type":658,"tag":683,"props":1243,"children":1245},{"class":1244},"language-text",[1246,1253,1254,1262,1263,1271,1272],{"type":658,"tag":980,"props":1247,"children":1248},{"class":982,"style":983},[1249],{"type":658,"tag":980,"props":1250,"children":1251},{},[1252],{"type":663,"value":786},{"type":663,"value":1015},{"type":658,"tag":980,"props":1255,"children":1256},{"class":982,"style":983},[1257],{"type":658,"tag":980,"props":1258,"children":1259},{},[1260],{"type":663,"value":1261},"  → user A signs in",{"type":663,"value":1015},{"type":658,"tag":980,"props":1264,"children":1265},{"class":982,"style":983},[1266],{"type":658,"tag":980,"props":1267,"children":1268},{},[1269],{"type":663,"value":1270},"  → user A signs out",{"type":663,"value":1015},{"type":658,"tag":980,"props":1273,"children":1274},{"class":982,"style":983},[1275],{"type":658,"tag":980,"props":1276,"children":1277},{},[1278],{"type":663,"value":1279},"  → user B signs in",{"type":658,"tag":659,"props":1281,"children":1282},{},[1283],{"type":663,"value":1284},"The runtime cannot safely reuse user A's local query and optimistic state for user B. On a stable identity change it:",{"type":658,"tag":1286,"props":1287,"children":1288},"ol",{},[1289,1295,1300,1305],{"type":658,"tag":1290,"props":1291,"children":1292},"li",{},[1293],{"type":663,"value":1294},"Clears identity-owned query state synchronously.",{"type":658,"tag":1290,"props":1296,"children":1297},{},[1298],{"type":663,"value":1299},"Retires the previous primary Convex client.",{"type":658,"tag":1290,"props":1301,"children":1302},{},[1303],{"type":663,"value":1304},"Creates and confirms a client for the new identity.",{"type":658,"tag":1290,"props":1306,"children":1307},{},[1308],{"type":663,"value":1309},"Rebinds supported listeners to the current client.",{"type":658,"tag":659,"props":1311,"children":1312},{},[1313],{"type":663,"value":1314},"Same-user token refresh does not create a new identity generation. It refreshes authentication without discarding valid same-user state.",{"type":658,"tag":666,"props":1316,"children":1318},{"id":1317},"why-useconvex-is-a-handle",[1319,1321,1326],{"type":663,"value":1320},"Why ",{"type":658,"tag":683,"props":1322,"children":1323},{},[1324],{"type":663,"value":1325},"useConvex()",{"type":663,"value":1327}," is a handle",{"type":658,"tag":659,"props":1329,"children":1330},{},[1331,1333,1337],{"type":663,"value":1332},"A raw client reference would become stale after replacement. ",{"type":658,"tag":683,"props":1334,"children":1335},{},[1336],{"type":663,"value":1325},{"type":663,"value":1338}," instead returns a stable object with four methods:",{"type":658,"tag":1340,"props":1341,"children":1342},"ul",{},[1343,1351,1359,1367],{"type":658,"tag":1290,"props":1344,"children":1345},{},[1346],{"type":658,"tag":683,"props":1347,"children":1348},{},[1349],{"type":663,"value":1350},"query",{"type":658,"tag":1290,"props":1352,"children":1353},{},[1354],{"type":658,"tag":683,"props":1355,"children":1356},{},[1357],{"type":663,"value":1358},"mutation",{"type":658,"tag":1290,"props":1360,"children":1361},{},[1362],{"type":658,"tag":683,"props":1363,"children":1364},{},[1365],{"type":663,"value":1366},"action",{"type":658,"tag":1290,"props":1368,"children":1369},{},[1370],{"type":658,"tag":683,"props":1371,"children":1372},{},[1373],{"type":663,"value":1374},"onUpdate",{"type":658,"tag":659,"props":1376,"children":1377},{},[1378,1380,1385,1387,1392],{"type":663,"value":1379},"Each call dispatches to the current client. A call that crosses an identity generation rejects with an authentication ",{"type":658,"tag":683,"props":1381,"children":1382},{},[1383],{"type":663,"value":1384},"ConvexCallError",{"type":663,"value":1386}," carrying code ",{"type":658,"tag":683,"props":1388,"children":1389},{},[1390],{"type":663,"value":1391},"IDENTITY_CHANGED",{"type":663,"value":813},{"type":658,"tag":659,"props":1394,"children":1395},{},[1396,1398,1402,1404,1409,1411,1416,1418,1423],{"type":663,"value":1397},"The browser client does not exist during server rendering. There, ",{"type":658,"tag":683,"props":1399,"children":1400},{},[1401],{"type":663,"value":1325},{"type":663,"value":1403}," returns a handle whose calls reject with code ",{"type":658,"tag":683,"props":1405,"children":1406},{},[1407],{"type":663,"value":1408},"CLIENT_UNAVAILABLE",{"type":663,"value":1410},", and ",{"type":658,"tag":683,"props":1412,"children":1413},{},[1414],{"type":663,"value":1415},"useConvexAuth().client",{"type":663,"value":1417}," is a stand-in whose methods throw the same code. Call them from browser event handlers or ",{"type":658,"tag":683,"props":1419,"children":1420},{},[1421],{"type":663,"value":1422},"onMounted()",{"type":663,"value":813},{"type":658,"tag":666,"props":1425,"children":1427},{"id":1426},"ssr-auth-avoids-a-presentation-flash",[1428],{"type":663,"value":1429},"SSR auth avoids a presentation flash",{"type":658,"tag":659,"props":1431,"children":1432},{},[1433],{"type":663,"value":1434},"The server plugin resolves auth for the incoming request and includes the usable auth snapshot in Nuxt state. The browser hydrates that state before continuing auth observation.",{"type":658,"tag":659,"props":1436,"children":1437},{},[1438],{"type":663,"value":1439},"This can avoid an anonymous-to-authenticated flash. It does not make an authenticated page safe to cache publicly.",{"type":658,"tag":666,"props":1441,"children":1443},{"id":1442},"authorization-is-the-next-boundary",[1444],{"type":663,"value":1445},"Authorization is the next boundary",{"type":658,"tag":659,"props":1447,"children":1448},{},[1449],{"type":663,"value":1450},"A valid identity is input to authorization, not the authorization decision. Convex functions still verify ownership, membership, and role rules.",{"type":658,"tag":659,"props":1452,"children":1453},{},[1454,1456,1462],{"type":663,"value":1455},"Continue with ",{"type":658,"tag":1457,"props":1458,"children":1459},"a",{"href":242},[1460],{"type":663,"value":1461},"backend authorization",{"type":663,"value":813},{"title":1464,"searchDepth":1465,"depth":1465,"links":1466},"",4,[1467,1469,1470,1471,1473,1474],{"id":668,"depth":1468,"text":671},2,{"id":816,"depth":1468,"text":819},{"id":1230,"depth":1468,"text":1233},{"id":1317,"depth":1468,"text":1472},"Why useConvex() is a handle",{"id":1426,"depth":1468,"text":1429},{"id":1442,"depth":1468,"text":1445},"markdown","docs",{"source":1478,"path":1479,"stem":1480,"dir":1481,"extension":1482},"content","docs\u002F5.concepts\u002F5.authentication-and-identity.md","docs\u002F5.concepts\u002F5.authentication-and-identity","concepts","md",{"requestedPath":522,"resolvedPath":522,"alternates":1484},[],{"requested":1486,"resolved":1487,"usedFallback":6},{},{"locale":8},{"previous":1489,"next":1491},{"title":511,"id":512,"canonicalKey":513,"locale":8,"draft":6,"navigation":1490,"icon":124,"path":515},{"icon":124},{"title":524,"id":525,"canonicalKey":526,"locale":8,"draft":6,"navigation":1492,"icon":108,"path":528},{"icon":108},{"left":1494,"top":1494,"width":1495,"height":1495,"rotate":1494,"vFlip":6,"hFlip":6,"body":1496},0,256,"\u003Cpath fill=\"#3178c6\" d=\"M20 0h216c11.046 0 20 8.954 20 20v216c0 11.046-8.954 20-20 20H20c-11.046 0-20-8.954-20-20V20C0 8.954 8.954 0 20 0\"\u002F>\u003Cpath fill=\"#fff\" d=\"M150.518 200.475v27.62q6.738 3.453 15.938 5.179T185.849 235q9.934 0 18.874-1.899t15.678-6.257q6.738-4.359 10.669-11.394q3.93-7.033 3.93-17.391q0-7.51-2.246-13.163a30.8 30.8 0 0 0-6.479-10.055q-4.232-4.402-10.149-7.898t-13.347-6.602q-5.442-2.245-9.761-4.359t-7.342-4.316q-3.024-2.2-4.665-4.661t-1.641-5.567q0-2.848 1.468-5.135q1.469-2.288 4.147-3.927t6.565-2.547q3.887-.906 8.638-.906q3.456 0 7.299.518q3.844.517 7.732 1.597a54 54 0 0 1 7.558 2.719a41.7 41.7 0 0 1 6.781 3.797v-25.807q-6.306-2.417-13.778-3.582T198.633 107q-9.847 0-18.658 2.115q-8.811 2.114-15.506 6.602q-6.694 4.49-10.582 11.437Q150 134.102 150 143.769q0 12.342 7.127 21.06t21.638 14.759a292 292 0 0 1 10.625 4.575q4.924 2.244 8.509 4.66t5.658 5.265t2.073 6.474a9.9 9.9 0 0 1-1.296 4.963q-1.295 2.287-3.93 3.97t-6.565 2.632t-9.2.95q-8.983 0-17.794-3.151t-16.327-9.451m-46.036-68.733H140V109H41v22.742h35.345V233h28.137z\"\u002F>",{"left":1494,"top":1494,"width":1498,"height":1498,"rotate":1494,"vFlip":6,"hFlip":6,"body":1499},24,"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"8\" height=\"4\" x=\"8\" y=\"2\" rx=\"1\" ry=\"1\"\u002F>\u003Cpath d=\"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2\"\u002F>\u003C\u002Fg>",1790591521248]