isr-engine 3.0.0 → 3.1.1

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 +8 -0
  2. package/dist/Logger-DqBS_3v8.cjs +184 -0
  3. package/dist/Logger-DqBS_3v8.cjs.map +1 -0
  4. package/dist/Logger-bg-doGwZ.js +174 -0
  5. package/dist/Logger-bg-doGwZ.js.map +1 -0
  6. package/dist/{abVariantContext-BcnxBn4V.cjs → abVariantContext-BvAMuhjj.cjs} +194 -122
  7. package/dist/abVariantContext-BvAMuhjj.cjs.map +1 -0
  8. package/dist/{abVariantContext-BmZZi1YZ.js → abVariantContext-Ud3aZ1yk.js} +117 -118
  9. package/dist/abVariantContext-Ud3aZ1yk.js.map +1 -0
  10. package/dist/cli/cli.cjs +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/config/normalizeEngineConfig.d.ts.map +1 -1
  13. package/dist/{createCacheInspectorMiddleware-BY6MX88X.js → createCacheInspectorMiddleware-BpMpmP_a.js} +10 -5
  14. package/dist/createCacheInspectorMiddleware-BpMpmP_a.js.map +1 -0
  15. package/dist/{createCacheInspectorMiddleware-DZr98Zfn.cjs → createCacheInspectorMiddleware-DvRhF_-D.cjs} +12 -5
  16. package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs.map +1 -0
  17. package/dist/{createISRApp-CS6XfjHl.js → createISRApp-D88Xp0Fb.js} +402 -68
  18. package/dist/createISRApp-D88Xp0Fb.js.map +1 -0
  19. package/dist/{createISRApp-CHiiWF3P.cjs → createISRApp-tRkpdmpp.cjs} +433 -92
  20. package/dist/createISRApp-tRkpdmpp.cjs.map +1 -0
  21. package/dist/{createImagePlugin-Ddo5t3dJ.js → createImagePlugin-Cdz3QfrJ.js} +67 -21
  22. package/dist/createImagePlugin-Cdz3QfrJ.js.map +1 -0
  23. package/dist/{createImagePlugin-BtJzr0t-.cjs → createImagePlugin-DomuzpoI.cjs} +73 -21
  24. package/dist/createImagePlugin-DomuzpoI.cjs.map +1 -0
  25. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -1
  26. package/dist/defaults/runtime/defineSiteHooks.cjs +2 -2
  27. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
  28. package/dist/defaults/runtime/defineSiteHooks.js +2 -2
  29. package/dist/{defineSiteHooks-C3v3WLS8.cjs → defineSiteHooks-BuhvW5YB.cjs} +55 -40
  30. package/dist/defineSiteHooks-BuhvW5YB.cjs.map +1 -0
  31. package/dist/{defineSiteHooks-BeVy-qPH.js → defineSiteHooks-bHtGQftZ.js} +55 -40
  32. package/dist/defineSiteHooks-bHtGQftZ.js.map +1 -0
  33. package/dist/engine/ISREngine.d.ts.map +1 -1
  34. package/dist/{i18n-CyJIoYJT.cjs → i18n-CS5QhOO0.cjs} +7 -30
  35. package/dist/i18n-CS5QhOO0.cjs.map +1 -0
  36. package/dist/{i18n-Dobe0Wxn.js → i18n-CnXYAgQE.js} +8 -25
  37. package/dist/i18n-CnXYAgQE.js.map +1 -0
  38. package/dist/isr/ISRRoutes.d.ts +3 -1
  39. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  40. package/dist/isr-engine.cjs +576 -94
  41. package/dist/isr-engine.cjs.map +1 -1
  42. package/dist/isr-engine.js +571 -89
  43. package/dist/isr-engine.js.map +1 -1
  44. package/dist/logger/Logger.d.ts +6 -2
  45. package/dist/logger/Logger.d.ts.map +1 -1
  46. package/dist/logger/logRecord.d.ts +11 -0
  47. package/dist/logger/logRecord.d.ts.map +1 -0
  48. package/dist/logger/runtimeLogger.d.ts +6 -0
  49. package/dist/logger/runtimeLogger.d.ts.map +1 -0
  50. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  51. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -1
  52. package/dist/plugin/createFontPlugin.d.ts +1 -1
  53. package/dist/plugin/createFontPlugin.d.ts.map +1 -1
  54. package/dist/plugin/googleFontAssets.d.ts +23 -0
  55. package/dist/plugin/googleFontAssets.d.ts.map +1 -0
  56. package/dist/plugin/isrCacheMiddleware.d.ts +5 -0
  57. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  58. package/dist/plugin/remoteImageSource.d.ts +3 -3
  59. package/dist/plugin/remoteImageSource.d.ts.map +1 -1
  60. package/dist/rsc/ServerActions.d.ts.map +1 -1
  61. package/dist/rsc/cacheTag.d.ts.map +1 -1
  62. package/dist/rsc/index.cjs +8 -9
  63. package/dist/rsc/index.js +2 -3
  64. package/dist/rsc/revalidate.d.ts.map +1 -1
  65. package/dist/{rsc-BSxvkPHd.js → rsc-BJzB9s8U.js} +4 -6
  66. package/dist/rsc-BJzB9s8U.js.map +1 -0
  67. package/dist/{rsc-NB-Uka7j.cjs → rsc-CYT6B6bf.cjs} +5 -7
  68. package/dist/rsc-CYT6B6bf.cjs.map +1 -0
  69. package/dist/server/manager.d.ts.map +1 -1
  70. package/dist/server/opsConfig.d.ts +7 -1
  71. package/dist/server/opsConfig.d.ts.map +1 -1
  72. package/dist/server/productionRuntime.d.ts +2 -3
  73. package/dist/server/productionRuntime.d.ts.map +1 -1
  74. package/dist/server/requestLimits.d.ts +36 -0
  75. package/dist/server/requestLimits.d.ts.map +1 -0
  76. package/dist/server/safeRedirect.d.ts +6 -0
  77. package/dist/server/safeRedirect.d.ts.map +1 -0
  78. package/dist/types/ISRConfig.d.ts +20 -2
  79. package/dist/types/ISRConfig.d.ts.map +1 -1
  80. package/dist/utils/cookie.d.ts.map +1 -1
  81. package/package.json +3 -1
  82. package/src/defaults/runtime/browserObservability.ts +27 -9
  83. package/src/defaults/runtime/defineServerEntry.tsx +2 -2
  84. package/src/defaults/runtime/defineSiteHooks.ts +70 -61
  85. package/src/types/ISRConfig.ts +22 -2
  86. package/src/utils/cookie.ts +5 -3
  87. package/dist/RequestContext-BVQ-rOmV.js +0 -58
  88. package/dist/RequestContext-BVQ-rOmV.js.map +0 -1
  89. package/dist/RequestContext-DgGEAxcW.cjs +0 -105
  90. package/dist/RequestContext-DgGEAxcW.cjs.map +0 -1
  91. package/dist/abVariantContext-BcnxBn4V.cjs.map +0 -1
  92. package/dist/abVariantContext-BmZZi1YZ.js.map +0 -1
  93. package/dist/createCacheInspectorMiddleware-BY6MX88X.js.map +0 -1
  94. package/dist/createCacheInspectorMiddleware-DZr98Zfn.cjs.map +0 -1
  95. package/dist/createISRApp-CHiiWF3P.cjs.map +0 -1
  96. package/dist/createISRApp-CS6XfjHl.js.map +0 -1
  97. package/dist/createImagePlugin-BtJzr0t-.cjs.map +0 -1
  98. package/dist/createImagePlugin-Ddo5t3dJ.js.map +0 -1
  99. package/dist/defineSiteHooks-BeVy-qPH.js.map +0 -1
  100. package/dist/defineSiteHooks-C3v3WLS8.cjs.map +0 -1
  101. package/dist/i18n-CyJIoYJT.cjs.map +0 -1
  102. package/dist/i18n-Dobe0Wxn.js.map +0 -1
  103. package/dist/rsc-BSxvkPHd.js.map +0 -1
  104. package/dist/rsc-NB-Uka7j.cjs.map +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "isr-engine",
