isr-engine 4.1.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +9 -0
  2. package/dist/CacheTagContext-Btmq8KCD.js +69 -0
  3. package/dist/CacheTagContext-Btmq8KCD.js.map +1 -0
  4. package/dist/{abVariantContext-CGBlCt0q.js → abVariantContext-yWZOqscY.js} +118 -38
  5. package/dist/abVariantContext-yWZOqscY.js.map +1 -0
  6. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -1
  7. package/dist/cache/RedisResponseCacheBackend.d.ts +1 -0
  8. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -1
  9. package/dist/cache/ResponseCacheBackend.d.ts +6 -0
  10. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/config/defineConfig.js +1 -1
  13. package/dist/context/CacheTagContext.d.ts +10 -0
  14. package/dist/context/CacheTagContext.d.ts.map +1 -0
  15. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js → createCacheInspectorMiddleware-glgtcBcQ.js} +2 -2
  16. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js.map → createCacheInspectorMiddleware-glgtcBcQ.js.map} +1 -1
  17. package/dist/createCachedFetcher-CgJscexq.js +186 -0
  18. package/dist/createCachedFetcher-CgJscexq.js.map +1 -0
  19. package/dist/{createISRApp-DTlZvKBm.js → createISRApp-BG-s3uuL.js} +356 -162
  20. package/dist/createISRApp-BG-s3uuL.js.map +1 -0
  21. package/dist/defaults/runtime/contentRevalidation.d.ts +26 -0
  22. package/dist/defaults/runtime/contentRevalidation.d.ts.map +1 -0
  23. package/dist/defaults/runtime/createCachedFetcher.d.ts +8 -2
  24. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -1
  25. package/dist/defaults/runtime/defineSiteHooks.d.ts +4 -7
  26. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
  27. package/dist/defaults/runtime/defineSiteHooks.js +655 -2
  28. package/dist/defaults/runtime/defineSiteHooks.js.map +1 -0
  29. package/dist/defaults/runtime/locale-links.client.d.ts.map +1 -1
  30. package/dist/defaults/runtime/renderCancellation.d.ts +3 -0
  31. package/dist/defaults/runtime/renderCancellation.d.ts.map +1 -0
  32. package/dist/engine/ISREngine.d.ts.map +1 -1
  33. package/dist/engine/seo/SEOEngine.d.ts +3 -0
  34. package/dist/engine/seo/SEOEngine.d.ts.map +1 -1
  35. package/dist/engine/seo/resolveSeoConfig.d.ts +6 -0
  36. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -1
  37. package/dist/{i18n-B2mWmifk.js → i18n-BZpAOZeO.js} +3 -2
  38. package/dist/{i18n-B2mWmifk.js.map → i18n-BZpAOZeO.js.map} +1 -1
  39. package/dist/index.d.ts +2 -2
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/isr/ISRRoutes.d.ts +2 -0
  42. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  43. package/dist/isr-engine.js +7 -7
  44. package/dist/middlewares/LocaleRedirect.d.ts +4 -3
  45. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  46. package/dist/plugin/coherentCacheStore.d.ts.map +1 -1
  47. package/dist/plugin/isrCacheMiddleware.d.ts +7 -6
  48. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  49. package/dist/plugin/isrCacheStore.d.ts +2 -0
  50. package/dist/plugin/isrCacheStore.d.ts.map +1 -1
  51. package/dist/rsc/browser.d.ts +3 -0
  52. package/dist/rsc/browser.d.ts.map +1 -1
  53. package/dist/rsc/browser.js +4 -9
  54. package/dist/rsc/browser.js.map +1 -1
  55. package/dist/rsc/cacheTag.d.ts +1 -8
  56. package/dist/rsc/cacheTag.d.ts.map +1 -1
  57. package/dist/rsc/index.d.ts +1 -1
  58. package/dist/rsc/index.d.ts.map +1 -1
  59. package/dist/rsc/index.js +4 -3
  60. package/dist/rsc/revalidate.d.ts +18 -9
  61. package/dist/rsc/revalidate.d.ts.map +1 -1
  62. package/dist/{rsc-DWwcqD4W.js → rsc-BYq2vvnh.js} +2 -2
  63. package/dist/{rsc-DWwcqD4W.js.map → rsc-BYq2vvnh.js.map} +1 -1
  64. package/dist/runtime/LocaleLink.d.ts.map +1 -1
  65. package/dist/runtime/i18n.d.ts +3 -0
  66. package/dist/runtime/i18n.d.ts.map +1 -1
  67. package/dist/runtime/localePreference.d.ts +7 -0
  68. package/dist/runtime/localePreference.d.ts.map +1 -0
  69. package/dist/server/contentRevalidationRoute.d.ts +4 -0
  70. package/dist/server/contentRevalidationRoute.d.ts.map +1 -0
  71. package/dist/server/manager.d.ts.map +1 -1
  72. package/dist/server/opsConfig.d.ts +6 -1
  73. package/dist/server/opsConfig.d.ts.map +1 -1
  74. package/dist/server/productionRuntime.d.ts +2 -0
  75. package/dist/server/productionRuntime.d.ts.map +1 -1
  76. package/dist/server/publishedSitemap.d.ts +8 -0
  77. package/dist/server/publishedSitemap.d.ts.map +1 -0
  78. package/dist/types/ISRConfig.d.ts +27 -0
  79. package/dist/types/ISRConfig.d.ts.map +1 -1
  80. package/dist/utils/cookie.d.ts +2 -2
  81. package/dist/utils/cookie.d.ts.map +1 -1
  82. package/dist/utils/isrPath.d.ts +6 -0
  83. package/dist/utils/isrPath.d.ts.map +1 -0
  84. package/package.json +2 -2
  85. package/src/context/CacheTagContext.ts +20 -0
  86. package/src/defaults/entry.server.ssr.tsx +10 -0
  87. package/src/defaults/runtime/contentRevalidation.ts +96 -0
  88. package/src/defaults/runtime/createCachedFetcher.ts +76 -20
  89. package/src/defaults/runtime/defineServerEntry.tsx +30 -29
  90. package/src/defaults/runtime/defineSiteHooks.ts +117 -80
  91. package/src/defaults/runtime/locale-links.client.ts +14 -4
  92. package/src/defaults/runtime/renderCancellation.ts +10 -0
  93. package/src/runtime/LocaleLink.tsx +8 -2
  94. package/src/runtime/i18n.ts +4 -0
  95. package/src/runtime/localePreference.ts +36 -0
  96. package/src/types/ISRConfig.ts +29 -0
  97. package/src/utils/cookie.ts +11 -4
  98. package/src/utils/isrPath.ts +24 -0
  99. package/dist/abVariantContext-CGBlCt0q.js.map +0 -1
  100. package/dist/cookie-DcUeYm6E.js +0 -42
  101. package/dist/cookie-DcUeYm6E.js.map +0 -1
  102. package/dist/createISRApp-DTlZvKBm.js.map +0 -1
  103. package/dist/defineSiteHooks-iwLiVChy.js +0 -716
  104. package/dist/defineSiteHooks-iwLiVChy.js.map +0 -1
