[{"data":1,"prerenderedAt":1587},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:docs:ZkigcpfyET25Qv7vaID12IDB2Y7AF-ywrOkG4C_9LeA":842,"content-page-surround:docs:ZkigcpfyET25Qv7vaID12IDB2Y7AF-ywrOkG4C_9LeA":1582},[4,41,110,540,643,708,772,837],{"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},"Complete and delete","content:docs:2.get-started:4.complete-and-delete.md","2\u002F4",{"icon":73},"i-lucide-square-check","\u002Fdocs\u002Fget-started\u002Fcomplete-and-delete",{"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,200,321,353,385,431,481],{"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,165,172,179,186,193],{"title":159,"id":160,"canonicalKey":161,"locale":8,"draft":6,"navigation":162,"icon":163,"path":164},"Mutations","content:docs:3.build:2.write-data:1.mutations.md","3\u002F2\u002F1",{"icon":163},"i-lucide-square-pen","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmutations",{"title":166,"id":167,"canonicalKey":168,"locale":8,"draft":6,"navigation":169,"icon":170,"path":171},"Actions","content:docs:3.build:2.write-data:2.actions.md","3\u002F2\u002F2",{"icon":170},"i-lucide-zap","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Factions",{"title":173,"id":174,"canonicalKey":175,"locale":8,"draft":6,"navigation":176,"icon":177,"path":178},"Optimistic updates","content:docs:3.build:2.write-data:3.optimistic-updates.md","3\u002F2\u002F3",{"icon":177},"i-lucide-gauge","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Foptimistic-updates",{"title":180,"id":181,"canonicalKey":182,"locale":8,"draft":6,"navigation":183,"icon":184,"path":185},"Concurrent operations","content:docs:3.build:2.write-data:4.concurrent-operations.md","3\u002F2\u002F4",{"icon":184},"i-lucide-git-fork","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fconcurrent-operations",{"title":187,"id":188,"canonicalKey":189,"locale":8,"draft":6,"navigation":190,"icon":191,"path":192},"Form submissions","content:docs:3.build:2.write-data:5.forms.md","3\u002F2\u002F5",{"icon":191},"i-lucide-list-checks","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fforms",{"title":194,"id":195,"canonicalKey":196,"locale":8,"draft":6,"navigation":197,"icon":198,"path":199},"Multi-step operations","content:docs:3.build:2.write-data:6.multi-step-operations.md","3\u002F2\u002F6",{"icon":198},"i-lucide-list-ordered","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmulti-step-operations",{"title":201,"page":6,"canonicalKey":202,"locale":8,"children":203},"Authentication","3\u002F3",[204,210,217,224,230,237,244,251,258,265,272,279,286,293,300,307,314],{"title":201,"id":205,"canonicalKey":206,"locale":8,"draft":6,"navigation":207,"icon":208,"path":209},"content:docs:3.build:3.authentication:1.overview.md","3\u002F3\u002F1",{"icon":208},"i-lucide-shield","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Foverview",{"title":211,"id":212,"canonicalKey":213,"locale":8,"draft":6,"navigation":214,"icon":215,"path":216},"Better Auth setup","content:docs:3.build:3.authentication:2.better-auth-setup.md","3\u002F3\u002F2",{"icon":215},"i-lucide-settings-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-setup",{"title":218,"id":219,"canonicalKey":220,"locale":8,"draft":6,"navigation":221,"icon":222,"path":223},"Auth state and user data","content:docs:3.build:3.authentication:3.auth-state-and-user.md","3\u002F3\u002F3",{"icon":222},"i-lucide-user-round","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fauth-state-and-user",{"title":225,"id":226,"canonicalKey":227,"locale":8,"draft":6,"navigation":228,"icon":80,"path":229},"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":231,"id":232,"canonicalKey":233,"locale":8,"draft":6,"navigation":234,"icon":235,"path":236},"Route protection","content:docs:3.build:3.authentication:5.route-protection.md","3\u002F3\u002F5",{"icon":235},"i-lucide-route","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Froute-protection",{"title":238,"id":239,"canonicalKey":240,"locale":8,"draft":6,"navigation":241,"icon":242,"path":243},"Backend authorization","content:docs:3.build:3.authentication:6.backend-authorization.md","3\u002F3\u002F6",{"icon":242},"i-lucide-lock-keyhole","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbackend-authorization",{"title":245,"id":246,"canonicalKey":247,"locale":8,"draft":6,"navigation":248,"icon":249,"path":250},"Better Auth plugins","content:docs:3.build:3.authentication:7.better-auth-plugins.md","3\u002F3\u002F7",{"icon":249},"i-lucide-plug","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugins",{"title":252,"id":253,"canonicalKey":254,"locale":8,"draft":6,"navigation":255,"icon":256,"path":257},"Custom user fields","content:docs:3.build:3.authentication:8.custom-user-fields.md","3\u002F3\u002F8",{"icon":256},"i-lucide-user-cog","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcustom-user-fields",{"title":259,"id":260,"canonicalKey":261,"locale":8,"draft":6,"navigation":262,"icon":263,"path":264},"User synchronization","content:docs:3.build:3.authentication:9.user-synchronization.md","3\u002F3\u002F9",{"icon":263},"i-lucide-refresh-ccw","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fuser-synchronization",{"title":266,"id":267,"canonicalKey":268,"locale":8,"draft":6,"navigation":269,"icon":270,"path":271},"Delegated OAuth and MCP","content:docs:3.build:3.authentication:10.delegated-oauth-and-mcp.md","3\u002F3\u002F10",{"icon":270},"i-lucide-bot","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fdelegated-oauth-and-mcp",{"title":273,"id":274,"canonicalKey":275,"locale":8,"draft":6,"navigation":276,"icon":277,"path":278},"Transactional auth email","content:docs:3.build:3.authentication:11.transactional-email.md","3\u002F3\u002F11",{"icon":277},"i-lucide-mail","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Ftransactional-email",{"title":280,"id":281,"canonicalKey":282,"locale":8,"draft":6,"navigation":283,"icon":284,"path":285},"Social sign-in","content:docs:3.build:3.authentication:12.social-sign-in.md","3\u002F3\u002F12",{"icon":284},"i-lucide-github","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsocial-sign-in",{"title":287,"id":288,"canonicalKey":289,"locale":8,"draft":6,"navigation":290,"icon":291,"path":292},"Better Auth plugin support","content:docs:3.build:3.authentication:13.better-auth-plugin-support.md","3\u002F3\u002F13",{"icon":291},"i-lucide-puzzle","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugin-support",{"title":294,"id":295,"canonicalKey":296,"locale":8,"draft":6,"navigation":297,"icon":298,"path":299},"Cacheable public pages","content:docs:3.build:3.authentication:14.cacheable-public-pages.md","3\u002F3\u002F14",{"icon":298},"i-lucide-globe","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcacheable-public-pages",{"title":301,"id":302,"canonicalKey":303,"locale":8,"draft":6,"navigation":304,"icon":305,"path":306},"Several sites on one deployment","content:docs:3.build:3.authentication:15.multiple-site-origins.md","3\u002F3\u002F15",{"icon":305},"i-lucide-network","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fmultiple-site-origins",{"title":308,"id":309,"canonicalKey":310,"locale":8,"draft":6,"navigation":311,"icon":312,"path":313},"Account deletion","content:docs:3.build:3.authentication:16.account-deletion.md","3\u002F3\u002F16",{"icon":312},"i-lucide-user-x","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Faccount-deletion",{"title":315,"id":316,"canonicalKey":317,"locale":8,"draft":6,"navigation":318,"icon":319,"path":320},"Company sign-in (OIDC)","content:docs:3.build:3.authentication:17.company-sign-in.md","3\u002F3\u002F17",{"icon":319},"i-lucide-building-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcompany-sign-in",{"title":322,"page":6,"canonicalKey":323,"locale":8,"children":324},"Server","3\u002F4",[325,332,339,346],{"title":326,"id":327,"canonicalKey":328,"locale":8,"draft":6,"navigation":329,"icon":330,"path":331},"serverConvex","content:docs:3.build:4.server:1.server-convex.md","3\u002F4\u002F1",{"icon":330},"i-lucide-server","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-convex",{"title":333,"id":334,"canonicalKey":335,"locale":8,"draft":6,"navigation":336,"icon":337,"path":338},"Server routes","content:docs:3.build:4.server:2.server-routes.md","3\u002F4\u002F2",{"icon":337},"i-lucide-waypoints","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-routes",{"title":340,"id":341,"canonicalKey":342,"locale":8,"draft":6,"navigation":343,"icon":344,"path":345},"Webhooks and jobs","content:docs:3.build:4.server:3.webhooks-and-jobs.md","3\u002F4\u002F3",{"icon":344},"i-lucide-webhook","\u002Fdocs\u002Fbuild\u002Fserver\u002Fwebhooks-and-jobs",{"title":347,"id":348,"canonicalKey":349,"locale":8,"draft":6,"navigation":350,"icon":351,"path":352},"Credentials and server security","content:docs:3.build:4.server:4.credentials-and-security.md","3\u002F4\u002F4",{"icon":351},"i-lucide-key-round","\u002Fdocs\u002Fbuild\u002Fserver\u002Fcredentials-and-security",{"title":354,"page":6,"canonicalKey":355,"locale":8,"children":356},"Files","3\u002F5",[357,364,371,378],{"title":358,"id":359,"canonicalKey":360,"locale":8,"draft":6,"navigation":361,"icon":362,"path":363},"Upload files","content:docs:3.build:5.files:1.upload-files.md","3\u002F5\u002F1",{"icon":362},"i-lucide-upload","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fupload-files",{"title":365,"id":366,"canonicalKey":367,"locale":8,"draft":6,"navigation":368,"icon":369,"path":370},"Storage URLs","content:docs:3.build:5.files:3.storage-urls.md","3\u002F5\u002F3",{"icon":369},"i-lucide-link","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fstorage-urls",{"title":372,"id":373,"canonicalKey":374,"locale":8,"draft":6,"navigation":375,"icon":376,"path":377},"File validation and deletion","content:docs:3.build:5.files:4.validation-and-deletion.md","3\u002F5\u002F4",{"icon":376},"i-lucide-file-x","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fvalidation-and-deletion",{"title":379,"id":380,"canonicalKey":381,"locale":8,"draft":6,"navigation":382,"icon":383,"path":384},"Private downloads","content:docs:3.build:5.files:5.private-downloads.md","3\u002F5\u002F5",{"icon":383},"i-lucide-file-lock","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fprivate-downloads",{"title":386,"page":6,"canonicalKey":387,"locale":8,"children":388},"Application Behavior","3\u002F6",[389,396,403,410,417,424],{"title":390,"id":391,"canonicalKey":392,"locale":8,"draft":6,"navigation":393,"icon":394,"path":395},"Connection state","content:docs:3.build:6.application-behavior:1.connection-state.md","3\u002F6\u002F1",{"icon":394},"i-lucide-wifi","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fconnection-state",{"title":397,"id":398,"canonicalKey":399,"locale":8,"draft":6,"navigation":400,"icon":401,"path":402},"Error handling","content:docs:3.build:6.application-behavior:2.error-handling.md","3\u002F6\u002F2",{"icon":401},"i-lucide-circle-alert","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Ferror-handling",{"title":404,"id":405,"canonicalKey":406,"locale":8,"draft":6,"navigation":407,"icon":408,"path":409},"Logging","content:docs:3.build:6.application-behavior:3.logging.md","3\u002F6\u002F3",{"icon":408},"i-lucide-scroll-text","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Flogging",{"title":411,"id":412,"canonicalKey":413,"locale":8,"draft":6,"navigation":414,"icon":415,"path":416},"DevTools","content:docs:3.build:6.application-behavior:4.devtools.md","3\u002F6\u002F4",{"icon":415},"i-lucide-wrench","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fdevtools",{"title":418,"id":419,"canonicalKey":420,"locale":8,"draft":6,"navigation":421,"icon":422,"path":423},"Performance","content:docs:3.build:6.application-behavior:5.performance.md","3\u002F6\u002F5",{"icon":422},"i-lucide-chart-no-axes-combined","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fperformance",{"title":425,"id":426,"canonicalKey":427,"locale":8,"draft":6,"navigation":428,"icon":429,"path":430},"Start the client on demand","content:docs:3.build:6.application-behavior:6.on-demand-client.md","3\u002F6\u002F6",{"icon":429},"i-lucide-power","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fon-demand-client",{"title":432,"page":6,"canonicalKey":433,"locale":8,"id":434,"draft":6,"icon":270,"children":435},"Agents and MCP","3\u002F7","content:docs:3.build:7.agents:.navigation.yml",[436,442,449,456,463,469,475],{"title":437,"id":438,"canonicalKey":439,"locale":8,"draft":6,"navigation":440,"icon":415,"path":441},"Tools and approvals","content:docs:3.build:7.agents:1.tools-and-approvals.md","3\u002F7\u002F1",{"icon":415},"\u002Fdocs\u002Fbuild\u002Fagents\u002Ftools-and-approvals",{"title":443,"id":444,"canonicalKey":445,"locale":8,"draft":6,"navigation":446,"icon":447,"path":448},"The MCP door","content:docs:3.build:7.agents:2.mcp-door.md","3\u002F7\u002F2",{"icon":447},"i-lucide-door-open","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-door",{"title":450,"id":451,"canonicalKey":452,"locale":8,"draft":6,"navigation":453,"icon":454,"path":455},"Limits","content:docs:3.build:7.agents:3.limits.md","3\u002F7\u002F3",{"icon":454},"i-lucide-traffic-cone","\u002Fdocs\u002Fbuild\u002Fagents\u002Flimits",{"title":457,"id":458,"canonicalKey":459,"locale":8,"draft":6,"navigation":460,"icon":461,"path":462},"MCP on Convex","content:docs:3.build:7.agents:4.mcp.md","3\u002F7\u002F4",{"icon":461},"i-lucide-plug-zap","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp",{"title":464,"id":465,"canonicalKey":466,"locale":8,"draft":6,"navigation":467,"icon":249,"path":468},"Add MCP to your application","content:docs:3.build:7.agents:5.mcp-application.md","3\u002F7\u002F5",{"icon":249},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-application",{"title":470,"id":471,"canonicalKey":472,"locale":8,"draft":6,"navigation":473,"icon":369,"path":474},"Connect ChatGPT and Claude","content:docs:3.build:7.agents:6.connect-chatgpt-and-claude.md","3\u002F7\u002F6",{"icon":369},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fconnect-chatgpt-and-claude",{"title":476,"id":477,"canonicalKey":478,"locale":8,"draft":6,"navigation":479,"icon":108,"path":480},"MCP Apps","content:docs:3.build:7.agents:7.mcp-apps.md","3\u002F7\u002F7",{"icon":108},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-apps",{"title":482,"page":6,"canonicalKey":483,"locale":8,"id":484,"draft":6,"icon":485,"children":486},"Operations and policy","3\u002F8","content:docs:3.build:8.functions:.navigation.yml","i-lucide-shield-half",[487,494,500,507,514,521,527,534],{"title":488,"id":489,"canonicalKey":490,"locale":8,"draft":6,"navigation":491,"icon":492,"path":493},"Start here","content:docs:3.build:8.functions:1.start-here.md","3\u002F8\u002F1",{"icon":492},"i-lucide-flag","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fstart-here",{"title":495,"id":496,"canonicalKey":497,"locale":8,"draft":6,"navigation":498,"icon":39,"path":499},"Policy and roles","content:docs:3.build:8.functions:2.policy-and-roles.md","3\u002F8\u002F2",{"icon":39},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fpolicy-and-roles",{"title":501,"id":502,"canonicalKey":503,"locale":8,"draft":6,"navigation":504,"icon":505,"path":506},"Row rules","content:docs:3.build:8.functions:3.row-rules.md","3\u002F8\u002F3",{"icon":505},"i-lucide-rows-3","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Frow-rules",{"title":508,"id":509,"canonicalKey":510,"locale":8,"draft":6,"navigation":511,"icon":512,"path":513},"Internal operations","content:docs:3.build:8.functions:4.internal-operations.md","3\u002F8\u002F4",{"icon":512},"i-lucide-workflow","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Finternal-operations",{"title":515,"id":516,"canonicalKey":517,"locale":8,"draft":6,"navigation":518,"icon":519,"path":520},"Test your app","content:docs:3.build:8.functions:5.testing.md","3\u002F8\u002F5",{"icon":519},"i-lucide-flask-conical","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Ftesting",{"title":522,"id":523,"canonicalKey":524,"locale":8,"draft":6,"navigation":525,"icon":177,"path":526},"Cost","content:docs:3.build:8.functions:6.cost.md","3\u002F8\u002F6",{"icon":177},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fcost",{"title":528,"id":529,"canonicalKey":530,"locale":8,"draft":6,"navigation":531,"icon":532,"path":533},"Threat model","content:docs:3.build:8.functions:7.threat-model.md","3\u002F8\u002F7",{"icon":532},"i-lucide-shield-alert","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fthreat-model",{"title":535,"id":536,"canonicalKey":537,"locale":8,"draft":6,"navigation":538,"icon":408,"path":539},"Rate limits, audit log and call events","content:docs:3.build:8.functions:8.limits-and-audit.md","3\u002F8\u002F8",{"icon":408},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit",{"title":541,"page":6,"canonicalKey":542,"locale":8,"id":543,"draft":6,"icon":544,"children":545},"Recipes","4","content:docs:4.recipes:.navigation.yml","i-lucide-cooking-pot",[546,553,560,567,574,581,587,593,599,605,612,619,626,633,638],{"title":547,"id":548,"canonicalKey":549,"locale":8,"draft":6,"navigation":550,"icon":551,"path":552},"Protected dashboard","content:docs:4.recipes:1.protected-dashboard.md","4\u002F1",{"icon":551},"i-lucide-layout-dashboard","\u002Fdocs\u002Frecipes\u002Fprotected-dashboard",{"title":554,"id":555,"canonicalKey":556,"locale":8,"draft":6,"navigation":557,"icon":558,"path":559},"Real-time feed","content:docs:4.recipes:2.realtime-feed.md","4\u002F2",{"icon":558},"i-lucide-messages-square","\u002Fdocs\u002Frecipes\u002Frealtime-feed",{"title":561,"id":562,"canonicalKey":563,"locale":8,"draft":6,"navigation":564,"icon":565,"path":566},"Optimistic todo list","content:docs:4.recipes:3.optimistic-todo-list.md","4\u002F3",{"icon":565},"i-lucide-list-todo","\u002Fdocs\u002Frecipes\u002Foptimistic-todo-list",{"title":568,"id":569,"canonicalKey":570,"locale":8,"draft":6,"navigation":571,"icon":572,"path":573},"Infinite scroll","content:docs:4.recipes:4.infinite-scroll.md","4\u002F4",{"icon":572},"i-lucide-mouse","\u002Fdocs\u002Frecipes\u002Finfinite-scroll",{"title":575,"id":576,"canonicalKey":577,"locale":8,"draft":6,"navigation":578,"icon":579,"path":580},"File upload form","content:docs:4.recipes:5.file-upload-form.md","4\u002F5",{"icon":579},"i-lucide-file-up","\u002Fdocs\u002Frecipes\u002Ffile-upload-form",{"title":582,"id":583,"canonicalKey":584,"locale":8,"draft":6,"navigation":585,"icon":319,"path":586},"Organization permissions","content:docs:4.recipes:6.organization-permissions.md","4\u002F6",{"icon":319},"\u002Fdocs\u002Frecipes\u002Forganization-permissions",{"title":588,"id":589,"canonicalKey":590,"locale":8,"draft":6,"navigation":591,"icon":330,"path":592},"Authenticated server route","content:docs:4.recipes:7.authenticated-server-route.md","4\u002F7",{"icon":330},"\u002Fdocs\u002Frecipes\u002Fauthenticated-server-route",{"title":594,"id":595,"canonicalKey":596,"locale":8,"draft":6,"navigation":597,"icon":108,"path":598},"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":600,"id":601,"canonicalKey":602,"locale":8,"draft":6,"navigation":603,"icon":519,"path":604},"Test signed-in screens","content:docs:4.recipes:9.component-testing.md","4\u002F9",{"icon":519},"\u002Fdocs\u002Frecipes\u002Fcomponent-testing",{"title":606,"id":607,"canonicalKey":608,"locale":8,"draft":6,"navigation":609,"icon":610,"path":611},"Time-based data","content:docs:4.recipes:10.time-based-data.md","4\u002F10",{"icon":610},"i-lucide-clock","\u002Fdocs\u002Frecipes\u002Ftime-based-data",{"title":613,"id":614,"canonicalKey":615,"locale":8,"draft":6,"navigation":616,"icon":617,"path":618},"A list of queries","content:docs:4.recipes:11.dynamic-query-list.md","4\u002F11",{"icon":617},"i-lucide-list-tree","\u002Fdocs\u002Frecipes\u002Fdynamic-query-list",{"title":620,"id":621,"canonicalKey":622,"locale":8,"draft":6,"navigation":623,"icon":624,"path":625},"Error messages","content:docs:4.recipes:12.error-messages.md","4\u002F12",{"icon":624},"i-lucide-message-circle-warning","\u002Fdocs\u002Frecipes\u002Ferror-messages",{"title":627,"id":628,"canonicalKey":629,"locale":8,"draft":6,"navigation":630,"icon":631,"path":632},"Several file uploads","content:docs:4.recipes:13.multiple-file-uploads.md","4\u002F13",{"icon":631},"i-lucide-files","\u002Fdocs\u002Frecipes\u002Fmultiple-file-uploads",{"title":634,"id":635,"canonicalKey":636,"locale":8,"draft":6,"path":637},"Guest users","content:docs:4.recipes:15.guest-users.md","4\u002F15","\u002Fdocs\u002Frecipes\u002Fguest-users",{"title":639,"id":640,"canonicalKey":641,"locale":8,"draft":6,"path":642},"Sign-in link","content:docs:4.recipes:16.sign-in-link.md","4\u002F16","\u002Fdocs\u002Frecipes\u002Fsign-in-link",{"title":644,"page":6,"canonicalKey":645,"locale":8,"id":646,"draft":6,"icon":647,"children":648},"Concepts","5","content:docs:5.concepts:.navigation.yml","i-lucide-brain",[649,655,661,668,674,681,687,694,701],{"title":650,"id":651,"canonicalKey":652,"locale":8,"draft":6,"navigation":653,"icon":647,"path":654},"Mental model","content:docs:5.concepts:1.mental-model.md","5\u002F1",{"icon":647},"\u002Fdocs\u002Fconcepts\u002Fmental-model",{"title":656,"id":657,"canonicalKey":658,"locale":8,"draft":6,"navigation":659,"icon":235,"path":660},"Request lifecycle","content:docs:5.concepts:2.request-lifecycle.md","5\u002F2",{"icon":235},"\u002Fdocs\u002Fconcepts\u002Frequest-lifecycle",{"title":662,"id":663,"canonicalKey":664,"locale":8,"draft":6,"navigation":665,"icon":666,"path":667},"SSR, hydration, and real-time","content:docs:5.concepts:3.ssr-hydration-realtime.md","5\u002F3",{"icon":666},"i-lucide-refresh-cw","\u002Fdocs\u002Fconcepts\u002Fssr-hydration-realtime",{"title":669,"id":670,"canonicalKey":671,"locale":8,"draft":6,"navigation":672,"icon":124,"path":673},"Query state and caching","content:docs:5.concepts:4.query-ownership-and-caching.md","5\u002F4",{"icon":124},"\u002Fdocs\u002Fconcepts\u002Fquery-ownership-and-caching",{"title":675,"id":676,"canonicalKey":677,"locale":8,"draft":6,"navigation":678,"icon":679,"path":680},"Authentication and identity","content:docs:5.concepts:5.authentication-and-identity.md","5\u002F5",{"icon":679},"i-lucide-fingerprint","\u002Fdocs\u002Fconcepts\u002Fauthentication-and-identity",{"title":682,"id":683,"canonicalKey":684,"locale":8,"draft":6,"navigation":685,"icon":108,"path":686},"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":688,"id":689,"canonicalKey":690,"locale":8,"draft":6,"navigation":691,"icon":692,"path":693},"Errors and failures","content:docs:5.concepts:7.errors-and-failures.md","5\u002F7",{"icon":692},"i-lucide-circle-x","\u002Fdocs\u002Fconcepts\u002Ferrors-and-failures",{"title":695,"id":696,"canonicalKey":697,"locale":8,"draft":6,"navigation":698,"icon":699,"path":700},"Design decisions","content:docs:5.concepts:8.design-decisions.md","5\u002F8",{"icon":699},"i-lucide-git-branch","\u002Fdocs\u002Fconcepts\u002Fdesign-decisions",{"title":702,"id":703,"canonicalKey":704,"locale":8,"draft":6,"navigation":705,"icon":706,"path":707},"Glossary","content:docs:5.concepts:9.glossary.md","5\u002F9",{"icon":706},"i-lucide-book-a","\u002Fdocs\u002Fconcepts\u002Fglossary",{"title":709,"page":6,"canonicalKey":710,"locale":8,"id":711,"draft":6,"icon":215,"children":712},"Operations","6","content:docs:6.operations:.navigation.yml",[713,719,726,733,739,746,752,759,765],{"title":714,"id":715,"canonicalKey":716,"locale":8,"draft":6,"navigation":717,"icon":45,"path":718},"Deployment","content:docs:6.operations:1.deployment.md","6\u002F1",{"icon":45},"\u002Fdocs\u002Foperations\u002Fdeployment",{"title":720,"id":721,"canonicalKey":722,"locale":8,"draft":6,"navigation":723,"icon":724,"path":725},"Environment variables","content:docs:6.operations:2.environment-variables.md","6\u002F2",{"icon":724},"i-lucide-variable","\u002Fdocs\u002Foperations\u002Fenvironment-variables",{"title":727,"id":728,"canonicalKey":729,"locale":8,"draft":6,"navigation":730,"icon":731,"path":732},"Deploy to Vercel","content:docs:6.operations:3.deploy-to-vercel.md","6\u002F3",{"icon":731},"i-lucide-triangle","\u002Fdocs\u002Foperations\u002Fdeploy-to-vercel",{"title":734,"id":735,"canonicalKey":736,"locale":8,"draft":6,"navigation":737,"icon":415,"path":738},"Troubleshooting","content:docs:6.operations:4.troubleshooting.md","6\u002F4",{"icon":415},"\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":740,"id":741,"canonicalKey":742,"locale":8,"draft":6,"navigation":743,"icon":744,"path":745},"Release compatibility","content:docs:6.operations:5.release-compatibility.md","6\u002F5",{"icon":744},"i-lucide-badge-check","\u002Fdocs\u002Foperations\u002Frelease-compatibility",{"title":747,"id":748,"canonicalKey":749,"locale":8,"draft":6,"navigation":750,"icon":87,"path":751},"Security model","content:docs:6.operations:6.security-model.md","6\u002F6",{"icon":87},"\u002Fdocs\u002Foperations\u002Fsecurity-model",{"title":753,"id":754,"canonicalKey":755,"locale":8,"draft":6,"navigation":756,"icon":757,"path":758},"Upgrade to 1.0","content:docs:6.operations:7.upgrade-to-1-0.md","6\u002F7",{"icon":757},"i-lucide-arrow-up-circle","\u002Fdocs\u002Foperations\u002Fupgrade-to-1-0",{"title":760,"id":761,"canonicalKey":762,"locale":8,"draft":6,"navigation":763,"icon":45,"path":764},"Before your app goes live","content:docs:6.operations:8.before-launch.md","6\u002F8",{"icon":45},"\u002Fdocs\u002Foperations\u002Fbefore-launch",{"title":766,"id":767,"canonicalKey":768,"locale":8,"draft":6,"navigation":769,"icon":770,"path":771},"Log streams and PostHog","content:docs:6.operations:9.log-streams.md","6\u002F9",{"icon":770},"i-lucide-activity","\u002Fdocs\u002Foperations\u002Flog-streams",{"title":773,"page":6,"canonicalKey":774,"locale":8,"id":775,"draft":6,"icon":776,"children":777},"Reference","7","content:docs:7.reference:.navigation.yml","i-lucide-braces",[778,784,790,796,803,810,817,823,830],{"title":779,"id":780,"canonicalKey":781,"locale":8,"draft":6,"navigation":782,"icon":776,"path":783},"Composables","content:docs:7.reference:1.composables.md","7\u002F1",{"icon":776},"\u002Fdocs\u002Freference\u002Fcomposables",{"title":785,"id":786,"canonicalKey":787,"locale":8,"draft":6,"navigation":788,"icon":330,"path":789},"Server API","content:docs:7.reference:3.server-api.md","7\u002F3",{"icon":330},"\u002Fdocs\u002Freference\u002Fserver-api",{"title":791,"id":792,"canonicalKey":793,"locale":8,"draft":6,"navigation":794,"icon":692,"path":795},"Error types","content:docs:7.reference:4.error-types.md","7\u002F4",{"icon":692},"\u002Fdocs\u002Freference\u002Ferror-types",{"title":797,"id":798,"canonicalKey":799,"locale":8,"draft":6,"navigation":800,"icon":801,"path":802},"Module configuration","content:docs:7.reference:5.module-configuration.md","7\u002F5",{"icon":801},"i-lucide-settings","\u002Fdocs\u002Freference\u002Fmodule-configuration",{"title":804,"id":805,"canonicalKey":806,"locale":8,"draft":6,"navigation":807,"icon":808,"path":809},"Package exports","content:docs:7.reference:6.package-exports.md","7\u002F6",{"icon":808},"i-lucide-package-open","\u002Fdocs\u002Freference\u002Fpackage-exports",{"title":811,"id":812,"canonicalKey":813,"locale":8,"draft":6,"navigation":814,"icon":815,"path":816},"API reference","content:docs:7.reference:7.api-surface.md","7\u002F7",{"icon":815},"i-lucide-list","\u002Fdocs\u002Freference\u002Fapi-surface",{"title":818,"id":819,"canonicalKey":820,"locale":8,"draft":6,"navigation":821,"icon":519,"path":822},"Experimental APIs","content:docs:7.reference:8.experimental.md","7\u002F8",{"icon":519},"\u002Fdocs\u002Freference\u002Fexperimental",{"title":824,"id":825,"canonicalKey":826,"locale":8,"draft":6,"navigation":827,"icon":828,"path":829},"Command line","content:docs:7.reference:9.cli.md","7\u002F9",{"icon":828},"i-lucide-terminal","\u002Fdocs\u002Freference\u002Fcli",{"title":831,"id":832,"canonicalKey":833,"locale":8,"draft":6,"navigation":834,"icon":835,"path":836},"Operation error codes","content:docs:7.reference:10.operation-error-codes.md","7\u002F10",{"icon":835},"i-lucide-octagon-alert","\u002Fdocs\u002Freference\u002Foperation-error-codes",{"title":838,"id":839,"canonicalKey":840,"locale":8,"draft":6,"path":841},"Better Convex documentation","content:docs:index.md","\u002F","\u002Fdocs",{"title":528,"description":843,"navigation":844,"body":845,"type":1569,"id":529,"canonicalKey":530,"draft":6,"partial":6,"locale":8,"collection":1570,"navigationFile":6,"file":1571,"route":1577,"resolution":1579},"What the policy, the row rules and the agent checks protect against, what they do not, and which parts you must review yourself.",{"icon":532},{"type":846,"children":847,"toc":1559},"root",[848,871,878,1146,1159,1165,1191,1208,1214,1366,1372,1377,1382,1460,1466,1471],{"type":849,"tag":850,"props":851,"children":852},"element","p",{},[853,856,862,864,869],{"type":854,"value":855},"text","The two packages protect against ",{"type":849,"tag":857,"props":858,"children":859},"strong",{},[860],{"type":854,"value":861},"mistakes in your application code",{"type":854,"value":863}," and\nagainst ",{"type":849,"tag":857,"props":865,"children":866},{},[867],{"type":854,"value":868},"agents",{"type":854,"value":870}," that do more than a person allowed. They do not protect\nagainst application code written on purpose to get around them.",{"type":849,"tag":872,"props":873,"children":875},"h2",{"id":874},"what-is-protected",[876],{"type":854,"value":877},"What is protected",{"type":849,"tag":879,"props":880,"children":881},"table",{},[882,901],{"type":849,"tag":883,"props":884,"children":885},"thead",{},[886],{"type":849,"tag":887,"props":888,"children":889},"tr",{},[890,896],{"type":849,"tag":891,"props":892,"children":893},"th",{},[894],{"type":854,"value":895},"Risk",{"type":849,"tag":891,"props":897,"children":898},{},[899],{"type":854,"value":900},"What stops it",{"type":849,"tag":902,"props":903,"children":904},"tbody",{},[905,919,932,951,969,982,995,1008,1028,1041,1064,1082,1102,1120,1133],{"type":849,"tag":887,"props":906,"children":907},{},[908,914],{"type":849,"tag":909,"props":910,"children":911},"td",{},[912],{"type":854,"value":913},"A query forgets a tenant filter and returns another organization's rows",{"type":849,"tag":909,"props":915,"children":916},{},[917],{"type":854,"value":918},"Row rules check every row a handler reads. The query fails instead of returning the row",{"type":849,"tag":887,"props":920,"children":921},{},[922,927],{"type":849,"tag":909,"props":923,"children":924},{},[925],{"type":854,"value":926},"A caller sends the ID of another tenant's row",{"type":849,"tag":909,"props":928,"children":929},{},[930],{"type":854,"value":931},"The tenant comes from the row, not from the caller. A tenant without a role does not exist for the caller",{"type":849,"tag":887,"props":933,"children":934},{},[935,940],{"type":849,"tag":909,"props":936,"children":937},{},[938],{"type":854,"value":939},"A handler writes a row the caller may only read",{"type":849,"tag":909,"props":941,"children":942},{},[943,945],{"type":854,"value":944},"The write fails with ",{"type":849,"tag":946,"props":947,"children":948},"code",{},[949],{"type":854,"value":950},"FORBIDDEN",{"type":849,"tag":887,"props":952,"children":953},{},[954,959],{"type":849,"tag":909,"props":955,"children":956},{},[957],{"type":854,"value":958},"A new Convex query method hands out rows without a check",{"type":849,"tag":909,"props":960,"children":961},{},[962,967],{"type":849,"tag":946,"props":963,"children":964},{},[965],{"type":854,"value":966},"ctx.db",{"type":854,"value":968}," has only the methods the library checks. Others fail",{"type":849,"tag":887,"props":970,"children":971},{},[972,977],{"type":849,"tag":909,"props":973,"children":974},{},[975],{"type":854,"value":976},"A function is built with Convex's own builders and skips every check",{"type":849,"tag":909,"props":978,"children":979},{},[980],{"type":854,"value":981},"The no-bypass test fails. An operation that calls such a function fails and keeps nothing",{"type":849,"tag":887,"props":983,"children":984},{},[985,990],{"type":849,"tag":909,"props":986,"children":987},{},[988],{"type":854,"value":989},"Scheduled work runs after the person lost access",{"type":849,"tag":909,"props":991,"children":992},{},[993],{"type":854,"value":994},"Each internal operation checks the caller, the role and the rows again",{"type":849,"tag":887,"props":996,"children":997},{},[998,1003],{"type":849,"tag":909,"props":999,"children":1000},{},[1001],{"type":854,"value":1002},"An agent calls a tool outside the scopes the person granted",{"type":849,"tag":909,"props":1004,"children":1005},{},[1006],{"type":854,"value":1007},"The host does not see the tool, and the call fails",{"type":849,"tag":887,"props":1009,"children":1010},{},[1011,1016],{"type":849,"tag":909,"props":1012,"children":1013},{},[1014],{"type":854,"value":1015},"An agent archives, publishes or deletes without asking",{"type":849,"tag":909,"props":1017,"children":1018},{},[1019,1021,1026],{"type":854,"value":1020},"Actions with ",{"type":849,"tag":946,"props":1022,"children":1023},{},[1024],{"type":854,"value":1025},"agents: { action: 'approve' }",{"type":854,"value":1027}," wait for a person",{"type":849,"tag":887,"props":1029,"children":1030},{},[1031,1036],{"type":849,"tag":909,"props":1032,"children":1033},{},[1034],{"type":854,"value":1035},"A write action gets no agent rule and an agent runs it on its own",{"type":849,"tag":909,"props":1037,"children":1038},{},[1039],{"type":854,"value":1040},"A call that changes data and has no agent rule waits for a person",{"type":849,"tag":887,"props":1042,"children":1043},{},[1044,1049],{"type":849,"tag":909,"props":1045,"children":1046},{},[1047],{"type":854,"value":1048},"A person cancels a job that someone else scheduled",{"type":849,"tag":909,"props":1050,"children":1051},{},[1052,1057,1059],{"type":849,"tag":946,"props":1053,"children":1054},{},[1055],{"type":854,"value":1056},"ctx.scheduler.cancel",{"type":854,"value":1058}," cancels only the caller's own jobs. Another job fails with ",{"type":849,"tag":946,"props":1060,"children":1061},{},[1062],{"type":854,"value":1063},"NOT_FOUND",{"type":849,"tag":887,"props":1065,"children":1066},{},[1067,1072],{"type":849,"tag":909,"props":1068,"children":1069},{},[1070],{"type":854,"value":1071},"A person approves something that changed since the agent asked",{"type":849,"tag":909,"props":1073,"children":1074},{},[1075,1077],{"type":854,"value":1076},"Approving fails with ",{"type":849,"tag":946,"props":1078,"children":1079},{},[1080],{"type":854,"value":1081},"STALE",{"type":849,"tag":887,"props":1083,"children":1084},{},[1085,1090],{"type":849,"tag":909,"props":1086,"children":1087},{},[1088],{"type":854,"value":1089},"A host retries a write",{"type":849,"tag":909,"props":1091,"children":1092},{},[1093,1095,1100],{"type":854,"value":1094},"The same ",{"type":849,"tag":946,"props":1096,"children":1097},{},[1098],{"type":854,"value":1099},"request_id",{"type":854,"value":1101}," runs once",{"type":849,"tag":887,"props":1103,"children":1104},{},[1105,1110],{"type":849,"tag":909,"props":1106,"children":1107},{},[1108],{"type":854,"value":1109},"An agent floods the application",{"type":849,"tag":909,"props":1111,"children":1112},{},[1113,1115],{"type":854,"value":1114},"Writes per minute, open requests and IDs per call have limits. See ",{"type":849,"tag":1116,"props":1117,"children":1118},"a",{"href":455},[1119],{"type":854,"value":450},{"type":849,"tag":887,"props":1121,"children":1122},{},[1123,1128],{"type":849,"tag":909,"props":1124,"children":1125},{},[1126],{"type":854,"value":1127},"Text from a row shows up as a link or HTML in an approval or a host",{"type":849,"tag":909,"props":1129,"children":1130},{},[1131],{"type":854,"value":1132},"Summaries are one plain line for people, and inert markdown for agents",{"type":849,"tag":887,"props":1134,"children":1135},{},[1136,1141],{"type":849,"tag":909,"props":1137,"children":1138},{},[1139],{"type":854,"value":1140},"A person disconnects a host, signs out, or loses a membership",{"type":849,"tag":909,"props":1142,"children":1143},{},[1144],{"type":854,"value":1145},"The next call of that agent fails",{"type":849,"tag":850,"props":1147,"children":1148},{},[1149,1151,1157],{"type":854,"value":1150},"Scheduled work stops once the person or agent that scheduled it loses access,\nso cleanup scheduled as them stops too. Give a status that must change soon a\n",{"type":849,"tag":1116,"props":1152,"children":1154},{"href":1153},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Finternal-operations#keep-short-lived-statuses-correct",[1155],{"type":854,"value":1156},"path of its own",{"type":854,"value":1158},".",{"type":849,"tag":872,"props":1160,"children":1162},{"id":1161},"the-guarantee-is-a-test",[1163],{"type":854,"value":1164},"The guarantee is a test",{"type":849,"tag":850,"props":1166,"children":1167},{},[1168,1170,1175,1177,1182,1184,1189],{"type":854,"value":1169},"Convex cannot inspect a function before it runs. So the rule that every\nfunction goes through ",{"type":849,"tag":946,"props":1171,"children":1172},{},[1173],{"type":854,"value":1174},"defineFunctions",{"type":854,"value":1176}," is kept by a test, not at runtime:\n",{"type":849,"tag":946,"props":1178,"children":1179},{},[1180],{"type":854,"value":1181},"unguardedFunctions",{"type":854,"value":1183}," in ",{"type":849,"tag":1116,"props":1185,"children":1187},{"href":1186},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Ftesting#no-raw-functions",[1188],{"type":854,"value":515},{"type":854,"value":1190},".\nRun it in CI. The runtime checks (the argument shape, the result envelope,\nthe rollback) are the second line.",{"type":849,"tag":850,"props":1192,"children":1193},{},[1194,1196,1200,1202,1206],{"type":854,"value":1195},"A scheduled raw function runs later on its own, with no operation around it to\nfail, so the ",{"type":849,"tag":946,"props":1197,"children":1198},{},[1199],{"type":854,"value":1181},{"type":854,"value":1201}," test in\n",{"type":849,"tag":1116,"props":1203,"children":1204},{"href":1186},[1205],{"type":854,"value":515},{"type":854,"value":1207}," is what catches it.",{"type":849,"tag":872,"props":1209,"children":1211},{"id":1210},"what-is-not-protected",[1212],{"type":854,"value":1213},"What is not protected",{"type":849,"tag":1215,"props":1216,"children":1217},"ul",{},[1218,1236,1273,1324,1334,1356],{"type":849,"tag":1219,"props":1220,"children":1221},"li",{},[1222,1227,1229,1234],{"type":849,"tag":857,"props":1223,"children":1224},{},[1225],{"type":854,"value":1226},"Code that is written to get around the library.",{"type":854,"value":1228}," A handler can import\nConvex's raw builders, call ",{"type":849,"tag":946,"props":1230,"children":1231},{},[1232],{"type":854,"value":1233},"trusted",{"type":854,"value":1235},", or use a job's database without rules.\nThe packages make this visible in review; they do not prevent it.",{"type":849,"tag":1219,"props":1237,"children":1238},{},[1239,1244,1246,1251,1253,1258,1260,1264,1266,1271],{"type":849,"tag":857,"props":1240,"children":1241},{},[1242],{"type":854,"value":1243},"Your own rules.",{"type":854,"value":1245}," ",{"type":849,"tag":946,"props":1247,"children":1248},{},[1249],{"type":854,"value":1250},"user",{"type":854,"value":1252},", ",{"type":849,"tag":946,"props":1254,"children":1255},{},[1256],{"type":854,"value":1257},"roleOf",{"type":854,"value":1259},", the row rules and the policy are the\nsource of truth. A ",{"type":849,"tag":946,"props":1261,"children":1262},{},[1263],{"type":854,"value":1257},{"type":854,"value":1265}," that returns ",{"type":849,"tag":946,"props":1267,"children":1268},{},[1269],{"type":854,"value":1270},"'owner'",{"type":854,"value":1272}," for everyone gives\neveryone every action.",{"type":849,"tag":1219,"props":1274,"children":1275},{},[1276,1281,1282,1287,1289,1294,1296,1301,1303,1307,1309,1314,1316,1322],{"type":849,"tag":857,"props":1277,"children":1278},{},[1279],{"type":854,"value":1280},"Files.",{"type":854,"value":1245},{"type":849,"tag":946,"props":1283,"children":1284},{},[1285],{"type":854,"value":1286},"ctx.storage",{"type":854,"value":1288}," is Convex's own. Row rules do not cover files, and\na storage ID gives whoever holds it the file: ",{"type":849,"tag":946,"props":1290,"children":1291},{},[1292],{"type":854,"value":1293},"getUrl",{"type":854,"value":1295}," hands it out and\n",{"type":849,"tag":946,"props":1297,"children":1298},{},[1299],{"type":854,"value":1300},"delete",{"type":854,"value":1302}," removes it. Take a storage ID from a row the call read through\n",{"type":849,"tag":946,"props":1304,"children":1305},{},[1306],{"type":854,"value":966},{"type":854,"value":1308},", never from the input, except to attach a file the caller just\nuploaded. Even then, a caller can attach the storage ID of someone else's\nfile to their own row, so treat storage IDs as secrets and never show one\nto a person who may not have the file. For a file from an agent, take an\nupload ID instead and call ",{"type":849,"tag":946,"props":1310,"children":1311},{},[1312],{"type":854,"value":1313},"claimUpload",{"type":854,"value":1315},": it checks that the caller sent\nthe file (see ",{"type":849,"tag":1116,"props":1317,"children":1319},{"href":1318},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-door#files-from-agents",[1320],{"type":854,"value":1321},"Files from agents",{"type":854,"value":1323},").",{"type":849,"tag":1219,"props":1325,"children":1326},{},[1327,1332],{"type":849,"tag":857,"props":1328,"children":1329},{},[1330],{"type":854,"value":1331},"Effects outside the database.",{"type":854,"value":1333}," An action has no transaction. A message\nsent or a payment made before a later step fails stays done.",{"type":849,"tag":1219,"props":1335,"children":1336},{},[1337,1342,1344,1349,1351,1355],{"type":849,"tag":857,"props":1338,"children":1339},{},[1340],{"type":854,"value":1341},"The auth component.",{"type":854,"value":1343}," Sessions, OAuth tokens and consent are checked by\nBetter Auth through ",{"type":849,"tag":946,"props":1345,"children":1346},{},[1347],{"type":854,"value":1348},"createBetterConvexAuth",{"type":854,"value":1350},". See\n",{"type":849,"tag":1116,"props":1352,"children":1353},{"href":751},[1354],{"type":854,"value":747},{"type":854,"value":1158},{"type":849,"tag":1219,"props":1357,"children":1358},{},[1359,1364],{"type":849,"tag":857,"props":1360,"children":1361},{},[1362],{"type":854,"value":1363},"What a model does with text.",{"type":854,"value":1365}," See the next section.",{"type":849,"tag":872,"props":1367,"children":1369},{"id":1368},"prompt-injection",[1370],{"type":854,"value":1371},"Prompt injection",{"type":849,"tag":850,"props":1373,"children":1374},{},[1375],{"type":854,"value":1376},"A tool result can contain text that someone else wrote: a crawled page, a\ncustomer's message, the name of a project. A model can read instructions in\nthat text and follow them. Escaping does not stop this. Inert markdown stops a\nlink from rendering; it does not stop a model from obeying the words.",{"type":849,"tag":850,"props":1378,"children":1379},{},[1380],{"type":854,"value":1381},"Plan for an agent that follows instructions from data:",{"type":849,"tag":1215,"props":1383,"children":1384},{},[1385,1395,1419,1429],{"type":849,"tag":1219,"props":1386,"children":1387},{},[1388,1393],{"type":849,"tag":857,"props":1389,"children":1390},{},[1391],{"type":854,"value":1392},"Grant narrow scopes.",{"type":854,"value":1394}," A host that only needs to read gets only read\nscopes. It does not see the write tools.",{"type":849,"tag":1219,"props":1396,"children":1397},{},[1398,1410,1412,1417],{"type":849,"tag":857,"props":1399,"children":1400},{},[1401,1403,1408],{"type":854,"value":1402},"Use ",{"type":849,"tag":946,"props":1404,"children":1405},{},[1406],{"type":854,"value":1407},"approve",{"type":854,"value":1409}," for every destructive action:",{"type":854,"value":1411}," delete, archive, publish,\nsend, pay, invite, or change a role. The person approves the plan your\n",{"type":849,"tag":946,"props":1413,"children":1414},{},[1415],{"type":854,"value":1416},"plan",{"type":854,"value":1418}," function builds, and the work changes only the rows it lists. The\nagent supplies data, never code: the limit is there for mistakes in your\nhandlers, and calls to components stay your code's responsibility.",{"type":849,"tag":1219,"props":1420,"children":1421},{},[1422,1427],{"type":849,"tag":857,"props":1423,"children":1424},{},[1425],{"type":854,"value":1426},"Keep the limits on.",{"type":854,"value":1428}," They bound what one connection can do in a minute.",{"type":849,"tag":1219,"props":1430,"children":1431},{},[1432,1437,1439,1444,1446,1451,1453,1458],{"type":849,"tag":857,"props":1433,"children":1434},{},[1435],{"type":854,"value":1436},"Read the activity feed.",{"type":854,"value":1438}," Every agent write of a call with a tenant is in\nthat tenant's feed, with the tool, the person and who approved it. A call\nwithout a tenant of its own is in no tenant's feed, only in the feed of the\nperson the agent acts for (",{"type":849,"tag":946,"props":1440,"children":1441},{},[1442],{"type":854,"value":1443},"activity({})",{"type":854,"value":1445},"): ",{"type":849,"tag":946,"props":1447,"children":1448},{},[1449],{"type":854,"value":1450},"crossTenant",{"type":854,"value":1452}," operations, and\ncalls whose input names only rows of ",{"type":849,"tag":946,"props":1454,"children":1455},{},[1456],{"type":854,"value":1457},"anyOf",{"type":854,"value":1459}," tables, such as a shared note.",{"type":849,"tag":872,"props":1461,"children":1463},{"id":1462},"review-these-by-hand",[1464],{"type":854,"value":1465},"Review these by hand",{"type":849,"tag":850,"props":1467,"children":1468},{},[1469],{"type":854,"value":1470},"Search the code for each one and check the reason:",{"type":849,"tag":1215,"props":1472,"children":1473},{},[1474,1491,1501,1511,1521,1538,1547],{"type":849,"tag":1219,"props":1475,"children":1476},{},[1477,1482,1484,1489],{"type":849,"tag":946,"props":1478,"children":1479},{},[1480],{"type":854,"value":1481},"trusted(",{"type":854,"value":1483}," and ",{"type":849,"tag":946,"props":1485,"children":1486},{},[1487],{"type":854,"value":1488},"trustedRoutes",{"type":854,"value":1490},": functions and routes without the library.",{"type":849,"tag":1219,"props":1492,"children":1493},{},[1494,1499],{"type":849,"tag":946,"props":1495,"children":1496},{},[1497],{"type":854,"value":1498},"unchecked(",{"type":854,"value":1500},": tables without a row check.",{"type":849,"tag":1219,"props":1502,"children":1503},{},[1504,1509],{"type":849,"tag":946,"props":1505,"children":1506},{},[1507],{"type":854,"value":1508},"job(",{"type":854,"value":1510},": code that runs as the system, with every tenant's rows.",{"type":849,"tag":1219,"props":1512,"children":1513},{},[1514,1519],{"type":849,"tag":946,"props":1515,"children":1516},{},[1517],{"type":854,"value":1518},"public",{"type":854,"value":1520}," in the policy: actions for signed-out visitors.",{"type":849,"tag":1219,"props":1522,"children":1523},{},[1524,1529,1531,1537],{"type":849,"tag":946,"props":1525,"children":1526},{},[1527],{"type":854,"value":1528},"crossTenant: true",{"type":854,"value":1530},": operations that move rows between tenants. Their agent\nwrites are in no tenant's activity feed, and none of their writes are in a\ntenant's audit trail. See\n",{"type":849,"tag":1116,"props":1532,"children":1534},{"href":1533},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit#audit-log",[1535],{"type":854,"value":1536},"Audit log",{"type":854,"value":1158},{"type":849,"tag":1219,"props":1539,"children":1540},{},[1541,1545],{"type":849,"tag":946,"props":1542,"children":1543},{},[1544],{"type":854,"value":1286},{"type":854,"value":1546},": every storage ID must come from a row the call read.",{"type":849,"tag":1219,"props":1548,"children":1549},{},[1550,1552,1557],{"type":854,"value":1551},"Agent rules set to ",{"type":849,"tag":946,"props":1553,"children":1554},{},[1555],{"type":854,"value":1556},"'allow'",{"type":854,"value":1558}," for actions that change data.",{"title":1560,"searchDepth":1561,"depth":1561,"links":1562},"",4,[1563,1565,1566,1567,1568],{"id":874,"depth":1564,"text":877},2,{"id":1161,"depth":1564,"text":1164},{"id":1210,"depth":1564,"text":1213},{"id":1368,"depth":1564,"text":1371},{"id":1462,"depth":1564,"text":1465},"markdown","docs",{"source":1572,"path":1573,"stem":1574,"dir":1575,"extension":1576},"content","docs\u002F3.build\u002F8.functions\u002F7.threat-model.md","docs\u002F3.build\u002F8.functions\u002F7.threat-model","functions","md",{"requestedPath":533,"resolvedPath":533,"alternates":1578},[],{"requested":1580,"resolved":1581,"usedFallback":6},{},{"locale":8},{"previous":1583,"next":1585},{"title":522,"id":523,"canonicalKey":524,"locale":8,"draft":6,"navigation":1584,"icon":177,"path":526},{"icon":177},{"title":535,"id":536,"canonicalKey":537,"locale":8,"draft":6,"navigation":1586,"icon":408,"path":539},{"icon":408},1794905511084]