[{"data":1,"prerenderedAt":2352},["ShallowReactive",2],{"navigation_docs":3,"-modules-commerce-stripe":587,"-modules-commerce-stripe-surround":2347},[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":250,"body":589,"description":2341,"extension":2342,"links":2343,"meta":2344,"navigation":1347,"path":251,"seo":2345,"stem":252,"__hash__":2346},"docs\u002F3.modules\u002F2.commerce\u002F1.stripe.md",{"type":590,"value":591,"toc":2319},"minimark",[592,603,611,616,636,640,674,678,910,930,934,941,987,1013,1017,1023,1111,1115,1121,1218,1229,1240,1264,1268,1271,1613,1617,1623,1861,1981,1991,1994,2070,2077,2081,2107,2110,2116,2148,2154,2158,2161,2198,2204,2268,2271,2278,2299,2303,2315],[593,594,595,596,599,600,602],"p",{},"Stripe tells your app that money moved by calling a webhook, and every feature that takes money needs those events.\nThis module receives them once: it verifies each event, skips duplicates and passes it to whoever listens. It also\nlinks each user to a Stripe customer. You rarely install it on its own: ",[597,598,254],"a",{"href":255}," and\n",[597,601,258],{"href":259}," install it for you.",[593,604,605,606,610],{},"The package is ",[607,608,609],"code",{},"@frigear-nu\u002Fstripe",". It stores no products or prices, only each user's Stripe customer id.",[612,613,615],"h2",{"id":614},"what-you-get","What you get",[617,618,619,631],"ul",{},[620,621,622,626,627,630],"li",{},[623,624,625],"strong",{},"Server routes"," (on by default): one webhook endpoint at ",[607,628,629],{},"\u002Fapi\u002Fstripe\u002Fwebhook",".",[620,632,633,635],{},[623,634,344],{}," (on by default): a shared Stripe client, a Stripe customer for any user, and two ways to\nlisten to events.",[637,638],"module-runtime",{":server":639},"true",[641,642,643,655,668],"note",{},[593,644,645,648,649,652,653,630],{},[623,646,647],{},"Installed for you:"," ",[607,650,651],{},"@frigear-nu\u002Fmodule-kit"," and ",[597,654,191],{"href":192},[593,656,657,648,660,663,664,667],{},[623,658,659],{},"You add:",[607,661,662],{},"@nuxthub\u002Fcore"," with key-value storage (KV) on. ",[607,665,666],{},"hub.kv"," is on by default, and the build fails without it.",[593,669,670,673],{},[623,671,672],{},"Optional:"," nothing.",[612,675,677],{"id":676},"quick-setup","Quick setup",[679,680,681,686,714,718,854,858,874,880,892,900,904],"steps",{},[682,683,685],"h3",{"id":684},"install-stripe","Install Stripe",[687,688,693],"pre",{"className":689,"code":690,"language":691,"meta":692,"style":692},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add @frigear-nu\u002Fstripe @nuxthub\u002Fcore\n","bash","",[607,694,695],{"__ignoreMap":692},[696,697,700,704,708,711],"span",{"class":698,"line":699},"line",1,[696,701,703],{"class":702},"sBMFI","pnpm",[696,705,707],{"class":706},"sfazB"," add",[696,709,710],{"class":706}," @frigear-nu\u002Fstripe",[696,712,713],{"class":706}," @nuxthub\u002Fcore\n",[682,715,717],{"id":716},"add-it-to-nuxtconfigts","Add it to nuxt.config.ts",[687,719,724],{"className":720,"code":721,"filename":722,"language":723,"meta":692,"style":692},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  modules: ['@nuxthub\u002Fcore', '@frigear-nu\u002Fstripe'], \u002F\u002F installs Users for you\n  hub: { db: { dialect: 'sqlite', driver: 'libsql' }, kv: true },\n})\n","nuxt.config.ts","ts",[607,725,726,747,786,845],{"__ignoreMap":692},[696,727,728,732,735,739,743],{"class":698,"line":699},[696,729,731],{"class":730},"s7zQu","export",[696,733,734],{"class":730}," default",[696,736,738],{"class":737},"s2Zo4"," defineNuxtConfig",[696,740,742],{"class":741},"sTEyZ","(",[696,744,746],{"class":745},"sMK4o","{\n",[696,748,750,754,757,760,763,765,767,770,773,775,777,780,782],{"class":698,"line":749},2,[696,751,753],{"class":752},"swJcz","  modules",[696,755,756],{"class":745},":",[696,758,759],{"class":741}," [",[696,761,762],{"class":745},"'",[696,764,662],{"class":706},[696,766,762],{"class":745},[696,768,769],{"class":745},",",[696,771,772],{"class":745}," '",[696,774,609],{"class":706},[696,776,762],{"class":745},[696,778,779],{"class":741},"]",[696,781,769],{"class":745},[696,783,785],{"class":784},"sHwdD"," \u002F\u002F installs Users for you\n",[696,787,789,792,794,797,800,802,804,807,809,811,814,816,818,821,823,825,828,830,833,836,838,842],{"class":698,"line":788},3,[696,790,791],{"class":752},"  hub",[696,793,756],{"class":745},[696,795,796],{"class":745}," {",[696,798,799],{"class":752}," db",[696,801,756],{"class":745},[696,803,796],{"class":745},[696,805,806],{"class":752}," dialect",[696,808,756],{"class":745},[696,810,772],{"class":745},[696,812,813],{"class":706},"sqlite",[696,815,762],{"class":745},[696,817,769],{"class":745},[696,819,820],{"class":752}," driver",[696,822,756],{"class":745},[696,824,772],{"class":745},[696,826,827],{"class":706},"libsql",[696,829,762],{"class":745},[696,831,832],{"class":745}," },",[696,834,835],{"class":752}," kv",[696,837,756],{"class":745},[696,839,841],{"class":840},"sfNiH"," true",[696,843,844],{"class":745}," },\n",[696,846,848,851],{"class":698,"line":847},4,[696,849,850],{"class":745},"}",[696,852,853],{"class":741},")\n",[682,855,857],{"id":856},"generate-the-migration","Generate the migration",[859,860,861,862,865,866,869,870,873],"warning",{},"Without a ",[597,863,864],{"href":87},"migration",", every write to the ",[607,867,868],{},"users"," table fails: the database lacks the\n",[607,871,872],{},"stripe_customer_id"," column.",[593,875,876,877,879],{},"The module adds a column to ",[607,878,868],{},". Generate a migration and commit it:",[687,881,883],{"className":689,"code":882,"language":691,"meta":692,"style":692},"pnpm db:generate\n",[607,884,885],{"__ignoreMap":692},[696,886,887,889],{"class":698,"line":699},[696,888,703],{"class":702},[696,890,891],{"class":706}," db:generate\n",[893,894,895,896,899],"caution",{},"Use test keys (",[607,897,898],{},"sk_test_...",") until the whole flow works: live keys charge real cards.",[682,901,903],{"id":902},"connect-your-stripe-account","Connect your Stripe account",[593,905,906,907,909],{},"Set the keys and add the webhook endpoint in the Stripe dashboard, as ",[597,908,146],{"href":147},"\ndescribes. That page also lists the events each module needs.",[911,912,915,918,919,922,923,926,927,630],"callout",{"color":913,"icon":914},"success","i-lucide-check",[623,916,917],{},"What you should see:"," with ",[607,920,921],{},"stripe listen"," forwarding to your dev server, ",[607,924,925],{},"stripe trigger customer.created"," shows\nthe event delivered with status ",[607,928,929],{},"200",[612,931,933],{"id":932},"options","Options",[593,935,936,937,940],{},"Options go under the ",[607,938,939],{},"stripe"," key.",[942,943,944,963],"table",{},[945,946,947],"thead",{},[948,949,950,954,957,960],"tr",{},[951,952,953],"th",{},"Option",[951,955,956],{},"Type",[951,958,959],{},"Default",[951,961,962],{},"Purpose",[964,965,966],"tbody",{},[948,967,968,974,979,984],{},[969,970,971],"td",{},[607,972,973],{},"settings.webhookPath",[969,975,976],{},[607,977,978],{},"string",[969,980,981],{},[607,982,983],{},"'\u002Fapi\u002Fstripe\u002Fwebhook'",[969,985,986],{},"The path of the webhook endpoint.",[593,988,989,993,994,997,998,1000,1001,1004,1005,1008,1009,1012],{},[623,990,991],{},[607,992,973],{}," gets a leading ",[607,995,996],{},"\u002F"," when it has none. ",[607,999,609],{}," exports the default as\n",[607,1002,1003],{},"DEFAULT_WEBHOOK_PATH",", and the pinned API version as ",[607,1006,1007],{},"STRIPE_API_VERSION"," (currently ",[607,1010,1011],{},"2026-09-30.endive",").",[682,1014,1016],{"id":1015},"runtime-config","Runtime config",[593,1018,1019,1020,630],{},"Keys are secrets, so set them through runtime config, never ",[607,1021,1022],{},"process.env",[942,1024,1025,1036],{},[945,1026,1027],{},[948,1028,1029,1031,1034],{},[951,1030,1016],{},[951,1032,1033],{},"Env var",[951,1035,962],{},[964,1037,1038,1057,1075,1092],{},[948,1039,1040,1045,1050],{},[969,1041,1042],{},[607,1043,1044],{},"stripe.secretKey",[969,1046,1047],{},[607,1048,1049],{},"NUXT_STRIPE_SECRET_KEY",[969,1051,1052,1053,1056],{},"The secret API key (",[607,1054,1055],{},"sk_...","), or a restricted key.",[948,1058,1059,1064,1069],{},[969,1060,1061],{},[607,1062,1063],{},"stripe.webhookSecret",[969,1065,1066],{},[607,1067,1068],{},"NUXT_STRIPE_WEBHOOK_SECRET",[969,1070,1071,1072,1012],{},"The signing secret of the webhook endpoint (",[607,1073,1074],{},"whsec_...",[948,1076,1077,1082,1087],{},[969,1078,1079],{},[607,1080,1081],{},"stripe.apiVersion",[969,1083,1084],{},[607,1085,1086],{},"NUXT_STRIPE_API_VERSION",[969,1088,1089,1090,630],{},"Optional. Overrides ",[607,1091,1007],{},[948,1093,1094,1099,1104],{},[969,1095,1096],{},[607,1097,1098],{},"public.stripe.publishableKey",[969,1100,1101],{},[607,1102,1103],{},"NUXT_PUBLIC_STRIPE_PUBLISHABLE_KEY",[969,1105,1106,1107,1110],{},"The publishable key (",[607,1108,1109],{},"pk_...","), exposed to the browser.",[612,1112,1114],{"id":1113},"server","Server",[593,1116,1117,1118,630],{},"These helpers are auto-imported in ",[597,1119,1120],{"href":87},"Nitro",[942,1122,1123,1136],{},[945,1124,1125],{},[948,1126,1127,1130,1133],{},[951,1128,1129],{},"Helper",[951,1131,1132],{},"Returns",[951,1134,1135],{},"What it does",[964,1137,1138,1156,1171,1186,1205],{},[948,1139,1140,1145,1149],{},[969,1141,1142],{},[607,1143,1144],{},"useStripe()",[969,1146,1147],{},[607,1148,250],{},[969,1150,1151,1152,1155],{},"The shared client. It uses ",[607,1153,1154],{},"fetch",", so it runs on Cloudflare Workers.",[948,1157,1158,1163,1168],{},[969,1159,1160],{},[607,1161,1162],{},"ensureStripeCustomer(userId)",[969,1164,1165],{},[607,1166,1167],{},"Promise\u003Cstring>",[969,1169,1170],{},"The user's Stripe customer id, found or created on first use.",[948,1172,1173,1178,1183],{},[969,1174,1175],{},[607,1176,1177],{},"getStripeCustomerUser(customerId)",[969,1179,1180],{},[607,1181,1182],{},"Promise\u003CUser | null>",[969,1184,1185],{},"The local user of a Stripe customer id.",[948,1187,1188,1193,1198],{},[969,1189,1190],{},[607,1191,1192],{},"onStripeEvent(type, handler)",[969,1194,1195],{},[607,1196,1197],{},"void",[969,1199,1200,1201,630],{},"Listens to events at runtime. See ",[597,1202,1204],{"href":1203},"#in-your-app","In your app",[948,1206,1207,1212,1215],{},[969,1208,1209],{},[607,1210,1211],{},"defineStripeEventHandler(handler)",[969,1213,1214],{},"handler",[969,1216,1217],{},"Types a handler file.",[593,1219,1220,1224,1225,1228],{},[623,1221,1222],{},[607,1223,1144],{}," throws ",[607,1226,1227],{},"501 not_configured"," when the secret key is missing.",[593,1230,1231,1236,1237,630],{},[623,1232,1233],{},[607,1234,1235],{},"ensureStripeCustomer"," first reads the stored id, then searches Stripe by email, then creates a customer and stores\nit. Concurrent calls end up with one id. An unknown user throws ",[607,1238,1239],{},"404",[593,1241,1242,1245,1246,1249,1250,652,1253,1256,1257,1260,1261,630],{},[607,1243,1244],{},"@frigear-nu\u002Fstripe\u002Futils"," exports ",[607,1247,1248],{},"registerStripeEventHandler",", ",[607,1251,1252],{},"onStripeEvent",[607,1254,1255],{},"defineStripeEventHandler",", and\nruns outside Nuxt as well. Module authors who send people to Stripe validate return URLs with\n",[607,1258,1259],{},"resolveSameOriginUrl(event, url, { fallback, name })"," from ",[607,1262,1263],{},"@frigear-nu\u002Fmodule-kit\u002Fserver",[682,1265,1267],{"id":1266},"listen-to-events","Listen to events",[593,1269,1270],{},"Register a handler at build time from a module, or at runtime from your app.",[687,1272,1274],{"className":720,"code":1273,"language":723,"meta":692,"style":692},"type StripeEventHandlerContext = {\n  stripe: Stripe          \u002F\u002F the useStripe() instance\n  userId: number | null   \u002F\u002F local user owning the event's customer, null if unknown\n  event: H3Event          \u002F\u002F the Nitro event of the webhook request\n}\n\ntype StripeEventHandler\u003CT extends StripeEventType = StripeEventType> = (\n  event: StripeEventOf\u003CT>,\n  ctx: StripeEventHandlerContext,\n) => void | Promise\u003Cvoid>\n\n\u002F\u002F Build time, from a module's setup()\nregisterStripeEventHandler(nuxt: Nuxt, options: {\n  events: string[] | '*'  \u002F\u002F Stripe event types, or '*' for every event\n  handler: string         \u002F\u002F absolute path to a file whose default export is a defineStripeEventHandler(...) result\n  order?: number          \u002F\u002F lower runs first, default 100\n}): void\n\n\u002F\u002F Runtime, from a Nitro plugin\nonStripeEvent\u003CT extends StripeEventType>(\n  type: T | T[] | '*',\n  handler: StripeEventHandler\u003CT>,\n): void\n",[607,1275,1276,1291,1304,1323,1336,1342,1349,1381,1399,1412,1436,1441,1447,1471,1498,1511,1525,1534,1539,1545,1561,1588,1603],{"__ignoreMap":692},[696,1277,1278,1282,1285,1288],{"class":698,"line":699},[696,1279,1281],{"class":1280},"spNyl","type",[696,1283,1284],{"class":702}," StripeEventHandlerContext",[696,1286,1287],{"class":745}," =",[696,1289,1290],{"class":745}," {\n",[696,1292,1293,1296,1298,1301],{"class":698,"line":749},[696,1294,1295],{"class":752},"  stripe",[696,1297,756],{"class":745},[696,1299,1300],{"class":702}," Stripe",[696,1302,1303],{"class":784},"          \u002F\u002F the useStripe() instance\n",[696,1305,1306,1309,1311,1314,1317,1320],{"class":698,"line":788},[696,1307,1308],{"class":752},"  userId",[696,1310,756],{"class":745},[696,1312,1313],{"class":702}," number",[696,1315,1316],{"class":745}," |",[696,1318,1319],{"class":702}," null",[696,1321,1322],{"class":784},"   \u002F\u002F local user owning the event's customer, null if unknown\n",[696,1324,1325,1328,1330,1333],{"class":698,"line":847},[696,1326,1327],{"class":752},"  event",[696,1329,756],{"class":745},[696,1331,1332],{"class":702}," H3Event",[696,1334,1335],{"class":784},"          \u002F\u002F the Nitro event of the webhook request\n",[696,1337,1339],{"class":698,"line":1338},5,[696,1340,1341],{"class":745},"}\n",[696,1343,1345],{"class":698,"line":1344},6,[696,1346,1348],{"emptyLinePlaceholder":1347},true,"\n",[696,1350,1352,1354,1357,1360,1363,1366,1369,1371,1373,1376,1378],{"class":698,"line":1351},7,[696,1353,1281],{"class":1280},[696,1355,1356],{"class":702}," StripeEventHandler",[696,1358,1359],{"class":745},"\u003C",[696,1361,1362],{"class":702},"T",[696,1364,1365],{"class":1280}," extends",[696,1367,1368],{"class":702}," StripeEventType",[696,1370,1287],{"class":745},[696,1372,1368],{"class":702},[696,1374,1375],{"class":745},">",[696,1377,1287],{"class":745},[696,1379,1380],{"class":741}," (\n",[696,1382,1384,1387,1389,1392,1394,1396],{"class":698,"line":1383},8,[696,1385,1327],{"class":1386},"sHdIc",[696,1388,756],{"class":745},[696,1390,1391],{"class":702}," StripeEventOf",[696,1393,1359],{"class":745},[696,1395,1362],{"class":702},[696,1397,1398],{"class":745},">,\n",[696,1400,1402,1405,1407,1409],{"class":698,"line":1401},9,[696,1403,1404],{"class":1386},"  ctx",[696,1406,756],{"class":745},[696,1408,1284],{"class":702},[696,1410,1411],{"class":745},",\n",[696,1413,1415,1418,1421,1424,1426,1429,1431,1433],{"class":698,"line":1414},10,[696,1416,1417],{"class":741},") ",[696,1419,1420],{"class":1280},"=>",[696,1422,1423],{"class":702}," void",[696,1425,1316],{"class":745},[696,1427,1428],{"class":702}," Promise",[696,1430,1359],{"class":745},[696,1432,1197],{"class":702},[696,1434,1435],{"class":745},">\n",[696,1437,1439],{"class":698,"line":1438},11,[696,1440,1348],{"emptyLinePlaceholder":1347},[696,1442,1444],{"class":698,"line":1443},12,[696,1445,1446],{"class":784},"\u002F\u002F Build time, from a module's setup()\n",[696,1448,1450,1452,1454,1457,1459,1462,1464,1467,1469],{"class":698,"line":1449},13,[696,1451,1248],{"class":702},[696,1453,742],{"class":745},[696,1455,1456],{"class":1386},"nuxt",[696,1458,756],{"class":745},[696,1460,1461],{"class":702}," Nuxt",[696,1463,769],{"class":745},[696,1465,1466],{"class":1386}," options",[696,1468,756],{"class":745},[696,1470,1290],{"class":745},[696,1472,1474,1477,1479,1482,1485,1488,1490,1493,1495],{"class":698,"line":1473},14,[696,1475,1476],{"class":752},"  events",[696,1478,756],{"class":745},[696,1480,1481],{"class":702}," string",[696,1483,1484],{"class":741},"[] ",[696,1486,1487],{"class":745},"|",[696,1489,772],{"class":745},[696,1491,1492],{"class":706},"*",[696,1494,762],{"class":745},[696,1496,1497],{"class":784},"  \u002F\u002F Stripe event types, or '*' for every event\n",[696,1499,1501,1504,1506,1508],{"class":698,"line":1500},15,[696,1502,1503],{"class":752},"  handler",[696,1505,756],{"class":745},[696,1507,1481],{"class":702},[696,1509,1510],{"class":784},"         \u002F\u002F absolute path to a file whose default export is a defineStripeEventHandler(...) result\n",[696,1512,1514,1517,1520,1522],{"class":698,"line":1513},16,[696,1515,1516],{"class":752},"  order",[696,1518,1519],{"class":745},"?:",[696,1521,1313],{"class":702},[696,1523,1524],{"class":784},"          \u002F\u002F lower runs first, default 100\n",[696,1526,1528,1531],{"class":698,"line":1527},17,[696,1529,1530],{"class":745},"}):",[696,1532,1533],{"class":702}," void\n",[696,1535,1537],{"class":698,"line":1536},18,[696,1538,1348],{"emptyLinePlaceholder":1347},[696,1540,1542],{"class":698,"line":1541},19,[696,1543,1544],{"class":784},"\u002F\u002F Runtime, from a Nitro plugin\n",[696,1546,1548,1550,1552,1554,1556,1558],{"class":698,"line":1547},20,[696,1549,1252],{"class":702},[696,1551,1359],{"class":745},[696,1553,1362],{"class":702},[696,1555,1365],{"class":1280},[696,1557,1368],{"class":702},[696,1559,1560],{"class":741},">(\n",[696,1562,1564,1567,1569,1572,1574,1576,1578,1580,1582,1584,1586],{"class":698,"line":1563},21,[696,1565,1566],{"class":1386},"  type",[696,1568,756],{"class":745},[696,1570,1571],{"class":702}," T",[696,1573,1316],{"class":745},[696,1575,1571],{"class":702},[696,1577,1484],{"class":741},[696,1579,1487],{"class":745},[696,1581,772],{"class":745},[696,1583,1492],{"class":706},[696,1585,762],{"class":745},[696,1587,1411],{"class":745},[696,1589,1591,1593,1595,1597,1599,1601],{"class":698,"line":1590},22,[696,1592,1503],{"class":1386},[696,1594,756],{"class":745},[696,1596,1356],{"class":702},[696,1598,1359],{"class":745},[696,1600,1362],{"class":702},[696,1602,1398],{"class":745},[696,1604,1606,1609,1611],{"class":698,"line":1605},23,[696,1607,1608],{"class":741},")",[696,1610,756],{"class":745},[696,1612,1533],{"class":702},[682,1614,1616],{"id":1615},"in-a-module","In a module",[593,1618,1619,1620,756],{},"A module registers a handler file from ",[607,1621,1622],{},"setup()",[687,1624,1626],{"className":720,"code":1625,"language":723,"meta":692,"style":692},"import { createResolver, defineNuxtModule } from '@nuxt\u002Fkit'\nimport { registerStripeEventHandler } from '@frigear-nu\u002Fstripe\u002Futils'\n\nexport default defineNuxtModule({\n  meta: { name: '@frigear-nu\u002Fexample' },\n  setup(options, nuxt) {\n    const resolver = createResolver(import.meta.url)\n    registerStripeEventHandler(nuxt, {\n      events: ['customer.subscription.updated', 'checkout.session.completed'],\n      handler: resolver.resolve('.\u002Fruntime\u002Fserver\u002Fstripe\u002Fexample-events'),\n      order: 10,\n    })\n  },\n})\n",[607,1627,1628,1657,1676,1680,1692,1715,1733,1761,1774,1803,1830,1843,1850,1855],{"__ignoreMap":692},[696,1629,1630,1633,1635,1638,1640,1643,1646,1649,1651,1654],{"class":698,"line":699},[696,1631,1632],{"class":730},"import",[696,1634,796],{"class":745},[696,1636,1637],{"class":741}," createResolver",[696,1639,769],{"class":745},[696,1641,1642],{"class":741}," defineNuxtModule",[696,1644,1645],{"class":745}," }",[696,1647,1648],{"class":730}," from",[696,1650,772],{"class":745},[696,1652,1653],{"class":706},"@nuxt\u002Fkit",[696,1655,1656],{"class":745},"'\n",[696,1658,1659,1661,1663,1666,1668,1670,1672,1674],{"class":698,"line":749},[696,1660,1632],{"class":730},[696,1662,796],{"class":745},[696,1664,1665],{"class":741}," registerStripeEventHandler",[696,1667,1645],{"class":745},[696,1669,1648],{"class":730},[696,1671,772],{"class":745},[696,1673,1244],{"class":706},[696,1675,1656],{"class":745},[696,1677,1678],{"class":698,"line":788},[696,1679,1348],{"emptyLinePlaceholder":1347},[696,1681,1682,1684,1686,1688,1690],{"class":698,"line":847},[696,1683,731],{"class":730},[696,1685,734],{"class":730},[696,1687,1642],{"class":737},[696,1689,742],{"class":741},[696,1691,746],{"class":745},[696,1693,1694,1697,1699,1701,1704,1706,1708,1711,1713],{"class":698,"line":1338},[696,1695,1696],{"class":752},"  meta",[696,1698,756],{"class":745},[696,1700,796],{"class":745},[696,1702,1703],{"class":752}," name",[696,1705,756],{"class":745},[696,1707,772],{"class":745},[696,1709,1710],{"class":706},"@frigear-nu\u002Fexample",[696,1712,762],{"class":745},[696,1714,844],{"class":745},[696,1716,1717,1720,1722,1724,1726,1729,1731],{"class":698,"line":1344},[696,1718,1719],{"class":752},"  setup",[696,1721,742],{"class":745},[696,1723,932],{"class":1386},[696,1725,769],{"class":745},[696,1727,1728],{"class":1386}," nuxt",[696,1730,1608],{"class":745},[696,1732,1290],{"class":745},[696,1734,1735,1738,1741,1743,1745,1747,1749,1751,1754,1756,1759],{"class":698,"line":1351},[696,1736,1737],{"class":1280},"    const",[696,1739,1740],{"class":741}," resolver",[696,1742,1287],{"class":745},[696,1744,1637],{"class":737},[696,1746,742],{"class":752},[696,1748,1632],{"class":730},[696,1750,630],{"class":745},[696,1752,1753],{"class":741},"meta",[696,1755,630],{"class":745},[696,1757,1758],{"class":741},"url",[696,1760,853],{"class":752},[696,1762,1763,1766,1768,1770,1772],{"class":698,"line":1383},[696,1764,1765],{"class":737},"    registerStripeEventHandler",[696,1767,742],{"class":752},[696,1769,1456],{"class":741},[696,1771,769],{"class":745},[696,1773,1290],{"class":745},[696,1775,1776,1779,1781,1783,1785,1788,1790,1792,1794,1797,1799,1801],{"class":698,"line":1401},[696,1777,1778],{"class":752},"      events",[696,1780,756],{"class":745},[696,1782,759],{"class":752},[696,1784,762],{"class":745},[696,1786,1787],{"class":706},"customer.subscription.updated",[696,1789,762],{"class":745},[696,1791,769],{"class":745},[696,1793,772],{"class":745},[696,1795,1796],{"class":706},"checkout.session.completed",[696,1798,762],{"class":745},[696,1800,779],{"class":752},[696,1802,1411],{"class":745},[696,1804,1805,1808,1810,1812,1814,1817,1819,1821,1824,1826,1828],{"class":698,"line":1414},[696,1806,1807],{"class":752},"      handler",[696,1809,756],{"class":745},[696,1811,1740],{"class":741},[696,1813,630],{"class":745},[696,1815,1816],{"class":737},"resolve",[696,1818,742],{"class":752},[696,1820,762],{"class":745},[696,1822,1823],{"class":706},".\u002Fruntime\u002Fserver\u002Fstripe\u002Fexample-events",[696,1825,762],{"class":745},[696,1827,1608],{"class":752},[696,1829,1411],{"class":745},[696,1831,1832,1835,1837,1841],{"class":698,"line":1438},[696,1833,1834],{"class":752},"      order",[696,1836,756],{"class":745},[696,1838,1840],{"class":1839},"sbssI"," 10",[696,1842,1411],{"class":745},[696,1844,1845,1848],{"class":698,"line":1443},[696,1846,1847],{"class":745},"    }",[696,1849,853],{"class":752},[696,1851,1852],{"class":698,"line":1449},[696,1853,1854],{"class":745},"  },\n",[696,1856,1857,1859],{"class":698,"line":1473},[696,1858,850],{"class":745},[696,1860,853],{"class":741},[687,1862,1865],{"className":720,"code":1863,"filename":1864,"language":723,"meta":692,"style":692},"import { defineStripeEventHandler } from '@frigear-nu\u002Fstripe\u002Futils'\n\nexport default defineStripeEventHandler\u003C'customer.subscription.updated' | 'checkout.session.completed'>(\n  async (event, { stripe, userId }) => {\n    \u002F\u002F `event` is narrowed to the generic's event types. Must be idempotent.\n    if (!userId) return\n  },\n)\n","runtime\u002Fserver\u002Fstripe\u002Fexample-events.ts",[607,1866,1867,1886,1890,1919,1950,1955,1973,1977],{"__ignoreMap":692},[696,1868,1869,1871,1873,1876,1878,1880,1882,1884],{"class":698,"line":699},[696,1870,1632],{"class":730},[696,1872,796],{"class":745},[696,1874,1875],{"class":741}," defineStripeEventHandler",[696,1877,1645],{"class":745},[696,1879,1648],{"class":730},[696,1881,772],{"class":745},[696,1883,1244],{"class":706},[696,1885,1656],{"class":745},[696,1887,1888],{"class":698,"line":749},[696,1889,1348],{"emptyLinePlaceholder":1347},[696,1891,1892,1894,1896,1898,1900,1902,1904,1906,1908,1910,1912,1914,1916],{"class":698,"line":788},[696,1893,731],{"class":730},[696,1895,734],{"class":730},[696,1897,1875],{"class":737},[696,1899,1359],{"class":745},[696,1901,762],{"class":745},[696,1903,1787],{"class":706},[696,1905,762],{"class":745},[696,1907,1316],{"class":745},[696,1909,772],{"class":745},[696,1911,1796],{"class":706},[696,1913,762],{"class":745},[696,1915,1375],{"class":745},[696,1917,1918],{"class":741},"(\n",[696,1920,1921,1924,1927,1930,1932,1934,1937,1939,1942,1945,1948],{"class":698,"line":847},[696,1922,1923],{"class":1280},"  async",[696,1925,1926],{"class":745}," (",[696,1928,1929],{"class":1386},"event",[696,1931,769],{"class":745},[696,1933,796],{"class":745},[696,1935,1936],{"class":1386}," stripe",[696,1938,769],{"class":745},[696,1940,1941],{"class":1386}," userId",[696,1943,1944],{"class":745}," })",[696,1946,1947],{"class":1280}," =>",[696,1949,1290],{"class":745},[696,1951,1952],{"class":698,"line":1338},[696,1953,1954],{"class":784},"    \u002F\u002F `event` is narrowed to the generic's event types. Must be idempotent.\n",[696,1956,1957,1960,1962,1965,1968,1970],{"class":698,"line":1344},[696,1958,1959],{"class":730},"    if",[696,1961,1926],{"class":752},[696,1963,1964],{"class":745},"!",[696,1966,1967],{"class":741},"userId",[696,1969,1417],{"class":752},[696,1971,1972],{"class":730},"return\n",[696,1974,1975],{"class":698,"line":1351},[696,1976,1854],{"class":745},[696,1978,1979],{"class":698,"line":1383},[696,1980,853],{"class":741},[593,1982,1983,1984,1987,1988,1990],{},"Handler files are bundled into ",[607,1985,1986],{},"#stripe\u002Fhandlers"," after every module's ",[607,1989,1622],{},", so the registration order does not\nmatter.",[682,1992,1204],{"id":1993},"in-your-app",[687,1995,1998],{"className":720,"code":1996,"filename":1997,"language":723,"meta":692,"style":692},"export default defineNitroPlugin(() => {\n  onStripeEvent('invoice.payment_failed', async (event, ctx) => {\n    \u002F\u002F notify the user, flag the account, ...\n  })\n})\n","server\u002Fplugins\u002Fstripe.ts",[607,1999,2000,2018,2052,2057,2064],{"__ignoreMap":692},[696,2001,2002,2004,2006,2009,2011,2014,2016],{"class":698,"line":699},[696,2003,731],{"class":730},[696,2005,734],{"class":730},[696,2007,2008],{"class":737}," defineNitroPlugin",[696,2010,742],{"class":741},[696,2012,2013],{"class":745},"()",[696,2015,1947],{"class":1280},[696,2017,1290],{"class":745},[696,2019,2020,2023,2025,2027,2030,2032,2034,2037,2039,2041,2043,2046,2048,2050],{"class":698,"line":749},[696,2021,2022],{"class":737},"  onStripeEvent",[696,2024,742],{"class":752},[696,2026,762],{"class":745},[696,2028,2029],{"class":706},"invoice.payment_failed",[696,2031,762],{"class":745},[696,2033,769],{"class":745},[696,2035,2036],{"class":1280}," async",[696,2038,1926],{"class":745},[696,2040,1929],{"class":1386},[696,2042,769],{"class":745},[696,2044,2045],{"class":1386}," ctx",[696,2047,1608],{"class":745},[696,2049,1947],{"class":1280},[696,2051,1290],{"class":745},[696,2053,2054],{"class":698,"line":788},[696,2055,2056],{"class":784},"    \u002F\u002F notify the user, flag the account, ...\n",[696,2058,2059,2062],{"class":698,"line":847},[696,2060,2061],{"class":745},"  }",[696,2063,853],{"class":752},[696,2065,2066,2068],{"class":698,"line":1338},[696,2067,850],{"class":745},[696,2069,853],{"class":741},[593,2071,2072,2073,2076],{},"Runtime handlers have order ",[607,2074,2075],{},"100",". They run after build-time handlers of the same order.",[682,2078,2080],{"id":2079},"delivery-and-retries","Delivery and retries",[617,2082,2083,2090,2093,2100],{},[620,2084,2085,2086,2089],{},"Matching handlers run one after another, sorted by ",[607,2087,2088],{},"order",". Handlers of equal order keep their registration order.",[620,2091,2092],{},"An error in one handler is logged, and the others still run.",[620,2094,2095,2096,2099],{},"If any handler throws, the webhook answers ",[607,2097,2098],{},"500"," and Stripe retries the whole event. So every handler must be\nidempotent.",[620,2101,2102,2103,2106],{},"The event id is stored in KV, under ",[607,2104,2105],{},"stripe:event:\u003Cevent id>"," for 7 days, only after all handlers succeed. A\nduplicate delivery is then acknowledged without running them again.",[612,2108,234],{"id":2109},"hooks",[593,2111,2112,2113,1012],{},"Your app can also answer this Nitro hook from a server plugin (",[607,2114,2115],{},"server\u002Fplugins\u002F*.ts",[942,2117,2118,2131],{},[945,2119,2120],{},[948,2121,2122,2125,2128],{},[951,2123,2124],{},"Hook",[951,2126,2127],{},"When",[951,2129,2130],{},"Payload",[964,2132,2133],{},[948,2134,2135,2140,2143],{},[969,2136,2137],{},[607,2138,2139],{},"stripe:event",[969,2141,2142],{},"After the handlers of every verified, new event ran, also when they failed.",[969,2144,2145],{},[607,2146,2147],{},"(event: Stripe.Event, ctx: StripeEventHandlerContext)",[593,2149,2150,2151,2153],{},"Errors in ",[607,2152,2139],{}," are logged and never fail the webhook.",[612,2155,2157],{"id":2156},"routes","Routes",[593,2159,2160],{},"Routes the module registers, and who may call them.",[942,2162,2163,2177],{},[945,2164,2165],{},[948,2166,2167,2170,2173,2175],{},[951,2168,2169],{},"Method",[951,2171,2172],{},"Path",[951,2174,168],{},[951,2176,962],{},[964,2178,2179],{},[948,2180,2181,2186,2192,2195],{},[969,2182,2183],{},[607,2184,2185],{},"POST",[969,2187,2188,1926,2190,1608],{},[607,2189,629],{},[607,2191,973],{},[969,2193,2194],{},"none, Stripe signature",[969,2196,2197],{},"Verifies the event and passes it to the handlers.",[859,2199,2200,2201,630],{},"Put no auth or CSRF middleware in front of this route: it verifies the raw body with ",[607,2202,2203],{},"constructEventAsync",[942,2205,2206,2215],{},[945,2207,2208],{},[948,2209,2210,2213],{},[951,2211,2212],{},"Status",[951,2214,2127],{},[964,2216,2217,2233,2247,2258],{},[948,2218,2219,2223],{},[969,2220,2221],{},[607,2222,929],{},[969,2224,2225,2228,2229,2232],{},[607,2226,2227],{},"{ received: true }",", or ",[607,2230,2231],{},"{ received: true, duplicate: true }"," for an event id already processed.",[948,2234,2235,2240],{},[969,2236,2237],{},[607,2238,2239],{},"400 bad_request",[969,2241,2242,2243,2246],{},"The ",[607,2244,2245],{},"stripe-signature"," header or the body is missing, or the signature is invalid.",[948,2248,2249,2253],{},[969,2250,2251],{},[607,2252,1227],{},[969,2254,2255,2257],{},[607,2256,1068],{}," is not set.",[948,2259,2260,2265],{},[969,2261,2262],{},[607,2263,2264],{},"500 handler_failed",[969,2266,2267],{},"At least one handler threw, and Stripe will retry.",[612,2269,41],{"id":2270},"database",[593,2272,2273,2274,2277],{},"Tables the module adds. Generate and commit a ",[597,2275,864],{"href":2276},"\u002Fget-started\u002Fdatabase#migrations"," after installing.",[593,2279,2280,2281,2285,2286,2289,2290,1926,2293,2295,2296,630],{},"The module adds one nullable column to ",[597,2282,2283],{"href":192},[607,2284,868],{},", through a\n",[597,2287,2288],{"href":78},"database extension",": ",[607,2291,2292],{},"stripeCustomerId",[607,2294,872],{},"). Do not add it to\nyour own ",[607,2297,2298],{},"server\u002Fdb\u002Fextend.sqlite.ts",[612,2300,2302],{"id":2301},"next-steps","Next steps",[617,2304,2305,2310],{},[620,2306,2307,2309],{},[597,2308,146],{"href":147}," – connect your Stripe account and pick the webhook events.",[620,2311,2312,2314],{},[597,2313,490],{"href":491}," – follow one payment from checkout to a webhook event.",[2316,2317,2318],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":692,"searchDepth":749,"depth":749,"links":2320},[2321,2322,2328,2331,2337,2338,2339,2340],{"id":614,"depth":749,"text":615},{"id":676,"depth":749,"text":677,"children":2323},[2324,2325,2326,2327],{"id":684,"depth":788,"text":685},{"id":716,"depth":788,"text":717},{"id":856,"depth":788,"text":857},{"id":902,"depth":788,"text":903},{"id":932,"depth":749,"text":933,"children":2329},[2330],{"id":1015,"depth":788,"text":1016},{"id":1113,"depth":749,"text":1114,"children":2332},[2333,2334,2335,2336],{"id":1266,"depth":788,"text":1267},{"id":1615,"depth":788,"text":1616},{"id":1993,"depth":788,"text":1204},{"id":2079,"depth":788,"text":2080},{"id":2109,"depth":749,"text":234},{"id":2156,"depth":749,"text":2157},{"id":2270,"depth":749,"text":41},{"id":2301,"depth":749,"text":2302},"Gives your app one verified Stripe webhook and a Stripe customer per user, for Payments and Subscriptions.","md",null,{},{"title":250,"description":2341},"X-RvqIvxLg6qVOvGHE0vKO_qGz_bYeTkH68mS66o_wk",[2348,2350],{"title":241,"path":242,"stem":243,"description":2349,"children":-1},"Let a separate service accept the access tokens of an issuer, so one mobile app signs in once and calls every service.",{"title":254,"path":255,"stem":256,"description":2351,"children":-1},"Charge a signed-in user once through Stripe Checkout, and hear through a hook when the money arrives.",1794503148329]