@@ -0,0 +1,186 @@
1
+ // src/utils/isrPath.ts
2
+ var RSC_URL_POSTFIX = "_.rsc";
3
+ function stripQuery(url) {
4
+ const index = url.indexOf("?");
5
+ return index === -1 ? url : url.slice(0, index);
6
+ }
7
+ function stripRscSuffix(path) {
8
+ if (path.endsWith(`/_.rsc`)) return path.slice(0, -6) || "/";
9
+ if (path.endsWith("_.rsc")) return path.slice(0, -5) || "/";
10
+ return path;
11
+ }
12
+ function normalizePath(path) {
13
+ return path.startsWith("/") ? path : "/" + path;
14
+ }
15
+ function contentPathname(path) {
16
+ return stripRscSuffix(normalizePath(stripQuery(path)));
17
+ }
18
+ // src/utils/cookie.ts
19
+ function getCookieHeader(source) {
20
+ if (!source) return "";
21
+ if (typeof source === "string") return source;
22
+ const headers = source.headers;
23
+ if (!headers) return "";
24
+ if (typeof headers.get === "function") return headers.get("cookie") ?? "";
25
+ const record = headers;
26
+ const raw = record.cookie ?? record.Cookie;
27
+ if (Array.isArray(raw)) return raw.join("; ");
28
+ return raw === void 0 || raw === null ? "" : String(raw);
29
+ }
30
+ function readCookie(source, name, duplicate = "last") {
31
+ if (!name) return void 0;
32
+ return parseCookieHeader(getCookieHeader(source), duplicate)[name];
33
+ }
34
+ function parseCookieHeader(header, duplicate = "last") {
35
+ const entries = /* @__PURE__ */ new Map();
36
+ for (const part of header.split(";")) {
37
+ const trimmed = part.trim();
38
+ if (!trimmed) continue;
39
+ const index = trimmed.indexOf("=");
40
+ if (index <= 0) continue;
41
+ const key = trimmed.slice(0, index).trim();
42
+ if (!key || duplicate === "first" && entries.has(key)) continue;
43
+ const rawValue = trimmed.slice(index + 1).trim();
44
+ entries.set(key, safeDecodeCookieValue(rawValue));
45
+ }
46
+ const cookies = Object.fromEntries(entries);
47
+ Object.setPrototypeOf(cookies, null);
48
+ return cookies;
49
+ }
50
+ function safeDecodeCookieValue(value) {
51
+ try {
52
+ return decodeURIComponent(value);
53
+ } catch {
54
+ return value;
55
+ }
56
+ }
57
+ // src/runtime/localePreference.ts
58
+ var LOCALE_PREFERENCE_COOKIE_NAME = "isr_locale";
59
+ function isSupportedLocalePreference(locale, config) {
60
+ return config.prefixDefault === true && config.rememberLocale === true && locale !== void 0 && config.locales.includes(locale);
61
+ }
62
+ function readLocalePreference(source, config) {
63
+ if (!config.rememberLocale || !config.prefixDefault) return void 0;
64
+ const locale = readCookie(source, LOCALE_PREFERENCE_COOKIE_NAME);
65
+ return isSupportedLocalePreference(locale, config) ? locale : void 0;
66
+ }
67
+ // src/defaults/runtime/createCachedFetcher.ts
68
+ /**
69
+ * createCachedFetcher —— 通用 TTL + 并发去重数据加载器
70
+ *
71
+ * 设计目标:
72
+ * - 给 i18n / SEO 这类「url 或本地 json」加载场景一个唯一的成熟实现
73
+ * - 同 key 的并发请求自动合并为一次(避免缓存击穿)
74
+ * - 过期后台刷新可选(SWR 模式)
75
+ *
76
+ * 用例:
77
+ * const loadMessages = createCachedFetcher<IntlPayload>({
78
+ * key: ({ locale }) => `intl:${locale}`,
79
+ * ttl: 60_000,
80
+ * fetch: async ({ locale }) => {
81
+ * const r = await fetch(`https://cdn.example.com/i18n/${locale}.json`);
82
+ * return r.json();
83
+ * },
84
+ * });
85
+ *
86
+ * // 在 hook 里用:
87
+ * loadIntl: (url) => loadMessages({ locale: detectLocale(url) }),
88
+ */
89
+ /**
90
+ * 极简 LRU —— 利用 Map 的插入顺序保留特性
91
+ *
92
+ * 不引外部 lru-cache 包是为了规避用户 RSC bundle 的 ESM/CJS interop 抖动
93
+ * (lru-cache@10 双发布在 rolldown 里偶发 default vs 命名导出错位)
94
+ * 本文件用于 i18n / SEO 数据的请求级缓存(典型 < 100 条),简单 Map 完全够用
95
+ */
96
+ var TinyLRU = class {
97
+ max;
98
+ store = /* @__PURE__ */ new Map();
99
+ constructor(max) {
100
+ this.max = max;
101
+ }
102
+ get(k) {
103
+ const v = this.store.get(k);
104
+ if (v !== void 0) {
105
+ this.store.delete(k);
106
+ this.store.set(k, v);
107
+ }
108
+ return v;
109
+ }
110
+ set(k, v) {
111
+ if (this.store.has(k)) this.store.delete(k);
112
+ this.store.set(k, v);
113
+ if (this.store.size > this.max) {
114
+ const oldest = this.store.keys().next().value;
115
+ if (oldest !== void 0) this.store.delete(oldest);
116
+ }
117
+ }
118
+ deleteWhere(matches) {
119
+ for (const [key, value] of this.store) if (matches(value)) this.store.delete(key);
120
+ }
121
+ };
122
+ function createCachedFetcher(opts) {
123
+ const ttl = opts.ttl ?? 6e4;
124
+ const max = opts.max ?? 500;
125
+ const staleIfErrorMs = opts.staleIfErrorMs ?? 0;
126
+ if (!Number.isSafeInteger(staleIfErrorMs) || staleIfErrorMs < 0) throw new RangeError("staleIfErrorMs must be a non-negative safe integer");
127
+ const cache = new TinyLRU(max);
128
+ const inflight = /* @__PURE__ */ new Map();
129
+ async function load(key, flight, previous) {
130
+ try {
131
+ let degraded = false;
132
+ const value = await opts.fetch(flight.arg, () => {
133
+ degraded = true;
134
+ });
135
+ if (!degraded && inflight.get(key) === flight) cache.set(key, {
136
+ arg: flight.arg,
137
+ value,
138
+ expiresAt: Date.now() + ttl
139
+ });
140
+ return {
141
+ value,
142
+ degraded
143
+ };
144
+ } catch (err) {
145
+ if (previous && staleIfErrorMs > 0 && inflight.get(key) === flight && Date.now() - previous.expiresAt < staleIfErrorMs) return {
146
+ value: previous.value,
147
+ degraded: true
148
+ };
149
+ if (opts.fallback) return {
150
+ value: await opts.fallback(flight.arg, err),
151
+ degraded: true
152
+ };
153
+ throw err;
154
+ }
155
+ }
156
+ function startLoad(key, arg, previous) {
157
+ const flight = { arg };
158
+ inflight.set(key, flight);
159
+ flight.promise = load(key, flight, previous).finally(() => {
160
+ if (inflight.get(key) === flight) inflight.delete(key);
161
+ });
162
+ return flight.promise;
163
+ }
164
+ async function cachedFetcher(arg) {
165
+ const key = opts.key(arg);
166
+ const entry = cache.get(key);
167
+ const now = Date.now();
168
+ if (entry && entry.expiresAt > now) return entry.value;
169
+ if (entry && opts.swr) {
170
+ if (!inflight.has(key)) startLoad(key, arg).catch(() => {});
171
+ opts.onDegraded?.();
172
+ return entry.value;
173
+ }
174
+ const result = await (inflight.get(key)?.promise ?? startLoad(key, arg, entry));
175
+ if (result.degraded) opts.onDegraded?.();
176
+ return result.value;
177
+ }
178
+ cachedFetcher.invalidate = (matches = () => true) => {
179
+ cache.deleteWhere((entry) => matches(entry.arg));
180
+ for (const [key, flight] of inflight) if (matches(flight.arg)) inflight.delete(key);
181
+ };
182
+ return cachedFetcher;
183
+ }
184
+ export { getCookieHeader as a, RSC_URL_POSTFIX as c, stripQuery as d, stripRscSuffix as f, readLocalePreference as i, contentPathname as l, LOCALE_PREFERENCE_COOKIE_NAME as n, parseCookieHeader as o, isSupportedLocalePreference as r, readCookie as s, createCachedFetcher as t, normalizePath as u };
185
+
186
+ //# sourceMappingURL=createCachedFetcher-CgJscexq.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createCachedFetcher-CgJscexq.js","names":[],"sources":["../src/utils/isrPath.ts","../src/utils/cookie.ts","../src/runtime/localePreference.ts","../src/defaults/runtime/createCachedFetcher.ts"],"sourcesContent":["export const RSC_URL_POSTFIX = '_.rsc';\n\nexport function stripQuery(url: string): string {\n const index = url.indexOf('?');\n return index === -1 ? url : url.slice(0, index);\n}\n\nexport function stripRscSuffix(path: string): string {\n if (path.endsWith(`/${RSC_URL_POSTFIX}`)) {\n return path.slice(0, -(RSC_URL_POSTFIX.length + 1)) || '/';\n }\n if (path.endsWith(RSC_URL_POSTFIX)) {\n return path.slice(0, -RSC_URL_POSTFIX.length) || '/';\n }\n return path;\n}\n\nexport function normalizePath(path: string): string {\n return path.startsWith('/') ? path : '/' + path;\n}\n\nexport function contentPathname(path: string): string {\n return stripRscSuffix(normalizePath(stripQuery(path)));\n}\n","export type CookieHeaderSource =\n | string\n | null\n | undefined\n | {\n headers?: Headers | Record<string, string | string[] | number | undefined | null>;\n };\n\nexport function getCookieHeader(source: CookieHeaderSource): string {\n if (!source) return '';\n if (typeof source === 'string') return source;\n\n const headers = source.headers;\n if (!headers) return '';\n\n if (typeof (headers as Headers).get === 'function') {\n return (headers as Headers).get('cookie') ?? '';\n }\n\n const record = headers as Record<string, string | string[] | number | undefined | null>;\n const raw = record.cookie ?? record.Cookie;\n if (Array.isArray(raw)) return raw.join('; ');\n return raw === undefined || raw === null ? '' : String(raw);\n}\n\nexport function readCookie(\n source: CookieHeaderSource,\n name: string,\n duplicate: 'first' | 'last' = 'last'\n): string | undefined {\n if (!name) return undefined;\n const cookies = parseCookieHeader(getCookieHeader(source), duplicate);\n return cookies[name];\n}\n\nexport function parseCookieHeader(\n header: string,\n duplicate: 'first' | 'last' = 'last'\n): Record<string, string> {\n const entries = new Map<string, string>();\n\n for (const part of header.split(';')) {\n const trimmed = part.trim();\n if (!trimmed) continue;\n\n const index = trimmed.indexOf('=');\n if (index <= 0) continue;\n\n const key = trimmed.slice(0, index).trim();\n if (!key || (duplicate === 'first' && entries.has(key))) continue;\n\n const rawValue = trimmed.slice(index + 1).trim();\n entries.set(key, safeDecodeCookieValue(rawValue));\n }\n\n // fromEntries creates own data properties, including __proto__, without invoking setters.\n const cookies = Object.fromEntries(entries);\n Object.setPrototypeOf(cookies, null);\n return cookies;\n}\n\nfunction safeDecodeCookieValue(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n","import { readCookie, type CookieHeaderSource } from '../utils/cookie';\nimport type { I18nConfig } from './i18n';\n\nexport const LOCALE_PREFERENCE_COOKIE_NAME = 'isr_locale';\nconst MAX_AGE_SECONDS = 365 * 24 * 60 * 60;\n\nexport function isSupportedLocalePreference(\n locale: string | undefined,\n config: I18nConfig\n): locale is string {\n return (\n config.prefixDefault === true &&\n config.rememberLocale === true &&\n locale !== undefined &&\n config.locales.includes(locale)\n );\n}\n\nexport function readLocalePreference(\n source: CookieHeaderSource,\n config: I18nConfig\n): string | undefined {\n if (!config.rememberLocale || !config.prefixDefault) return undefined;\n const locale = readCookie(source, LOCALE_PREFERENCE_COOKIE_NAME);\n return isSupportedLocalePreference(locale, config) ? locale : undefined;\n}\n\nexport function serializeLocalePreference(\n locale: string,\n config: I18nConfig,\n secure: boolean\n): string | undefined {\n if (!isSupportedLocalePreference(locale, config)) return undefined;\n const value = encodeURIComponent(locale);\n return `${LOCALE_PREFERENCE_COOKIE_NAME}=${value}; Path=/; Max-Age=${MAX_AGE_SECONDS}; SameSite=Lax${secure ? '; Secure' : ''}`;\n}\n","/**\n * createCachedFetcher —— 通用 TTL + 并发去重数据加载器\n *\n * 设计目标:\n * - 给 i18n / SEO 这类「url 或本地 json」加载场景一个唯一的成熟实现\n * - 同 key 的并发请求自动合并为一次(避免缓存击穿)\n * - 过期后台刷新可选(SWR 模式)\n *\n * 用例:\n * const loadMessages = createCachedFetcher<IntlPayload>({\n * key: ({ locale }) => `intl:${locale}`,\n * ttl: 60_000,\n * fetch: async ({ locale }) => {\n * const r = await fetch(`https://cdn.example.com/i18n/${locale}.json`);\n * return r.json();\n * },\n * });\n *\n * // 在 hook 里用:\n * loadIntl: (url) => loadMessages({ locale: detectLocale(url) }),\n */\n/**\n * 极简 LRU —— 利用 Map 的插入顺序保留特性\n *\n * 不引外部 lru-cache 包是为了规避用户 RSC bundle 的 ESM/CJS interop 抖动\n * (lru-cache@10 双发布在 rolldown 里偶发 default vs 命名导出错位)\n * 本文件用于 i18n / SEO 数据的请求级缓存(典型 < 100 条),简单 Map 完全够用\n */\nclass TinyLRU<K, V> {\n private store = new Map<K, V>();\n constructor(private max: number) {}\n get(k: K): V | undefined {\n const v = this.store.get(k);\n if (v !== undefined) {\n // 触发 LRU:删后再 set,使其变成最新插入\n this.store.delete(k);\n this.store.set(k, v);\n }\n return v;\n }\n set(k: K, v: V): void {\n if (this.store.has(k)) this.store.delete(k);\n this.store.set(k, v);\n if (this.store.size > this.max) {\n const oldest = this.store.keys().next().value;\n if (oldest !== undefined) this.store.delete(oldest);\n }\n }\n\n deleteWhere(matches: (value: V) => boolean): void {\n for (const [key, value] of this.store) {\n if (matches(value)) this.store.delete(key);\n }\n }\n}\n\nexport interface CachedFetcherOptions<TArg, TValue> {\n /** 从入参生成缓存 key */\n key: (arg: TArg) => string;\n /** 实际加载逻辑(network / fs / dynamic import 都可) */\n fetch: (arg: TArg, markDegraded?: () => void) => Promise<TValue>;\n /** 缓存 TTL(毫秒),默认 60s */\n ttl?: number;\n /** LRU 容量,默认 500 */\n max?: number;\n /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */\n swr?: boolean;\n /** Maximum time after expiry to reuse the last successful value on refresh errors. */\n staleIfErrorMs?: number;\n /** Called in each consumer's context when it receives a stale or degraded result. */\n onDegraded?: () => void;\n /** 拉取失败时的回退值(如不提供则抛错) */\n fallback?: (arg: TArg, error: unknown) => TValue | Promise<TValue>;\n}\n\ninterface Entry<TArg, TValue> {\n arg: TArg;\n value: TValue;\n expiresAt: number;\n}\n\ninterface LoadResult<TValue> {\n value: TValue;\n degraded: boolean;\n}\n\nexport type CachedFetcher<TArg, TValue> = (arg: TArg) => Promise<TValue>;\n\nexport function createCachedFetcher<TArg, TValue>(\n opts: CachedFetcherOptions<TArg, TValue>\n): CachedFetcher<TArg, TValue> & { invalidate(matches?: (arg: TArg) => boolean): void } {\n const ttl = opts.ttl ?? 60_000;\n const max = opts.max ?? 500;\n const staleIfErrorMs = opts.staleIfErrorMs ?? 0;\n if (!Number.isSafeInteger(staleIfErrorMs) || staleIfErrorMs < 0) {\n throw new RangeError('staleIfErrorMs must be a non-negative safe integer');\n }\n type Flight = { arg: TArg; promise?: Promise<LoadResult<TValue>> };\n const cache = new TinyLRU<string, Entry<TArg, TValue>>(max);\n const inflight = new Map<string, Flight>();\n\n async function load(\n key: string,\n flight: Flight,\n previous?: Entry<TArg, TValue>\n ): Promise<LoadResult<TValue>> {\n try {\n let degraded = false;\n const value = await opts.fetch(flight.arg, () => {\n degraded = true;\n });\n if (!degraded && inflight.get(key) === flight) {\n cache.set(key, { arg: flight.arg, value, expiresAt: Date.now() + ttl });\n }\n return { value, degraded };\n } catch (err) {\n if (\n previous &&\n staleIfErrorMs > 0 &&\n inflight.get(key) === flight &&\n Date.now() - previous.expiresAt < staleIfErrorMs\n ) {\n return { value: previous.value, degraded: true };\n }\n if (opts.fallback) return { value: await opts.fallback(flight.arg, err), degraded: true };\n throw err;\n }\n }\n\n function startLoad(\n key: string,\n arg: TArg,\n previous?: Entry<TArg, TValue>\n ): Promise<LoadResult<TValue>> {\n const flight: Flight = { arg };\n inflight.set(key, flight);\n flight.promise = load(key, flight, previous).finally(() => {\n if (inflight.get(key) === flight) inflight.delete(key);\n });\n return flight.promise;\n }\n\n async function cachedFetcher(arg: TArg): Promise<TValue> {\n const key = opts.key(arg);\n const entry = cache.get(key);\n const now = Date.now();\n\n if (entry && entry.expiresAt > now) {\n return entry.value;\n }\n\n if (entry && opts.swr) {\n // SWR:返回旧值,后台刷新(不阻塞);如已有 in-flight 则不重复触发\n if (!inflight.has(key)) {\n startLoad(key, arg).catch(() => {\n /* 后台刷新失败保留旧值 */\n });\n }\n opts.onDegraded?.();\n return entry.value;\n }\n\n // miss 或非 SWR 过期:合并并发到同一个 promise\n const result = await (inflight.get(key)?.promise ?? startLoad(key, arg, entry));\n if (result.degraded) opts.onDegraded?.();\n return result.value;\n }\n\n cachedFetcher.invalidate = (matches: (arg: TArg) => boolean = () => true): void => {\n cache.deleteWhere(entry => matches(entry.arg));\n for (const [key, flight] of inflight) {\n if (matches(flight.arg)) inflight.delete(key);\n }\n };\n\n return cachedFetcher;\n}\n"],"mappings":"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"}