[{"data":1,"prerenderedAt":617},["ShallowReactive",2],{"navigation_docs":3,"diagnostic-content-NITRO0023":48},[4,8,12,16,20,24,28,32,36,40,44],{"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},"MCP","\u002Fmcp","9.mcp",{"title":45,"path":46,"stem":47},"Pinia","\u002Fpinia","9.pinia",{"id":49,"title":50,"body":51,"category":57,"code":607,"description":608,"docsUrl":58,"extension":609,"fix":610,"framework":611,"meta":612,"navigation":180,"pack":60,"path":613,"ruleId":61,"rulePath":62,"seo":614,"severity":63,"source":64,"sourceUrl":65,"stem":615,"why":74,"__hash__":616},"diagnostics\u002Fdiagnostics\u002FNITRO0023.md","NITRO0023: Cache upstream responses with defineCachedFunction",{"type":52,"value":53,"toc":597},"minimark",[54,66,71,75,79,87,91,96,99,395,398,522,526,529,565,569,581,585,593],[55,56],"rule-metadata",{"category":57,"docsUrl":58,"fix":59,"pack":60,"ruleId":61,"rulePath":62,"severity":63,"source":64,"sourceUrl":65},"cache","https:\u002F\u002Fnitro.build\u002Fdocs\u002Fcache","suggestion","vite-doctor\u002Fnitro","nitro\u002Fcache\u002Fno-module-scope-response-cache","\u002Fnitro\u002Frules\u002Fcache\u002Fno-module-scope-response-cache","warn","src\u002Frule-packs\u002Fnitro\u002Frules\u002Fno-module-scope-response-cache.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fnitro\u002Frules\u002Fno-module-scope-response-cache.ts",[67,68,70],"h2",{"id":69},"why-it-happens","Why it happens",[72,73,74],"p",{},"A module-scope cache with an expiry check lives in one server instance or worker isolate. Each instance warms its own copy, entries for keys nobody asks for again are never evicted, and Nitro's cache storage, invalidation, and stale-while-revalidate cannot see it. The key is whatever the author remembered to include: when a request-scoped client, such as one authorized as the current user, fills the cache, the next caller with the same key gets that user's response.",[67,76,78],{"id":77},"fix","Fix",[72,80,81,82,86],{},"Wrap the upstream call in ",[83,84,85],"code",{},"defineCachedFunction()"," with a maxAge and a getKey that covers every input that changes the response, including the user or tenant when the client is authorized per request. Values that cannot be serialized to cache storage, such as compiled validators, can stay in memory; suppress the diagnostic with a comment that says why.",[67,88,90],{"id":89},"example","Example",[92,93,95],"h3",{"id":94},"cache-upstream-responses-with-definecachedfunction","Cache upstream responses with defineCachedFunction",[72,97,98],{},"Before",[100,101,106],"pre",{"className":102,"code":103,"language":104,"meta":105,"style":105},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const labelCache = new Map\u003Cstring, { labels: string[]; expiry: number }>()\n\nexport async function getLabels(group: string) {\n  const cached = labelCache.get(group)\n  if (cached && cached.expiry > Date.now()) return cached.labels\n  const labels = await $fetch\u003Cstring[]>(`\u002Flabels\u002F${group}`)\n  labelCache.set(group, { labels, expiry: Date.now() + 60_000 })\n  return labels\n}\n","ts","",[83,107,108,175,182,215,243,289,332,380,389],{"__ignoreMap":105},[109,110,113,117,121,125,128,132,135,139,142,145,149,152,155,158,161,164,166,169,172],"span",{"class":111,"line":112},"line",1,[109,114,116],{"class":115},"spNyl","const",[109,118,120],{"class":119},"sTEyZ"," labelCache ",[109,122,124],{"class":123},"sMK4o","=",[109,126,127],{"class":123}," new",[109,129,131],{"class":130},"s2Zo4"," Map",[109,133,134],{"class":123},"\u003C",[109,136,138],{"class":137},"sBMFI","string",[109,140,141],{"class":123},",",[109,143,144],{"class":123}," {",[109,146,148],{"class":147},"swJcz"," labels",[109,150,151],{"class":123},":",[109,153,154],{"class":137}," string",[109,156,157],{"class":119},"[]",[109,159,160],{"class":123},";",[109,162,163],{"class":147}," expiry",[109,165,151],{"class":123},[109,167,168],{"class":137}," number",[109,170,171],{"class":123}," }>",[109,173,174],{"class":119},"()\n",[109,176,178],{"class":111,"line":177},2,[109,179,181],{"emptyLinePlaceholder":180},true,"\n",[109,183,185,189,192,195,198,201,205,207,209,212],{"class":111,"line":184},3,[109,186,188],{"class":187},"s7zQu","export",[109,190,191],{"class":115}," async",[109,193,194],{"class":115}," function",[109,196,197],{"class":130}," getLabels",[109,199,200],{"class":123},"(",[109,202,204],{"class":203},"sHdIc","group",[109,206,151],{"class":123},[109,208,154],{"class":137},[109,210,211],{"class":123},")",[109,213,214],{"class":123}," {\n",[109,216,218,221,224,227,230,233,236,238,240],{"class":111,"line":217},4,[109,219,220],{"class":115},"  const",[109,222,223],{"class":119}," cached",[109,225,226],{"class":123}," =",[109,228,229],{"class":119}," labelCache",[109,231,232],{"class":123},".",[109,234,235],{"class":130},"get",[109,237,200],{"class":147},[109,239,204],{"class":119},[109,241,242],{"class":147},")\n",[109,244,246,249,252,255,258,260,262,265,268,271,273,276,279,282,284,286],{"class":111,"line":245},5,[109,247,248],{"class":187},"  if",[109,250,251],{"class":147}," (",[109,253,254],{"class":119},"cached",[109,256,257],{"class":123}," &&",[109,259,223],{"class":119},[109,261,232],{"class":123},[109,263,264],{"class":119},"expiry",[109,266,267],{"class":123}," >",[109,269,270],{"class":119}," Date",[109,272,232],{"class":123},[109,274,275],{"class":130},"now",[109,277,278],{"class":147},"()) ",[109,280,281],{"class":187},"return",[109,283,223],{"class":119},[109,285,232],{"class":123},[109,287,288],{"class":119},"labels\n",[109,290,292,294,296,298,301,304,306,308,310,313,315,318,322,325,327,330],{"class":111,"line":291},6,[109,293,220],{"class":115},[109,295,148],{"class":119},[109,297,226],{"class":123},[109,299,300],{"class":187}," await",[109,302,303],{"class":130}," $fetch",[109,305,134],{"class":123},[109,307,138],{"class":137},[109,309,157],{"class":147},[109,311,312],{"class":123},">",[109,314,200],{"class":147},[109,316,317],{"class":123},"`",[109,319,321],{"class":320},"sfazB","\u002Flabels\u002F",[109,323,324],{"class":123},"${",[109,326,204],{"class":119},[109,328,329],{"class":123},"}`",[109,331,242],{"class":147},[109,333,335,338,340,343,345,347,349,351,353,355,357,359,361,363,365,368,371,375,378],{"class":111,"line":334},7,[109,336,337],{"class":119},"  labelCache",[109,339,232],{"class":123},[109,341,342],{"class":130},"set",[109,344,200],{"class":147},[109,346,204],{"class":119},[109,348,141],{"class":123},[109,350,144],{"class":123},[109,352,148],{"class":119},[109,354,141],{"class":123},[109,356,163],{"class":147},[109,358,151],{"class":123},[109,360,270],{"class":119},[109,362,232],{"class":123},[109,364,275],{"class":130},[109,366,367],{"class":147},"() ",[109,369,370],{"class":123},"+",[109,372,374],{"class":373},"sbssI"," 60_000",[109,376,377],{"class":123}," }",[109,379,242],{"class":147},[109,381,383,386],{"class":111,"line":382},8,[109,384,385],{"class":187},"  return",[109,387,388],{"class":119}," labels\n",[109,390,392],{"class":111,"line":391},9,[109,393,394],{"class":123},"}\n",[72,396,397],{},"After",[100,399,401],{"className":102,"code":400,"language":104,"meta":105,"style":105},"export const getLabels = defineCachedFunction(\n  (group: string) => $fetch\u003Cstring[]>(`\u002Flabels\u002F${group}`),\n  { name: 'labels', maxAge: 60, getKey: (group: string) => group },\n)\n",[83,402,403,421,464,518],{"__ignoreMap":105},[109,404,405,407,410,413,415,418],{"class":111,"line":112},[109,406,188],{"class":187},[109,408,409],{"class":115}," const",[109,411,412],{"class":119}," getLabels ",[109,414,124],{"class":123},[109,416,417],{"class":130}," defineCachedFunction",[109,419,420],{"class":119},"(\n",[109,422,423,426,428,430,432,434,437,439,441,443,445,447,449,451,453,455,457,459,461],{"class":111,"line":177},[109,424,425],{"class":123},"  (",[109,427,204],{"class":203},[109,429,151],{"class":123},[109,431,154],{"class":137},[109,433,211],{"class":123},[109,435,436],{"class":115}," =>",[109,438,303],{"class":130},[109,440,134],{"class":123},[109,442,138],{"class":137},[109,444,157],{"class":119},[109,446,312],{"class":123},[109,448,200],{"class":119},[109,450,317],{"class":123},[109,452,321],{"class":320},[109,454,324],{"class":123},[109,456,204],{"class":119},[109,458,329],{"class":123},[109,460,211],{"class":119},[109,462,463],{"class":123},",\n",[109,465,466,469,472,474,477,480,483,485,488,490,493,495,498,500,502,504,506,508,510,512,515],{"class":111,"line":184},[109,467,468],{"class":123},"  {",[109,470,471],{"class":147}," name",[109,473,151],{"class":123},[109,475,476],{"class":123}," '",[109,478,479],{"class":320},"labels",[109,481,482],{"class":123},"'",[109,484,141],{"class":123},[109,486,487],{"class":147}," maxAge",[109,489,151],{"class":123},[109,491,492],{"class":373}," 60",[109,494,141],{"class":123},[109,496,497],{"class":130}," getKey",[109,499,151],{"class":123},[109,501,251],{"class":123},[109,503,204],{"class":203},[109,505,151],{"class":123},[109,507,154],{"class":137},[109,509,211],{"class":123},[109,511,436],{"class":115},[109,513,514],{"class":119}," group ",[109,516,517],{"class":123},"},\n",[109,519,520],{"class":111,"line":217},[109,521,242],{"class":119},[67,523,525],{"id":524},"verify-the-fix","Verify the fix",[72,527,528],{},"Run only this rule after editing so the report stays focused on the diagnostic you are closing:",[100,530,534],{"className":531,"code":532,"language":533,"meta":105,"style":105},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --framework nitro --extends auto,nitro\u002Fstrict --rules nitro\u002Fcache\u002Fno-module-scope-response-cache\n","bash",[83,535,536],{"__ignoreMap":105},[109,537,538,541,544,547,550,553,556,559,562],{"class":111,"line":112},[109,539,540],{"class":137},"pnpm",[109,542,543],{"class":320}," vite-doctor",[109,545,546],{"class":320}," .",[109,548,549],{"class":320}," --framework",[109,551,552],{"class":320}," nitro",[109,554,555],{"class":320}," --extends",[109,557,558],{"class":320}," auto,nitro\u002Fstrict",[109,560,561],{"class":320}," --rules",[109,563,564],{"class":320}," nitro\u002Fcache\u002Fno-module-scope-response-cache\n",[67,566,568],{"id":567},"useful-links","Useful links",[570,571,572],"ul",{},[573,574,575],"li",{},[576,577,580],"a",{"href":58,"rel":578},[579],"nofollow","Upstream docs",[67,582,584],{"id":583},"related-rule","Related rule",[570,586,587],{},[573,588,589],{},[576,590,591],{"href":62},[83,592,61],{},[594,595,596],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .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 .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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);}",{"title":105,"searchDepth":177,"depth":177,"links":598},[599,600,601,604,605,606],{"id":69,"depth":177,"text":70},{"id":77,"depth":177,"text":78},{"id":89,"depth":177,"text":90,"children":602},[603],{"id":94,"depth":184,"text":95},{"id":524,"depth":177,"text":525},{"id":567,"depth":177,"text":568},{"id":583,"depth":177,"text":584},"NITRO0023","Report module-scope Maps and reassigned variables that server code uses as hand-rolled TTL caches for upstream responses.","md","Wrap the upstream call in defineCachedFunction() with a maxAge and a getKey that covers every input that changes the response, including the user or tenant when the client is authorized per request. Values that cannot be serialized to cache storage, such as compiled validators, can stay in memory; suppress the diagnostic with a comment that says why.","nitro",{},"\u002Fdiagnostics\u002Fnitro0023",{"title":50,"description":608},"diagnostics\u002FNITRO0023","VkbZVRRRYSCXeiph8DxB0GVqQ2rrBVeVtOBUa1U6vUk",1795268817115]