[{"data":1,"prerenderedAt":1842},["ShallowReactive",2],{"navigation_docs":3,"-modules-features-forms-server":587,"-modules-features-forms-server-surround":1837},[4,50,155,441,504],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":49},"Get Started","i-lucide-rocket","\u002Fget-started","1.get-started",[10,15,20,25,30,35,40,45],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fget-started\u002Fintroduction","1.get-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Installation","\u002Fget-started\u002Finstallation","1.get-started\u002F2.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Project structure","\u002Fget-started\u002Fproject-structure","1.get-started\u002F3.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Configuration","\u002Fget-started\u002Fconfiguration","1.get-started\u002F4.configuration","i-lucide-settings",{"title":31,"path":32,"stem":33,"icon":34},"Authentication","\u002Fget-started\u002Fauthentication","1.get-started\u002F5.authentication","i-lucide-lock",{"title":36,"path":37,"stem":38,"icon":39},"Adding modules","\u002Fget-started\u002Fadding-modules","1.get-started\u002F6.adding-modules","i-lucide-puzzle",{"title":41,"path":42,"stem":43,"icon":44},"Database","\u002Fget-started\u002Fdatabase","1.get-started\u002F7.database","i-lucide-database",{"title":46,"path":47,"stem":48,"icon":6},"Deployment","\u002Fget-started\u002Fdeployment","1.get-started\u002F8.deployment",false,{"title":51,"icon":52,"path":53,"stem":54,"children":55,"page":49},"Guide","i-lucide-book-open","\u002Fguide","2.guide",[56,90,115,125],{"title":57,"icon":49,"path":58,"stem":59,"children":60,"page":49},"Concepts","\u002Fguide\u002Fconcepts","2.guide\u002F1.concepts",[61,66,71,76,80,85],{"title":62,"path":63,"stem":64,"icon":65},"Architecture","\u002Fguide\u002Fconcepts\u002Farchitecture","2.guide\u002F1.concepts\u002F1.architecture","i-lucide-blocks",{"title":67,"path":68,"stem":69,"icon":70},"Access control","\u002Fguide\u002Fconcepts\u002Fauth-and-scopes","2.guide\u002F1.concepts\u002F2.auth-and-scopes","i-lucide-shield-check",{"title":72,"path":73,"stem":74,"icon":75},"Extension points","\u002Fguide\u002Fconcepts\u002Fextension-points","2.guide\u002F1.concepts\u002F3.extension-points","i-lucide-plug",{"title":77,"path":78,"stem":79,"icon":44},"Database extensions","\u002Fguide\u002Fconcepts\u002Fdatabase-extensions","2.guide\u002F1.concepts\u002F4.database-extensions",{"title":81,"path":82,"stem":83,"icon":84},"Identity","\u002Fguide\u002Fconcepts\u002Fidentity","2.guide\u002F1.concepts\u002F5.identity","i-lucide-fingerprint",{"title":86,"path":87,"stem":88,"icon":89},"Glossary","\u002Fguide\u002Fconcepts\u002Fglossary","2.guide\u002F1.concepts\u002F6.glossary","i-lucide-book-a",{"title":91,"icon":49,"path":92,"stem":93,"children":94,"page":49},"UX patterns","\u002Fguide\u002Fux-patterns","2.guide\u002F2.ux-patterns",[95,100,105,110],{"title":96,"path":97,"stem":98,"icon":99},"Layouts and navigation","\u002Fguide\u002Fux-patterns\u002Flayouts-and-navigation","2.guide\u002F2.ux-patterns\u002F1.layouts-and-navigation","i-lucide-layout-template",{"title":101,"path":102,"stem":103,"icon":104},"Pages","\u002Fguide\u002Fux-patterns\u002Fpages","2.guide\u002F2.ux-patterns\u002F2.pages","i-lucide-table",{"title":106,"path":107,"stem":108,"icon":109},"Forms and actions","\u002Fguide\u002Fux-patterns\u002Fforms-and-actions","2.guide\u002F2.ux-patterns\u002F3.forms-and-actions","i-lucide-square-pen",{"title":111,"path":112,"stem":113,"icon":114},"Text and formatting","\u002Fguide\u002Fux-patterns\u002Ftext-and-formatting","2.guide\u002F2.ux-patterns\u002F4.text-and-formatting","i-lucide-type",{"title":116,"icon":49,"path":117,"stem":118,"children":119,"page":49},"Best practices","\u002Fguide\u002Fbest-practices","2.guide\u002F3.best-practices",[120],{"title":121,"path":122,"stem":123,"icon":124},"HTTP routes","\u002Fguide\u002Fbest-practices\u002Fhttp-routes","2.guide\u002F3.best-practices\u002F1.http-routes","i-lucide-route",{"title":126,"icon":49,"path":127,"stem":128,"children":129,"page":49},"Going further","\u002Fguide\u002Fgoing-further","2.guide\u002F4.going-further",[130,135,140,145,150],{"title":131,"path":132,"stem":133,"icon":134},"Use your own OAuth server","\u002Fguide\u002Fgoing-further\u002Fown-oauth-server","2.guide\u002F4.going-further\u002F1.own-oauth-server","i-lucide-key-round",{"title":136,"path":137,"stem":138,"icon":139},"Create an OAuth application","\u002Fguide\u002Fgoing-further\u002Foauth-application","2.guide\u002F4.going-further\u002F2.oauth-application","i-lucide-app-window",{"title":141,"path":142,"stem":143,"icon":144},"Signing keys","\u002Fguide\u002Fgoing-further\u002Fsigning-keys","2.guide\u002F4.going-further\u002F3.signing-keys","i-lucide-key-square",{"title":146,"path":147,"stem":148,"icon":149},"Stripe setup","\u002Fguide\u002Fgoing-further\u002Fstripe-setup","2.guide\u002F4.going-further\u002F4.stripe-setup","i-lucide-credit-card",{"title":151,"path":152,"stem":153,"icon":154},"Migrate to the permission model","\u002Fguide\u002Fgoing-further\u002Fmigrate-access-control","2.guide\u002F4.going-further\u002F5.migrate-access-control","i-lucide-arrow-right-left",{"title":156,"icon":157,"path":158,"stem":159,"children":160},"Modules","i-lucide-boxes","\u002Fmodules","3.modules",[161,163,244,273,320,375],{"title":156,"path":158,"stem":162},"3.modules\u002Findex",{"title":81,"icon":49,"path":164,"stem":165,"children":166,"page":49},"\u002Fmodules\u002Fidentity","3.modules\u002F1.identity",[167,190,194,198,220,224,240],{"title":168,"path":169,"stem":170,"children":171},"Auth","\u002Fmodules\u002Fidentity\u002Fauth","3.modules\u002F1.identity\u002F1.auth\u002Findex",[172,174,178,182,186],{"title":173,"path":169,"stem":170},"Overview",{"title":175,"path":176,"stem":177},"Server API","\u002Fmodules\u002Fidentity\u002Fauth\u002Fserver","3.modules\u002F1.identity\u002F1.auth\u002F2.server",{"title":179,"path":180,"stem":181},"Reference","\u002Fmodules\u002Fidentity\u002Fauth\u002Freference","3.modules\u002F1.identity\u002F1.auth\u002F3.reference",{"title":183,"path":184,"stem":185},"Client mode","\u002Fmodules\u002Fidentity\u002Fauth\u002Fclient-mode","3.modules\u002F1.identity\u002F1.auth\u002F4.client-mode",{"title":187,"path":188,"stem":189},"OAuth providers","\u002Fmodules\u002Fidentity\u002Fauth\u002Foauth-providers","3.modules\u002F1.identity\u002F1.auth\u002F5.oauth-providers",{"title":191,"path":192,"stem":193},"Users","\u002Fmodules\u002Fidentity\u002Fusers","3.modules\u002F1.identity\u002F2.users",{"title":195,"path":196,"stem":197},"Account","\u002Fmodules\u002Fidentity\u002Faccount","3.modules\u002F1.identity\u002F3.account",{"title":199,"path":200,"stem":201,"children":202},"Authorization","\u002Fmodules\u002Fidentity\u002Fauthorization","3.modules\u002F1.identity\u002F4.authorization\u002Findex",[203,204,208,212,216],{"title":173,"path":200,"stem":201},{"title":205,"path":206,"stem":207},"Roles and requirements","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Froles-and-requirements","3.modules\u002F1.identity\u002F4.authorization\u002F2.roles-and-requirements",{"title":209,"path":210,"stem":211},"Policies","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fpolicies","3.modules\u002F1.identity\u002F4.authorization\u002F3.policies",{"title":213,"path":214,"stem":215},"Client","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fclient","3.modules\u002F1.identity\u002F4.authorization\u002F4.client",{"title":217,"path":218,"stem":219},"Admin","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fadmin","3.modules\u002F1.identity\u002F4.authorization\u002F5.admin",{"title":221,"path":222,"stem":223},"Preferences","\u002Fmodules\u002Fidentity\u002Fpreferences","3.modules\u002F1.identity\u002F5.preferences",{"title":225,"path":226,"stem":227,"children":228},"OAuth Server","\u002Fmodules\u002Fidentity\u002Foauth-server","3.modules\u002F1.identity\u002F6.oauth-server\u002Findex",[229,230,233,237],{"title":173,"path":226,"stem":227},{"title":175,"path":231,"stem":232},"\u002Fmodules\u002Fidentity\u002Foauth-server\u002Fserver","3.modules\u002F1.identity\u002F6.oauth-server\u002F2.server",{"title":234,"path":235,"stem":236},"Hooks","\u002Fmodules\u002Fidentity\u002Foauth-server\u002Fhooks","3.modules\u002F1.identity\u002F6.oauth-server\u002F3.hooks",{"title":179,"path":238,"stem":239},"\u002Fmodules\u002Fidentity\u002Foauth-server\u002Froutes-and-clients","3.modules\u002F1.identity\u002F6.oauth-server\u002F4.routes-and-clients",{"title":241,"path":242,"stem":243},"OAuth Resource","\u002Fmodules\u002Fidentity\u002Foauth-resource","3.modules\u002F1.identity\u002F8.oauth-resource",{"title":245,"icon":49,"path":246,"stem":247,"children":248,"page":49},"Commerce","\u002Fmodules\u002Fcommerce","3.modules\u002F2.commerce",[249,253,257],{"title":250,"path":251,"stem":252},"Stripe","\u002Fmodules\u002Fcommerce\u002Fstripe","3.modules\u002F2.commerce\u002F1.stripe",{"title":254,"path":255,"stem":256},"Payments","\u002Fmodules\u002Fcommerce\u002Fpayments","3.modules\u002F2.commerce\u002F2.payments",{"title":258,"path":259,"stem":260,"children":261},"Subscriptions","\u002Fmodules\u002Fcommerce\u002Fsubscriptions","3.modules\u002F2.commerce\u002F3.subscriptions\u002Findex",[262,263,266,270],{"title":173,"path":259,"stem":260},{"title":175,"path":264,"stem":265},"\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Fserver","3.modules\u002F2.commerce\u002F3.subscriptions\u002F2.server",{"title":267,"path":268,"stem":269},"App","\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Fapp","3.modules\u002F2.commerce\u002F3.subscriptions\u002F3.app",{"title":179,"path":271,"stem":272},"\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Freference","3.modules\u002F2.commerce\u002F3.subscriptions\u002F4.reference",{"title":274,"icon":49,"path":275,"stem":276,"children":277,"page":49},"Features","\u002Fmodules\u002Ffeatures","3.modules\u002F3.features",[278,293,312,316],{"title":279,"path":280,"stem":281,"children":282},"Events","\u002Fmodules\u002Ffeatures\u002Fevents","3.modules\u002F3.features\u002F1.events\u002Findex",[283,284,287,290],{"title":173,"path":280,"stem":281},{"title":175,"path":285,"stem":286},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Fserver","3.modules\u002F3.features\u002F1.events\u002F2.server",{"title":267,"path":288,"stem":289},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Fapp","3.modules\u002F3.features\u002F1.events\u002F3.app",{"title":179,"path":291,"stem":292},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Freference","3.modules\u002F3.features\u002F1.events\u002F4.reference",{"title":294,"path":295,"stem":296,"children":297},"Forms","\u002Fmodules\u002Ffeatures\u002Fforms","3.modules\u002F3.features\u002F2.forms\u002Findex",[298,299,303,306,309],{"title":173,"path":295,"stem":296},{"title":300,"path":301,"stem":302},"Definition","\u002Fmodules\u002Ffeatures\u002Fforms\u002Fdefinition","3.modules\u002F3.features\u002F2.forms\u002F2.definition",{"title":175,"path":304,"stem":305},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Fserver","3.modules\u002F3.features\u002F2.forms\u002F3.server",{"title":267,"path":307,"stem":308},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Fapp","3.modules\u002F3.features\u002F2.forms\u002F4.app",{"title":179,"path":310,"stem":311},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Freference","3.modules\u002F3.features\u002F2.forms\u002F5.reference",{"title":313,"path":314,"stem":315},"Cookie Consent","\u002Fmodules\u002Ffeatures\u002Fcookie-consent","3.modules\u002F3.features\u002F3.cookie-consent",{"title":317,"path":318,"stem":319},"MCP","\u002Fmodules\u002Ffeatures\u002Fmcp","3.modules\u002F3.features\u002F4.mcp",{"title":321,"icon":49,"path":322,"stem":323,"children":324,"page":49},"Interface","\u002Fmodules\u002Finterface","3.modules\u002F4.interface",[325,350,353,357,361],{"title":326,"path":327,"stem":328,"children":329},"UI","\u002Fmodules\u002Finterface\u002Fui","3.modules\u002F4.interface\u002F1.ui\u002Findex",[330,331,335,339,343,347],{"title":173,"path":327,"stem":328},{"title":332,"path":333,"stem":334},"Page components","\u002Fmodules\u002Finterface\u002Fui\u002Fpage-components","3.modules\u002F4.interface\u002F1.ui\u002F2.page-components",{"title":336,"path":337,"stem":338},"App shell","\u002Fmodules\u002Finterface\u002Fui\u002Fapp-shell","3.modules\u002F4.interface\u002F1.ui\u002F3.app-shell",{"title":340,"path":341,"stem":342},"Form inputs","\u002Fmodules\u002Finterface\u002Fui\u002Fform-inputs","3.modules\u002F4.interface\u002F1.ui\u002F4.form-inputs",{"title":344,"path":345,"stem":346},"Composables and helpers","\u002Fmodules\u002Finterface\u002Fui\u002Fcomposables","3.modules\u002F4.interface\u002F1.ui\u002F5.composables",{"title":179,"path":348,"stem":349},"\u002Fmodules\u002Finterface\u002Fui\u002Freference","3.modules\u002F4.interface\u002F1.ui\u002F6.reference",{"title":217,"path":351,"stem":352},"\u002Fmodules\u002Finterface\u002Fadmin","3.modules\u002F4.interface\u002F2.admin",{"title":354,"path":355,"stem":356},"Menu","\u002Fmodules\u002Finterface\u002Fmenu","3.modules\u002F4.interface\u002F3.menu",{"title":358,"path":359,"stem":360},"Widget","\u002Fmodules\u002Finterface\u002Fwidget","3.modules\u002F4.interface\u002F4.widget",{"title":362,"path":363,"stem":364,"children":365},"Mobile","\u002Fmodules\u002Finterface\u002Fmobile","3.modules\u002F4.interface\u002F5.mobile\u002Findex",[366,367,371],{"title":173,"path":363,"stem":364},{"title":368,"path":369,"stem":370},"CLI and devices","\u002Fmodules\u002Finterface\u002Fmobile\u002Fcli-and-devices","3.modules\u002F4.interface\u002F5.mobile\u002F2.cli-and-devices",{"title":372,"path":373,"stem":374},"Splash screen","\u002Fmodules\u002Finterface\u002Fmobile\u002Fsplash-screen","3.modules\u002F4.interface\u002F5.mobile\u002F3.splash-screen",{"title":376,"icon":49,"path":377,"stem":378,"children":379,"page":49},"Platform","\u002Fmodules\u002Fplatform","3.modules\u002F5.platform",[380,402,406,423],{"title":381,"path":382,"stem":383,"children":384},"Module Kit","\u002Fmodules\u002Fplatform\u002Fmodule-kit","3.modules\u002F5.platform\u002F1.module-kit\u002Findex",[385,386,390,394,398],{"title":173,"path":382,"stem":383},{"title":387,"path":388,"stem":389},"Server toolkit","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fserver-toolkit","3.modules\u002F5.platform\u002F1.module-kit\u002F2.server-toolkit",{"title":391,"path":392,"stem":393},"Registries and menus","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fregistries-and-menus","3.modules\u002F5.platform\u002F1.module-kit\u002F3.registries-and-menus",{"title":395,"path":396,"stem":397},"Translations","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fi18n","3.modules\u002F5.platform\u002F1.module-kit\u002F4.i18n",{"title":399,"path":400,"stem":401},"Database helpers","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fdatabase","3.modules\u002F5.platform\u002F1.module-kit\u002F5.database",{"title":403,"path":404,"stem":405},"Notify","\u002Fmodules\u002Fplatform\u002Fnotify","3.modules\u002F5.platform\u002F2.notify",{"title":407,"path":408,"stem":409,"children":410},"Email Templates","\u002Fmodules\u002Fplatform\u002Femail-templates","3.modules\u002F5.platform\u002F3.email-templates\u002Findex",[411,412,416,419],{"title":173,"path":408,"stem":409},{"title":413,"path":414,"stem":415},"Email components","\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fcomponents","3.modules\u002F5.platform\u002F3.email-templates\u002F2.components",{"title":175,"path":417,"stem":418},"\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fserver","3.modules\u002F5.platform\u002F3.email-templates\u002F3.server",{"title":420,"path":421,"stem":422},"Module emails","\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fmodule-emails","3.modules\u002F5.platform\u002F3.email-templates\u002F4.module-emails",{"title":424,"path":425,"stem":426,"children":427},"Base Layer","\u002Fmodules\u002Fplatform\u002Fbase-layer","3.modules\u002F5.platform\u002F4.base-layer\u002Findex",[428,429,433,437],{"title":173,"path":425,"stem":426},{"title":430,"path":431,"stem":432},"Content collections","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Fcontent-collections","3.modules\u002F5.platform\u002F4.base-layer\u002F2.content-collections",{"title":434,"path":435,"stem":436},"Layouts and routing","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Flayouts-and-routing","3.modules\u002F5.platform\u002F4.base-layer\u002F3.layouts-and-routing",{"title":438,"path":439,"stem":440},"Composables and utils","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Fcomposables-and-utils","3.modules\u002F5.platform\u002F4.base-layer\u002F4.composables-and-utils",{"title":442,"icon":443,"path":444,"stem":445,"children":446,"page":49},"Examples","i-lucide-code-xml","\u002Fexamples","4.examples",[447,466,476],{"title":448,"icon":49,"path":449,"stem":450,"children":451,"page":49},"Starters","\u002Fexamples\u002Fstarters","4.examples\u002F1.starters",[452,456,461],{"title":453,"path":454,"stem":455,"icon":6},"Workspace starter","\u002Fexamples\u002Fstarters\u002Fworkspace","4.examples\u002F1.starters\u002F1.workspace",{"title":457,"path":458,"stem":459,"icon":460},"Mobile starter","\u002Fexamples\u002Fstarters\u002Fmobile","4.examples\u002F1.starters\u002F2.mobile","i-lucide-smartphone",{"title":462,"path":463,"stem":464,"icon":465},"Standalone mobile starter","\u002Fexamples\u002Fstarters\u002Fmobile-standalone","4.examples\u002F1.starters\u002F3.mobile-standalone","i-lucide-tablet-smartphone",{"title":467,"icon":49,"path":468,"stem":469,"children":470,"page":49},"Apps","\u002Fexamples\u002Fapps","4.examples\u002F2.apps",[471],{"title":472,"path":473,"stem":474,"icon":475},"Frigear website app","\u002Fexamples\u002Fapps\u002Ffrigear-nu-website","4.examples\u002F2.apps\u002F1.frigear-nu-website","i-lucide-layout-dashboard",{"title":477,"icon":49,"path":478,"stem":479,"children":480,"page":49},"Tasks","\u002Fexamples\u002Ftasks","4.examples\u002F3.tasks",[481,485,489,494,499],{"title":482,"path":483,"stem":484,"icon":70},"Protect a route","\u002Fexamples\u002Ftasks\u002Fprotect-a-route","4.examples\u002F3.tasks\u002F1.protect-a-route",{"title":486,"path":487,"stem":488,"icon":475},"Add an admin page","\u002Fexamples\u002Ftasks\u002Fadd-an-admin-page","4.examples\u002F3.tasks\u002F2.add-an-admin-page",{"title":490,"path":491,"stem":492,"icon":493},"Sell event tickets","\u002Fexamples\u002Ftasks\u002Fsell-event-tickets","4.examples\u002F3.tasks\u002F3.sell-event-tickets","i-lucide-ticket",{"title":495,"path":496,"stem":497,"icon":498},"Build a form","\u002Fexamples\u002Ftasks\u002Fbuild-a-form","4.examples\u002F3.tasks\u002F4.build-a-form","i-lucide-clipboard-list",{"title":500,"path":501,"stem":502,"icon":503},"Send an email","\u002Fexamples\u002Ftasks\u002Fsend-an-email","4.examples\u002F3.tasks\u002F5.send-an-email","i-lucide-mail",{"title":505,"icon":506,"path":507,"stem":508,"children":509,"page":49},"Contribute","i-lucide-git-pull-request","\u002Fcontribute","5.contribute",[510,513,518,544,549,552,556,571],{"title":173,"path":511,"stem":512,"icon":506},"\u002Fcontribute\u002Foverview","5.contribute\u002F1.overview",{"title":514,"path":515,"stem":516,"icon":517},"Local development","\u002Fcontribute\u002Flocal-development","5.contribute\u002F2.local-development","i-lucide-terminal",{"title":519,"icon":49,"path":520,"stem":521,"children":522,"page":49},"Writing a module","\u002Fcontribute\u002Fwriting-a-module","5.contribute\u002F3.writing-a-module",[523,527,532,536,541],{"title":524,"path":525,"stem":526,"icon":39},"Scaffold a module","\u002Fcontribute\u002Fwriting-a-module\u002Fscaffold","5.contribute\u002F3.writing-a-module\u002F1.scaffold",{"title":528,"path":529,"stem":530,"icon":531},"Setup checklist","\u002Fcontribute\u002Fwriting-a-module\u002Fsetup-checklist","5.contribute\u002F3.writing-a-module\u002F2.setup-checklist","i-lucide-list-checks",{"title":533,"path":534,"stem":535,"icon":44},"Database tables","\u002Fcontribute\u002Fwriting-a-module\u002Fdatabase-tables","5.contribute\u002F3.writing-a-module\u002F3.database-tables",{"title":537,"path":538,"stem":539,"icon":540},"Testing","\u002Fcontribute\u002Fwriting-a-module\u002Ftesting","5.contribute\u002F3.writing-a-module\u002F4.testing","i-lucide-flask-conical",{"title":67,"path":542,"stem":543,"icon":70},"\u002Fcontribute\u002Fwriting-a-module\u002Faccess-control","5.contribute\u002F3.writing-a-module\u002F5.access-control",{"title":545,"path":546,"stem":547,"icon":548},"Publishing","\u002Fcontribute\u002Fpublishing","5.contribute\u002F4.publishing","i-lucide-package-check",{"title":448,"path":550,"stem":551,"icon":6},"\u002Fcontribute\u002Fstarters","5.contribute\u002F5.starters",{"title":553,"path":554,"stem":555,"icon":52},"Documentation","\u002Fcontribute\u002Fdocumentation","5.contribute\u002F6.documentation",{"title":557,"icon":49,"path":558,"stem":559,"children":560,"page":49},"Tooling","\u002Fcontribute\u002Ftooling","5.contribute\u002F7.tooling",[561,566],{"title":562,"path":563,"stem":564,"icon":565},"CLI","\u002Fcontribute\u002Ftooling\u002Fcli","5.contribute\u002F7.tooling\u002F1.cli","i-lucide-square-terminal",{"title":567,"path":568,"stem":569,"icon":570},"ESLint config","\u002Fcontribute\u002Ftooling\u002Feslint-config","5.contribute\u002F7.tooling\u002F2.eslint-config","i-lucide-spell-check",{"title":572,"icon":49,"path":573,"stem":574,"children":575},"Decisions","\u002Fcontribute\u002Fdecisions","5.contribute\u002F8.decisions\u002Findex",[576,578,583],{"title":572,"path":573,"stem":574,"icon":577},"i-lucide-scale",{"title":579,"path":580,"stem":581,"icon":582},"Session lifetimes per OAuth client","\u002Fcontribute\u002Fdecisions\u002Foauth-token-lifetimes","5.contribute\u002F8.decisions\u002F1.oauth-token-lifetimes","i-lucide-timer",{"title":584,"path":585,"stem":586,"icon":70},"One permission model","\u002Fcontribute\u002Fdecisions\u002Fpermission-model","5.contribute\u002F8.decisions\u002F2.permission-model",{"id":588,"title":589,"body":590,"description":1830,"extension":1831,"links":1832,"meta":1833,"navigation":1834,"path":304,"seo":1835,"stem":305,"__hash__":1836},"docs\u002F3.modules\u002F3.features\u002F2.forms\u002F3.server.md","Forms server",{"type":591,"value":592,"toc":1819},"minimark",[593,605,610,650,677,956,966,1125,1129,1144,1148,1155,1234,1273,1277,1294,1297,1301,1308,1320,1336,1340,1343,1378,1382,1404,1416,1610,1620,1624,1678,1692,1696,1706,1785,1790,1794,1815],[594,595,596,597,601,602,604],"p",{},"This page covers what happens on the server when someone submits a form, and what you can configure there: access, rate\nlimits, secrets, seeding, ",[598,599,600],"a",{"href":87},"staff"," access and MCP tools. It is for app developers and module\nauthors. Set up the module first: ",[598,603,173],{"href":295},".",[606,607,609],"h2",{"id":608},"submit-a-form","Submit a form",[594,611,612,616,617,620,621,624,625,628,629,632,633,636,637,639,640,643,644,647,648,604],{},[613,614,615],"code",{},"POST \u002Fapi\u002Fforms\u002F:slug\u002Fsubmit"," takes JSON ",[613,618,619],{},"{ answers, locale }",". With files, send ",[613,622,623],{},"multipart\u002Fform-data"," instead: an\n",[613,626,627],{},"answers"," JSON part, a ",[613,630,631],{},"locale"," part and one ",[613,634,635],{},"file:\u003Ckey>"," part per file. ",[613,638,631],{}," is a language tag such as ",[613,641,642],{},"en"," or\n",[613,645,646],{},"da-DK",", and defaults to ",[613,649,642],{},[594,651,652,653,656,657,660,661,664,665,668,669,672,673,676],{},"The answer is ",[613,654,655],{},"{ ok: true, id }",". ",[613,658,659],{},"id"," is ",[613,662,663],{},"null"," when the form has ",[613,666,667],{},"storage: 'none'",". Build the path with ",[613,670,671],{},"formsApi","\nfrom ",[613,674,675],{},"@frigear-nu\u002Fforms\u002Fapi",":",[678,679,684],"pre",{"className":680,"code":681,"language":682,"meta":683,"style":683},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { formsApi } from '@frigear-nu\u002Fforms\u002Fapi'\n\ntry {\n  await $fetch(formsApi.submit('contact'), { method: 'POST', body: { answers, locale: 'en' } })\n}\ncatch (error) {\n  \u002F\u002F 400: one issue per rejected field\n  const issues = (error as { data?: { data?: { issues?: { path: (string | number)[], message: string }[] } } }).data?.data?.issues ?? []\n}\n","ts","",[613,685,686,718,725,734,817,823,835,842,951],{"__ignoreMap":683},[687,688,691,695,699,703,706,709,712,715],"span",{"class":689,"line":690},"line",1,[687,692,694],{"class":693},"s7zQu","import",[687,696,698],{"class":697},"sMK4o"," {",[687,700,702],{"class":701},"sTEyZ"," formsApi",[687,704,705],{"class":697}," }",[687,707,708],{"class":693}," from",[687,710,711],{"class":697}," '",[687,713,675],{"class":714},"sfazB",[687,716,717],{"class":697},"'\n",[687,719,721],{"class":689,"line":720},2,[687,722,724],{"emptyLinePlaceholder":723},true,"\n",[687,726,728,731],{"class":689,"line":727},3,[687,729,730],{"class":693},"try",[687,732,733],{"class":697}," {\n",[687,735,737,740,744,748,750,752,755,757,760,763,765,768,771,773,776,778,780,783,785,787,790,792,794,797,799,802,804,806,808,810,812,814],{"class":689,"line":736},4,[687,738,739],{"class":693},"  await",[687,741,743],{"class":742},"s2Zo4"," $fetch",[687,745,747],{"class":746},"swJcz","(",[687,749,671],{"class":701},[687,751,604],{"class":697},[687,753,754],{"class":742},"submit",[687,756,747],{"class":746},[687,758,759],{"class":697},"'",[687,761,762],{"class":714},"contact",[687,764,759],{"class":697},[687,766,767],{"class":746},")",[687,769,770],{"class":697},",",[687,772,698],{"class":697},[687,774,775],{"class":746}," method",[687,777,676],{"class":697},[687,779,711],{"class":697},[687,781,782],{"class":714},"POST",[687,784,759],{"class":697},[687,786,770],{"class":697},[687,788,789],{"class":746}," body",[687,791,676],{"class":697},[687,793,698],{"class":697},[687,795,796],{"class":701}," answers",[687,798,770],{"class":697},[687,800,801],{"class":746}," locale",[687,803,676],{"class":697},[687,805,711],{"class":697},[687,807,642],{"class":714},[687,809,759],{"class":697},[687,811,705],{"class":697},[687,813,705],{"class":697},[687,815,816],{"class":746},")\n",[687,818,820],{"class":689,"line":819},5,[687,821,822],{"class":697},"}\n",[687,824,826,829,832],{"class":689,"line":825},6,[687,827,828],{"class":693},"catch",[687,830,831],{"class":701}," (error) ",[687,833,834],{"class":697},"{\n",[687,836,838],{"class":689,"line":837},7,[687,839,841],{"class":840},"sHwdD","  \u002F\u002F 400: one issue per rejected field\n",[687,843,845,849,852,855,858,861,864,866,869,872,874,876,878,880,882,884,886,889,891,893,897,900,903,906,908,911,913,916,918,921,924,926,928,930,932,935,938,940,942,945,948],{"class":689,"line":844},8,[687,846,848],{"class":847},"spNyl","  const",[687,850,851],{"class":701}," issues",[687,853,854],{"class":697}," =",[687,856,857],{"class":746}," (",[687,859,860],{"class":701},"error",[687,862,863],{"class":693}," as",[687,865,698],{"class":697},[687,867,868],{"class":746}," data",[687,870,871],{"class":697},"?:",[687,873,698],{"class":697},[687,875,868],{"class":746},[687,877,871],{"class":697},[687,879,698],{"class":697},[687,881,851],{"class":746},[687,883,871],{"class":697},[687,885,698],{"class":697},[687,887,888],{"class":746}," path",[687,890,676],{"class":697},[687,892,857],{"class":746},[687,894,896],{"class":895},"sBMFI","string",[687,898,899],{"class":697}," |",[687,901,902],{"class":895}," number",[687,904,905],{"class":746},")[]",[687,907,770],{"class":697},[687,909,910],{"class":746}," message",[687,912,676],{"class":697},[687,914,915],{"class":895}," string",[687,917,705],{"class":697},[687,919,920],{"class":746},"[] ",[687,922,923],{"class":697},"}",[687,925,705],{"class":697},[687,927,705],{"class":697},[687,929,767],{"class":746},[687,931,604],{"class":697},[687,933,934],{"class":701},"data",[687,936,937],{"class":697},"?.",[687,939,934],{"class":701},[687,941,937],{"class":697},[687,943,944],{"class":701},"issues",[687,946,947],{"class":697}," ??",[687,949,950],{"class":746}," []\n",[687,952,954],{"class":689,"line":953},9,[687,955,822],{"class":697},[594,957,958,959,962,963,604],{},"Every error has its message in ",[613,960,961],{},"statusMessage"," and a snake_case code in ",[613,964,965],{},"data.code",[967,968,969,985],"table",{},[970,971,972],"thead",{},[973,974,975,979,982],"tr",{},[976,977,978],"th",{},"Status",[976,980,981],{},"Code",[976,983,984],{},"Cause",[986,987,988,1011,1037,1055,1070,1089,1104],"tbody",{},[973,989,990,996,1001],{},[991,992,993],"td",{},[613,994,995],{},"400",[991,997,998],{},[613,999,1000],{},"validation_failed",[991,1002,1003,1004,1007,1008,604],{},"A malformed body, rejected answers or a failed captcha. Each issue is ",[613,1005,1006],{},"{ path, message }",", with the field key in ",[613,1009,1010],{},"path[0]",[973,1012,1013,1018,1023],{},[991,1014,1015],{},[613,1016,1017],{},"401",[991,1019,1020],{},[613,1021,1022],{},"unauthorized",[991,1024,1025,1026,1030,1031,660,1034,604],{},"The form's ",[598,1027,1029],{"href":1028},"#decide-who-may-submit","access"," is not met. ",[613,1032,1033],{},"data.access",[613,1035,1036],{},"true",[973,1038,1039,1044,1049],{},[991,1040,1041],{},[613,1042,1043],{},"403",[991,1045,1046],{},[613,1047,1048],{},"form_closed",[991,1050,1051,1052,604],{},"The form is outside its open period: ",[613,1053,1054],{},"data: { closed: true, opensAt }",[973,1056,1057,1062,1067],{},[991,1058,1059],{},[613,1060,1061],{},"404",[991,1063,1064],{},[613,1065,1066],{},"not_found",[991,1068,1069],{},"The form is unknown or not published.",[973,1071,1072,1077,1082],{},[991,1073,1074],{},[613,1075,1076],{},"429",[991,1078,1079],{},[613,1080,1081],{},"rate_limited",[991,1083,1084,1085,1088],{},"Too many submissions. The ",[613,1086,1087],{},"Retry-After"," header says when to try again.",[973,1090,1091,1096,1101],{},[991,1092,1093],{},[613,1094,1095],{},"500",[991,1097,1098],{},[613,1099,1100],{},"not_configured",[991,1102,1103],{},"Captcha has no secret key.",[973,1105,1106,1111,1120],{},[991,1107,1108],{},[613,1109,1110],{},"502",[991,1112,1113,1116,1117],{},[613,1114,1115],{},"captcha_unavailable",", ",[613,1118,1119],{},"delivery_failed",[991,1121,1122,1123,604],{},"The captcha provider is unreachable, or delivery failed for a form with ",[613,1124,667],{},[1126,1127,1128],"note",{},"A stored submission is written before it is delivered. A failed email never loses it: the error is recorded on the\nsubmission, and staff can deliver it again from the admin area.",[594,1130,1131,1134,1135,1139,1140,1143],{},[613,1132,1133],{},"GET \u002Fapi\u002Fforms\u002F:slug"," returns the published definition ",[1136,1137,1138],"strong",{},"without"," ",[613,1141,1142],{},"delivery",", so recipients are never public.",[606,1145,1147],{"id":1146},"decide-who-may-submit","Decide who may submit",[594,1149,1150,1151,1154],{},"A form's ",[613,1152,1153],{},"access.auth"," decides who may read and submit it. Its secrets are never part of the definition.",[967,1156,1157,1169],{},[970,1158,1159],{},[973,1160,1161,1166],{},[976,1162,1163],{},[613,1164,1165],{},"auth",[976,1167,1168],{},"The submitter proves access with",[986,1170,1171,1181,1199,1216],{},[973,1172,1173,1178],{},[991,1174,1175],{},[613,1176,1177],{},"none",[991,1179,1180],{},"Nothing.",[973,1182,1183,1188],{},[991,1184,1185],{},[613,1186,1187],{},"user",[991,1189,1190,1191,1194,1195,1198],{},"A ",[598,1192,1193],{"href":87},"signed-in user",": a session, or a token with the ",[613,1196,1197],{},"forms:submit"," scope.",[973,1200,1201,1206],{},[991,1202,1203],{},[613,1204,1205],{},"token",[991,1207,1208,1209,1212,1213,604],{},"A form access token in ",[613,1210,1211],{},"Authorization: Bearer \u003Ctoken>"," or ",[613,1214,1215],{},"x-form-token: \u003Ctoken>",[973,1217,1218,1223],{},[991,1219,1220],{},[613,1221,1222],{},"password",[991,1224,1225,1226,1229,1230,1233],{},"The form's shared password in the ",[613,1227,1228],{},"x-form-password"," header (",[613,1231,1232],{},"FORM_PASSWORD_HEADER",").",[1235,1236,1237,1255,1265],"ul",{},[1238,1239,1240,1243,1244,1247,1248,1251,1252,604],"li",{},[1136,1241,1242],{},"Form access tokens"," start with ",[613,1245,1246],{},"ffk_",". Staff create them per form in the admin area, and each is shown once. Only\na SHA-256 hash is stored, with a display prefix, ",[613,1249,1250],{},"lastUsedAt"," and ",[613,1253,1254],{},"revokedAt",[1238,1256,1257,1260,1261,1264],{},[1136,1258,1259],{},"The password"," is stored as a scrypt hash. A form with ",[613,1262,1263],{},"auth: 'password'"," and no password set stays closed.",[1238,1266,1267,1272],{},[1136,1268,1269],{},[613,1270,1271],{},"availability: 'api'"," only removes the public page. The API still serves the form.",[606,1274,1276],{"id":1275},"rate-limiting","Rate limiting",[594,1278,1279,1280,1283,1284,1287,1288,1290,1291,1293],{},"Submissions are counted per client IP and form in key-value storage, in a fixed window: ",[613,1281,1282],{},"settings.rateLimit"," per\n",[613,1285,1286],{},"settings.rateLimitWindowSeconds",". Over the limit the answer is ",[613,1289,1076],{}," with ",[613,1292,1087],{},". Wrong password attempts have\ntheir own counter, with the same limit and window.",[594,1295,1296],{},"The count is read and then written, so it is not exact under concurrency. That is enough against casual abuse.",[606,1298,1300],{"id":1299},"per-form-secrets","Per-form secrets",[594,1302,1303,1304,1307],{},"Some secrets belong to one form, such as its own captcha secret key. They live in the ",[613,1305,1306],{},"form_secrets"," table, encrypted\non the server with AES-256-GCM. They never end up in definition versions, submission snapshots, deliveries, imports or\nthe public API. Staff can write them, but nobody can read them back.",[594,1309,1310,1311,1116,1314,1251,1317,604],{},"The allowed keys are ",[613,1312,1313],{},"captcha.turnstile.secretKey",[613,1315,1316],{},"captcha.recaptcha.secretKey",[613,1318,1319],{},"captcha.hcaptcha.secretKey",[1321,1322,1323,1324,1327,1328,1331,1332,1335],"caution",{},"The key is ",[613,1325,1326],{},"encryptionKey",", else ",[613,1329,1330],{},"NUXT_ENCRYPTION_KEY",", else the session password. Set a dedicated key in production.\nChanging the key makes every stored secret unreadable: the admin API reports ",[613,1333,1334],{},"unreadable: true",", and captcha checks fall\nback to the configured key until staff enter the secrets again.",[606,1337,1339],{"id":1338},"seeding-and-import","Seeding and import",[594,1341,1342],{},"Forms never inserts anything by itself. There are two ways to load definitions, and both insert only slugs that do not\nexist yet. Neither overwrites a form.",[1235,1344,1345,1357],{},[1238,1346,1347,1139,1350,1353,1354,1356],{},[1136,1348,1349],{},"Seed.",[613,1351,1352],{},"seed: { enabled: true, forms: [...] }"," inserts at startup. ",[598,1355,495],{"href":496},"\nshows it.",[1238,1358,1359,1362,1363,1366,1367,1370,1371,1374,1375,604],{},[1136,1360,1361],{},"Import."," The ",[1136,1364,1365],{},"Import JSON"," button in the admin area calls ",[613,1368,1369],{},"POST \u002Fapi\u002Fadmin\u002Fforms\u002Fimport"," with\n",[613,1372,1373],{},"{ forms: [{ slug, name, definition }] }",". It answers ",[613,1376,1377],{},"{ inserted, skipped }",[606,1379,1381],{"id":1380},"let-staff-manage-forms","Let staff manage forms",[594,1383,1384,1385,1388,1389,1391,1392,1395,1396,1399,1400,604],{},"Every staff route calls ",[613,1386,1387],{},"authorize(event, permission)"," from ",[598,1390,199],{"href":200},":\n",[613,1393,1394],{},"forms:manage"," for most routes, and ",[613,1397,1398],{},"forms:credentials"," for form access tokens, passwords and secrets. Who holds them is\na matter of roles, as in ",[598,1401,1403],{"href":1402},"\u002Fmodules\u002Ffeatures\u002Fforms#quick-setup","Quick setup",[594,1405,1406,1407,1212,1409,1411,1412,1415],{},"A route that loads a form authorizes twice. The first call fails with ",[613,1408,1017],{},[613,1410,1043],{}," before anything is looked up. The\nsecond call passes the record, so a ",[598,1413,1414],{"href":210},"policy"," can refine the answer:",[678,1417,1420],{"className":680,"code":1418,"filename":1419,"language":682,"meta":683,"style":683},"export default defineEventHandler(async (event) => {\n  await authorize(event, 'forms:manage')           \u002F\u002F 401 or 403 before any 404\n  const { id } = await getValidatedRouterParams(event, idParams().parse)\n  const form = await loadForm(id)                  \u002F\u002F then 404\n  if (!form) throw notFound('Form not found.')\n  await authorize(event, 'forms:manage', form)     \u002F\u002F record-level policies\n  \u002F\u002F ...\n})\n","server\u002Fapi\u002Fadmin\u002Fforms\u002F[id].delete.ts",[613,1421,1422,1451,1476,1514,1538,1571,1599,1604],{"__ignoreMap":683},[687,1423,1424,1427,1430,1433,1435,1438,1440,1444,1446,1449],{"class":689,"line":690},[687,1425,1426],{"class":693},"export",[687,1428,1429],{"class":693}," default",[687,1431,1432],{"class":742}," defineEventHandler",[687,1434,747],{"class":701},[687,1436,1437],{"class":847},"async",[687,1439,857],{"class":697},[687,1441,1443],{"class":1442},"sHdIc","event",[687,1445,767],{"class":697},[687,1447,1448],{"class":847}," =>",[687,1450,733],{"class":697},[687,1452,1453,1455,1458,1460,1462,1464,1466,1468,1470,1473],{"class":689,"line":720},[687,1454,739],{"class":693},[687,1456,1457],{"class":742}," authorize",[687,1459,747],{"class":746},[687,1461,1443],{"class":701},[687,1463,770],{"class":697},[687,1465,711],{"class":697},[687,1467,1394],{"class":714},[687,1469,759],{"class":697},[687,1471,1472],{"class":746},")           ",[687,1474,1475],{"class":840},"\u002F\u002F 401 or 403 before any 404\n",[687,1477,1478,1480,1482,1485,1487,1489,1492,1495,1497,1499,1501,1504,1507,1509,1512],{"class":689,"line":727},[687,1479,848],{"class":847},[687,1481,698],{"class":697},[687,1483,1484],{"class":701}," id",[687,1486,705],{"class":697},[687,1488,854],{"class":697},[687,1490,1491],{"class":693}," await",[687,1493,1494],{"class":742}," getValidatedRouterParams",[687,1496,747],{"class":746},[687,1498,1443],{"class":701},[687,1500,770],{"class":697},[687,1502,1503],{"class":742}," idParams",[687,1505,1506],{"class":746},"()",[687,1508,604],{"class":697},[687,1510,1511],{"class":701},"parse",[687,1513,816],{"class":746},[687,1515,1516,1518,1521,1523,1525,1528,1530,1532,1535],{"class":689,"line":736},[687,1517,848],{"class":847},[687,1519,1520],{"class":701}," form",[687,1522,854],{"class":697},[687,1524,1491],{"class":693},[687,1526,1527],{"class":742}," loadForm",[687,1529,747],{"class":746},[687,1531,659],{"class":701},[687,1533,1534],{"class":746},")                  ",[687,1536,1537],{"class":840},"\u002F\u002F then 404\n",[687,1539,1540,1543,1545,1548,1551,1554,1557,1560,1562,1564,1567,1569],{"class":689,"line":819},[687,1541,1542],{"class":693},"  if",[687,1544,857],{"class":746},[687,1546,1547],{"class":697},"!",[687,1549,1550],{"class":701},"form",[687,1552,1553],{"class":746},") ",[687,1555,1556],{"class":693},"throw",[687,1558,1559],{"class":742}," notFound",[687,1561,747],{"class":746},[687,1563,759],{"class":697},[687,1565,1566],{"class":714},"Form not found.",[687,1568,759],{"class":697},[687,1570,816],{"class":746},[687,1572,1573,1575,1577,1579,1581,1583,1585,1587,1589,1591,1593,1596],{"class":689,"line":825},[687,1574,739],{"class":693},[687,1576,1457],{"class":742},[687,1578,747],{"class":746},[687,1580,1443],{"class":701},[687,1582,770],{"class":697},[687,1584,711],{"class":697},[687,1586,1394],{"class":714},[687,1588,759],{"class":697},[687,1590,770],{"class":697},[687,1592,1520],{"class":701},[687,1594,1595],{"class":746},")     ",[687,1597,1598],{"class":840},"\u002F\u002F record-level policies\n",[687,1600,1601],{"class":689,"line":837},[687,1602,1603],{"class":840},"  \u002F\u002F ...\n",[687,1605,1606,1608],{"class":689,"line":844},[687,1607,923],{"class":697},[687,1609,816],{"class":701},[594,1611,1612,1613,1615,1616,1619],{},"Changing form access tokens, password or secrets needs ",[613,1614,1398],{},", which is session only: a token gets\n",[613,1617,1618],{},"403 session_required",", whatever its scopes.",[606,1621,1623],{"id":1622},"permissions-and-scopes","Permissions and scopes",[967,1625,1626,1636],{},[970,1627,1628],{},[973,1629,1630,1633],{},[976,1631,1632],{},"Permission",[976,1634,1635],{},"Allows",[986,1637,1638,1647,1656,1665],{},[973,1639,1640,1644],{},[991,1641,1642],{},[613,1643,1394],{},[991,1645,1646],{},"Managing forms and submissions as staff.",[973,1648,1649,1653],{},[991,1650,1651],{},[613,1652,1398],{},[991,1654,1655],{},"Form access tokens, passwords and secrets. Session only.",[973,1657,1658,1662],{},[991,1659,1660],{},[613,1661,1197],{},[991,1663,1664],{},"Submitting forms as the user, and reading forms that need a signed-in user.",[973,1666,1667,1672],{},[991,1668,1669],{},[613,1670,1671],{},"forms:pii",[991,1673,1674,1675,1677],{},"Sensitive (MCP only): submission answers and file names in MCP tool output. The admin HTTP routes for submissions need ",[613,1676,1394],{}," only. Grant it by name.",[594,1679,1680,1681,1684,1685,1687,1688,604],{},"The named scope ",[613,1682,1683],{},"forms"," expands to ",[613,1686,1197],{},". The full table, with defaults, is under\n",[598,1689,1691],{"href":1690},"\u002Fmodules\u002Ffeatures\u002Fforms#permissions","Permissions",[606,1693,1695],{"id":1694},"mcp-tools","MCP tools",[594,1697,1698,1699,1702,1703,1705],{},"With ",[613,1700,1701],{},"settings.mcp: true",", Forms adds these tools to the ",[598,1704,317],{"href":318}," endpoint.",[967,1707,1708,1720],{},[970,1709,1710],{},[973,1711,1712,1715,1717],{},[976,1713,1714],{},"Tool",[976,1716,1632],{},[976,1718,1719],{},"Purpose",[986,1721,1722,1742,1765],{},[973,1723,1724,1735,1739],{},[991,1725,1726,1116,1729,1116,1732],{},[613,1727,1728],{},"list-forms",[613,1730,1731],{},"get-form",[613,1733,1734],{},"submit-form",[991,1736,1737],{},[613,1738,1197],{},[991,1740,1741],{},"Browse published forms and submit as the user.",[973,1743,1744,1758,1762],{},[991,1745,1746,1116,1749,1116,1752,1116,1755],{},[613,1747,1748],{},"list-all-forms",[613,1750,1751],{},"get-form-definition",[613,1753,1754],{},"create-form",[613,1756,1757],{},"update-form",[991,1759,1760],{},[613,1761,1394],{},[991,1763,1764],{},"Manage forms. Delivery settings are never returned or changed.",[973,1766,1767,1775,1779],{},[991,1768,1769,1116,1772],{},[613,1770,1771],{},"list-submissions",[613,1773,1774],{},"get-submission",[991,1776,1777],{},[613,1778,1394],{},[991,1780,1781,1782,1784],{},"Submissions. Answers, submitter and file names need ",[613,1783,1671],{}," too.",[594,1786,1787,1789],{},[613,1788,1734],{}," always submits as the caller, and refuses forms that need a form access token or a password.",[606,1791,1793],{"id":1792},"next-steps","Next steps",[1235,1795,1796,1805,1810],{},[1238,1797,1798,1800,1801,1804],{},[598,1799,179],{"href":310}," – every route, and the ",[613,1802,1803],{},"forms:submitted"," hook for your own delivery.",[1238,1806,1807,1809],{},[598,1808,267],{"href":307}," – show a form, or its password gate, on any page.",[1238,1811,1812,1814],{},[598,1813,317],{"href":318}," – how agents connect and which permissions they hold.",[1816,1817,1818],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":683,"searchDepth":720,"depth":720,"links":1820},[1821,1822,1823,1824,1825,1826,1827,1828,1829],{"id":608,"depth":720,"text":609},{"id":1146,"depth":720,"text":1147},{"id":1275,"depth":720,"text":1276},{"id":1299,"depth":720,"text":1300},{"id":1338,"depth":720,"text":1339},{"id":1380,"depth":720,"text":1381},{"id":1622,"depth":720,"text":1623},{"id":1694,"depth":720,"text":1695},{"id":1792,"depth":720,"text":1793},"Submit forms from code, choose who may answer them, and seed forms, keep their secrets and give staff access.","md",null,{},{"title":175},{"title":589,"description":1830},"trKNjoUAPSvj0DNYtS2SCUBeCV65dcbKD7mVwat4V8Y",[1838,1840],{"title":300,"path":301,"stem":302,"description":1839,"children":-1},"What a form is made of, from fields and conditions to open periods, the email it sends and captcha.",{"title":267,"path":307,"stem":308,"description":1841,"children":-1},"Show a form on its own page, inside any page or in Markdown, and use the composables and utils behind it.",1794503157087]