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