[{"data":1,"prerenderedAt":420},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Fnitro\u002Frules\u002Fstructure\u002Fprefer-server-utils":44},[4,8,12,16,20,24,28,32,36,40],{"title":5,"path":6,"stem":7},"CLI","\u002Fcli","1.cli",{"title":9,"path":10,"stem":11},"Nuxt","\u002Fnuxt","2.nuxt",{"title":13,"path":14,"stem":15},"Vue","\u002Fvue","3.vue",{"title":17,"path":18,"stem":19},"Vite","\u002Fvite","4.vite",{"title":21,"path":22,"stem":23},"Nitro","\u002Fnitro","5.nitro",{"title":25,"path":26,"stem":27},"TypeScript","\u002Ftypescript","6.typescript",{"title":29,"path":30,"stem":31},"shadcn","\u002Fshadcn","7.shadcn",{"title":33,"path":34,"stem":35},"Package","\u002Fpackage","8.package",{"title":37,"path":38,"stem":39},"Extending Doctor","\u002Fextending","9.extending",{"title":41,"path":42,"stem":43},"Pinia","\u002Fpinia","9.pinia",{"id":45,"title":46,"body":47,"category":53,"description":407,"diagnosticCodes":408,"docsUrl":55,"extension":411,"fix":56,"framework":412,"meta":413,"navigation":414,"pack":57,"path":416,"recommendedReplacement":125,"ruleId":58,"seo":417,"severity":59,"source":60,"sourceUrl":61,"stem":418,"why":118,"__hash__":419},"rules\u002Fnitro\u002Frules\u002Fstructure\u002Fprefer-server-utils.md","Keep Nitro server helpers in server\u002Futils",{"type":48,"value":49,"toc":398},"minimark",[50,62,67,111,115,119,123,126,130,149,153,158,161,312,315,394],[51,52],"rule-metadata",{"category":53,"diagnosticCodes":54,"docsUrl":55,"fix":56,"pack":57,"ruleId":58,"severity":59,"source":60,"sourceUrl":61},"imports","NITRO0021,NITRO0022","https:\u002F\u002Fnuxt.com\u002Fdocs\u002F4.x\u002Fguide\u002Fdirectory-structure\u002Fserver#server-utilities","suggestion","vite-doctor\u002Fnitro","nitro\u002Fstructure\u002Fprefer-server-utils","info","src\u002Frule-packs\u002Fnitro\u002Frules\u002Fprefer-server-utils.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fnitro\u002Frules\u002Fprefer-server-utils.ts",[63,64,66],"h2",{"id":65},"run-this-rule","Run this rule",[68,69,74],"pre",{"className":70,"code":71,"language":72,"meta":73,"style":73},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --framework nitro --extends auto,nitro\u002Fstrict --rules nitro\u002Fstructure\u002Fprefer-server-utils\n","bash","",[75,76,77],"code",{"__ignoreMap":73},[78,79,82,86,90,93,96,99,102,105,108],"span",{"class":80,"line":81},"line",1,[78,83,85],{"class":84},"sBMFI","pnpm",[78,87,89],{"class":88},"sfazB"," vite-doctor",[78,91,92],{"class":88}," .",[78,94,95],{"class":88}," --framework",[78,97,98],{"class":88}," nitro",[78,100,101],{"class":88}," --extends",[78,103,104],{"class":88}," auto,nitro\u002Fstrict",[78,106,107],{"class":88}," --rules",[78,109,110],{"class":88}," nitro\u002Fstructure\u002Fprefer-server-utils\n",[63,112,114],{"id":113},"why-it-matters","Why it matters",[116,117,118],"p",{},"Nitro 2 and Nuxt auto-import exports from server\u002Futils in server code and generate their types. Helpers kept in directories such as server\u002Flib or server\u002Fhelpers need a relative import in every caller.",[63,120,122],{"id":121},"recommended-fix","Recommended fix",[116,124,125],{},"Move shared server helpers to server\u002Futils\u002F when server auto-imports are enabled. NITRO0022 is currently suppressed: Doctor does not yet capture Nitro’s resolved provider and exclusion evidence, so it cannot establish that an explicit utility import selects the same implementation as an auto-import.",[63,127,129],{"id":128},"useful-links","Useful links",[131,132,133,142],"ul",{},[134,135,136],"li",{},[137,138,141],"a",{"href":55,"rel":139},[140],"nofollow","Rule reference",[134,143,144],{},[137,145,148],{"href":146,"rel":147},"https:\u002F\u002Fnitro.build\u002Fguide\u002Frouting",[140],"Nitro handlers",[63,150,152],{"id":151},"example","Example",[154,155,157],"h3",{"id":156},"let-nitro-auto-import-server-helpers","Let Nitro auto-import server helpers",[116,159,160],{},"Before",[68,162,166],{"className":163,"code":164,"language":165,"meta":73,"style":73},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F server\u002Fapi\u002Fadmin\u002Fusers.get.ts\nimport { requireAdmin } from '..\u002F..\u002Flib\u002Fauth'\nimport { paginate } from '..\u002F..\u002Fhelpers\u002Fpaginate'\n\nexport default defineEventHandler(async (event) => {\n  await requireAdmin(event)\n  return paginate(event, users)\n})\n","ts",[75,167,168,174,204,225,232,268,284,304],{"__ignoreMap":73},[78,169,170],{"class":80,"line":81},[78,171,173],{"class":172},"sHwdD","\u002F\u002F server\u002Fapi\u002Fadmin\u002Fusers.get.ts\n",[78,175,177,181,185,189,192,195,198,201],{"class":80,"line":176},2,[78,178,180],{"class":179},"s7zQu","import",[78,182,184],{"class":183},"sMK4o"," {",[78,186,188],{"class":187},"sTEyZ"," requireAdmin",[78,190,191],{"class":183}," }",[78,193,194],{"class":179}," from",[78,196,197],{"class":183}," '",[78,199,200],{"class":88},"..\u002F..\u002Flib\u002Fauth",[78,202,203],{"class":183},"'\n",[78,205,207,209,211,214,216,218,220,223],{"class":80,"line":206},3,[78,208,180],{"class":179},[78,210,184],{"class":183},[78,212,213],{"class":187}," paginate",[78,215,191],{"class":183},[78,217,194],{"class":179},[78,219,197],{"class":183},[78,221,222],{"class":88},"..\u002F..\u002Fhelpers\u002Fpaginate",[78,224,203],{"class":183},[78,226,228],{"class":80,"line":227},4,[78,229,231],{"emptyLinePlaceholder":230},true,"\n",[78,233,235,238,241,245,248,252,255,259,262,265],{"class":80,"line":234},5,[78,236,237],{"class":179},"export",[78,239,240],{"class":179}," default",[78,242,244],{"class":243},"s2Zo4"," defineEventHandler",[78,246,247],{"class":187},"(",[78,249,251],{"class":250},"spNyl","async",[78,253,254],{"class":183}," (",[78,256,258],{"class":257},"sHdIc","event",[78,260,261],{"class":183},")",[78,263,264],{"class":250}," =>",[78,266,267],{"class":183}," {\n",[78,269,271,274,276,279,281],{"class":80,"line":270},6,[78,272,273],{"class":179},"  await",[78,275,188],{"class":243},[78,277,247],{"class":278},"swJcz",[78,280,258],{"class":187},[78,282,283],{"class":278},")\n",[78,285,287,290,292,294,296,299,302],{"class":80,"line":286},7,[78,288,289],{"class":179},"  return",[78,291,213],{"class":243},[78,293,247],{"class":278},[78,295,258],{"class":187},[78,297,298],{"class":183},",",[78,300,301],{"class":187}," users",[78,303,283],{"class":278},[78,305,307,310],{"class":80,"line":306},8,[78,308,309],{"class":183},"}",[78,311,283],{"class":187},[116,313,314],{},"After",[68,316,318],{"className":163,"code":317,"language":165,"meta":73,"style":73},"\u002F\u002F server\u002Futils\u002Fauth.ts exports requireAdmin\n\u002F\u002F server\u002Futils\u002Fpaginate.ts exports paginate\n\n\u002F\u002F server\u002Fapi\u002Fadmin\u002Fusers.get.ts\nexport default defineEventHandler(async (event) => {\n  await requireAdmin(event)\n  return paginate(event, users)\n})\n",[75,319,320,325,330,334,338,360,372,388],{"__ignoreMap":73},[78,321,322],{"class":80,"line":81},[78,323,324],{"class":172},"\u002F\u002F server\u002Futils\u002Fauth.ts exports requireAdmin\n",[78,326,327],{"class":80,"line":176},[78,328,329],{"class":172},"\u002F\u002F server\u002Futils\u002Fpaginate.ts exports paginate\n",[78,331,332],{"class":80,"line":206},[78,333,231],{"emptyLinePlaceholder":230},[78,335,336],{"class":80,"line":227},[78,337,173],{"class":172},[78,339,340,342,344,346,348,350,352,354,356,358],{"class":80,"line":234},[78,341,237],{"class":179},[78,343,240],{"class":179},[78,345,244],{"class":243},[78,347,247],{"class":187},[78,349,251],{"class":250},[78,351,254],{"class":183},[78,353,258],{"class":257},[78,355,261],{"class":183},[78,357,264],{"class":250},[78,359,267],{"class":183},[78,361,362,364,366,368,370],{"class":80,"line":270},[78,363,273],{"class":179},[78,365,188],{"class":243},[78,367,247],{"class":278},[78,369,258],{"class":187},[78,371,283],{"class":278},[78,373,374,376,378,380,382,384,386],{"class":80,"line":286},[78,375,289],{"class":179},[78,377,213],{"class":243},[78,379,247],{"class":278},[78,381,258],{"class":187},[78,383,298],{"class":183},[78,385,301],{"class":187},[78,387,283],{"class":278},[78,389,390,392],{"class":80,"line":306},[78,391,309],{"class":183},[78,393,283],{"class":187},[395,396,397],"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 .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 .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":73,"searchDepth":176,"depth":176,"links":399},[400,401,402,403,404],{"id":65,"depth":176,"text":66},{"id":113,"depth":176,"text":114},{"id":121,"depth":176,"text":122},{"id":128,"depth":176,"text":129},{"id":151,"depth":176,"text":152,"children":405},[406],{"id":156,"depth":206,"text":157},"Suggests server\u002Futils for helpers that Nitro server routes, middleware, and plugins import from ad-hoc directories.",[409,410],"NITRO0021","NITRO0022","md","nitro",{},{"title":415},"server\u002Futils helpers","\u002Fnitro\u002Frules\u002Fstructure\u002Fprefer-server-utils",{"title":46,"description":407},"nitro\u002Frules\u002Fstructure\u002Fprefer-server-utils","YMLpbqnFZb-Yw0UsGhuvGq2pwBXXk6LzFoMpaprWta8",1791309464405]