isr-engine 4.2.0 → 4.4.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.
- package/README.md +7 -1
- package/dist/{contentRevalidation-D3SZwwbX.js → CacheTagContext-Btmq8KCD.js} +20 -7
- package/dist/CacheTagContext-Btmq8KCD.js.map +1 -0
- package/dist/{abVariantContext-BNInoflb.js → abVariantContext-yWZOqscY.js} +94 -36
- package/dist/abVariantContext-yWZOqscY.js.map +1 -0
- package/dist/cli/cli.js +1 -1
- package/dist/context/CacheTagContext.d.ts +10 -0
- package/dist/context/CacheTagContext.d.ts.map +1 -0
- package/dist/{createCacheInspectorMiddleware-CDOoJXGO.js → createCacheInspectorMiddleware-DUYq46J4.js} +2 -2
- package/dist/{createCacheInspectorMiddleware-CDOoJXGO.js.map → createCacheInspectorMiddleware-DUYq46J4.js.map} +1 -1
- package/dist/{createCachedFetcher-Y7zbGgjb.js → createCachedFetcher-CgJscexq.js} +29 -10
- package/dist/createCachedFetcher-CgJscexq.js.map +1 -0
- package/dist/{createISRApp-DA3-5Ezk.js → createISRApp-yBEBvYD5.js} +74 -56
- package/dist/createISRApp-yBEBvYD5.js.map +1 -0
- package/dist/defaults/runtime/contentRevalidation.d.ts +5 -2
- package/dist/defaults/runtime/contentRevalidation.d.ts.map +1 -1
- package/dist/defaults/runtime/createCachedFetcher.d.ts +5 -1
- package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -1
- package/dist/defaults/runtime/defineSiteHooks.d.ts +7 -2
- package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
- package/dist/defaults/runtime/defineSiteHooks.js +103 -36
- package/dist/defaults/runtime/defineSiteHooks.js.map +1 -1
- package/dist/defaults/runtime/renderCancellation.d.ts +3 -0
- package/dist/defaults/runtime/renderCancellation.d.ts.map +1 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts +1 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -1
- package/dist/isr-engine.js +4 -4
- package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
- package/dist/rsc/browser.js +1 -1
- package/dist/rsc/browser.js.map +1 -1
- package/dist/rsc/cacheTag.d.ts +1 -8
- package/dist/rsc/cacheTag.d.ts.map +1 -1
- package/dist/rsc/index.js +3 -2
- package/dist/rsc/revalidate.d.ts +3 -2
- package/dist/rsc/revalidate.d.ts.map +1 -1
- package/dist/{rsc-CbZ-BsWD.js → rsc-BYq2vvnh.js} +2 -2
- package/dist/{rsc-CbZ-BsWD.js.map → rsc-BYq2vvnh.js.map} +1 -1
- package/dist/server/contentRevalidationRoute.d.ts +4 -0
- package/dist/server/contentRevalidationRoute.d.ts.map +1 -0
- package/dist/server/opsConfig.d.ts +6 -1
- package/dist/server/opsConfig.d.ts.map +1 -1
- package/dist/server/productionRuntime.d.ts.map +1 -1
- package/dist/server/publishedSitemap.d.ts.map +1 -1
- package/dist/types/ISRConfig.d.ts +16 -0
- package/dist/types/ISRConfig.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/context/CacheTagContext.ts +20 -0
- package/src/defaults/entry.server.ssr.tsx +10 -0
- package/src/defaults/runtime/contentRevalidation.ts +9 -3
- package/src/defaults/runtime/createCachedFetcher.ts +45 -10
- package/src/defaults/runtime/defineServerEntry.tsx +26 -28
- package/src/defaults/runtime/defineSiteHooks.ts +138 -44
- package/src/defaults/runtime/renderCancellation.ts +10 -0
- package/src/types/ISRConfig.ts +18 -0
- package/dist/abVariantContext-BNInoflb.js.map +0 -1
- package/dist/contentRevalidation-D3SZwwbX.js.map +0 -1
- package/dist/createCachedFetcher-Y7zbGgjb.js.map +0 -1
- package/dist/createISRApp-DA3-5Ezk.js.map +0 -1
|
@@ -38,6 +38,7 @@ import type { IntlPayload, PageSeoMeta } from './seo-runtime';
|
|
|
38
38
|
import type {
|
|
39
39
|
DynamicSeoResolver,
|
|
40
40
|
ISRConfig,
|
|
41
|
+
LanguageCatalogEntry,
|
|
41
42
|
RuntimeI18nConfig,
|
|
42
43
|
RuntimeSeoConfig,
|
|
43
44
|
} from '../../types';
|
|
@@ -49,18 +50,21 @@ import {
|
|
|
49
50
|
type I18nConfig,
|
|
50
51
|
} from '../../runtime/i18n';
|
|
51
52
|
import { readLocalePreference } from '../../runtime/localePreference';
|
|
53
|
+
import { markUncacheable } from '../../context/CacheTagContext';
|
|
52
54
|
|
|
53
55
|
export { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';
|
|
54
56
|
|
|
55
57
|
export type SiteRuntimeConfig = ISRConfig['runtime'];
|
|
56
58
|
|
|
57
59
|
const CONTENT_INVALIDATOR = Symbol('contentInvalidator');
|
|
60
|
+
const MARK_METADATA_DEGRADED = Symbol('markMetadataDegraded');
|
|
58
61
|
|
|
59
62
|
export interface SiteRuntimeContext {
|
|
60
63
|
runtime: SiteRuntimeConfig;
|
|
61
64
|
services: RuntimeServices;
|
|
62
65
|
telemetry?: string;
|
|
63
66
|
site?: string;
|
|
67
|
+
[MARK_METADATA_DEGRADED]?: () => void;
|
|
64
68
|
}
|
|
65
69
|
|
|
66
70
|
export interface RuntimeServices {
|
|
@@ -85,6 +89,8 @@ export type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string |
|
|
|
85
89
|
export type IntlMessagesByLocale = Record<string, Record<string, unknown>>;
|
|
86
90
|
|
|
87
91
|
export interface CreateAdminIntlLoaderOptions {
|
|
92
|
+
/** Supported routes, independent of which dictionaries are present in the local fallback. */
|
|
93
|
+
locales?: readonly string[];
|
|
88
94
|
/** 远端字典端点;相对路径会用 runtime.services.api 拼接 */
|
|
89
95
|
endpoint?: string;
|
|
90
96
|
/** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */
|
|
@@ -293,7 +299,7 @@ export function createAdminIntlLoader(
|
|
|
293
299
|
const endpoint = options.endpoint ?? '/api/i18n/{locale}/manifest';
|
|
294
300
|
const fallbackMessages = options.fallbackMessages ?? {};
|
|
295
301
|
const defaultLocale = options.defaultLocale;
|
|
296
|
-
const supportedLocales = Object.keys(fallbackMessages);
|
|
302
|
+
const supportedLocales = options.locales ?? Object.keys(fallbackMessages);
|
|
297
303
|
|
|
298
304
|
return async (locale, ctx) => {
|
|
299
305
|
const normalizedLocale =
|
|
@@ -301,10 +307,13 @@ export function createAdminIntlLoader(
|
|
|
301
307
|
? (matchConfiguredLocale(locale, supportedLocales) ?? defaultLocale)
|
|
302
308
|
: locale;
|
|
303
309
|
const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);
|
|
304
|
-
const
|
|
305
|
-
|
|
310
|
+
const markDegraded = ctx[MARK_METADATA_DEGRADED];
|
|
311
|
+
const remoteMessages = remoteUrl
|
|
312
|
+
? extractIntlMessagesOrNull(
|
|
313
|
+
await fetchMetadataJson(remoteUrl, options.timeoutMs, markDegraded),
|
|
314
|
+
options.endpoint ? markDegraded : undefined
|
|
315
|
+
)
|
|
306
316
|
: null;
|
|
307
|
-
const remoteMessages = extractIntlMessagesOrNull(remote);
|
|
308
317
|
const localMessages =
|
|
309
318
|
fallbackMessages[normalizedLocale] ??
|
|
310
319
|
(defaultLocale ? fallbackMessages[defaultLocale] : undefined) ??
|
|
@@ -339,7 +348,7 @@ export function createAdminSeoLoader(
|
|
|
339
348
|
// 1. admin endpoint —— 运营在 dashboard 给具体 path 配过的覆盖优先级最高
|
|
340
349
|
const remoteUrl = resolveAdminUrl(endpoint, { ...params, pathname }, ctx);
|
|
341
350
|
const remote = remoteUrl
|
|
342
|
-
? await
|
|
351
|
+
? await fetchMetadataJson(remoteUrl, options.timeoutMs, ctx[MARK_METADATA_DEGRADED])
|
|
343
352
|
: null;
|
|
344
353
|
const remoteMeta = extractSeoMetaOrNull(remote);
|
|
345
354
|
if (remoteMeta) return remoteMeta;
|
|
@@ -362,6 +371,7 @@ export function createAdminSeoLoader(
|
|
|
362
371
|
});
|
|
363
372
|
if (result) return result as PageSeoMeta;
|
|
364
373
|
} catch (err) {
|
|
374
|
+
ctx[MARK_METADATA_DEGRADED]?.();
|
|
365
375
|
// resolver 抛错不阻塞渲染:业务异常时把 SEO 当 null 处理
|
|
366
376
|
console.warn('[seo] dynamic resolver threw, falling through to fallback', err);
|
|
367
377
|
}
|
|
@@ -427,6 +437,7 @@ function createAdminSiteHooks(
|
|
|
427
437
|
prefixDefault: i18n.prefixDefault ?? runtimeI18n.prefixDefault,
|
|
428
438
|
detect: i18n.detect,
|
|
429
439
|
load: createAdminIntlLoader({
|
|
440
|
+
locales,
|
|
430
441
|
endpoint: i18n.endpoint ?? runtimeI18n.endpoint,
|
|
431
442
|
fallbackMessages,
|
|
432
443
|
defaultLocale,
|
|
@@ -465,6 +476,7 @@ export interface ServerHooksOutput {
|
|
|
465
476
|
engineCtx: { traceId: string; startedAt: number }
|
|
466
477
|
) => Promise<Record<string, unknown>>;
|
|
467
478
|
loadIntl: (req: Request) => Promise<IntlPayload | null>;
|
|
479
|
+
loadLanguageCatalog?: () => Promise<readonly LanguageCatalogEntry[]>;
|
|
468
480
|
loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;
|
|
469
481
|
onError: (
|
|
470
482
|
err: unknown,
|
|
@@ -483,7 +495,7 @@ export function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput {
|
|
|
483
495
|
export function applyRuntimeToServerHooks<T extends object>(
|
|
484
496
|
hooks: T,
|
|
485
497
|
runtime: SiteRuntimeConfig
|
|
486
|
-
): T {
|
|
498
|
+
): T & Pick<ServerHooksOutput, 'loadLanguageCatalog'> {
|
|
487
499
|
const maybeRuntimeAware = hooks as T & {
|
|
488
500
|
__configureRuntime?: (runtime: SiteRuntimeConfig) => T;
|
|
489
501
|
};
|
|
@@ -495,6 +507,7 @@ export function applyRuntimeToServerHooks<T extends object>(
|
|
|
495
507
|
apiBaseUrl?: string;
|
|
496
508
|
intl?: unknown;
|
|
497
509
|
loadIntl?: unknown;
|
|
510
|
+
loadLanguageCatalog?: ServerHooksOutput['loadLanguageCatalog'];
|
|
498
511
|
loadSeoMeta?: unknown;
|
|
499
512
|
beforeRequest?: SiteHooksConfig['beforeRequest'];
|
|
500
513
|
onError?: SiteHooksConfig['onError'];
|
|
@@ -522,6 +535,7 @@ export function applyRuntimeToServerHooks<T extends object>(
|
|
|
522
535
|
intl: runtimeHooks.intl,
|
|
523
536
|
beforeRequest: runtimeHooks.beforeRequest,
|
|
524
537
|
loadIntl: runtimeHooks.loadIntl,
|
|
538
|
+
loadLanguageCatalog: runtimeHooks.loadLanguageCatalog,
|
|
525
539
|
loadSeoMeta: runtimeHooks.loadSeoMeta,
|
|
526
540
|
onError: runtimeHooks.onError,
|
|
527
541
|
} as T;
|
|
@@ -541,6 +555,8 @@ export function applyRuntimeToServerHooks<T extends object>(
|
|
|
541
555
|
...hooks,
|
|
542
556
|
siteBaseUrl,
|
|
543
557
|
apiBaseUrl,
|
|
558
|
+
loadLanguageCatalog:
|
|
559
|
+
baseHooks.loadLanguageCatalog ?? createLanguageCatalog(runtime, runtime.i18n?.locales),
|
|
544
560
|
...(runtimeSeoHook && { loadSeoMeta: runtimeSeoHook }),
|
|
545
561
|
} as T;
|
|
546
562
|
}
|
|
@@ -555,16 +571,12 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
|
|
|
555
571
|
telemetry: services.telemetry,
|
|
556
572
|
site: site || undefined,
|
|
557
573
|
};
|
|
558
|
-
const
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
} catch {
|
|
565
|
-
return null;
|
|
566
|
-
}
|
|
567
|
-
};
|
|
574
|
+
const metadataContext = (markDegraded?: () => void): SiteRuntimeContext => ({
|
|
575
|
+
...runtimeCtx,
|
|
576
|
+
[MARK_METADATA_DEGRADED]: markDegraded,
|
|
577
|
+
});
|
|
578
|
+
const fetchJson = (path: string, markDegraded?: () => void) =>
|
|
579
|
+
api ? fetchMetadataJson(api + path, null, markDegraded) : Promise.resolve(null);
|
|
568
580
|
|
|
569
581
|
// ─── i18n 缓存(一次创建,请求级复用)──────────────
|
|
570
582
|
const runtimeLocale = runtime.i18n;
|
|
@@ -626,26 +638,28 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
|
|
|
626
638
|
key: locale => `intl:${locale}`,
|
|
627
639
|
ttl: intlCfg.ttl ?? 60_000,
|
|
628
640
|
swr: true,
|
|
629
|
-
|
|
641
|
+
onDegraded: markUncacheable,
|
|
642
|
+
fetch: async (locale, markDegraded) => {
|
|
630
643
|
if (intlCfg.load) {
|
|
631
|
-
const r = await intlCfg.load(locale,
|
|
644
|
+
const r = await intlCfg.load(locale, metadataContext(markDegraded));
|
|
632
645
|
return r ?? { locale, messages: {}, direction: rtlOf(locale) };
|
|
633
646
|
}
|
|
634
647
|
if (intlCfg.endpoint) {
|
|
635
|
-
const url =
|
|
636
|
-
const json = await
|
|
648
|
+
const url = resolveAdminUrl(intlCfg.endpoint, { locale }, runtimeCtx);
|
|
649
|
+
const json = url ? await fetchMetadataJson(url, null) : null;
|
|
637
650
|
if (json !== null && intlCfg.transform) {
|
|
638
651
|
const transformed = await intlCfg.transform(json, locale);
|
|
639
|
-
if (transformed) {
|
|
652
|
+
if (transformed && isUsableDictionary(transformed.messages)) {
|
|
640
653
|
return {
|
|
641
654
|
...transformed,
|
|
642
655
|
direction: transformed.direction ?? rtlOf(transformed.locale),
|
|
643
656
|
};
|
|
644
657
|
}
|
|
645
658
|
}
|
|
659
|
+
const messages = extractIntlMessagesOrNull(json, url ? markDegraded : undefined);
|
|
646
660
|
return {
|
|
647
661
|
locale,
|
|
648
|
-
messages:
|
|
662
|
+
messages: messages ?? {},
|
|
649
663
|
direction: rtlOf(locale),
|
|
650
664
|
};
|
|
651
665
|
}
|
|
@@ -679,8 +693,9 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
|
|
|
679
693
|
const cache = createCachedFetcher<SeoRouteRequest, PageSeoMeta | null>({
|
|
680
694
|
key: request => JSON.stringify(request),
|
|
681
695
|
ttl: remote.ttl ?? 300_000,
|
|
682
|
-
|
|
683
|
-
|
|
696
|
+
onDegraded: markUncacheable,
|
|
697
|
+
fetch: async ({ params }, markDegraded) => {
|
|
698
|
+
const data = await fetchJson(fillTemplate(remote.endpoint, params), markDegraded);
|
|
684
699
|
if (data === null) return null;
|
|
685
700
|
return remote.transform(data, { ...params });
|
|
686
701
|
},
|
|
@@ -695,7 +710,9 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
|
|
|
695
710
|
const cache = createCachedFetcher<SeoRouteRequest, PageSeoMeta | null>({
|
|
696
711
|
key: request => JSON.stringify(request),
|
|
697
712
|
ttl: local.ttl ?? 300_000,
|
|
698
|
-
|
|
713
|
+
onDegraded: markUncacheable,
|
|
714
|
+
fetch: async ({ params }, markDegraded) =>
|
|
715
|
+
local.load({ ...params }, metadataContext(markDegraded)),
|
|
699
716
|
fallback: () => null,
|
|
700
717
|
});
|
|
701
718
|
seoCaches.push(cache);
|
|
@@ -735,6 +752,7 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
|
|
|
735
752
|
async loadIntl(req) {
|
|
736
753
|
return intlLoader(detectLocale(req));
|
|
737
754
|
},
|
|
755
|
+
loadLanguageCatalog: createLanguageCatalog(runtime, runtimeLocale?.locales ?? supportedLocales),
|
|
738
756
|
async loadSeoMeta(req) {
|
|
739
757
|
const url = new URL(req.url);
|
|
740
758
|
const locale = detectLocale(req);
|
|
@@ -815,20 +833,83 @@ function matchConfiguredLocale(
|
|
|
815
833
|
return supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);
|
|
816
834
|
}
|
|
817
835
|
|
|
818
|
-
function
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
const raw = data as Record<string, unknown>;
|
|
825
|
-
const dataValue = raw.data;
|
|
836
|
+
function extractIntlMessagesOrNull(
|
|
837
|
+
data: unknown,
|
|
838
|
+
markDegraded?: () => void
|
|
839
|
+
): Record<string, unknown> | null {
|
|
840
|
+
const body = isRecord(data) ? data : {};
|
|
841
|
+
const dataValue = body.data;
|
|
826
842
|
const candidate =
|
|
827
|
-
|
|
828
|
-
|
|
843
|
+
body.strings ??
|
|
844
|
+
body.messages ??
|
|
829
845
|
(isRecord(dataValue) && 'strings' in dataValue ? dataValue.strings : dataValue);
|
|
830
|
-
if (
|
|
831
|
-
|
|
846
|
+
if (body.status !== false && isUsableDictionary(candidate)) return normalizeMessages(candidate);
|
|
847
|
+
markDegraded?.();
|
|
848
|
+
return null;
|
|
849
|
+
}
|
|
850
|
+
|
|
851
|
+
function isUsableDictionary(value: unknown): value is Record<string, unknown> {
|
|
852
|
+
return isRecord(value) && Object.values(value).some(hasMessageValue);
|
|
853
|
+
}
|
|
854
|
+
|
|
855
|
+
function hasMessageValue(value: unknown): boolean {
|
|
856
|
+
if (typeof value === 'string') return value.trim().length > 0;
|
|
857
|
+
if (typeof value === 'boolean' || typeof value === 'number') return true;
|
|
858
|
+
return !!value && typeof value === 'object' && Object.values(value).some(hasMessageValue);
|
|
859
|
+
}
|
|
860
|
+
|
|
861
|
+
function displayLanguageName(locale: string): string {
|
|
862
|
+
try {
|
|
863
|
+
return (
|
|
864
|
+
new Intl.DisplayNames([locale], { type: 'language', fallback: 'none' }).of(locale) ?? locale
|
|
865
|
+
);
|
|
866
|
+
} catch (error) {
|
|
867
|
+
if (error instanceof RangeError) return locale;
|
|
868
|
+
throw error;
|
|
869
|
+
}
|
|
870
|
+
}
|
|
871
|
+
|
|
872
|
+
function createLanguageCatalog(runtime: SiteRuntimeConfig, locales: readonly string[] = []) {
|
|
873
|
+
const defaults = locales.map(locale => ({ locale, name: displayLanguageName(locale) }));
|
|
874
|
+
const config = runtime.i18n?.catalog;
|
|
875
|
+
if (!config || !locales.length) return async () => defaults;
|
|
876
|
+
|
|
877
|
+
const ctx: SiteRuntimeContext = { runtime, services: resolveRuntimeServices(runtime) };
|
|
878
|
+
const url = resolveAdminUrl(config.endpoint, {}, ctx);
|
|
879
|
+
const load = createCachedFetcher<void, readonly LanguageCatalogEntry[]>({
|
|
880
|
+
key: () => 'language-catalog',
|
|
881
|
+
ttl: config.ttl ?? runtime.i18n?.ttl,
|
|
882
|
+
onDegraded: markUncacheable,
|
|
883
|
+
fallback: () => defaults,
|
|
884
|
+
fetch: async () => {
|
|
885
|
+
const json = url ? await fetchMetadataJson(url, runtime.i18n?.timeoutMs) : null;
|
|
886
|
+
const entries: unknown = isRecord(json) ? json.data : json;
|
|
887
|
+
if (!Array.isArray(entries)) throw new TypeError('Invalid language catalog response');
|
|
888
|
+
|
|
889
|
+
const names = new Map<string, string>();
|
|
890
|
+
for (const entry of entries as unknown[]) {
|
|
891
|
+
if (
|
|
892
|
+
!isRecord(entry) ||
|
|
893
|
+
typeof entry.locale !== 'string' ||
|
|
894
|
+
typeof entry.name !== 'string'
|
|
895
|
+
) {
|
|
896
|
+
throw new TypeError('Invalid language catalog entry');
|
|
897
|
+
}
|
|
898
|
+
const name = entry.name.trim();
|
|
899
|
+
if (name) names.set(entry.locale.toLowerCase(), name);
|
|
900
|
+
}
|
|
901
|
+
return defaults.map(({ locale, name }) => ({
|
|
902
|
+
locale,
|
|
903
|
+
name: names.get(locale.toLowerCase()) ?? name,
|
|
904
|
+
}));
|
|
905
|
+
},
|
|
906
|
+
});
|
|
907
|
+
const invalidate: Parameters<typeof registerContentInvalidator>[0] = scopes => {
|
|
908
|
+
if (scopes.allPageMetadata || scopes.locales.length) load.invalidate();
|
|
909
|
+
};
|
|
910
|
+
Object.defineProperty(load, CONTENT_INVALIDATOR, { value: invalidate });
|
|
911
|
+
registerContentInvalidator(invalidate, { weak: true });
|
|
912
|
+
return load;
|
|
832
913
|
}
|
|
833
914
|
|
|
834
915
|
function normalizeMessages(messages: Record<string, unknown>): Record<string, unknown> {
|
|
@@ -991,15 +1072,28 @@ function createServerReportId(): string | null {
|
|
|
991
1072
|
}
|
|
992
1073
|
}
|
|
993
1074
|
|
|
994
|
-
async function
|
|
1075
|
+
async function fetchMetadataJson(
|
|
1076
|
+
url: string,
|
|
1077
|
+
timeoutMs: number | null = 1200,
|
|
1078
|
+
markDegraded?: () => void
|
|
1079
|
+
): Promise<unknown> {
|
|
995
1080
|
try {
|
|
996
|
-
const response =
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1081
|
+
const response =
|
|
1082
|
+
timeoutMs === null
|
|
1083
|
+
? await fetch(url)
|
|
1084
|
+
: await fetch(url, {
|
|
1085
|
+
headers: { Accept: 'application/json' },
|
|
1086
|
+
signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,
|
|
1087
|
+
});
|
|
1088
|
+
if (!response.ok) {
|
|
1089
|
+
if (response.status !== 404) markDegraded?.();
|
|
1090
|
+
void response.body?.cancel().catch(() => undefined);
|
|
1091
|
+
return null;
|
|
1092
|
+
}
|
|
1093
|
+
if (response.status === 204) return null;
|
|
1094
|
+
return await response.json();
|
|
1002
1095
|
} catch {
|
|
1096
|
+
markDegraded?.();
|
|
1003
1097
|
return null;
|
|
1004
1098
|
}
|
|
1005
1099
|
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export function isRenderCancellation(signal: AbortSignal | undefined, error: unknown): boolean {
|
|
2
|
+
// React receives this same reason through its render signal.
|
|
3
|
+
return signal?.aborted === true && error === signal.reason;
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
export function createRenderErrorHandler(signal: AbortSignal | undefined) {
|
|
7
|
+
return (error: unknown): void => {
|
|
8
|
+
if (!isRenderCancellation(signal, error)) console.error(error);
|
|
9
|
+
};
|
|
10
|
+
}
|
package/src/types/ISRConfig.ts
CHANGED
|
@@ -98,6 +98,18 @@ export interface RuntimeExperimentTrackingConfig {
|
|
|
98
98
|
enabled: boolean | undefined;
|
|
99
99
|
}
|
|
100
100
|
|
|
101
|
+
export interface LanguageCatalogEntry {
|
|
102
|
+
readonly locale: string;
|
|
103
|
+
readonly name: string;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
export interface RuntimeLanguageCatalogConfig {
|
|
107
|
+
/** Returns an array of locale/name entries, optionally wrapped in { data }. */
|
|
108
|
+
endpoint: string;
|
|
109
|
+
/** Catalog cache TTL in milliseconds. Defaults to the dictionary TTL. */
|
|
110
|
+
ttl?: number;
|
|
111
|
+
}
|
|
112
|
+
|
|
101
113
|
export interface RuntimeI18nConfig {
|
|
102
114
|
/** 支持的 locale 列表,用于 URL locale 前缀解析和请求协商 */
|
|
103
115
|
locales: readonly string[];
|
|
@@ -107,6 +119,8 @@ export interface RuntimeI18nConfig {
|
|
|
107
119
|
prefixDefault: boolean;
|
|
108
120
|
/** Opt in to remembering LocaleLink selections for the unprefixed root in prefixDefault mode. */
|
|
109
121
|
rememberLocale?: boolean;
|
|
122
|
+
/** Optional bulk source for the display names of the configured locales. */
|
|
123
|
+
catalog?: RuntimeLanguageCatalogConfig;
|
|
110
124
|
/** 远端字典端点;相对路径会拼到 services.api 上 */
|
|
111
125
|
endpoint: string | undefined;
|
|
112
126
|
/** 本地兜底字典;配置 API 不可用时使用 */
|
|
@@ -185,6 +199,8 @@ export interface RuntimeSitemapConfig {
|
|
|
185
199
|
}) => readonly RuntimeSitemapEntry[] | Promise<readonly RuntimeSitemapEntry[]>;
|
|
186
200
|
/** Catalog cache TTL in milliseconds. Defaults to runtime.seo.ttl. */
|
|
187
201
|
ttl?: number;
|
|
202
|
+
/** Reuse a successful catalog on refresh errors for at most this long after expiry. Default 300000. */
|
|
203
|
+
staleIfErrorMs?: number;
|
|
188
204
|
}
|
|
189
205
|
|
|
190
206
|
export interface RuntimeSeoConfig {
|
|
@@ -528,6 +544,8 @@ export interface ISRConfig {
|
|
|
528
544
|
enabled: boolean;
|
|
529
545
|
public: boolean;
|
|
530
546
|
};
|
|
547
|
+
/** Enable the authenticated Node production publication endpoint. Defaults to false. */
|
|
548
|
+
contentRevalidation?: boolean;
|
|
531
549
|
};
|
|
532
550
|
};
|
|
533
551
|
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"abVariantContext-BNInoflb.js","names":["runtime","AsyncLocalStorage"],"sources":["../src/context/RequestContext.ts","../src/logger/logRecord.ts","../src/logger/runtimeLogger.ts","../src/rsc/revalidationMetrics.ts","../src/rsc/revalidate.ts","../src/rsc/cacheTag.ts","../src/middlewares/abVariantContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\nimport type { ISRContextData } from '../types/ISRContext';\n\n// 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致\nexport type RequestContextState = ISRContextData;\n\nconst REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';\n\nfunction getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {\n const globalState = globalThis as typeof globalThis & {\n [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;\n };\n\n globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();\n return globalState[REQUEST_CONTEXT_KEY];\n}\n\n// 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。\nexport const requestContext = getGlobalRequestContext();\n\n// 获取当前请求上下文的辅助函数\nexport const getRequestContext = (): RequestContextState | undefined => {\n return requestContext.getStore();\n};\n\n// 获取 Trace ID 的辅助函数 (安全访问)\nexport const getTraceId = (): string => {\n const store = requestContext.getStore();\n return store?.traceId || 'system';\n};\n\n// 获取 Request ID 的辅助函数 (安全访问)\nexport const getRequestId = (): string => {\n const store = requestContext.getStore();\n return store?.requestId || 'unknown';\n};\n\n/**\n * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。\n *\n * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值\n * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。\n * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。\n */\nexport const getAnonId = (): string => {\n const store = requestContext.getStore();\n return store?.anonId || 'system';\n};\n\n/**\n * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。\n * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远\n * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。\n */\nexport const getUserId = (): string | null => {\n const store = requestContext.getStore();\n return store?.userId ?? null;\n};\n\n/**\n * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。\n * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。\n * 没接 ABVariantMiddleware 时返回空对象。\n */\nexport const getExperiments = (): Record<string, string> => {\n const store = requestContext.getStore();\n return store?.experiments ?? {};\n};\n","export type LogValue = null | boolean | number | string | LogValue[] | { [key: string]: LogValue };\n\n/** Snapshot once so console and file output cannot invoke a caller's toJSON twice. */\nexport function snapshotLogArgument(value: unknown): LogValue {\n try {\n const seen = new WeakSet<object>();\n const serialized = JSON.stringify(value, (_key, item: unknown) => {\n if (typeof item === 'bigint') return `${item}n`;\n if (item && typeof item === 'object') {\n if (seen.has(item)) return '[Circular]';\n seen.add(item);\n if (item instanceof Error) {\n return {\n ...item,\n name: item.name,\n message: item.message,\n stack: item.stack,\n cause: item.cause,\n };\n }\n }\n return item;\n });\n return serialized === undefined ? String(value) : (JSON.parse(serialized) as LogValue);\n } catch {\n return '[Unserializable log argument]';\n }\n}\n\n/** JSON handles C0/CR/LF; these additional controls are legal raw JSON characters. */\nexport function escapeSupplementalLogControls(serialized: string): string {\n return serialized.replace(\n /[\\u007f-\\u009f\\u061c\\u200e\\u200f\\u2028-\\u202e\\u2066-\\u2069]/g,\n character => `\\\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`\n );\n}\n\n/** Keep every untrusted console field visibly quoted and inside one physical line. */\nexport function encodeLogField(value: LogValue): string {\n return escapeSupplementalLogControls(JSON.stringify(value));\n}\n\nexport function encodeSpinnerMessage(value: string): string {\n return encodeLogField(value).slice(1, -1);\n}\n","import { encodeLogField, snapshotLogArgument } from './logRecord';\n\ntype RuntimeLogLevel = 'debug' | 'info' | 'error';\ntype RuntimeLogger = Record<RuntimeLogLevel, (...args: unknown[]) => void>;\n\nconst LOGGER_KEY = Symbol.for('isr-engine:origin-logger');\nconst runtime = globalThis as typeof globalThis & { [LOGGER_KEY]?: RuntimeLogger };\n\nexport function setOriginLogger(logger: RuntimeLogger): void {\n runtime[LOGGER_KEY] = logger;\n}\n\n/** Rendered modules share the origin logger without bundling its file transport. */\nfunction log(level: RuntimeLogLevel, args: unknown[]): void {\n const origin = runtime[LOGGER_KEY];\n if (origin) {\n origin[level](...args);\n } else if (level !== 'debug') {\n console[level](encodeLogField({ level, args: args.map(snapshotLogArgument) }));\n }\n}\n\nexport const runtimeLogger: RuntimeLogger = {\n debug: (...args) => log('debug', args),\n info: (...args) => log('info', args),\n error: (...args) => log('error', args),\n};\n","type RevalidationMetricRecorder = (\n event: 'run' | 'failure',\n kind: 'path' | 'tag',\n target: string\n) => void;\n\nconst RECORDER_KEY = Symbol.for('isr-engine:revalidation-metric-recorder');\nconst runtime = globalThis as typeof globalThis & {\n [RECORDER_KEY]?: RevalidationMetricRecorder;\n};\n\n/** The Node origin owns the metrics registry, including events from the separate Vite RSC graph. */\nexport function setRevalidationMetricRecorder(recorder: RevalidationMetricRecorder): void {\n runtime[RECORDER_KEY] = recorder;\n}\n\nexport function recordRevalidationMetric(...args: Parameters<RevalidationMetricRecorder>): void {\n runtime[RECORDER_KEY]?.(...args);\n}\n","/**\n * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效\n *\n * 跨环境状态共享:\n * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),\n * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),\n * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。\n * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,\n * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。\n *\n * 失败语义(v2.0.x 起):\n * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行\n * 但 reject 被吞**——多 invalidator 场景下出现\"看似成功但部分缓存没清\"的脏状态。\n * 现在改为:\n * 1. `Promise.allSettled` 让所有 invalidator 都跑到底\n * 2. 每个失败单独打 metric + log(含 trace 上下文)\n * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)\n * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,\n * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种\"沉默错误\"比抛错更危险。\n *\n * 用法:\n * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`\n * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册\n * 3. 分发到所有注册的 invalidator,清理对应缓存条目\n *\n * 注意:\n * - 本模块不持有任何缓存实现,纯做路由分发\n * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\nimport {\n invalidateContentCaches,\n normalizeContentScopes,\n type ContentPublication,\n type ContentRevalidationOptions,\n} from '../defaults/runtime/contentRevalidation';\nimport { recordRevalidationMetric } from './revalidationMetrics';\n\n/** Invalidator 签名:接收失效目标描述 */\nexport interface RevalidateInvalidator {\n (target: RevalidateTarget): Promise<void> | void;\n}\n\ntype ContentResponseInvalidator = (publication: ContentPublication) => Promise<void> | void;\n\n/** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */\nconst REGISTRY_KEY = Symbol.for('isr-engine:revalidate-registry');\ntype Registry = Map<RevalidateInvalidator, ContentResponseInvalidator | undefined>;\n\ntype GlobalWithRegistry = typeof globalThis & {\n [REGISTRY_KEY]?: Registry;\n};\n\nfunction getRegistry(): Registry {\n const g = globalThis as GlobalWithRegistry;\n return (g[REGISTRY_KEY] ??= new Map());\n}\n\n/**\n * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)\n * 返回取消注册的函数\n */\nexport function registerInvalidator(\n fn: RevalidateInvalidator,\n invalidatePublication?: ContentResponseInvalidator\n): () => void {\n const registry = getRegistry();\n registry.set(fn, invalidatePublication);\n return () => {\n registry.delete(fn);\n };\n}\n\n/**\n * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。\n *\n * 含:\n * - successCount / failureCount:方便调用方决定补偿策略\n * - causes:每个失败的原始 Error(按注册顺序)\n * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')\n *\n * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node\n * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。\n */\nexport class RevalidationError extends Error {\n public readonly target: string;\n public readonly successCount: number;\n public readonly failureCount: number;\n public readonly causes: readonly Error[];\n\n constructor(\n target: string,\n successCount: number,\n failureCount: number,\n causes: readonly Error[]\n ) {\n super(\n `revalidate(${target}) —— ${failureCount} invalidator(s) failed, ` +\n `${successCount} succeeded. First cause: ${causes[0]?.message ?? '(unknown)'}`\n );\n this.name = 'RevalidationError';\n this.target = target;\n this.successCount = successCount;\n this.failureCount = failureCount;\n this.causes = causes;\n }\n}\n\nexport type RevalidateTarget = { kind: 'path'; value: string } | { kind: 'tag'; value: string };\n\nexport function contentResponseTargets(scopes: ContentPublication['scopes']): RevalidateTarget[] {\n return [\n ...scopes.paths.map(value => ({ kind: 'path' as const, value })),\n ...scopes.tags.map(value => ({ kind: 'tag' as const, value })),\n ];\n}\n\n/**\n * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。\n *\n * `Promise.allSettled` 保证任意 invalidator 抛错都不会中断其他 invalidator 的执行——\n * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。\n */\nasync function dispatch(target: RevalidateTarget): Promise<void> {\n const targetLabel = `${target.kind}:${target.value}`;\n await runInvalidators(\n targetLabel,\n Array.from(getRegistry().keys(), invalidate => () => invalidate(target)),\n target\n );\n}\n\nasync function runInvalidators(\n targetLabel: string,\n invalidators: Array<() => Promise<void> | void>,\n target?: RevalidateTarget\n): Promise<void> {\n if (invalidators.length === 0) {\n logger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);\n return;\n }\n\n if (target) recordRevalidationMetric('run', target.kind, target.value);\n\n // 包一层 async 函数:把同步抛错也转成 Promise rejection,让 allSettled 能统一处理\n // (直接 `fn(target)` 在 fn 同步抛错时会在 `.map` 里 escape,allSettled 收不到)\n const results = await Promise.allSettled(invalidators.map(async fn => fn()));\n\n const causes: Error[] = [];\n let successCount = 0;\n let failureCount = 0;\n\n results.forEach((r, idx) => {\n if (r.status === 'fulfilled') {\n successCount++;\n return;\n }\n failureCount++;\n const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));\n causes.push(err);\n if (target) recordRevalidationMetric('failure', target.kind, target.value);\n // 单独 log 每个失败,方便从 stack 定位是哪个 invalidator\n logger.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);\n });\n\n if (failureCount > 0) {\n throw new RevalidationError(targetLabel, successCount, failureCount, causes);\n }\n\n logger.debug(\n `✅ revalidate(${targetLabel}) —— 已分发到 ${invalidators.length} 个 invalidator(全部成功)`\n );\n}\n\n/**\n * 使指定路径的缓存失效\n *\n * @param path 形如 '/books' / '/posts/42' 的路径\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidatePath(path: string): Promise<void> {\n await dispatch({ kind: 'path', value: path });\n}\n\n/**\n * 使指定 tag 标记的所有缓存条目失效\n *\n * @param tag 业务语义 tag(如 'books' / `book:${id}`)\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidateTag(tag: string): Promise<void> {\n await dispatch({ kind: 'tag', value: tag });\n}\n\n/** Invalidate managed metadata before invalidating the affected rendered responses. */\nexport async function revalidateContent(options: ContentRevalidationOptions): Promise<void> {\n const scopes = normalizeContentScopes(options);\n const targets = contentResponseTargets(scopes);\n if (!targets.length && !scopes.locales.length && !scopes.sitemap) return;\n invalidateContentCaches(scopes);\n const publication = { id: randomUUID(), scopes };\n const invalidators = Array.from(getRegistry()).flatMap(([invalidate, invalidatePublication]) =>\n invalidatePublication\n ? [() => invalidatePublication(publication)]\n : targets.map(target => () => invalidate(target))\n );\n await runInvalidators('content', invalidators);\n}\n\nexport { registerContentInvalidator } from '../defaults/runtime/contentRevalidation';\nexport type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';\n","/**\n * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效\n *\n * 协作模型:\n * 1. ISR 缓存中间件在进入 handler 前 `runWithTagStore(() => rscHandler(request))`\n * —— 给本次请求开一个 AsyncLocalStorage 作用域,内部放 `{ tags: Set<string> }`\n * 2. Server Component 体内任意位置调用 `cacheTag('books', `book:${id}`)`\n * → 写入当前作用域的 tags Set\n * 3. 响应捕获阶段 `collectTags()` 读出 tag 列表,写入 CachedEntry.tags\n * 4. `revalidateTag('books')` 被 invalidator 接收后,遍历 cache 条目,\n * 命中 tags 列表的精准清除(无副作用污染其他条目)\n *\n * 跨环境状态共享:\n * Server Component 在 Vite `rsc` 环境执行(模块图 A),\n * ISR 缓存中间件在 Node(模块图 B)。\n * ES 模块作用域的 `new AsyncLocalStorage()` 会被双模块图各持有一份副本,\n * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。\n * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\n\ninterface TagStore {\n tags: Set<string>;\n /** 本次渲染过程中是否被显式标记为不可缓存(例如上游 fetch 失败) */\n uncacheable: boolean;\n}\n\nconst ALS_KEY = Symbol.for('isr-engine:cache-tag-als');\n\ntype GlobalWithALS = typeof globalThis & {\n [ALS_KEY]?: AsyncLocalStorage<TagStore>;\n};\n\nfunction getALS(): AsyncLocalStorage<TagStore> {\n const g = globalThis as GlobalWithALS;\n if (!g[ALS_KEY]) {\n g[ALS_KEY] = new AsyncLocalStorage<TagStore>();\n }\n return g[ALS_KEY];\n}\n\n/**\n * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用\n *\n * fn 内部以及 fn 启动的任何 async/Promise 链路内,调用 cacheTag(...) 都会\n * 写入本作用域,不会污染父作用域或兄弟请求\n */\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return getALS().run({ tags: new Set<string>(), uncacheable: false }, fn);\n}\n\n/**\n * 在 Server Component / loader 内显式声明本次渲染产物**不应入缓存**。\n * 适用场景:上游接口失败、降级渲染了一段错误提示 UI、命中风控/限流等\n * —— 渲染结果是 200,但内容会让用户困惑或马上过期,不应被 ISR HIT 反复回放。\n *\n * 调用一次即可;后续 cacheTag(...) 仍可继续调用但不会改变 uncacheable 决定。\n */\nexport function markUncacheable(): void {\n const store = getALS().getStore();\n if (store) {\n store.uncacheable = true;\n }\n}\n\n/** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */\nexport function isUncacheable(): boolean {\n return getALS().getStore()?.uncacheable === true;\n}\n\n/**\n * Server Component / server action / server-only util 内声明:\n * 本次渲染/调用产出的缓存条目应关联以下 tag\n *\n * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略\n */\nexport function cacheTag(...tags: string[]): void {\n const store = getALS().getStore();\n if (!store) {\n return;\n }\n for (const tag of tags) {\n if (typeof tag === 'string' && tag.length > 0) {\n store.tags.add(tag);\n }\n }\n}\n\n/**\n * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)\n */\nexport function collectTags(): string[] {\n const store = getALS().getStore();\n return store ? Array.from(store.tags) : [];\n}\n\n/**\n * 调试:打印当前 tag store 状态\n */\nexport function debugTagStore(label = ''): void {\n const store = getALS().getStore();\n logger.debug(\n `[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : '<none>'}`\n );\n}\n","/**\n * A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦\n *\n * RSC 环境通过本文件 import(不引入 express 类型,bundle 更轻);\n * Express 中间件在 ABVariantMiddleware.ts。\n */\nimport { getRequestContext } from '../context/RequestContext';\n\n/**\n * 在 Server Component 里读取 variant\n *\n * 不在 A/B middleware 后调用 → 返回 undefined\n */\nexport function getVariant(experimentName: string): string | undefined {\n const ctx = getRequestContext();\n const v = ctx?.flags?.[experimentName];\n return typeof v === 'string' ? v : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"contentRevalidation-D3SZwwbX.js","names":[],"sources":["../src/defaults/runtime/contentRevalidation.ts"],"sourcesContent":["/** Data and response cache scopes to invalidate after a content write commits. */\nexport interface ContentRevalidationOptions {\n paths?: readonly string[];\n tags?: readonly string[];\n locales?: readonly string[];\n sitemap?: boolean;\n}\n\nexport interface ContentPublication {\n id: string;\n scopes: Readonly<Required<ContentRevalidationOptions>>;\n}\n\ntype ContentInvalidation = ContentPublication['scopes'] & { allPageMetadata?: true };\ntype ContentInvalidator = (scopes: ContentInvalidation) => void;\n\n// Node, the RSC bundle, and the published site-hooks entry have separate module graphs.\nconst KEY = Symbol.for('isr-engine:content-invalidators');\nconst runtime = globalThis as typeof globalThis & {\n [KEY]?: Set<ContentInvalidator | WeakRef<ContentInvalidator>>;\n};\n\nexport function registerContentInvalidator(\n invalidate: ContentInvalidator,\n { weak = false } = {}\n): () => void {\n const registry = (runtime[KEY] ??= new Set());\n for (const entry of registry) {\n if (typeof entry !== 'function' && !entry.deref()) registry.delete(entry);\n }\n const entry = weak ? new WeakRef(invalidate) : invalidate;\n registry.add(entry);\n return () => {\n registry.delete(entry);\n };\n}\n\n/** The default scope recovers page metadata after a missed Redis notification. */\nexport function invalidateContentCaches(\n scopes: ContentInvalidation = {\n paths: [],\n tags: [],\n locales: [],\n sitemap: false,\n allPageMetadata: true,\n }\n): void {\n const errors: unknown[] = [];\n const registry = runtime[KEY];\n if (!registry) return;\n for (const entry of registry) {\n const invalidate = typeof entry === 'function' ? entry : entry.deref();\n if (!invalidate) {\n registry.delete(entry);\n continue;\n }\n try {\n invalidate(scopes);\n } catch (error) {\n errors.push(error);\n }\n }\n if (errors.length) throw new AggregateError(errors, 'Content metadata invalidation failed');\n}\n\nexport function normalizeContentScopes(input: unknown): ContentPublication['scopes'] {\n if (!input || typeof input !== 'object' || Array.isArray(input)) {\n throw new TypeError('Invalid content revalidation scopes');\n }\n const { paths, tags, locales, sitemap } = input as ContentRevalidationOptions;\n function read(values: unknown): string[] {\n if (values === undefined) return [];\n if (\n !Array.isArray(values) ||\n Array.from(values).some(value => typeof value !== 'string' || !value.trim())\n ) {\n throw new TypeError('Content revalidation scopes must contain non-empty strings');\n }\n return values;\n }\n if (sitemap !== undefined && typeof sitemap !== 'boolean') {\n throw new TypeError('Content revalidation sitemap must be a boolean');\n }\n return {\n paths: [...new Set(read(paths))],\n tags: [...new Set(read(tags))],\n locales: [...new Set(read(locales).map(locale => locale.trim().toLowerCase()))],\n sitemap: sitemap ?? false,\n };\n}\n"],"mappings":";AAiBA,IAAM,MAAM,OAAO,IAAI,iCAAiC;AACxD,IAAM,UAAU;AAIhB,SAAgB,2BACd,YACA,EAAE,OAAO,UAAU,CAAC,GACR;CACZ,MAAM,WAAY,QAAQ,yBAAS,IAAI,IAAI;CAC3C,KAAK,MAAM,SAAS,UAClB,IAAI,OAAO,UAAU,cAAc,CAAC,MAAM,MAAM,GAAG,SAAS,OAAO,KAAK;CAE1E,MAAM,QAAQ,OAAO,IAAI,QAAQ,UAAU,IAAI;CAC/C,SAAS,IAAI,KAAK;CAClB,aAAa;EACX,SAAS,OAAO,KAAK;CACvB;AACF;;AAGA,SAAgB,wBACd,SAA8B;CAC5B,OAAO,CAAC;CACR,MAAM,CAAC;CACP,SAAS,CAAC;CACV,SAAS;CACT,iBAAiB;AACnB,GACM;CACN,MAAM,SAAoB,CAAC;CAC3B,MAAM,WAAW,QAAQ;CACzB,IAAI,CAAC,UAAU;CACf,KAAK,MAAM,SAAS,UAAU;EAC5B,MAAM,aAAa,OAAO,UAAU,aAAa,QAAQ,MAAM,MAAM;EACrE,IAAI,CAAC,YAAY;GACf,SAAS,OAAO,KAAK;GACrB;EACF;EACA,IAAI;GACF,WAAW,MAAM;EACnB,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB;CACF;CACA,IAAI,OAAO,QAAQ,MAAM,IAAI,eAAe,QAAQ,sCAAsC;AAC5F;AAEA,SAAgB,uBAAuB,OAA8C;CACnF,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAC5D,MAAM,IAAI,UAAU,qCAAqC;CAE3D,MAAM,EAAE,OAAO,MAAM,SAAS,YAAY;CAC1C,SAAS,KAAK,QAA2B;EACvC,IAAI,WAAW,KAAA,GAAW,OAAO,CAAC;EAClC,IACE,CAAC,MAAM,QAAQ,MAAM,KACrB,MAAM,KAAK,MAAM,CAAC,CAAC,MAAK,UAAS,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,CAAC,GAE3E,MAAM,IAAI,UAAU,4DAA4D;EAElF,OAAO;CACT;CACA,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,WAC9C,MAAM,IAAI,UAAU,gDAAgD;CAEtE,OAAO;EACL,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;EAC/B,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;EAC7B,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,KAAI,WAAU,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;EAC9E,SAAS,WAAW;CACtB;AACF"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"createCachedFetcher-Y7zbGgjb.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) => Promise<TValue>;\n /** 缓存 TTL(毫秒),默认 60s */\n ttl?: number;\n /** LRU 容量,默认 500 */\n max?: number;\n /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */\n swr?: boolean;\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\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 type Flight = { arg: TArg; promise?: Promise<TValue> };\n const cache = new TinyLRU<string, Entry<TArg, TValue>>(max);\n const inflight = new Map<string, Flight>();\n\n async function load(key: string, flight: Flight): Promise<TValue> {\n try {\n const value = await opts.fetch(flight.arg);\n if (inflight.get(key) === flight) {\n cache.set(key, { arg: flight.arg, value, expiresAt: Date.now() + ttl });\n }\n return value;\n } catch (err) {\n if (opts.fallback) return await opts.fallback(flight.arg, err);\n throw err;\n }\n }\n\n function startLoad(key: string, arg: TArg): Promise<TValue> {\n const flight: Flight = { arg };\n inflight.set(key, flight);\n flight.promise = load(key, flight).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 return entry.value;\n }\n\n // miss 或非 SWR 过期:合并并发到同一个 promise\n return inflight.get(key)?.promise ?? startLoad(key, arg);\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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"}
|