3
- "version": "3.0.0",
3
+ "version": "3.1.1",
4
4
  "description": "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {
@@ -122,11 +122,13 @@
122
122
  "css-tree": "^3.2.1",
123
123
  "esbuild": "^0.28.2",
124
124
  "express": "^5.3.0",
125
+ "express-rate-limit": "8.7.5",
125
126
  "helmet": "^7.1.0",
126
127
  "ipaddr.js": "^2.5.0",
127
128
  "lru-cache": "^10.4.3",
128
129
  "ora": "^10.0.0",
129
130
  "parse5": "^8.0.1",
131
+ "pino": "10.4.0",
130
132
  "prom-client": "^15.1.3",
131
133
  "rsc-html-stream": "0.0.7",
132
134
  "sharp": "^0.35.5",
@@ -211,6 +211,7 @@ function createEndpointAnalyticsClient(
211
211
  },
212
212
  getUser
213
213
  );
214
+ if (!base) return null;
214
215
 
215
216
  return {
216
217
  track(name, properties, trackOptions) {
@@ -278,6 +279,7 @@ function createEndpointErrorReporter(
278
279
  },
279
280
  getUser
280
281
  );
282
+ if (!base) return null;
281
283
 
282
284
  const captureException = (error: unknown, context: TelemetryCaptureOptions = {}) => {
283
285
  const normalized = normalizeError(error);
@@ -375,6 +377,8 @@ function createEndpointQueue(
375
377
  const queue: FallbackPayload[] = [];
376
378
  const sessionId = readOrCreateBrowserId(`${baseOptions.key}_session`);
377
379
  const anonymousId = readOrCreateBrowserId(`${baseOptions.key}_anonymous`);
380
+ // Telemetry is optional: fail closed for identifiers without blocking client hydration.
381
+ if (!sessionId || !anonymousId) return null;
378
382
  let timer: number | null = null;
379
383
  let retryTimer: number | null = null;
380
384
  let inFlight = false;
@@ -414,9 +418,11 @@ function createEndpointQueue(
414
418
  const enqueue = (payload: FallbackPayload) => {
415
419
  if (baseOptions.sampleRate <= 0) return;
416
420
  if (baseOptions.sampleRate < 1 && Math.random() > baseOptions.sampleRate) return;
421
+ const id = createId(baseOptions.key.includes('errors') ? 'err' : 'evt');
422
+ if (!id) return;
417
423
 
418
424
  queue.push({
419
- id: createId(baseOptions.key.includes('errors') ? 'err' : 'evt'),
425
+ id,
420
426
  app: options.app,
421
427
  ts: Date.now(),
422
428
  release: options.release,
@@ -486,7 +492,7 @@ function createEndpointQueue(
486
492
  }
487
493
 
488
494
  function installFallbackWebVitals(
489
- base: ReturnType<typeof createEndpointQueue>,
495
+ base: NonNullable<ReturnType<typeof createEndpointQueue>>,
490
496
  includeQueryString?: boolean
491
497
  ): () => void {
492
498
  if (!isBrowser() || typeof PerformanceObserver === 'undefined') return () => {};
@@ -760,21 +766,33 @@ function isBrowser(): boolean {
760
766
  return typeof window !== 'undefined' && typeof document !== 'undefined';
761
767
  }
762
768
 
763
- function createId(prefix: string): string {
764
- return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
769
+ function createId(prefix: 'runtime' | 'evt' | 'err'): string | null {
770
+ try {
771
+ if (typeof globalThis.crypto?.getRandomValues !== 'function') return null;
772
+ const bytes = globalThis.crypto.getRandomValues(new Uint8Array(16));
773
+ return `${prefix}_${Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')}`;
774
+ } catch {
775
+ return null;
776
+ }
765
777
  }
766
778
 
767
- function readOrCreateBrowserId(key: string): string {
779
+ function readOrCreateBrowserId(key: string): string | null {
768
780
  if (!isBrowser()) return createId('runtime');
769
781
  try {
770
782
  const existing = window.localStorage.getItem(key);
771
- if (existing) return existing;
772
- const next = createId('runtime');
783
+ // Older timestamp/Math.random identifiers must not retain the weak generator's output.
784
+ if (existing && /^runtime_[0-9a-f]{32}$/.test(existing)) return existing;
785
+ } catch {
786
+ // Storage can be unavailable in privacy modes; use an ephemeral secure identifier.
787
+ }
788
+ const next = createId('runtime');
789
+ if (!next) return null;
790
+ try {
773
791
  window.localStorage.setItem(key, next);
774
- return next;
775
792
  } catch {
776
- return createId('runtime');
793
+ // Persisting an identifier is optional and must not affect event delivery.
777
794
  }
795
+ return next;
778
796
  }
779
797
 
780
798
  /** 解析 ignoreSourcePatterns 选项 —— false 关闭过滤;数组与默认合并;缺省走默认。 */
@@ -154,9 +154,9 @@ export interface ServerEntryModule {
154
154
  fetch: (request: Request) => Promise<Response>;
155
155
  }
156
156
 
157
- /** 生成一个紧凑的 trace-id(10 位 base36,约 2^52 / 1e6 = 4.5T 条不重碰)*/
157
+ /** Node 24 and supported edge runtimes expose the Web Crypto UUID generator. */
158
158
  function genTraceId(): string {
159
- return `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
159
+ return `t-${crypto.randomUUID()}`;
160
160
  }
161
161
 
162
162
  export function defineServerEntry<C extends ServerCtx = ServerCtx>(
@@ -108,36 +108,6 @@ export interface CreateAdminSeoLoaderOptions {
108
108
  dynamicResolvers?: readonly DynamicSeoResolver[];
109
109
  }
110
110
 
111
- /**
112
- * 内部用:把 `/books/:id` 这种 pattern 编译成 RegExp + 参数名列表。
113
- * `:name` 匹配单段(不跨 /)。`*` 匹配任意后缀(包括 /),收成 ":wildcard" param。
114
- * 编译后缓存,避免每次请求重算。
115
- */
116
- interface CompiledSeoResolver {
117
- re: RegExp;
118
- paramNames: string[];
119
- resolver: DynamicSeoResolver;
120
- }
121
-
122
- function compileSeoResolver(resolver: DynamicSeoResolver): CompiledSeoResolver {
123
- const paramNames: string[] = [];
124
- const reSrc = resolver.pattern
125
- .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
126
- .replace(/:([A-Za-z_][A-Za-z0-9_]*)|\\\*/g, (m, name) => {
127
- if (m === '\\*') {
128
- paramNames.push('wildcard');
129
- return '(.*)';
130
- }
131
- paramNames.push(name);
132
- return '([^/]+)';
133
- });
134
- return {
135
- re: new RegExp(`^${reSrc}$`),
136
- paramNames,
137
- resolver,
138
- };
139
- }
140
-
141
111
  export interface DefineAdminSiteHooksOptions {
142
112
  i18n?: {
143
113
  locales?: readonly string[];
@@ -271,23 +241,38 @@ export interface SiteHooksConfig {
271
241
  headExtras?: (ctx: { nonce?: string }) => string | undefined;
272
242
  }
273
243
 
274
- interface CompiledRoute {
244
+ interface CompiledSeoPattern {
275
245
  re: RegExp;
276
246
  paramNames: string[];
247
+ }
248
+
249
+ interface CompiledRoute extends CompiledSeoPattern {
277
250
  resolver: (params: Record<string, string>) => Promise<PageSeoMeta | null> | PageSeoMeta | null;
278
251
  }
279
252
 
280
- /** 把 `/books/:id/reviews/:rid` 编译成 RegExp + 参数名列表 */
281
- function compilePattern(pattern: string): { re: RegExp; paramNames: string[] } {
253
+ function escapeSeoPatternLiteral(literal: string): string {
254
+ return literal.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
255
+ }
256
+
257
+ /** Both SEO entry points recognize named parameters and a terminal /* before escaping literals. */
258
+ function compileSeoPattern(pattern: string, captureWildcard = false): CompiledSeoPattern {
282
259
  const paramNames: string[] = [];
283
260
  const wildcard = pattern.endsWith('/*');
284
261
  const base = wildcard ? pattern.slice(0, -2) : pattern;
285
- const escaped = base.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
286
- const reSrc = escaped.replace(/:(\w+)/g, (_, name) => {
287
- paramNames.push(name);
288
- return '([^/]+)';
289
- });
290
- return { re: new RegExp(`^${reSrc}${wildcard ? '(?:/.*)?' : ''}$`), paramNames };
262
+ let cursor = 0;
263
+ let source = '';
264
+ for (const match of base.matchAll(/:(\w+)/g)) {
265
+ source += escapeSeoPatternLiteral(base.slice(cursor, match.index)) + '([^/]+)';
266
+ paramNames.push(match[1]);
267
+ cursor = match.index + match[0].length;
268
+ }
269
+ source += escapeSeoPatternLiteral(base.slice(cursor));
270
+
271
+ if (wildcard) {
272
+ if (captureWildcard) paramNames.push('wildcard');
273
+ source += captureWildcard ? '(?:/(.*))?' : '(?:/.*)?';
274
+ }
275
+ return { re: new RegExp(`^${source}$`), paramNames };
291
276
  }
292
277
 
293
278
  function fillTemplate(template: string, vars: Record<string, string>): string {
@@ -335,9 +320,10 @@ export function createAdminSeoLoader(
335
320
  const endpoint = options.endpoint ?? '/api/seo?path={pathname}';
336
321
  const fallbackEntries = options.fallbackEntries ?? [];
337
322
  // 编译一次 + 缓存。N 个 resolver 在每个请求里只是 N 次正则 test,cost 可忽略。
338
- const compiledResolvers: CompiledSeoResolver[] = (options.dynamicResolvers ?? []).map(
339
- compileSeoResolver
340
- );
323
+ const compiledResolvers = (options.dynamicResolvers ?? []).map(resolver => ({
324
+ ...compileSeoPattern(resolver.pattern, true),
325
+ resolver,
326
+ }));
341
327
 
342
328
  return async (params, ctx) => {
343
329
  const pathname = normalizePathname(params.pathname || '/');
@@ -390,6 +376,23 @@ export function defineAdminSiteHooks(options: DefineAdminSiteHooksOptions = {}):
390
376
  return createAdminSiteHooks(options, createEmptyRuntimeConfig());
391
377
  }
392
378
 
379
+ function createAdminSeoEntry(
380
+ seo: NonNullable<DefineAdminSiteHooksOptions['seo']>,
381
+ runtimeSeo: Partial<RuntimeSeoConfig>
382
+ ): SeoLocalEntry {
383
+ return {
384
+ load: createAdminSeoLoader({
385
+ endpoint: seo.endpoint ?? runtimeSeo.endpoint,
386
+ fallbackEntries: normalizeAdminSeoFallbackEntries(
387
+ seo.fallbackLocal ?? runtimeSeo.fallbackLocal
388
+ ),
389
+ timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,
390
+ dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,
391
+ }),
392
+ ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,
393
+ };
394
+ }
395
+
393
396
  function createAdminSiteHooks(
394
397
  options: DefineAdminSiteHooksOptions,
395
398
  runtime: SiteRuntimeConfig
@@ -426,17 +429,7 @@ function createAdminSiteHooks(
426
429
  ttl: i18n.ttl ?? runtimeI18n.ttl ?? 60_000,
427
430
  },
428
431
  seo: {
429
- '/*': {
430
- load: createAdminSeoLoader({
431
- endpoint: seo.endpoint ?? runtimeSeo.endpoint,
432
- fallbackEntries: normalizeAdminSeoFallbackEntries(
433
- seo.fallbackLocal ?? runtimeSeo.fallbackLocal
434
- ),
435
- timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,
436
- dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,
437
- }),
438
- ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,
439
- },
432
+ '/*': createAdminSeoEntry(seo, runtimeSeo),
440
433
  },
441
434
  },
442
435
  runtime
@@ -526,10 +519,21 @@ export function applyRuntimeToServerHooks<T extends object>(
526
519
  } as T;
527
520
  }
528
521
 
522
+ // A dynamic SEO table on its own does not opt a plain server entry into the admin i18n
523
+ // loader or wrap its beforeRequest callback.
524
+ const runtimeSeo = runtime.seo;
525
+ const runtimeSeoHook =
526
+ !hasUserContentHooks && runtimeSeo?.dynamicResolvers?.length
527
+ ? createSiteHooks(
528
+ { intl: runtime.i18n, seo: { '/*': createAdminSeoEntry({}, runtimeSeo) } },
529
+ runtime
530
+ ).loadSeoMeta
531
+ : undefined;
529
532
  return {
530
533
  ...hooks,
531
534
  siteBaseUrl,
532
535
  apiBaseUrl,
536
+ ...(runtimeSeoHook && { loadSeoMeta: runtimeSeoHook }),
533
537
  } as T;
534
538
  }
535
539
 
@@ -642,7 +646,7 @@ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): S
642
646
  >();
643
647
 
644
648
  for (const [pattern, value] of Object.entries(config.seo ?? {})) {
645
- const { re, paramNames } = compilePattern(pattern);
649
+ const { re, paramNames } = compileSeoPattern(pattern);
646
650
 
647
651
  if (typeof value === 'function') {
648
652
  // 自定义 resolver
@@ -905,7 +909,10 @@ function createServerErrorEndpointReporter(
905
909
  const includeQueryString = config.includeQueryString === true;
906
910
 
907
911
  return (err, req, errorCtx) => {
912
+ const id = createServerReportId();
913
+ if (!id) return;
908
914
  const report = normalizeServerErrorReport(err, req, errorCtx, {
915
+ id,
909
916
  release,
910
917
  environment,
911
918
  includeQueryString,
@@ -934,6 +941,7 @@ function normalizeServerErrorReport(
934
941
  req: Request,
935
942
  ctx: { traceId: string; locale?: string },
936
943
  options: {
944
+ id: string;
937
945
  release?: string;
938
946
  environment?: string;
939
947
  includeQueryString?: boolean;
@@ -945,7 +953,7 @@ function normalizeServerErrorReport(
945
953
  const url = safeRequestPath(req.url, options.includeQueryString);
946
954
 
947
955
  return {
948
- id: createServerReportId(),
956
+ id: options.id,
949
957
  ts: Date.now(),
950
958
  level: 'error',
951
959
  message,
@@ -976,12 +984,13 @@ function safeRequestPath(rawUrl: string, includeQueryString?: boolean): string {
976
984
  }
977
985
  }
978
986
 
979
- function createServerReportId(): string {
980
- const random =
981
- typeof crypto !== 'undefined' && 'randomUUID' in crypto
982
- ? crypto.randomUUID()
983
- : Math.random().toString(36).slice(2);
984
- return `srv_${Date.now().toString(36)}_${random}`;
987
+ function createServerReportId(): string | null {
988
+ try {
989
+ return `srv_${crypto.randomUUID()}`;
990
+ } catch {
991
+ // Optional reporting must not weaken IDs or interrupt rendering without Web Crypto.
992
+ return null;
993
+ }
985
994
  }
986
995
 
987
996
  async function fetchJsonWithTimeout<T>(url: string, timeoutMs = 1200): Promise<T | null> {
@@ -143,7 +143,7 @@ export interface RuntimeI18nConfig {
143
143
  */
144
144
  export interface DynamicSeoResolver {
145
145
  /**
146
- * 路径 pattern。支持 `:name` 命名参数(贪婪到 `/`)和 `*` 通配后缀。
146
+ * 路径 pattern。支持 `:name` 匹配单段和末尾 `/*` 匹配路径本身及其子路径。
147
147
  * 例:`/books/:id`、`/u/:handle`、`/dashboard/*`
148
148
  */
149
149
  pattern: string;
@@ -151,7 +151,8 @@ export interface DynamicSeoResolver {
151
151
  * 命中后的 resolver。返回 PageSeoMeta(平铺)或 null。
152
152
  * 抛错会被引擎吞掉并写到 onError,不会导致 SSR 失败。
153
153
  *
154
- * input.params 包含 pattern 里 :name 解析出的值。
154
+ * input.params 包含命名参数。末尾 `/*` 还会返回 `wildcard`,
155
+ * 其值为不带起始斜杠的剩余路径,本身命中时为空字符串。
155
156
  * input.locale 是当前请求 locale(可能 undefined,特别是没启 i18n 时)。
156
157
  * input.services / input.runtime 给到完整 runtime context,可拿 api origin。
157
158
  */
@@ -386,6 +387,23 @@ export const FallbackChain: Record<RenderModeType, InternalStrategyType[]> = {
386
387
  export type ProxyTrustPolicy =
387
388
  boolean | number | string | string[] | ((address: string, hop: number) => boolean);
388
389
 
390
+ /** Positive, per-process admission budgets for engine-owned expensive request work. */
391
+ export interface RequestLimitPolicy {
392
+ windowMs?: number;
393
+ /** Maximum requests from one IPv4 address or IPv6 /56 per window. */
394
+ maxRequests?: number;
395
+ /** Maximum aggregate requests per window, including rejected client attempts. */
396
+ globalMaxRequests?: number;
397
+ /** Maximum live client counters; new clients receive 429 when this capacity is full. */
398
+ maxClients?: number;
399
+ }
400
+
401
+ export interface RequestLimitsConfig {
402
+ ops?: RequestLimitPolicy;
403
+ staticHtml?: RequestLimitPolicy;
404
+ seo?: RequestLimitPolicy;
405
+ }
406
+
389
407
  export interface ISRConfig {
390
408
  /** 全局默认渲染模式 */
391
409
  renderMode: RenderModeType;
@@ -441,6 +459,8 @@ export interface ISRConfig {
441
459
  * Hop counts/true require an ingress that overwrites client forwarded headers.
442
460
  */
443
461
  trustProxy?: ProxyTrustPolicy;
462
+ /** Engine ops, indexed static HTML reads and SEO admission. Page cache hits/APIs are separate. */
463
+ requestLimits?: RequestLimitsConfig;
444
464
  /** Node origin 监听端口;缺省 3000。 */
445
465
  port: number;
446
466
  /** Node origin 监听地址;通常本地留空,容器/内网按部署平台注入。 */
@@ -30,8 +30,7 @@ export function readCookie(source: CookieHeaderSource, name: string): string | u
30
30
  }
31
31
 
32
32
  export function parseCookieHeader(header: string): Record<string, string> {
33
- const cookies: Record<string, string> = Object.create(null);
34
- if (!header) return cookies;
33
+ const entries = new Map<string, string>();
35
34
 
36
35
  for (const part of header.split(';')) {
37
36
  const trimmed = part.trim();
@@ -44,9 +43,12 @@ export function parseCookieHeader(header: string): Record<string, string> {
44
43
  if (!key) continue;
45
44
 
46
45
  const rawValue = trimmed.slice(index + 1).trim();
47
- cookies[key] = safeDecodeCookieValue(rawValue);
46
+ entries.set(key, safeDecodeCookieValue(rawValue));
48
47
  }
49
48
 
49
+ // fromEntries creates own data properties, including __proto__, without invoking setters.
50
+ const cookies = Object.fromEntries(entries);
51
+ Object.setPrototypeOf(cookies, null);
50
52
  return cookies;
51
53
  }
52
54
 
@@ -1,58 +0,0 @@
1
- import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
2
- import { AsyncLocalStorage } from "async_hooks";
3
- //#region src/context/RequestContext.ts
4
- var RequestContext_exports = /* @__PURE__ */ __exportAll({
5
- getAnonId: () => getAnonId,
6
- getExperiments: () => getExperiments,
7
- getRequestContext: () => getRequestContext,
8
- getRequestId: () => getRequestId,
9
- getTraceId: () => getTraceId,
10
- getUserId: () => getUserId,
11
- requestContext: () => requestContext
12
- });
13
- var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
14
- function getGlobalRequestContext() {
15
- const globalState = globalThis;
16
- globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage();
17
- return globalState[REQUEST_CONTEXT_KEY];
18
- }
19
- var requestContext = getGlobalRequestContext();
20
- var getRequestContext = () => {
21
- return requestContext.getStore();
22
- };
23
- var getTraceId = () => {
24
- return requestContext.getStore()?.traceId || "system";
25
- };
26
- var getRequestId = () => {
27
- return requestContext.getStore()?.requestId || "unknown";
28
- };
29
- /**
30
- * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
31
- *
32
- * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
33
- * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
34
- * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
35
- */
36
- var getAnonId = () => {
37
- return requestContext.getStore()?.anonId || "system";
38
- };
39
- /**
40
- * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
41
- * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
42
- * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
43
- */
44
- var getUserId = () => {
45
- return requestContext.getStore()?.userId ?? null;
46
- };
47
- /**
48
- * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
49
- * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
50
- * 没接 ABVariantMiddleware 时返回空对象。
51
- */
52
- var getExperiments = () => {
53
- return requestContext.getStore()?.experiments ?? {};
54
- };
55
- //#endregion
56
- export { getRequestId as a, requestContext as c, getRequestContext as i, getAnonId as n, getTraceId as o, getExperiments as r, getUserId as s, RequestContext_exports as t };
57
-
58
- //# sourceMappingURL=RequestContext-BVQ-rOmV.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"RequestContext-BVQ-rOmV.js","names":[],"sources":["../src/context/RequestContext.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"],"mappings":";;;;;;;;;;;;AAMA,IAAM,sBAAsB;AAE5B,SAAS,0BAAkE;CACzE,MAAM,cAAc;CAIpB,YAAY,yBAAyB,IAAI,kBAAuC;CAChF,OAAO,YAAY;AACrB;AAGA,IAAa,iBAAiB,wBAAwB;AAGtD,IAAa,0BAA2D;CACtE,OAAO,eAAe,SAAS;AACjC;AAGA,IAAa,mBAA2B;CAEtC,OADc,eAAe,SACtB,CAAA,EAAO,WAAW;AAC3B;AAGA,IAAa,qBAA6B;CAExC,OADc,eAAe,SACtB,CAAA,EAAO,aAAa;AAC7B;;;;;;;;AASA,IAAa,kBAA0B;CAErC,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,kBAAiC;CAE5C,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,uBAA+C;CAE1D,OADc,eAAe,SACtB,CAAA,EAAO,eAAe,CAAC;AAChC"}
@@ -1,105 +0,0 @@
1
- const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
2
- let async_hooks = require("async_hooks");
3
- //#region src/context/RequestContext.ts
4
- var RequestContext_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
5
- getAnonId: () => getAnonId,
6
- getExperiments: () => getExperiments,
7
- getRequestContext: () => getRequestContext,
8
- getRequestId: () => getRequestId,
9
- getTraceId: () => getTraceId,
10
- getUserId: () => getUserId,
11
- requestContext: () => requestContext
12
- });
13
- var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
14
- function getGlobalRequestContext() {
15
- const globalState = globalThis;
16
- globalState[REQUEST_CONTEXT_KEY] ??= new async_hooks.AsyncLocalStorage();
17
- return globalState[REQUEST_CONTEXT_KEY];
18
- }
19
- var requestContext = getGlobalRequestContext();
20
- var getRequestContext = () => {
21
- return requestContext.getStore();
22
- };
23
- var getTraceId = () => {
24
- return requestContext.getStore()?.traceId || "system";
25
- };
26
- var getRequestId = () => {
27
- return requestContext.getStore()?.requestId || "unknown";
28
- };
29
- /**
30
- * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
31
- *
32
- * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
33
- * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
34
- * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
35
- */
36
- var getAnonId = () => {
37
- return requestContext.getStore()?.anonId || "system";
38
- };
39
- /**
40
- * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
41
- * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
42
- * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
43
- */
44
- var getUserId = () => {
45
- return requestContext.getStore()?.userId ?? null;
46
- };
47
- /**
48
- * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
49
- * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
50
- * 没接 ABVariantMiddleware 时返回空对象。
51
- */
52
- var getExperiments = () => {
53
- return requestContext.getStore()?.experiments ?? {};
54
- };
55
- //#endregion
56
- Object.defineProperty(exports, "RequestContext_exports", {
57
- enumerable: true,
58
- get: function() {
59
- return RequestContext_exports;
60
- }
61
- });
62
- Object.defineProperty(exports, "getAnonId", {
63
- enumerable: true,
64
- get: function() {
65
- return getAnonId;
66
- }
67
- });
68
- Object.defineProperty(exports, "getExperiments", {
69
- enumerable: true,
70
- get: function() {
71
- return getExperiments;
72
- }
73
- });
74
- Object.defineProperty(exports, "getRequestContext", {
75
- enumerable: true,
76
- get: function() {
77
- return getRequestContext;
78
- }
79
- });
80
- Object.defineProperty(exports, "getRequestId", {
81
- enumerable: true,
82
- get: function() {
83
- return getRequestId;
84
- }
85
- });
86
- Object.defineProperty(exports, "getTraceId", {
87
- enumerable: true,
88
- get: function() {
89
- return getTraceId;
90
- }
91
- });
92
- Object.defineProperty(exports, "getUserId", {
93
- enumerable: true,
94
- get: function() {
95
- return getUserId;
96
- }
97
- });
98
- Object.defineProperty(exports, "requestContext", {
99
- enumerable: true,
100
- get: function() {
101
- return requestContext;
102
- }
103
- });
104
-
105
- //# sourceMappingURL=RequestContext-DgGEAxcW.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"RequestContext-DgGEAxcW.cjs","names":[],"sources":["../src/context/RequestContext.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"],"mappings":";;;;;;;;;;;;AAMA,IAAM,sBAAsB;AAE5B,SAAS,0BAAkE;CACzE,MAAM,cAAc;CAIpB,YAAY,yBAAyB,IAAI,YAAA,kBAAuC;CAChF,OAAO,YAAY;AACrB;AAGA,IAAa,iBAAiB,wBAAwB;AAGtD,IAAa,0BAA2D;CACtE,OAAO,eAAe,SAAS;AACjC;AAGA,IAAa,mBAA2B;CAEtC,OADc,eAAe,SACtB,CAAA,EAAO,WAAW;AAC3B;AAGA,IAAa,qBAA6B;CAExC,OADc,eAAe,SACtB,CAAA,EAAO,aAAa;AAC7B;;;;;;;;AASA,IAAa,kBAA0B;CAErC,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,kBAAiC;CAE5C,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,uBAA+C;CAE1D,OADc,eAAe,SACtB,CAAA,EAAO,eAAe,CAAC;AAChC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"abVariantContext-BcnxBn4V.cjs","names":[],"sources":["../src/logger/Logger.ts","../src/rsc/revalidationMetrics.ts","../src/rsc/revalidate.ts","../src/rsc/cacheTag.ts","../src/middlewares/abVariantContext.ts"],"sourcesContent":["import chalk from 'chalk';\nimport ora, { Ora } from 'ora';\nimport fs from 'fs';\nimport path from 'path';\nimport { getTraceId, getRequestId } from '../context/RequestContext';\n\nexport enum LogLevel {\n VERBOSE = 'verbose',\n DEBUG = 'debug',\n INFO = 'info',\n WARN = 'warn',\n ERROR = 'error',\n SUCCESS = 'success',\n}\n\nexport interface LoggerOptions {\n verbose?: boolean;\n logFile?: string;\n}\n\nexport class Logger {\n private static instance: Logger;\n private verboseMode: boolean = false;\n private logFile: string | null = null;\n private spinner: Ora | null = null;\n\n public static getInstance(options: LoggerOptions = {}): Logger {\n if (!Logger.instance) {\n Logger.instance = new Logger();\n }\n\n if (options.verbose !== undefined) {\n Logger.instance.verboseMode = options.verbose;\n }\n\n if (options.logFile !== undefined) {\n Logger.instance.logFile = options.logFile;\n try {\n const dir = path.dirname(options.logFile);\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n } catch (error) {\n console.error('Failed to create log directory:', error);\n }\n }\n\n return Logger.instance;\n }\n\n private formatMessage(level: LogLevel, colorize: boolean, ...args: unknown[]): string {\n const timestamp = new Date().toISOString();\n const levelName = level.toUpperCase();\n const traceId = getTraceId();\n const requestId = getRequestId();\n\n let levelTag = `[${levelName}]`;\n let traceTag = `[${escapeLogValue(traceId)}]`;\n let requestTag = requestId !== 'unknown' ? `[${escapeLogValue(requestId)}]` : '';\n\n const message = args\n .map(arg => {\n if (arg instanceof Error) {\n return arg.stack || arg.message;\n }\n return typeof arg === 'object' ? (JSON.stringify(arg, null, 2) ?? '') : String(arg);\n })\n .map(escapeLogValue)\n .join(' ');\n\n if (colorize) {\n const levelColor = this.getLevelColor(level);\n levelTag = levelColor(levelTag);\n traceTag = chalk.cyan(traceTag);\n requestTag = requestTag ? chalk.blue(requestTag) : '';\n return `${chalk.gray(timestamp)} ${traceTag} ${requestTag} ${levelTag} ${message}`;\n }\n\n return `${timestamp} ${traceTag} ${requestTag} ${levelTag} ${message}`;\n }\n\n private getLevelColor(level: LogLevel) {\n switch (level) {\n case LogLevel.ERROR:\n return chalk.red.bold;\n case LogLevel.WARN:\n return chalk.yellow.bold;\n case LogLevel.SUCCESS:\n return chalk.green.bold;\n case LogLevel.INFO:\n return chalk.blue.bold;\n case LogLevel.DEBUG:\n return chalk.magenta;\n case LogLevel.VERBOSE:\n return chalk.gray;\n default:\n return chalk.white;\n }\n }\n\n private writeToFile(message: string) {\n if (this.logFile) {\n try {\n fs.appendFileSync(this.logFile, message + '\\n');\n } catch (error) {\n // Prevent infinite loop if logging fails\n process.stderr.write(`Failed to write to log file: ${error}\\n`);\n }\n }\n }\n\n public log(level: LogLevel, ...args: unknown[]) {\n if (this.spinner && this.spinner.isSpinning) {\n this.spinner.stop();\n }\n\n if (level === LogLevel.VERBOSE && !this.verboseMode) return;\n if (level === LogLevel.DEBUG && !this.verboseMode) return;\n\n // Console output\n console.log(this.formatMessage(level, true, ...args));\n\n // File output\n if (this.logFile) {\n this.writeToFile(this.formatMessage(level, false, ...args));\n }\n\n if (this.spinner && !this.spinner.isSpinning) {\n this.spinner.start();\n }\n }\n\n public error(...args: unknown[]) {\n this.log(LogLevel.ERROR, ...args);\n }\n\n public warn(...args: unknown[]) {\n this.log(LogLevel.WARN, ...args);\n }\n\n public info(...args: unknown[]) {\n this.log(LogLevel.INFO, ...args);\n }\n\n public success(...args: unknown[]) {\n this.log(LogLevel.SUCCESS, ...args);\n }\n\n public debug(...args: unknown[]) {\n this.log(LogLevel.DEBUG, ...args);\n }\n\n public verbose(...args: unknown[]) {\n this.log(LogLevel.VERBOSE, ...args);\n }\n\n public spin(message: string): Ora {\n if (this.spinner) {\n this.spinner.succeed();\n }\n this.spinner = ora(message).start();\n return this.spinner;\n }\n\n public stopSpinner(message?: string, success: boolean = true) {\n if (this.spinner) {\n if (success) {\n this.spinner.succeed(message);\n } else {\n this.spinner.fail(message);\n }\n this.spinner = null;\n }\n }\n}\n\nfunction escapeLogValue(value: string): string {\n return Array.from(value, character => {\n const code = character.charCodeAt(0);\n if (character === '\\n') return '\\\\n';\n if (character === '\\r') return '\\\\r';\n if (code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === 0x2028 || code === 0x2029) {\n return `\\\\u${code.toString(16).padStart(4, '0')}`;\n }\n return character;\n }).join('');\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 { Logger } from '../logger/Logger';\nimport { recordRevalidationMetric } from './revalidationMetrics';\n\nconst logger = Logger.getInstance();\n\n/** Invalidator 签名:接收失效目标描述 */\nexport interface RevalidateInvalidator {\n (target: { kind: 'path'; value: string } | { kind: 'tag'; value: string }): Promise<void> | void;\n}\n\n/** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */\nconst REGISTRY_KEY = Symbol.for('isr-engine:revalidate-registry');\n\ntype GlobalWithRegistry = typeof globalThis & {\n [REGISTRY_KEY]?: Set<RevalidateInvalidator>;\n};\n\nfunction getRegistry(): Set<RevalidateInvalidator> {\n const g = globalThis as GlobalWithRegistry;\n if (!g[REGISTRY_KEY]) {\n g[REGISTRY_KEY] = new Set<RevalidateInvalidator>();\n }\n return g[REGISTRY_KEY];\n}\n\n/**\n * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)\n * 返回取消注册的函数\n */\nexport function registerInvalidator(fn: RevalidateInvalidator): () => void {\n const registry = getRegistry();\n registry.add(fn);\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\ntype RevalidateTarget = { kind: 'path'; value: string } | { kind: 'tag'; value: string };\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 registry = getRegistry();\n const targetLabel = `${target.kind}:${target.value}`;\n if (registry.size === 0) {\n logger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);\n return;\n }\n\n recordRevalidationMetric('run', target.kind, target.value);\n\n // 包一层 async 函数:把同步抛错也转成 Promise rejection,让 allSettled 能统一处理\n // (直接 `fn(target)` 在 fn 同步抛错时会在 `.map` 里 escape,allSettled 收不到)\n const invalidators = Array.from(registry);\n const results = await Promise.allSettled(invalidators.map(async fn => fn(target)));\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 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}) —— 已分发到 ${registry.size} 个 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 * 缓存 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 { Logger } from '../logger/Logger';\n\nconst logger = Logger.getInstance();\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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"}