API
diff --git a/api/module-options.html b/api/module-options.html index 471e670..b2d6ea8 100644 --- a/api/module-options.html +++ b/api/module-options.html @@ -4,8 +4,8 @@Module Options
diff --git a/api/service-interface.html b/api/service-interface.html index b9fed12..e01f0fd 100644 --- a/api/service-interface.html +++ b/api/service-interface.html @@ -4,8 +4,8 @@Service Interface
diff --git a/assets/js/2d4cceda.5696927d.js b/assets/js/2d4cceda.5696927d.js new file mode 100644 index 0000000..7dbc107 --- /dev/null +++ b/assets/js/2d4cceda.5696927d.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunknestjs_cls_docs=self.webpackChunknestjs_cls_docs||[]).push([[285],{2599:(e,n,t)=>{t.d(n,{Z:()=>i});t(7378);var a=t(624);const s={tabItem:"tabItem_wHwb"};var r=t(4246);function i(e){let{children:n,hidden:t,className:i}=e;return(0,r.jsx)("div",{role:"tabpanel",className:(0,a.Z)(s.tabItem,i),hidden:t,children:n})}},8447:(e,n,t)=>{t.d(n,{Z:()=>w});var a=t(7378),s=t(624),r=t(9169),i=t(3620),l=t(9749),o=t(8981),c=t(56),u=t(8796);function d(e){return a.Children.toArray(e).filter((e=>"\n"!==e)).map((e=>{if(!e||(0,a.isValidElement)(e)&&function(e){const{props:n}=e;return!!n&&"object"==typeof n&&"value"in n}(e))return e;throw new Error(`Docusaurus error: BadTransactionHost
",id:"using-the-transactionhost",level:3},{value:"Using the @Transactional
decorator",id:"using-the-transactional-decorator",level:3},{value:"Using the @InjectTransaction
decorator",id:"using-the-injecttransaction-decorator",level:3},{value:"Passing transaction options",id:"passing-transaction-options",level:3},{value:"Transaction propagation",id:"transaction-propagation",level:3},{value:"ClsPluginTransactional Interface",id:"clsplugintransactional-interface",level:2},{value:"TransactionHost Interface",id:"transactionhost-interface",level:2},{value:"Transactional decorator interface",id:"transactional-decorator-interface",level:3},{value:"Multiple databases",id:"multiple-databases",level:2},{value:"Registration",id:"registration",level:3},{value:"Usage",id:"usage",level:3}];function u(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"nestjs-clstransactional",children:"@nestjs-cls/transactional"}),"\n",(0,a.jsxs)(n.p,{children:["The ",(0,a.jsx)(n.em,{children:"Transactional"})," plugin for ",(0,a.jsx)(n.code,{children:"nestjs-cls"})," provides a generic interface that can be used to wrap any function call in\na CLS-enabled transaction by storing the transaction reference in the CLS context."]}),"\n",(0,a.jsx)(n.p,{children:"The transaction reference can be then retrieved in any other service and refer to the same transaction without having to pass it around."}),"\n",(0,a.jsxs)(n.p,{children:["The plugin is designed to be database-agnostic and can be used with any database library that supports transactions (via adapters). At the expense of using a ",(0,a.jsx)(n.a,{href:"#using-the-transactionhost",children:"minimal wrapper"}),", it deliberately ",(0,a.jsx)(n.strong,{children:"does not require any monkey-patching"})," of the underlying library."]}),"\n",(0,a.jsx)(n.h2,{id:"installation",children:"Installation"}),"\n",(0,a.jsxs)(r.Z,{children:[(0,a.jsx)(i.Z,{value:"npm",label:"npm",default:!0,children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"npm install @nestjs-cls/transactional\n"})})}),(0,a.jsx)(i.Z,{value:"yarn",label:"yarn",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"yarn add @nestjs-cls/transactional\n"})})}),(0,a.jsx)(i.Z,{value:"pnpm",label:"pnpm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"pnpm add @nestjs-cls/transactional\n"})})})]}),"\n",(0,a.jsx)(n.p,{children:"The plugin works in conjunction with various adapters that provide the actual transactional logic and types for the underlying database library, so you'll need to install one of those as well."}),"\n",(0,a.jsx)(n.p,{children:"Adapters for the following libraries are available:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:["Prisma (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter",children:"@nestjs-cls/transactional-adapter-prisma"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Knex (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/knex-adapter",children:"@nestjs-cls/transactional-adapter-knex"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Kysely (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/kysely-adapter",children:"@nestjs-cls/transactional-adapter-knex"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Pg-promise (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/pg-promise-adapter",children:"@nestjs-cls/transactional-adapter-pg-promise"}),")"]}),"\n"]}),"\n",(0,a.jsxs)(n.p,{children:["Adapters ",(0,a.jsx)(n.em,{children:"will not"})," be implemented for the following libraries:"]}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:["TypeORM (since a more fully-featured ",(0,a.jsx)(n.a,{href:"https://github.com/Aliheym/typeorm-transactional",children:"community package already exists"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Sequelize (since it already includes a ",(0,a.jsx)(n.a,{href:"https://sequelize.org/docs/v6/other-topics/transactions/#automatically-pass-transactions-to-all-queries",children:"built-in CLS-enabled transaction support"}),")"]}),"\n"]}),"\n",(0,a.jsx)(n.h2,{id:"example",children:"Example"}),"\n",(0,a.jsxs)(n.p,{children:["For this example, we'll use the ",(0,a.jsx)(n.code,{children:"prisma"})," library and the ",(0,a.jsxs)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter",children:[(0,a.jsx)(n.code,{children:"@nestjs-cls/transactional-adapter-prisma"})," adapter"]}),". Later, you'll learn how to ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/creating-custom-adapter",children:"create your own adapter"}),"."]}),"\n",(0,a.jsxs)(n.p,{children:["Suppose we already have a ",(0,a.jsx)(n.code,{children:"PrismaModule"})," which provides a ",(0,a.jsx)(n.code,{children:"PrismaClient"})," instance and two other services ",(0,a.jsx)(n.code,{children:"UserService"})," and ",(0,a.jsx)(n.code,{children:"AccountService"})," which we'd like to make transactional."]}),"\n",(0,a.jsx)(n.h3,{id:"plugin-registration",children:"Plugin registration"}),"\n",(0,a.jsxs)(n.p,{children:["To add register the transactional plugin with ",(0,a.jsx)(n.code,{children:"nestjs-cls"}),", we need to pass it to the ",(0,a.jsx)(n.code,{children:"forRoot"})," method of the ",(0,a.jsx)(n.code,{children:"ClsModule"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-ts",metastring:'title="app.module.ts"',children:"import { ClsModule } from 'nestjs-cls';\nimport { ClsPluginTransactional } from '@nestjs-cls/transactional';\nimport { TransactionalAdapterPrisma } from '@nestjs-cls/transactional-adapter-prisma';\n// ... other imports\n\n@Module({\n imports: [\n PrismaModule,\n ClsModule.forRoot({\n plugins: [\n // highlight-start\n new ClsPluginTransactional({\n // if PrismaModule is not global, we need to make it available to the plugin\n imports: [PrismaModule],\n adapter: new TransactionalAdapterPrisma({\n // each adapter has its own options, see the adapter docs for more info\n prismaInjectionToken: PrismaClient,\n }),\n }),\n // highlight-end\n ],\n }),\n ],\n providers: [UserService, AccountService],\n})\nexport class AppModule {}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["This registers a ",(0,a.jsx)(n.code,{children:"TransactionHost"})," provider in the global context which can be used to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.h3,{id:"using-the-transactionhost",children:["Using the ",(0,a.jsx)(n.code,{children:"TransactionHost"})]}),"\n",(0,a.jsxs)(n.p,{children:["Now that we have the plugin registered, we can use the ",(0,a.jsx)(n.code,{children:"TransactionHost"})," to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.p,{children:["Suppose that any time we create an ",(0,a.jsx)(n.code,{children:"User"}),", we want to create an ",(0,a.jsx)(n.code,{children:"Account"})," for them as well and both operations must either succeed or fail. We can use the ",(0,a.jsx)(n.code,{children:"TransactionHost"})," to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.p,{children:["The type argument on the ",(0,a.jsx)(n.code,{children:"TransactionHostTransactionHost
",id:"using-the-transactionhost",level:3},{value:"Using the @Transactional
decorator",id:"using-the-transactional-decorator",level:3},{value:"Using the @InjectTransaction
decorator",id:"using-the-injecttransaction-decorator",level:3},{value:"Passing transaction options",id:"passing-transaction-options",level:3},{value:"Transaction propagation",id:"transaction-propagation",level:3},{value:"ClsPluginTransactional Interface",id:"clsplugintransactional-interface",level:2},{value:"TransactionHost Interface",id:"transactionhost-interface",level:2},{value:"Transactional decorator interface",id:"transactional-decorator-interface",level:3},{value:"Multiple databases",id:"multiple-databases",level:2},{value:"Registration",id:"registration",level:3},{value:"Usage",id:"usage",level:3}];function u(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"nestjs-clstransactional",children:"@nestjs-cls/transactional"}),"\n",(0,a.jsxs)(n.p,{children:["The ",(0,a.jsx)(n.em,{children:"Transactional"})," plugin for ",(0,a.jsx)(n.code,{children:"nestjs-cls"})," provides a generic interface that can be used to wrap any function call in\na CLS-enabled transaction by storing the transaction reference in the CLS context."]}),"\n",(0,a.jsx)(n.p,{children:"The transaction reference can be then retrieved in any other service and refer to the same transaction without having to pass it around."}),"\n",(0,a.jsxs)(n.p,{children:["The plugin is designed to be database-agnostic and can be used with any database library that supports transactions (via adapters). At the expense of using a ",(0,a.jsx)(n.a,{href:"#using-the-transactionhost",children:"minimal wrapper"}),", it deliberately ",(0,a.jsx)(n.strong,{children:"does not require any monkey-patching"})," of the underlying library."]}),"\n",(0,a.jsx)(n.h2,{id:"installation",children:"Installation"}),"\n",(0,a.jsxs)(r.Z,{children:[(0,a.jsx)(i.Z,{value:"npm",label:"npm",default:!0,children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"npm install @nestjs-cls/transactional\n"})})}),(0,a.jsx)(i.Z,{value:"yarn",label:"yarn",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"yarn add @nestjs-cls/transactional\n"})})}),(0,a.jsx)(i.Z,{value:"pnpm",label:"pnpm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"pnpm add @nestjs-cls/transactional\n"})})})]}),"\n",(0,a.jsx)(n.p,{children:"The plugin works in conjunction with various adapters that provide the actual transactional logic and types for the underlying database library, so you'll need to install one of those as well."}),"\n",(0,a.jsx)(n.p,{children:"Adapters for the following libraries are available:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:["Prisma (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter",children:"@nestjs-cls/transactional-adapter-prisma"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Knex (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/knex-adapter",children:"@nestjs-cls/transactional-adapter-knex"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Kysely (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/kysely-adapter",children:"@nestjs-cls/transactional-adapter-knex"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Pg-promise (see ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/pg-promise-adapter",children:"@nestjs-cls/transactional-adapter-pg-promise"}),")"]}),"\n"]}),"\n",(0,a.jsxs)(n.p,{children:["Adapters ",(0,a.jsx)(n.em,{children:"will not"})," be implemented for the following libraries:"]}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:["TypeORM (since a more fully-featured ",(0,a.jsx)(n.a,{href:"https://github.com/Aliheym/typeorm-transactional",children:"community package already exists"}),")"]}),"\n",(0,a.jsxs)(n.li,{children:["Sequelize (since it already includes a ",(0,a.jsx)(n.a,{href:"https://sequelize.org/docs/v6/other-topics/transactions/#automatically-pass-transactions-to-all-queries",children:"built-in CLS-enabled transaction support"}),")"]}),"\n"]}),"\n",(0,a.jsx)(n.h2,{id:"example",children:"Example"}),"\n",(0,a.jsxs)(n.p,{children:["For this example, we'll use the ",(0,a.jsx)(n.code,{children:"prisma"})," library and the ",(0,a.jsxs)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter",children:[(0,a.jsx)(n.code,{children:"@nestjs-cls/transactional-adapter-prisma"})," adapter"]}),". Later, you'll learn how to ",(0,a.jsx)(n.a,{href:"/nestjs-cls/plugins/available-plugins/transactional/creating-custom-adapter",children:"create your own adapter"}),"."]}),"\n",(0,a.jsxs)(n.p,{children:["Suppose we already have a ",(0,a.jsx)(n.code,{children:"PrismaModule"})," which provides a ",(0,a.jsx)(n.code,{children:"PrismaClient"})," instance and two other services ",(0,a.jsx)(n.code,{children:"UserService"})," and ",(0,a.jsx)(n.code,{children:"AccountService"})," which we'd like to make transactional."]}),"\n",(0,a.jsx)(n.h3,{id:"plugin-registration",children:"Plugin registration"}),"\n",(0,a.jsxs)(n.p,{children:["To add register the transactional plugin with ",(0,a.jsx)(n.code,{children:"nestjs-cls"}),", we need to pass it to the ",(0,a.jsx)(n.code,{children:"forRoot"})," method of the ",(0,a.jsx)(n.code,{children:"ClsModule"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-ts",metastring:'title="app.module.ts"',children:"import { ClsModule } from 'nestjs-cls';\nimport { ClsPluginTransactional } from '@nestjs-cls/transactional';\nimport { TransactionalAdapterPrisma } from '@nestjs-cls/transactional-adapter-prisma';\n// ... other imports\n\n@Module({\n imports: [\n PrismaModule,\n ClsModule.forRoot({\n plugins: [\n // highlight-start\n new ClsPluginTransactional({\n // if PrismaModule is not global, we need to make it available to the plugin\n imports: [PrismaModule],\n adapter: new TransactionalAdapterPrisma({\n // each adapter has its own options, see the adapter docs for more info\n prismaInjectionToken: PrismaClient,\n }),\n }),\n // highlight-end\n ],\n }),\n ],\n providers: [UserService, AccountService],\n})\nexport class AppModule {}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["This registers a ",(0,a.jsx)(n.code,{children:"TransactionHost"})," provider in the global context which can be used to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.h3,{id:"using-the-transactionhost",children:["Using the ",(0,a.jsx)(n.code,{children:"TransactionHost"})]}),"\n",(0,a.jsxs)(n.p,{children:["Now that we have the plugin registered, we can use the ",(0,a.jsx)(n.code,{children:"TransactionHost"})," to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.p,{children:["Suppose that any time we create an ",(0,a.jsx)(n.code,{children:"User"}),", we want to create an ",(0,a.jsx)(n.code,{children:"Account"})," for them as well and both operations must either succeed or fail. We can use the ",(0,a.jsx)(n.code,{children:"TransactionHost"})," to start a new transaction and retrieve the current transaction reference."]}),"\n",(0,a.jsxs)(n.p,{children:["The type argument on the ",(0,a.jsx)(n.code,{children:"TransactionHostYour Docusaurus site did not load properly.
\nA very common reason is a wrong site baseUrl configuration.
\nCurrent configured baseUrl = ${e} ${"/"===e?" (default value)":""}
\nWe suggest trying baseUrl =
\n.comment
can become .namespace--comment
) or replace them with your defined ones (like .editor__comment
). You can even add new classes.",owner:"dvkndn",noCSS:!0},"file-highlight":{title:"File Highlight",description:"Fetch external files and highlight them with Prism. Used on the Prism website itself.",noCSS:!0},"show-language":{title:"Show Language",description:"Display the highlighted language in code blocks (inline code does not show the label).",owner:"nauzilus",noCSS:!0,require:"toolbar"},"jsonp-highlight":{title:"JSONP Highlight",description:"Fetch content with JSONP and highlight some interesting content (e.g. GitHub/Gists or Bitbucket API).",noCSS:!0,owner:"nauzilus"},"highlight-keywords":{title:"Highlight Keywords",description:"Adds special CSS classes for each keyword for fine-grained highlighting.",owner:"vkbansal",noCSS:!0},"remove-initial-line-feed":{title:"Remove initial line feed",description:"Removes the initial line feed in code blocks.",owner:"Golmote",noCSS:!0},"inline-color":{title:"Inline color",description:"Adds a small inline preview for colors in style sheets.",require:"css-extras",owner:"RunDevelopment"},previewers:{title:"Previewers",description:"Previewers for angles, colors, gradients, easing and time.",require:"css-extras",owner:"Golmote"},autoloader:{title:"Autoloader",description:"Automatically loads the needed languages to highlight the code blocks.",owner:"Golmote",noCSS:!0},"keep-markup":{title:"Keep Markup",description:"Prevents custom markup from being dropped out during highlighting.",owner:"Golmote",optional:"normalize-whitespace",noCSS:!0},"command-line":{title:"Command Line",description:"Display a command line with a prompt and, optionally, the output/response from the commands.",owner:"chriswells0"},"unescaped-markup":{title:"Unescaped Markup",description:"Write markup without having to escape anything."},"normalize-whitespace":{title:"Normalize Whitespace",description:"Supports multiple operations to normalize whitespace in code blocks.",owner:"zeitgeist87",optional:"unescaped-markup",noCSS:!0},"data-uri-highlight":{title:"Data-URI Highlight",description:"Highlights data-URI contents.",owner:"Golmote",noCSS:!0},toolbar:{title:"Toolbar",description:"Attach a toolbar for plugins to easily register buttons on the top of a code block.",owner:"mAAdhaTTah"},"copy-to-clipboard":{title:"Copy to Clipboard Button",description:"Add a button that copies the code block to the clipboard when clicked.",owner:"mAAdhaTTah",require:"toolbar",noCSS:!0},"download-button":{title:"Download Button",description:"A button in the toolbar of a code block adding a convenient way to download a code file.",owner:"Golmote",require:"toolbar",noCSS:!0},"match-braces":{title:"Match braces",description:"Highlights matching braces.",owner:"RunDevelopment"},"diff-highlight":{title:"Diff Highlight",description:"Highlights the code inside diff blocks.",owner:"RunDevelopment",require:"diff"},"filter-highlight-all":{title:"Filter highlightAll",description:"Filters the elements the highlightAll
and highlightAllUnder
methods actually highlight.",owner:"RunDevelopment",noCSS:!0},treeview:{title:"Treeview",description:"A language with special styles to highlight file system tree structures.",owner:"Golmote"}}})},3916:(e,t,n)=>{const r=n(9911),a=n(4587),o=new Set;function i(e){void 0===e?e=Object.keys(r.languages).filter((e=>"meta"!=e)):Array.isArray(e)||(e=[e]);const t=[...o,...Object.keys(Prism.languages)];a(r,e,t).load((e=>{if(!(e in r.languages))return void(i.silent||console.warn("Language does not exist: "+e));const t="./prism-"+e;delete n.c[n(3392).resolve(t)],delete Prism.languages[e],n(3392)(t),o.add(e)}))}i.silent=!1,e.exports=i},3109:()=>{!function(e){function t(e,t){return"___"+e.toUpperCase()+t+"___"}Object.defineProperties(e.languages["markup-templating"]={},{buildPlaceholders:{value:function(n,r,a,o){if(n.language===r){var i=n.tokenStack=[];n.code=n.code.replace(a,(function(e){if("function"==typeof o&&!o(e))return e;for(var a,l=i.length;-1!==n.code.indexOf(a=t(r,l));)++l;return i[l]=e,a})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var a=0,o=Object.keys(n.tokenStack);!function i(l){for(var s=0;s{const o=t.toLowerCase(),i=((e,t)=>{const[n,r]=(0,u.useState)(V(t,e)),a=(0,u.useRef)(),o=(0,u.useRef)();return(0,u.useEffect)((()=>{t===a.current&&e===o.current||(a.current=t,o.current=e,r(V(t,e)))}),[e,t]),n})(o,r),l=(e=>(0,u.useCallback)((t=>{var n=t,{className:r,style:a,line:o}=n,i=C(n,["className","style","line"]);const l=E(S({},i),{className:(0,d.Z)("token-line",r)});return"object"==typeof e&&"plain"in e&&(l.style=e.plain),"object"==typeof a&&(l.style=S(S({},l.style||{}),a)),l}),[e]))(i),s=(e=>{const t=(0,u.useCallback)((({types:t,empty:n})=>{if(null!=e)return 1===t.length&&"plain"===t[0]?null!=n?{display:"inline-block"}:void 0:1===t.length&&null!=n?e[t[0]]:Object.assign(null!=n?{display:"inline-block"}:{},...t.map((t=>e[t])))}),[e]);return(0,u.useCallback)((e=>{var n=e,{token:r,className:a,style:o}=n,i=C(n,["token","className","style"]);const l=E(S({},i),{className:(0,d.Z)("token",...r.types,a),children:r.content,style:t(r)});return null!=o&&(l.style=S(S({},l.style||{}),o)),l}),[t])})(i),c=(({prism:e,code:t,grammar:n,language:r})=>{const a=(0,u.useRef)(e);return(0,u.useMemo)((()=>{if(null==n)return J([t]);const e={code:t,grammar:n,language:r,tokens:[]};return a.current.hooks.run("before-tokenize",e),e.tokens=a.current.tokenize(t,n),a.current.hooks.run("after-tokenize",e),J(e.tokens)}),[t,n,r])})({prism:a,language:o,code:n,grammar:a.languages[o]});return e({tokens:c,className:`prism-code language-${o}`,style:null!=i?i.root:{},getLineProps:l,getTokenProps:s})},ee=e=>(0,u.createElement)(X,E(S({},e),{prism:e.prism||j,theme:e.theme||U,code:e.code,language:e.language}))},2215:(e,t,n)=>{"use strict";n.d(t,{Z:()=>o});var r=!0,a="Invariant failed";function o(e,t){if(!e){if(r)throw new Error(a);var n="function"==typeof t?t():t,o=n?"".concat(a,": ").concat(n):a;throw new Error(o)}}},7529:e=>{"use strict";e.exports={}},6887:e=>{"use strict";e.exports=JSON.parse('{"/nestjs-cls/-460":{"__comp":"5e95c892","__context":{"plugin":"1cd7469c"}},"/nestjs-cls/-b1d":{"__comp":"a7bd4aaa","version":"935f2afb"},"/nestjs-cls/-15b":{"__comp":"a94703ab"},"/nestjs-cls/api-212":{"__comp":"17896441","content":"4c9a797e"},"/nestjs-cls/api/module-options-77a":{"__comp":"17896441","content":"97d55a5e"},"/nestjs-cls/api/service-interface-0da":{"__comp":"17896441","content":"df604e10"},"/nestjs-cls/considerations-416":{"__comp":"17896441","content":"94e5e920"},"/nestjs-cls/considerations/compatibility-10c":{"__comp":"17896441","content":"b787da23"},"/nestjs-cls/considerations/security-54f":{"__comp":"17896441","content":"57c14adc"},"/nestjs-cls/features-and-use-cases-1da":{"__comp":"17896441","content":"ef9f7d37"},"/nestjs-cls/features-and-use-cases/additional-cls-setup-d4a":{"__comp":"17896441","content":"6212613f"},"/nestjs-cls/features-and-use-cases/breaking-out-of-di-38a":{"__comp":"17896441","content":"6bb5cc7f"},"/nestjs-cls/features-and-use-cases/proxy-providers-53b":{"__comp":"17896441","content":"592cbe55"},"/nestjs-cls/features-and-use-cases/request-id-b90":{"__comp":"17896441","content":"f83e606a"},"/nestjs-cls/features-and-use-cases/type-safety-and-type-inference-88f":{"__comp":"17896441","content":"4998a0a4"},"/nestjs-cls/features-and-use-cases/usage-outside-of-web-request-9b7":{"__comp":"17896441","content":"a8d12efa"},"/nestjs-cls/introduction/how-it-works-a84":{"__comp":"17896441","content":"3ac8ff5d"},"/nestjs-cls/introduction/installation-885":{"__comp":"17896441","content":"3b39bba3"},"/nestjs-cls/introduction/quick-start-cf1":{"__comp":"17896441","content":"eca1a52a"},"/nestjs-cls/migration-guide-225":{"__comp":"17896441","content":"6fbaaecb"},"/nestjs-cls/migration-guide/v2x-v3x-553":{"__comp":"17896441","content":"baa2f4d8"},"/nestjs-cls/migration-guide/v3x-v4x-09e":{"__comp":"17896441","content":"075c86f0"},"/nestjs-cls/plugins-3b3":{"__comp":"17896441","content":"e83b8e0a"},"/nestjs-cls/plugins/available-plugins-3a5":{"__comp":"17896441","content":"e2112352"},"/nestjs-cls/plugins/available-plugins/transactional-927":{"__comp":"17896441","content":"739a1e5f"},"/nestjs-cls/plugins/available-plugins/transactional/creating-custom-adapter-09b":{"__comp":"17896441","content":"a886e75a"},"/nestjs-cls/plugins/available-plugins/transactional/knex-adapter-79d":{"__comp":"17896441","content":"fde5f810"},"/nestjs-cls/plugins/available-plugins/transactional/kysely-adapter-508":{"__comp":"17896441","content":"5e2b3edd"},"/nestjs-cls/plugins/available-plugins/transactional/pg-promise-adapter-d86":{"__comp":"17896441","content":"15a3970d"},"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter-b91":{"__comp":"17896441","content":"2d4cceda"},"/nestjs-cls/plugins/plugin-api-8c2":{"__comp":"17896441","content":"b67d68ed"},"/nestjs-cls/setting-up-cls-context-e63":{"__comp":"17896441","content":"a2c1fdb7"},"/nestjs-cls/setting-up-cls-context/using_cls_run-361":{"__comp":"17896441","content":"18c15bff"},"/nestjs-cls/setting-up-cls-context/using-a-decorator-cc5":{"__comp":"17896441","content":"eb9c95da"},"/nestjs-cls/setting-up-cls-context/using-a-guard-8c0":{"__comp":"17896441","content":"d459cca2"},"/nestjs-cls/setting-up-cls-context/using-a-middleware-ad9":{"__comp":"17896441","content":"ae4976f8"},"/nestjs-cls/setting-up-cls-context/using-an-interceptor-393":{"__comp":"17896441","content":"b09df872"},"/nestjs-cls/testing-a1e":{"__comp":"17896441","content":"82070906"},"/nestjs-cls/-c45":{"__comp":"17896441","content":"86ea57e0"}}')}},e=>{e.O(0,[532],(()=>{return t=9921,e(e.s=t);var t}));e.O()}]);
\ No newline at end of file
+/*! For license information please see main.165fda6b.js.LICENSE.txt */
+(self.webpackChunknestjs_cls_docs=self.webpackChunknestjs_cls_docs||[]).push([[179],{3512:(e,t,n)=>{"use strict";n.d(t,{Z:()=>p});n(7378);var r=n(1237),a=n.n(r),o=n(6887);const i={"075c86f0":[()=>n.e(506).then(n.bind(n,9658)),"@site/docs/10_migration-guide/01_v3x-v4x.md",9658],"15a3970d":[()=>Promise.all([n.e(532),n.e(769)]).then(n.bind(n,1950)),"@site/docs/06_plugins/01_available-plugins/01-transactional/04-pg-promise-adapter.md",1950],17896441:[()=>Promise.all([n.e(532),n.e(918)]).then(n.bind(n,8135)),"@theme/DocItem",8135],"18c15bff":[()=>n.e(399).then(n.bind(n,6752)),"@site/docs/02_setting-up-cls-context/05_using_cls_run.md",6752],"1cd7469c":[()=>n.e(665).then(n.t.bind(n,3769,19)),"/media/papooch/Storage/Ondra/Stuff/Projects/Node/nestjs-cls/docs/.docusaurus/docusaurus-plugin-content-docs/default/plugin-route-context-module-100.json",3769],"2d4cceda":[()=>Promise.all([n.e(532),n.e(285)]).then(n.bind(n,2822)),"@site/docs/06_plugins/01_available-plugins/01-transactional/01-prisma-adapter.md",2822],"3ac8ff5d":[()=>n.e(332).then(n.bind(n,4760)),"@site/docs/01_introduction/03_how-it-works.md",4760],"3b39bba3":[()=>Promise.all([n.e(532),n.e(546)]).then(n.bind(n,7309)),"@site/docs/01_introduction/01_installation.md",7309],"4998a0a4":[()=>n.e(872).then(n.bind(n,5436)),"@site/docs/03_features-and-use-cases/05_type-safety-and-type-inference.md",5436],"4c9a797e":[()=>n.e(720).then(n.bind(n,5875)),"@site/docs/04_api/index.md",5875],"57c14adc":[()=>n.e(507).then(n.bind(n,3253)),"@site/docs/05_considerations/01_security.md",3253],"592cbe55":[()=>n.e(437).then(n.bind(n,652)),"@site/docs/03_features-and-use-cases/06_proxy-providers.md",652],"5e2b3edd":[()=>Promise.all([n.e(532),n.e(844)]).then(n.bind(n,3943)),"@site/docs/06_plugins/01_available-plugins/01-transactional/03-kysely-adapter.md",3943],"5e95c892":[()=>n.e(661).then(n.bind(n,32)),"@theme/DocsRoot",32],"6212613f":[()=>n.e(849).then(n.bind(n,2867)),"@site/docs/03_features-and-use-cases/02_additional-cls-setup.md",2867],"6bb5cc7f":[()=>n.e(499).then(n.bind(n,6035)),"@site/docs/03_features-and-use-cases/03_breaking-out-of-di.md",6035],"6fbaaecb":[()=>n.e(979).then(n.bind(n,726)),"@site/docs/10_migration-guide/index.md",726],"739a1e5f":[()=>Promise.all([n.e(532),n.e(180)]).then(n.bind(n,7518)),"@site/docs/06_plugins/01_available-plugins/01-transactional/index.md",7518],82070906:[()=>n.e(336).then(n.bind(n,2935)),"@site/docs/07_testing/index.md",2935],"86ea57e0":[()=>n.e(202).then(n.bind(n,5737)),"@site/docs/01_introduction/index.md",5737],"935f2afb":[()=>n.e(53).then(n.t.bind(n,1109,19)),"~docs/default/version-current-metadata-prop-751.json",1109],"94e5e920":[()=>n.e(575).then(n.bind(n,9257)),"@site/docs/05_considerations/index.md",9257],"97d55a5e":[()=>n.e(823).then(n.bind(n,6274)),"@site/docs/04_api/02_module-options.md",6274],a2c1fdb7:[()=>n.e(776).then(n.bind(n,5308)),"@site/docs/02_setting-up-cls-context/index.md",5308],a7bd4aaa:[()=>n.e(518).then(n.bind(n,2922)),"@theme/DocVersionRoot",2922],a886e75a:[()=>n.e(466).then(n.bind(n,877)),"@site/docs/06_plugins/01_available-plugins/01-transactional/10-creating-custom-adapter.md",877],a8d12efa:[()=>n.e(55).then(n.bind(n,9446)),"@site/docs/03_features-and-use-cases/04_usage-outside-of-web-request.md",9446],a94703ab:[()=>Promise.all([n.e(532),n.e(368)]).then(n.bind(n,552)),"@theme/DocRoot",552],ae4976f8:[()=>n.e(93).then(n.bind(n,5934)),"@site/docs/02_setting-up-cls-context/01_using-a-middleware.md",5934],b09df872:[()=>n.e(246).then(n.bind(n,8625)),"@site/docs/02_setting-up-cls-context/03_using-an-interceptor.md",8625],b67d68ed:[()=>n.e(241).then(n.bind(n,5575)),"@site/docs/06_plugins/02_plugin-api.md",5575],b787da23:[()=>n.e(126).then(n.bind(n,9622)),"@site/docs/05_considerations/02_compatibility.md",9622],baa2f4d8:[()=>n.e(423).then(n.bind(n,8711)),"@site/docs/10_migration-guide/02_v2x-v3x.md",8711],d459cca2:[()=>n.e(47).then(n.bind(n,2041)),"@site/docs/02_setting-up-cls-context/02_using-a-guard.md",2041],df604e10:[()=>n.e(775).then(n.bind(n,1763)),"@site/docs/04_api/01_service-interface.md",1763],e2112352:[()=>n.e(826).then(n.bind(n,1267)),"@site/docs/06_plugins/01_available-plugins/index.md",1267],e83b8e0a:[()=>n.e(446).then(n.bind(n,5834)),"@site/docs/06_plugins/index.md",5834],eb9c95da:[()=>n.e(715).then(n.bind(n,8258)),"@site/docs/02_setting-up-cls-context/04_using-a-decorator.md",8258],eca1a52a:[()=>n.e(873).then(n.bind(n,5638)),"@site/docs/01_introduction/02_quick-start.md",5638],ef9f7d37:[()=>n.e(990).then(n.bind(n,2098)),"@site/docs/03_features-and-use-cases/index.md",2098],f83e606a:[()=>n.e(104).then(n.bind(n,8472)),"@site/docs/03_features-and-use-cases/01_request-id.md",8472],fde5f810:[()=>Promise.all([n.e(532),n.e(738)]).then(n.bind(n,7636)),"@site/docs/06_plugins/01_available-plugins/01-transactional/02-knex-adapter.md",7636]};var l=n(4246);function s(e){let{error:t,retry:n,pastDelay:r}=e;return t?(0,l.jsxs)("div",{style:{textAlign:"center",color:"#fff",backgroundColor:"#fa383e",borderColor:"#fa383e",borderStyle:"solid",borderRadius:"0.25rem",borderWidth:"1px",boxSizing:"border-box",display:"block",padding:"1rem",flex:"0 0 50%",marginLeft:"25%",marginRight:"25%",marginTop:"5rem",maxWidth:"50%",width:"100%"},children:[(0,l.jsx)("p",{children:String(t)}),(0,l.jsx)("div",{children:(0,l.jsx)("button",{type:"button",onClick:n,children:"Retry"})})]}):r?(0,l.jsx)("div",{style:{display:"flex",justifyContent:"center",alignItems:"center",height:"100vh"},children:(0,l.jsx)("svg",{id:"loader",style:{width:128,height:110,position:"absolute",top:"calc(100vh - 64%)"},viewBox:"0 0 45 45",xmlns:"http://www.w3.org/2000/svg",stroke:"#61dafb",children:(0,l.jsxs)("g",{fill:"none",fillRule:"evenodd",transform:"translate(1 1)",strokeWidth:"2",children:[(0,l.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,l.jsx)("animate",{attributeName:"r",begin:"1.5s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-opacity",begin:"1.5s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-width",begin:"1.5s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,l.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,l.jsx)("animate",{attributeName:"r",begin:"3s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-opacity",begin:"3s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-width",begin:"3s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,l.jsx)("circle",{cx:"22",cy:"22",r:"8",children:(0,l.jsx)("animate",{attributeName:"r",begin:"0s",dur:"1.5s",values:"6;1;2;3;4;5;6",calcMode:"linear",repeatCount:"indefinite"})})]})})}):null}var c=n(7308),u=n(2729);function d(e,t){if("*"===e)return a()({loading:s,loader:()=>n.e(765).then(n.bind(n,765)),modules:["@theme/NotFound"],webpack:()=>[765],render(e,t){const n=e.default;return(0,l.jsx)(u.z,{value:{plugin:{name:"native",id:"default"}},children:(0,l.jsx)(n,{...t})})}});const r=o[`${e}-${t}`],d={},p=[],f=[],m=(0,c.Z)(r);return Object.entries(m).forEach((e=>{let[t,n]=e;const r=i[n];r&&(d[t]=r[0],p.push(r[1]),f.push(r[2]))})),a().Map({loading:s,loader:d,modules:p,webpack:()=>f,render(t,n){const a=JSON.parse(JSON.stringify(r));Object.entries(t).forEach((t=>{let[n,r]=t;const o=r.default;if(!o)throw new Error(`The page component at ${e} doesn't have a default export. This makes it impossible to render anything. Consider default-exporting a React component.`);"object"!=typeof o&&"function"!=typeof o||Object.keys(r).filter((e=>"default"!==e)).forEach((e=>{o[e]=r[e]}));let i=a;const l=n.split(".");l.slice(0,-1).forEach((e=>{i=i[e]})),i[l[l.length-1]]=o}));const o=a.__comp;delete a.__comp;const i=a.__context;return delete a.__context,(0,l.jsx)(u.z,{value:i,children:(0,l.jsx)(o,{...a,...n})})}})}const p=[{path:"/nestjs-cls/",component:d("/nestjs-cls/","460"),routes:[{path:"/nestjs-cls/",component:d("/nestjs-cls/","b1d"),routes:[{path:"/nestjs-cls/",component:d("/nestjs-cls/","15b"),routes:[{path:"/nestjs-cls/api",component:d("/nestjs-cls/api","212"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/api/module-options",component:d("/nestjs-cls/api/module-options","77a"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/api/service-interface",component:d("/nestjs-cls/api/service-interface","0da"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/considerations",component:d("/nestjs-cls/considerations","416"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/considerations/compatibility",component:d("/nestjs-cls/considerations/compatibility","10c"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/considerations/security",component:d("/nestjs-cls/considerations/security","54f"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases",component:d("/nestjs-cls/features-and-use-cases","1da"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/additional-cls-setup",component:d("/nestjs-cls/features-and-use-cases/additional-cls-setup","d4a"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/breaking-out-of-di",component:d("/nestjs-cls/features-and-use-cases/breaking-out-of-di","38a"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/proxy-providers",component:d("/nestjs-cls/features-and-use-cases/proxy-providers","53b"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/request-id",component:d("/nestjs-cls/features-and-use-cases/request-id","b90"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/type-safety-and-type-inference",component:d("/nestjs-cls/features-and-use-cases/type-safety-and-type-inference","88f"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/features-and-use-cases/usage-outside-of-web-request",component:d("/nestjs-cls/features-and-use-cases/usage-outside-of-web-request","9b7"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/introduction/how-it-works",component:d("/nestjs-cls/introduction/how-it-works","a84"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/introduction/installation",component:d("/nestjs-cls/introduction/installation","885"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/introduction/quick-start",component:d("/nestjs-cls/introduction/quick-start","cf1"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/migration-guide",component:d("/nestjs-cls/migration-guide","225"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/migration-guide/v2x-v3x",component:d("/nestjs-cls/migration-guide/v2x-v3x","553"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/migration-guide/v3x-v4x",component:d("/nestjs-cls/migration-guide/v3x-v4x","09e"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins",component:d("/nestjs-cls/plugins","3b3"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins",component:d("/nestjs-cls/plugins/available-plugins","3a5"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional",component:d("/nestjs-cls/plugins/available-plugins/transactional","927"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional/creating-custom-adapter",component:d("/nestjs-cls/plugins/available-plugins/transactional/creating-custom-adapter","09b"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional/knex-adapter",component:d("/nestjs-cls/plugins/available-plugins/transactional/knex-adapter","79d"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional/kysely-adapter",component:d("/nestjs-cls/plugins/available-plugins/transactional/kysely-adapter","508"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional/pg-promise-adapter",component:d("/nestjs-cls/plugins/available-plugins/transactional/pg-promise-adapter","d86"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter",component:d("/nestjs-cls/plugins/available-plugins/transactional/prisma-adapter","b91"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/plugins/plugin-api",component:d("/nestjs-cls/plugins/plugin-api","8c2"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context",component:d("/nestjs-cls/setting-up-cls-context","e63"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context/using_cls_run",component:d("/nestjs-cls/setting-up-cls-context/using_cls_run","361"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context/using-a-decorator",component:d("/nestjs-cls/setting-up-cls-context/using-a-decorator","cc5"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context/using-a-guard",component:d("/nestjs-cls/setting-up-cls-context/using-a-guard","8c0"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context/using-a-middleware",component:d("/nestjs-cls/setting-up-cls-context/using-a-middleware","ad9"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/setting-up-cls-context/using-an-interceptor",component:d("/nestjs-cls/setting-up-cls-context/using-an-interceptor","393"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/testing",component:d("/nestjs-cls/testing","a1e"),exact:!0,sidebar:"documentationSidebar"},{path:"/nestjs-cls/",component:d("/nestjs-cls/","c45"),exact:!0,sidebar:"documentationSidebar"}]}]}]},{path:"*",component:d("*")}]},3210:(e,t,n)=>{"use strict";n.d(t,{_:()=>o,t:()=>i});var r=n(7378),a=n(4246);const o=r.createContext(!1);function i(e){let{children:t}=e;const[n,i]=(0,r.useState)(!1);return(0,r.useEffect)((()=>{i(!0)}),[]),(0,a.jsx)(o.Provider,{value:n,children:t})}},9921:(e,t,n)=>{"use strict";var r=n(7378),a=n(7634),o=n(4289),i=n(2883),l=n(5894);const s=[n(142),n(3887),n(8833),n(6222)];var c=n(3512),u=n(3620),d=n(5473),p=n(4246);function f(e){let{children:t}=e;return(0,p.jsx)(p.Fragment,{children:t})}var m=n(2750),g=n(9939),h=n(1847),y=n(9899),b=n(8836),v=n(9699),w=n(1706),k=n(2064),x=n(2615),S=n(4386);function E(){const{i18n:{currentLocale:e,defaultLocale:t,localeConfigs:n}}=(0,g.Z)(),r=(0,v.l)(),a=n[e].htmlLang,o=e=>e.replace("-","_");return(0,p.jsxs)(m.Z,{children:[Object.entries(n).map((e=>{let[t,{htmlLang:n}]=e;return(0,p.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:n},t)})),(0,p.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:"x-default"}),(0,p.jsx)("meta",{property:"og:locale",content:o(a)}),Object.values(n).filter((e=>a!==e.htmlLang)).map((e=>(0,p.jsx)("meta",{property:"og:locale:alternate",content:o(e.htmlLang)},`meta-og-${e.htmlLang}`)))]})}function C(e){let{permalink:t}=e;const{siteConfig:{url:n}}=(0,g.Z)(),r=function(){const{siteConfig:{url:e,baseUrl:t,trailingSlash:n}}=(0,g.Z)(),{pathname:r}=(0,u.TH)();return e+(0,x.applyTrailingSlash)((0,h.Z)(r),{trailingSlash:n,baseUrl:t})}(),a=t?`${n}${t}`:r;return(0,p.jsxs)(m.Z,{children:[(0,p.jsx)("meta",{property:"og:url",content:a}),(0,p.jsx)("link",{rel:"canonical",href:a})]})}function _(){const{i18n:{currentLocale:e}}=(0,g.Z)(),{metadata:t,image:n}=(0,y.L)();return(0,p.jsxs)(p.Fragment,{children:[(0,p.jsxs)(m.Z,{children:[(0,p.jsx)("meta",{name:"twitter:card",content:"summary_large_image"}),(0,p.jsx)("body",{className:w.h})]}),n&&(0,p.jsx)(b.d,{image:n}),(0,p.jsx)(C,{}),(0,p.jsx)(E,{}),(0,p.jsx)(S.Z,{tag:k.HX,locale:e}),(0,p.jsx)(m.Z,{children:t.map(((e,t)=>(0,p.jsx)("meta",{...e},t)))})]})}const j=new Map;function T(e){if(j.has(e.pathname))return{...e,pathname:j.get(e.pathname)};if((0,d.f)(c.Z,e.pathname).some((e=>{let{route:t}=e;return!0===t.exact})))return j.set(e.pathname,e.pathname),e;const t=e.pathname.trim().replace(/(?:\/index)?\.html$/,"")||"/";return j.set(e.pathname,t),{...e,pathname:t}}var N=n(3210),R=n(2014),A=n(9749);function L(e){for(var t=arguments.length,n=new Array(t>1?t-1:0),r=1;r Your Docusaurus site did not load properly. A very common reason is a wrong site baseUrl configuration. Current configured baseUrl = ${e} ${"/"===e?" (default value)":""} We suggest trying baseUrl = {if(!e)return;const r=t.location.hash;if(r?document.getElementById(r.substring(1)):void 0)return a.current=!0,void n(!1);n(!0)})),{navbarRef:i,isNavbarVisible:t}}(n);return(0,u.jsxs)("nav",{ref:l,"aria-label":(0,s.I)({id:"theme.NavBar.navAriaLabel",message:"Main",description:"The ARIA label for the main navigation"}),className:(0,a.Z)("navbar","navbar--fixed-top",n&&[De.navbarHideable,!d&&De.navbarHidden],{"navbar--dark":"dark"===o,"navbar--primary":"primary"===o,"navbar-sidebar--show":i.shown}),children:[t,(0,u.jsx)(Me,{onClick:i.toggle}),(0,u.jsx)(Ie,{})]})}var ze=n(2615);const Be={errorBoundaryError:"errorBoundaryError_WE6Q",errorBoundaryFallback:"errorBoundaryFallback_bdJX"};function $e(e){return(0,u.jsx)("button",{type:"button",...e,children:(0,u.jsx)(s.Z,{id:"theme.ErrorPageContent.tryAgain",description:"The label of the button to try again rendering when the React error boundary captures an error",children:"Try again"})})}function Ue(e){let{error:t}=e;const n=(0,ze.getErrorCausalChain)(t).map((e=>e.message)).join("\n\nCause:\n");return(0,u.jsx)("p",{className:Be.errorBoundaryError,children:n})}class qe extends r.Component{componentDidCatch(e,t){throw this.props.onError(e,t)}render(){return this.props.children}}const He="right";function Ze(e){let{width:t=30,height:n=30,className:r,...a}=e;return(0,u.jsx)("svg",{className:r,width:t,height:n,viewBox:"0 0 30 30","aria-hidden":"true",...a,children:(0,u.jsx)("path",{stroke:"currentColor",strokeLinecap:"round",strokeMiterlimit:"10",strokeWidth:"2",d:"M4 7h22M4 15h22M4 23h22"})})}function Ge(){const{toggle:e,shown:t}=(0,N.e)();return(0,u.jsx)("button",{onClick:e,"aria-label":(0,s.I)({id:"theme.docs.sidebar.toggleSidebarButtonAriaLabel",message:"Toggle navigation bar",description:"The ARIA label for hamburger menu button of mobile navigation"}),"aria-expanded":t,className:"navbar__toggle clean-btn",type:"button",children:(0,u.jsx)(Ze,{})})}const We={colorModeToggle:"colorModeToggle_Hewu"};function Ve(e){let{items:t}=e;return(0,u.jsx)(u.Fragment,{children:t.map(((e,t)=>(0,u.jsx)(qe,{onError:t=>new Error(`A theme navbar item failed to render.\nPlease double-check the following navbar item (themeConfig.navbar.items) of your Docusaurus config:\n${JSON.stringify(e,null,2)}`,{cause:t}),children:(0,u.jsx)(Ae,{...e})},t)))})}function Qe(e){let{left:t,right:n}=e;return(0,u.jsxs)("div",{className:"navbar__inner",children:[(0,u.jsx)("div",{className:"navbar__items",children:t}),(0,u.jsx)("div",{className:"navbar__items navbar__items--right",children:n})]})}function Ke(){const e=(0,N.e)(),t=(0,w.L)().navbar.items,[n,r]=function(e){function t(e){return"left"===(e.position??He)}return[e.filter(t),e.filter((e=>!t(e)))]}(t),a=t.find((e=>"search"===e.type));return(0,u.jsx)(Qe,{left:(0,u.jsxs)(u.Fragment,{children:[!e.disabled&&(0,u.jsx)(Ge,{}),(0,u.jsx)(V,{}),(0,u.jsx)(Ve,{items:n})]}),right:(0,u.jsxs)(u.Fragment,{children:[(0,u.jsx)(Ve,{items:r}),(0,u.jsx)(G,{className:We.colorModeToggle}),!a&&(0,u.jsx)(Ce,{children:(0,u.jsx)(Se,{})})]})})}function Ye(){return(0,u.jsx)(Fe,{children:(0,u.jsx)(Ke,{})})}function Je(e){let{item:t}=e;const{to:n,href:r,label:a,prependBaseUrlToHref:o,...i}=t,l=(0,J.Z)(n),s=(0,J.Z)(r,{forcePrependBaseUrl:!0});return(0,u.jsxs)(Y.Z,{className:"footer__link-item",...r?{href:o?s:r}:{to:l},...i,children:[a,r&&!(0,X.Z)(r)&&(0,u.jsx)(te.Z,{})]})}function Xe(e){let{item:t}=e;return t.html?(0,u.jsx)("li",{className:"footer__item",dangerouslySetInnerHTML:{__html:t.html}}):(0,u.jsx)("li",{className:"footer__item",children:(0,u.jsx)(Je,{item:t})},t.href??t.to)}function et(e){let{column:t}=e;return(0,u.jsxs)("div",{className:"col footer__col",children:[(0,u.jsx)("div",{className:"footer__title",children:t.title}),(0,u.jsx)("ul",{className:"footer__items clean-list",children:t.items.map(((e,t)=>(0,u.jsx)(Xe,{item:e},t)))})]})}function tt(e){let{columns:t}=e;return(0,u.jsx)("div",{className:"row footer__links",children:t.map(((e,t)=>(0,u.jsx)(et,{column:e},t)))})}function nt(){return(0,u.jsx)("span",{className:"footer__link-separator",children:"\xb7"})}function rt(e){let{item:t}=e;return t.html?(0,u.jsx)("span",{className:"footer__link-item",dangerouslySetInnerHTML:{__html:t.html}}):(0,u.jsx)(Je,{item:t})}function at(e){let{links:t}=e;return(0,u.jsx)("div",{className:"footer__links text--center",children:(0,u.jsx)("div",{className:"footer__links",children:t.map(((e,n)=>(0,u.jsxs)(r.Fragment,{children:[(0,u.jsx)(rt,{item:e}),t.length!==n+1&&(0,u.jsx)(nt,{})]},n)))})})}function ot(e){let{links:t}=e;return function(e){return"title"in e[0]}(t)?(0,u.jsx)(tt,{columns:t}):(0,u.jsx)(at,{links:t})}var it=n(1412);const lt={footerLogoLink:"footerLogoLink_tutC"};function st(e){let{logo:t}=e;const{withBaseUrl:n}=(0,J.C)(),r={light:n(t.src),dark:n(t.srcDark??t.src)};return(0,u.jsx)(it.Z,{className:(0,a.Z)("footer__logo",t.className),alt:t.alt,sources:r,width:t.width,height:t.height,style:t.style})}function ct(e){let{logo:t}=e;return t.href?(0,u.jsx)(Y.Z,{href:t.href,className:lt.footerLogoLink,target:t.target,children:(0,u.jsx)(st,{logo:t})}):(0,u.jsx)(st,{logo:t})}function ut(e){let{copyright:t}=e;return(0,u.jsx)("div",{className:"footer__copyright",dangerouslySetInnerHTML:{__html:t}})}function dt(e){let{style:t,links:n,logo:r,copyright:o}=e;return(0,u.jsx)("footer",{className:(0,a.Z)("footer",{"footer--dark":"dark"===t}),children:(0,u.jsxs)("div",{className:"container container-fluid",children:[n,(r||o)&&(0,u.jsxs)("div",{className:"footer__bottom text--center",children:[r&&(0,u.jsx)("div",{className:"margin-bottom--sm",children:r}),o]})]})})}function pt(){const{footer:e}=(0,w.L)();if(!e)return null;const{copyright:t,links:n,logo:r,style:a}=e;return(0,u.jsx)(dt,{style:a,links:n&&n.length>0&&(0,u.jsx)(ot,{links:n}),logo:r&&(0,u.jsx)(ct,{logo:r}),copyright:t&&(0,u.jsx)(ut,{copyright:t})})}const ft=r.memo(pt),mt=(0,A.Qc)([F.S,k.pl,R.OC,Te.L5,i.VC,function(e){let{children:t}=e;return(0,u.jsx)(L.n2,{children:(0,u.jsx)(N.M,{children:(0,u.jsx)(O,{children:t})})})}]);function gt(e){let{children:t}=e;return(0,u.jsx)(mt,{children:t})}var ht=n(8825);function yt(e){let{error:t,tryAgain:n}=e;return(0,u.jsx)("main",{className:"container margin-vert--xl",children:(0,u.jsx)("div",{className:"row",children:(0,u.jsxs)("div",{className:"col col--6 col--offset-3",children:[(0,u.jsx)(ht.Z,{as:"h1",className:"hero__title",children:(0,u.jsx)(s.Z,{id:"theme.ErrorPageContent.title",description:"The title of the fallback page when the page crashed",children:"This page crashed."})}),(0,u.jsx)("div",{className:"margin-vert--lg",children:(0,u.jsx)($e,{onClick:n,className:"button button--primary shadow--lw"})}),(0,u.jsx)("hr",{}),(0,u.jsx)("div",{className:"margin-vert--md",children:(0,u.jsx)(Ue,{error:t})})]})})})}const bt={mainWrapper:"mainWrapper_MB5r"};function vt(e){const{children:t,noFooter:n,wrapperClassName:r,title:l,description:s}=e;return(0,y.t)(),(0,u.jsxs)(gt,{children:[(0,u.jsx)(i.d,{title:l,description:s}),(0,u.jsx)(v,{}),(0,u.jsx)(T,{}),(0,u.jsx)(Ye,{}),(0,u.jsx)("div",{id:d,className:(0,a.Z)(h.k.wrapper.main,bt.mainWrapper,r),children:(0,u.jsx)(o.Z,{fallback:e=>(0,u.jsx)(yt,{...e}),children:t})}),!n&&(0,u.jsx)(ft,{})]})}},8340:(e,t,n)=>{"use strict";n.d(t,{Z:()=>u});n(7378);var r=n(5237),a=n(1847),o=n(9939),i=n(9899),l=n(1412),s=n(4246);function c(e){let{logo:t,alt:n,imageClassName:r}=e;const o={light:(0,a.Z)(t.src),dark:(0,a.Z)(t.srcDark||t.src)},i=(0,s.jsx)(l.Z,{className:t.className,sources:o,height:t.height,width:t.width,alt:n,style:t.style});return r?(0,s.jsx)("div",{className:r,children:i}):i}function u(e){const{siteConfig:{title:t}}=(0,o.Z)(),{navbar:{title:n,logo:l}}=(0,i.L)(),{imageClassName:u,titleClassName:d,...p}=e,f=(0,a.Z)(l?.href||"/"),m=n?"":t,g=l?.alt??m;return(0,s.jsxs)(r.Z,{to:f,...p,...l?.target&&{target:l.target},children:[l&&(0,s.jsx)(c,{logo:l,alt:g,imageClassName:u}),null!=n&&(0,s.jsx)("b",{className:d,children:n})]})}},4386:(e,t,n)=>{"use strict";n.d(t,{Z:()=>o});n(7378);var r=n(2750),a=n(4246);function o(e){let{locale:t,version:n,tag:o}=e;const i=t;return(0,a.jsxs)(r.Z,{children:[t&&(0,a.jsx)("meta",{name:"docusaurus_locale",content:t}),n&&(0,a.jsx)("meta",{name:"docusaurus_version",content:n}),o&&(0,a.jsx)("meta",{name:"docusaurus_tag",content:o}),i&&(0,a.jsx)("meta",{name:"docsearch:language",content:i}),n&&(0,a.jsx)("meta",{name:"docsearch:version",content:n}),o&&(0,a.jsx)("meta",{name:"docsearch:docusaurus_tag",content:o})]})}},1412:(e,t,n)=>{"use strict";n.d(t,{Z:()=>u});var r=n(7378),a=n(624),o=n(362),i=n(4561);const l={themedComponent:"themedComponent_siVc","themedComponent--light":"themedComponent--light_hHel","themedComponent--dark":"themedComponent--dark_yETr"};var s=n(4246);function c(e){let{className:t,children:n}=e;const c=(0,o.Z)(),{colorMode:u}=(0,i.I)();return(0,s.jsx)(s.Fragment,{children:(c?"dark"===u?["dark"]:["light"]:["light","dark"]).map((e=>{const o=n({theme:e,className:(0,a.Z)(t,l.themedComponent,l[`themedComponent--${e}`])});return(0,s.jsx)(r.Fragment,{children:o},e)}))})}function u(e){const{sources:t,className:n,alt:r,...a}=e;return(0,s.jsx)(c,{className:n,children:e=>{let{theme:n,className:o}=e;return(0,s.jsx)("img",{src:t[n],alt:r,className:o,...a})}})}},4229:(e,t,n)=>{"use strict";n.d(t,{u:()=>c,z:()=>y});var r=n(7378),a=n(5894),o=n(9749),i=n(5122),l=n(4246);const s="ease-in-out";function c(e){let{initialState:t}=e;const[n,a]=(0,r.useState)(t??!1),o=(0,r.useCallback)((()=>{a((e=>!e))}),[]);return{collapsed:n,setCollapsed:a,toggleCollapsed:o}}const u={display:"none",overflow:"hidden",height:"0px"},d={display:"block",overflow:"visible",height:"auto"};function p(e,t){const n=t?u:d;e.style.display=n.display,e.style.overflow=n.overflow,e.style.height=n.height}function f(e){let{collapsibleRef:t,collapsed:n,animation:a}=e;const o=(0,r.useRef)(!1);(0,r.useEffect)((()=>{const e=t.current;function r(){const t=e.scrollHeight,n=a?.duration??function(e){if((0,i.n)())return 1;const t=e/36;return Math.round(10*(4+15*t**.25+t/5))}(t);return{transition:`height ${n}ms ${a?.easing??s}`,height:`${t}px`}}function l(){const t=r();e.style.transition=t.transition,e.style.height=t.height}if(!o.current)return p(e,n),void(o.current=!0);return e.style.willChange="height",function(){const t=requestAnimationFrame((()=>{n?(l(),requestAnimationFrame((()=>{e.style.height=u.height,e.style.overflow=u.overflow}))):(e.style.display="block",requestAnimationFrame((()=>{l()})))}));return()=>cancelAnimationFrame(t)}()}),[t,n,a])}function m(e){if(!a.Z.canUseDOM)return e?u:d}function g(e){let{as:t="div",collapsed:n,children:a,animation:o,onCollapseTransitionEnd:i,className:s,disableSSRStyle:c}=e;const u=(0,r.useRef)(null);return f({collapsibleRef:u,collapsed:n,animation:o}),(0,l.jsx)(t,{ref:u,style:c?void 0:m(n),onTransitionEnd:e=>{"height"===e.propertyName&&(p(u.current,n),i?.(n))},className:s,children:a})}function h(e){let{collapsed:t,...n}=e;const[a,i]=(0,r.useState)(!t),[s,c]=(0,r.useState)(t);return(0,o.Z)((()=>{t||i(!0)}),[t]),(0,o.Z)((()=>{a&&c(t)}),[a,t]),a?(0,l.jsx)(g,{...n,collapsed:s}):null}function y(e){let{lazy:t,...n}=e;const r=t?h:g;return(0,l.jsx)(r,{...n})}},4234:(e,t,n)=>{"use strict";n.d(t,{nT:()=>g,pl:()=>m});var r=n(7378),a=n(362),o=n(8796),i=n(3879),l=n(9899),s=n(4246);const c=(0,o.WA)("docusaurus.announcement.dismiss"),u=(0,o.WA)("docusaurus.announcement.id"),d=()=>"true"===c.get(),p=e=>c.set(String(e)),f=r.createContext(null);function m(e){let{children:t}=e;const n=function(){const{announcementBar:e}=(0,l.L)(),t=(0,a.Z)(),[n,o]=(0,r.useState)((()=>!!t&&d()));(0,r.useEffect)((()=>{o(d())}),[]);const i=(0,r.useCallback)((()=>{p(!0),o(!0)}),[]);return(0,r.useEffect)((()=>{if(!e)return;const{id:t}=e;let n=u.get();"annoucement-bar"===n&&(n="announcement-bar");const r=t!==n;u.set(t),r&&p(!1),!r&&d()||o(!1)}),[e]),(0,r.useMemo)((()=>({isActive:!!e&&!n,close:i})),[e,n,i])}();return(0,s.jsx)(f.Provider,{value:n,children:t})}function g(){const e=(0,r.useContext)(f);if(!e)throw new i.i6("AnnouncementBarProvider");return e}},4561:(e,t,n)=>{"use strict";n.d(t,{I:()=>y,S:()=>h});var r=n(7378),a=n(5894),o=n(3879),i=n(8796),l=n(9899),s=n(4246);const c=r.createContext(void 0),u="theme",d=(0,i.WA)(u),p={light:"light",dark:"dark"},f=e=>e===p.dark?p.dark:p.light,m=e=>a.Z.canUseDOM?f(document.documentElement.getAttribute("data-theme")):f(e),g=e=>{d.set(f(e))};function h(e){let{children:t}=e;const n=function(){const{colorMode:{defaultMode:e,disableSwitch:t,respectPrefersColorScheme:n}}=(0,l.L)(),[a,o]=(0,r.useState)(m(e));(0,r.useEffect)((()=>{t&&d.del()}),[t]);const i=(0,r.useCallback)((function(t,r){void 0===r&&(r={});const{persist:a=!0}=r;t?(o(t),a&&g(t)):(o(n?window.matchMedia("(prefers-color-scheme: dark)").matches?p.dark:p.light:e),d.del())}),[n,e]);(0,r.useEffect)((()=>{document.documentElement.setAttribute("data-theme",f(a))}),[a]),(0,r.useEffect)((()=>{if(t)return;const e=e=>{if(e.key!==u)return;const t=d.get();null!==t&&i(f(t))};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)}),[t,i]);const s=(0,r.useRef)(!1);return(0,r.useEffect)((()=>{if(t&&!n)return;const e=window.matchMedia("(prefers-color-scheme: dark)"),r=()=>{window.matchMedia("print").matches||s.current?s.current=window.matchMedia("print").matches:i(null)};return e.addListener(r),()=>e.removeListener(r)}),[i,t,n]),(0,r.useMemo)((()=>({colorMode:a,setColorMode:i,get isDarkTheme(){return a===p.dark},setLightTheme(){i(p.light)},setDarkTheme(){i(p.dark)}})),[a,i])}();return(0,s.jsx)(c.Provider,{value:n,children:t})}function y(){const e=(0,r.useContext)(c);if(null==e)throw new o.i6("ColorModeProvider","Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.");return e}},8072:(e,t,n)=>{"use strict";n.d(t,{J:()=>v,L5:()=>y});var r=n(7378),a=n(4924),o=n(5167),i=n(9899),l=n(7470),s=n(3879),c=n(8796),u=n(4246);const d=e=>`docs-preferred-version-${e}`,p={save:(e,t,n)=>{(0,c.WA)(d(e),{persistence:t}).set(n)},read:(e,t)=>(0,c.WA)(d(e),{persistence:t}).get(),clear:(e,t)=>{(0,c.WA)(d(e),{persistence:t}).del()}},f=e=>Object.fromEntries(e.map((e=>[e,{preferredVersionName:null}])));const m=r.createContext(null);function g(){const e=(0,a._r)(),t=(0,i.L)().docs.versionPersistence,n=(0,r.useMemo)((()=>Object.keys(e)),[e]),[o,l]=(0,r.useState)((()=>f(n)));(0,r.useEffect)((()=>{l(function(e){let{pluginIds:t,versionPersistence:n,allDocsData:r}=e;function a(e){const t=p.read(e,n);return r[e].versions.some((e=>e.name===t))?{preferredVersionName:t}:(p.clear(e,n),{preferredVersionName:null})}return Object.fromEntries(t.map((e=>[e,a(e)])))}({allDocsData:e,versionPersistence:t,pluginIds:n}))}),[e,t,n]);return[o,(0,r.useMemo)((()=>({savePreferredVersion:function(e,n){p.save(e,t,n),l((t=>({...t,[e]:{preferredVersionName:n}})))}})),[t])]}function h(e){let{children:t}=e;const n=g();return(0,u.jsx)(m.Provider,{value:n,children:t})}function y(e){let{children:t}=e;return l.cE?(0,u.jsx)(h,{children:t}):(0,u.jsx)(u.Fragment,{children:t})}function b(){const e=(0,r.useContext)(m);if(!e)throw new s.i6("DocsPreferredVersionContextProvider");return e}function v(e){void 0===e&&(e=o.m);const t=(0,a.zh)(e),[n,i]=b(),{preferredVersionName:l}=n[e];return{preferredVersion:t.versions.find((e=>e.name===l))??null,savePreferredVersionName:(0,r.useCallback)((t=>{i.savePreferredVersion(e,t)}),[i,e])}}},8774:(e,t,n)=>{"use strict";n.d(t,{V:()=>c,b:()=>s});var r=n(7378),a=n(3879),o=n(4246);const i=Symbol("EmptyContext"),l=r.createContext(i);function s(e){let{children:t,name:n,items:a}=e;const i=(0,r.useMemo)((()=>n&&a?{name:n,items:a}:null),[n,a]);return(0,o.jsx)(l.Provider,{value:i,children:t})}function c(){const e=(0,r.useContext)(l);if(e===i)throw new a.i6("DocsSidebarProvider");return e}},2885:(e,t,n)=>{"use strict";n.d(t,{E:()=>s,q:()=>l});var r=n(7378),a=n(3879),o=n(4246);const i=r.createContext(null);function l(e){let{children:t,version:n}=e;return(0,o.jsx)(i.Provider,{value:n,children:t})}function s(){const e=(0,r.useContext)(i);if(null===e)throw new a.i6("DocsVersionProvider");return e}},9067:(e,t,n)=>{"use strict";n.d(t,{M:()=>p,e:()=>f});var r=n(7378),a=n(197),o=n(7980),i=n(8981),l=n(9899),s=n(3879),c=n(4246);const u=r.createContext(void 0);function d(){const e=function(){const e=(0,a.HY)(),{items:t}=(0,l.L)().navbar;return 0===t.length&&!e.component}(),t=(0,o.i)(),n=!e&&"mobile"===t,[s,c]=(0,r.useState)(!1);(0,i.Rb)((()=>{if(s)return c(!1),!1}));const u=(0,r.useCallback)((()=>{c((e=>!e))}),[]);return(0,r.useEffect)((()=>{"desktop"===t&&c(!1)}),[t]),(0,r.useMemo)((()=>({disabled:e,shouldRender:n,toggle:u,shown:s})),[e,n,u,s])}function p(e){let{children:t}=e;const n=d();return(0,c.jsx)(u.Provider,{value:n,children:t})}function f(){const e=r.useContext(u);if(void 0===e)throw new s.i6("NavbarMobileSidebarProvider");return e}},197:(e,t,n)=>{"use strict";n.d(t,{HY:()=>s,Zo:()=>c,n2:()=>l});var r=n(7378),a=n(3879),o=n(4246);const i=r.createContext(null);function l(e){let{children:t}=e;const n=(0,r.useState)({component:null,props:null});return(0,o.jsx)(i.Provider,{value:n,children:t})}function s(){const e=(0,r.useContext)(i);if(!e)throw new a.i6("NavbarSecondaryMenuContentProvider");return e[0]}function c(e){let{component:t,props:n}=e;const o=(0,r.useContext)(i);if(!o)throw new a.i6("NavbarSecondaryMenuContentProvider");const[,l]=o,s=(0,a.Ql)(n);return(0,r.useEffect)((()=>{l({component:t,props:s})}),[l,t,s]),(0,r.useEffect)((()=>()=>l({component:null,props:null})),[l]),null}},1706:(e,t,n)=>{"use strict";n.d(t,{h:()=>a,t:()=>o});var r=n(7378);const a="navigation-with-keyboard";function o(){(0,r.useEffect)((()=>{function e(e){"keydown"===e.type&&"Tab"===e.key&&document.body.classList.add(a),"mousedown"===e.type&&document.body.classList.remove(a)}return document.addEventListener("keydown",e),document.addEventListener("mousedown",e),()=>{document.body.classList.remove(a),document.removeEventListener("keydown",e),document.removeEventListener("mousedown",e)}}),[])}},7980:(e,t,n)=>{"use strict";n.d(t,{i:()=>l});var r=n(7378),a=n(5894);const o={desktop:"desktop",mobile:"mobile",ssr:"ssr"},i=996;function l(e){let{desktopBreakpoint:t=i}=void 0===e?{}:e;const[n,l]=(0,r.useState)((()=>"ssr"));return(0,r.useEffect)((()=>{function e(){l(function(e){if(!a.Z.canUseDOM)throw new Error("getWindowSize() should only be called after React hydration");return window.innerWidth>e?o.desktop:o.mobile}(t))}return e(),window.addEventListener("resize",e),()=>{window.removeEventListener("resize",e)}}),[t]),n}},5854:(e,t,n)=>{"use strict";n.d(t,{k:()=>r});const r={page:{blogListPage:"blog-list-page",blogPostPage:"blog-post-page",blogTagsListPage:"blog-tags-list-page",blogTagPostListPage:"blog-tags-post-list-page",docsDocPage:"docs-doc-page",docsTagsListPage:"docs-tags-list-page",docsTagDocListPage:"docs-tags-doc-list-page",mdxPage:"mdx-page"},wrapper:{main:"main-wrapper",blogPages:"blog-wrapper",docsPages:"docs-wrapper",mdxPages:"mdx-wrapper"},common:{editThisPage:"theme-edit-this-page",lastUpdated:"theme-last-updated",backToTopButton:"theme-back-to-top-button",codeBlock:"theme-code-block",admonition:"theme-admonition",unlistedBanner:"theme-unlisted-banner",admonitionType:e=>`theme-admonition-${e}`},layout:{},docs:{docVersionBanner:"theme-doc-version-banner",docVersionBadge:"theme-doc-version-badge",docBreadcrumbs:"theme-doc-breadcrumbs",docMarkdown:"theme-doc-markdown",docTocMobile:"theme-doc-toc-mobile",docTocDesktop:"theme-doc-toc-desktop",docFooter:"theme-doc-footer",docFooterTagsRow:"theme-doc-footer-tags-row",docFooterEditMetaRow:"theme-doc-footer-edit-meta-row",docSidebarContainer:"theme-doc-sidebar-container",docSidebarMenu:"theme-doc-sidebar-menu",docSidebarItemCategory:"theme-doc-sidebar-item-category",docSidebarItemLink:"theme-doc-sidebar-item-link",docSidebarItemCategoryLevel:e=>`theme-doc-sidebar-item-category-level-${e}`,docSidebarItemLinkLevel:e=>`theme-doc-sidebar-item-link-level-${e}`},blog:{}}},5122:(e,t,n)=>{"use strict";function r(){return window.matchMedia("(prefers-reduced-motion: reduce)").matches}n.d(t,{n:()=>r})},7470:(e,t,n)=>{"use strict";n.d(t,{LM:()=>f,SN:()=>E,_F:()=>h,cE:()=>p,f:()=>b,lO:()=>k,oz:()=>x,s1:()=>w,vY:()=>S});var r=n(7378),a=n(3620),o=n(5473),i=n(4924),l=n(8072),s=n(2885),c=n(8774),u=n(56),d=n(6440);const p=!!i._r;function f(e){return"link"!==e.type||e.unlisted?"category"===e.type?function(e){if(e.href&&!e.linkUnlisted)return e.href;for(const t of e.items){const e=f(t);if(e)return e}}(e):void 0:e.href}const m=(e,t)=>void 0!==e&&(0,d.Mg)(e,t),g=(e,t)=>e.some((e=>h(e,t)));function h(e,t){return"link"===e.type?m(e.href,t):"category"===e.type&&(m(e.href,t)||g(e.items,t))}function y(e,t){switch(e.type){case"category":return h(e,t)||e.items.some((e=>y(e,t)));case"link":return!e.unlisted||h(e,t);default:return!0}}function b(e,t){return(0,r.useMemo)((()=>e.filter((e=>y(e,t)))),[e,t])}function v(e){let{sidebarItems:t,pathname:n,onlyCategories:r=!1}=e;const a=[];return function e(t){for(const o of t)if("category"===o.type&&((0,d.Mg)(o.href,n)||e(o.items))||"link"===o.type&&(0,d.Mg)(o.href,n)){return r&&"category"!==o.type||a.unshift(o),!0}return!1}(t),a}function w(){const e=(0,c.V)(),{pathname:t}=(0,a.TH)(),n=(0,i.gA)()?.pluginData.breadcrumbs;return!1!==n&&e?v({sidebarItems:e.items,pathname:t}):null}function k(e){const{activeVersion:t}=(0,i.Iw)(e),{preferredVersion:n}=(0,l.J)(e),a=(0,i.yW)(e);return(0,r.useMemo)((()=>(0,u.j)([t,n,a].filter(Boolean))),[t,n,a])}function x(e,t){const n=k(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.sidebars?Object.entries(e.sidebars):[])),r=t.find((t=>t[0]===e));if(!r)throw new Error(`Can't find any sidebar with id "${e}" in version${n.length>1?"s":""} ${n.map((e=>e.name)).join(", ")}".\nAvailable sidebar ids are:\n- ${t.map((e=>e[0])).join("\n- ")}`);return r[1]}),[e,n])}function S(e,t){const n=k(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.docs)),r=t.find((t=>t.id===e));if(!r){if(n.flatMap((e=>e.draftIds)).includes(e))return null;throw new Error(`Couldn't find any doc with id "${e}" in version${n.length>1?"s":""} "${n.map((e=>e.name)).join(", ")}".\nAvailable doc ids are:\n- ${(0,u.j)(t.map((e=>e.id))).join("\n- ")}`)}return r}),[e,n])}function E(e){let{route:t}=e;const n=(0,a.TH)(),r=(0,s.E)(),i=t.routes,l=i.find((e=>(0,a.LX)(n.pathname,e)));if(!l)return null;const c=l.sidebar,u=c?r.docsSidebars[c]:void 0;return{docElement:(0,o.H)(i),sidebarName:c,sidebarItems:u}}},8981:(e,t,n)=>{"use strict";n.d(t,{Rb:()=>i,_X:()=>l});var r=n(7378),a=n(3620),o=n(3879);function i(e){!function(e){const t=(0,a.k6)(),n=(0,o.zX)(e);(0,r.useEffect)((()=>t.block(((e,t)=>n(e,t)))),[t,n])}(((t,n)=>{if("POP"===n)return e(t,n)}))}function l(e){return function(e){const t=(0,a.k6)();return(0,r.useSyncExternalStore)(t.listen,(()=>e(t)),(()=>e(t)))}((t=>null===e?null:new URLSearchParams(t.location.search).get(e)))}},56:(e,t,n)=>{"use strict";function r(e,t){return void 0===t&&(t=(e,t)=>e===t),e.filter(((n,r)=>e.findIndex((e=>t(e,n)))!==r))}function a(e){return Array.from(new Set(e))}n.d(t,{j:()=>a,l:()=>r})},8836:(e,t,n)=>{"use strict";n.d(t,{FG:()=>f,d:()=>d,VC:()=>m});var r=n(7378),a=n(624),o=n(2750),i=n(2729);function l(){const e=r.useContext(i._);if(!e)throw new Error("Unexpected: no Docusaurus route context found");return e}var s=n(1847),c=n(9939);var u=n(4246);function d(e){let{title:t,description:n,keywords:r,image:a,children:i}=e;const l=function(e){const{siteConfig:t}=(0,c.Z)(),{title:n,titleDelimiter:r}=t;return e?.trim().length?`${e.trim()} ${r} ${n}`:n}(t),{withBaseUrl:d}=(0,s.C)(),p=a?d(a,{absolute:!0}):void 0;return(0,u.jsxs)(o.Z,{children:[t&&(0,u.jsx)("title",{children:l}),t&&(0,u.jsx)("meta",{property:"og:title",content:l}),n&&(0,u.jsx)("meta",{name:"description",content:n}),n&&(0,u.jsx)("meta",{property:"og:description",content:n}),r&&(0,u.jsx)("meta",{name:"keywords",content:Array.isArray(r)?r.join(","):r}),p&&(0,u.jsx)("meta",{property:"og:image",content:p}),p&&(0,u.jsx)("meta",{name:"twitter:image",content:p}),i]})}const p=r.createContext(void 0);function f(e){let{className:t,children:n}=e;const i=r.useContext(p),l=(0,a.Z)(i,t);return(0,u.jsxs)(p.Provider,{value:l,children:[(0,u.jsx)(o.Z,{children:(0,u.jsx)("html",{className:l})}),n]})}function m(e){let{children:t}=e;const n=l(),r=`plugin-${n.plugin.name.replace(/docusaurus-(?:plugin|theme)-(?:content-)?/gi,"")}`;const o=`plugin-id-${n.plugin.id}`;return(0,u.jsx)(f,{className:(0,a.Z)(r,o),children:t})}},3879:(e,t,n)=>{"use strict";n.d(t,{D9:()=>l,Qc:()=>u,Ql:()=>c,i6:()=>s,zX:()=>i});var r=n(7378),a=n(9749),o=n(4246);function i(e){const t=(0,r.useRef)(e);return(0,a.Z)((()=>{t.current=e}),[e]),(0,r.useCallback)((function(){return t.current(...arguments)}),[])}function l(e){const t=(0,r.useRef)();return(0,a.Z)((()=>{t.current=e})),t.current}class s extends Error{constructor(e,t){super(),this.name="ReactContextError",this.message=`Hook ${this.stack?.split("\n")[1]?.match(/at (?:\w+\.)?(?