vinext 1.3.1 → 1.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.
Files changed (234) hide show
  1. package/README.md +5 -2
  2. package/THIRD_PARTY_LICENSES.md +47 -0
  3. package/dist/_virtual/_rolldown/runtime.js +3 -2
  4. package/dist/build/prerender.js +1 -1
  5. package/dist/build/report.d.ts +0 -14
  6. package/dist/build/report.js +1 -51
  7. package/dist/check.js +1 -1
  8. package/dist/cli.js +3 -0
  9. package/dist/client/dev-error-overlay.js +1 -1
  10. package/dist/client/navigation-runtime.d.ts +13 -1
  11. package/dist/client/navigation-runtime.js +1 -1
  12. package/dist/config/next-config.d.ts +19 -0
  13. package/dist/config/next-config.js +64 -1
  14. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/dbcs-codec.js +327 -0
  15. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/dbcs-data.js +123 -0
  16. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/index.js +29 -0
  17. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/internal.js +134 -0
  18. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/sbcs-codec.js +50 -0
  19. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/sbcs-data-generated.js +455 -0
  20. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/sbcs-data.js +147 -0
  21. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/big5-added.json.js +169 -0
  22. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/cp936.json.js +2584 -0
  23. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/cp949.json.js +2220 -0
  24. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/cp950.json.js +227 -0
  25. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/eucjp.json.js +425 -0
  26. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/gb18030-ranges.json.js +427 -0
  27. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/gbk-added.json.js +229 -0
  28. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/tables/shiftjis.json.js +292 -0
  29. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/utf16.js +106 -0
  30. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/encodings/utf7.js +182 -0
  31. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/lib/bom-handling.js +42 -0
  32. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/lib/extend-node.js +147 -0
  33. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/lib/index.js +94 -0
  34. package/dist/deps/.pnpm/iconv-lite@0.4.24/deps/iconv-lite/lib/streams.js +95 -0
  35. package/dist/deps/.pnpm/safer-buffer@2.1.2/deps/safer-buffer/safer.js +45 -0
  36. package/dist/entries/app-rsc-entry.js +17 -48
  37. package/dist/entries/app-rsc-manifest.js +3 -4
  38. package/dist/entries/app-ssr-entry.js +1 -0
  39. package/dist/entries/pages-server-entry.js +33 -8
  40. package/dist/index.js +83 -70
  41. package/dist/init-cloudflare.d.ts +1 -3
  42. package/dist/init-cloudflare.js +10 -48
  43. package/dist/init-platform.d.ts +2 -0
  44. package/dist/init-platform.js +4 -0
  45. package/dist/plugins/extensionless-dynamic-import.js +6 -2
  46. package/dist/plugins/next-intl-catalog.d.ts +12 -0
  47. package/dist/plugins/next-intl-catalog.js +85 -0
  48. package/dist/plugins/pages-node-externals.d.ts +1 -0
  49. package/dist/plugins/pages-node-externals.js +1 -1
  50. package/dist/plugins/use-cache-callable.d.ts +1 -1
  51. package/dist/plugins/use-cache-callable.js +136 -94
  52. package/dist/routing/app-route-graph.d.ts +6 -0
  53. package/dist/routing/app-route-graph.js +9 -1
  54. package/dist/server/api-handler.js +19 -4
  55. package/dist/server/app-bfcache-identity.js +1 -1
  56. package/dist/server/app-browser-entry.js +79 -63
  57. package/dist/server/app-browser-history-controller.d.ts +5 -4
  58. package/dist/server/app-browser-history-controller.js +93 -15
  59. package/dist/server/app-browser-navigation-controller.d.ts +2 -2
  60. package/dist/server/app-browser-navigation-controller.js +1 -2
  61. package/dist/server/app-browser-rsc-redirect.js +4 -4
  62. package/dist/server/app-browser-server-action-client.d.ts +2 -0
  63. package/dist/server/app-browser-server-action-client.js +4 -3
  64. package/dist/server/app-browser-state.d.ts +2 -4
  65. package/dist/server/app-browser-state.js +9 -4
  66. package/dist/server/app-browser-supplemental-refresh.js +16 -1
  67. package/dist/server/app-browser-visible-commit.d.ts +1 -1
  68. package/dist/server/app-browser-visible-commit.js +2 -12
  69. package/dist/server/app-elements-wire.d.ts +6 -38
  70. package/dist/server/app-elements-wire.js +4 -41
  71. package/dist/server/app-elements.d.ts +2 -2
  72. package/dist/server/app-elements.js +2 -2
  73. package/dist/server/app-history-state.d.ts +2 -2
  74. package/dist/server/app-history-state.js +5 -2
  75. package/dist/server/app-mounted-layouts.d.ts +21 -0
  76. package/dist/server/app-mounted-layouts.js +67 -0
  77. package/dist/server/app-optimistic-routing.d.ts +19 -1
  78. package/dist/server/app-optimistic-routing.js +42 -2
  79. package/dist/server/app-page-boundary-render.js +7 -6
  80. package/dist/server/app-page-boundary.js +2 -2
  81. package/dist/server/app-page-cache-finalizer.d.ts +12 -1
  82. package/dist/server/app-page-cache-finalizer.js +70 -29
  83. package/dist/server/app-page-cache.d.ts +13 -1
  84. package/dist/server/app-page-cache.js +31 -9
  85. package/dist/server/app-page-dispatch.d.ts +5 -10
  86. package/dist/server/app-page-dispatch.js +84 -154
  87. package/dist/server/app-page-element-builder.d.ts +2 -2
  88. package/dist/server/app-page-element-builder.js +10 -9
  89. package/dist/server/app-page-execution.d.ts +17 -52
  90. package/dist/server/app-page-execution.js +99 -95
  91. package/dist/server/app-page-head.d.ts +13 -0
  92. package/dist/server/app-page-head.js +44 -16
  93. package/dist/server/app-page-http-access-fallback-metadata.d.ts +1 -0
  94. package/dist/server/app-page-http-access-fallback-metadata.js +2 -2
  95. package/dist/server/app-page-layout-gate.d.ts +35 -0
  96. package/dist/server/app-page-layout-gate.js +50 -0
  97. package/dist/server/app-page-params.d.ts +0 -1
  98. package/dist/server/app-page-params.js +1 -14
  99. package/dist/server/app-page-probe.d.ts +3 -21
  100. package/dist/server/app-page-probe.js +4 -37
  101. package/dist/server/app-page-render.d.ts +2 -12
  102. package/dist/server/app-page-render.js +89 -220
  103. package/dist/server/app-page-request.d.ts +1 -3
  104. package/dist/server/app-page-request.js +1 -1
  105. package/dist/server/app-page-response.js +3 -3
  106. package/dist/server/app-page-route-wiring.d.ts +13 -6
  107. package/dist/server/app-page-route-wiring.js +67 -61
  108. package/dist/server/app-page-rsc-render-status.d.ts +27 -1
  109. package/dist/server/app-page-rsc-render-status.js +121 -13
  110. package/dist/server/app-page-stream.d.ts +2 -0
  111. package/dist/server/app-page-stream.js +2 -2
  112. package/dist/server/app-pages-bridge.d.ts +4 -0
  113. package/dist/server/app-pages-bridge.js +7 -3
  114. package/dist/server/app-render-dependency.d.ts +11 -4
  115. package/dist/server/app-render-dependency.js +86 -38
  116. package/dist/server/app-request-stage-dispatch.js +1 -1
  117. package/dist/server/app-route-handler-cache.js +2 -2
  118. package/dist/server/app-route-handler-dispatch.js +14 -9
  119. package/dist/server/app-route-handler-execution.js +8 -3
  120. package/dist/server/app-route-handler-policy.d.ts +1 -1
  121. package/dist/server/app-route-handler-policy.js +3 -3
  122. package/dist/server/app-route-handler-response.js +1 -1
  123. package/dist/server/app-route-handler-runtime.js +17 -4
  124. package/dist/server/app-rsc-cache-busting.d.ts +2 -2
  125. package/dist/server/app-rsc-cache-busting.js +4 -4
  126. package/dist/server/app-rsc-error-handler.d.ts +2 -1
  127. package/dist/server/app-rsc-error-handler.js +9 -1
  128. package/dist/server/app-rsc-errors.d.ts +8 -0
  129. package/dist/server/app-rsc-errors.js +8 -1
  130. package/dist/server/app-rsc-handler.d.ts +5 -5
  131. package/dist/server/app-rsc-handler.js +30 -24
  132. package/dist/server/app-rsc-request-normalization.d.ts +0 -4
  133. package/dist/server/app-rsc-request-normalization.js +1 -4
  134. package/dist/server/app-rsc-response-finalizer.js +2 -2
  135. package/dist/server/app-rsc-response-stage.js +5 -3
  136. package/dist/server/app-server-action-execution.d.ts +3 -1
  137. package/dist/server/app-server-action-execution.js +7 -4
  138. package/dist/server/app-ssr-entry.d.ts +2 -0
  139. package/dist/server/app-ssr-entry.js +9 -8
  140. package/dist/server/app-ssr-stream.js +1 -1
  141. package/dist/server/app-visited-response-cache.d.ts +36 -1
  142. package/dist/server/app-visited-response-cache.js +46 -5
  143. package/dist/server/app-worker-stages.d.ts +25 -3
  144. package/dist/server/app-worker-stages.js +45 -6
  145. package/dist/server/artifact-compatibility.d.ts +0 -1
  146. package/dist/server/artifact-compatibility.js +1 -10
  147. package/dist/server/cache-proof.d.ts +1 -115
  148. package/dist/server/cache-proof.js +1 -544
  149. package/dist/server/cacheability-request.js +13 -8
  150. package/dist/server/dev-server.js +4 -3
  151. package/dist/server/headers.d.ts +6 -3
  152. package/dist/server/headers.js +9 -5
  153. package/dist/server/isr-cache.d.ts +8 -2
  154. package/dist/server/isr-cache.js +26 -1
  155. package/dist/server/metadata-route-response.js +32 -15
  156. package/dist/server/multi-stage.d.ts +52 -11
  157. package/dist/server/multi-stage.js +13 -1
  158. package/dist/server/navigation-planner.js +1 -1
  159. package/dist/server/pages-api-route.js +28 -19
  160. package/dist/server/pages-media-type.d.ts +21 -1
  161. package/dist/server/pages-media-type.js +69 -5
  162. package/dist/server/pages-node-compat.js +52 -27
  163. package/dist/server/pages-page-handler.js +11 -20
  164. package/dist/server/pages-request-pipeline.d.ts +8 -0
  165. package/dist/server/pages-request-pipeline.js +2 -2
  166. package/dist/server/pages-request-stage-entry.js +14 -12
  167. package/dist/server/pages-response-stage-entry.js +9 -3
  168. package/dist/server/prod-server.js +5 -1
  169. package/dist/server/request-pipeline.d.ts +6 -0
  170. package/dist/server/request-pipeline.js +21 -1
  171. package/dist/server/shared-cache-identity.d.ts +23 -0
  172. package/dist/server/shared-cache-identity.js +36 -0
  173. package/dist/server/worker-stages.d.ts +16 -3
  174. package/dist/server/worker-stages.js +23 -4
  175. package/dist/shims/cache-handler.js +2 -2
  176. package/dist/shims/cache-request-state.d.ts +17 -20
  177. package/dist/shims/cache-request-state.js +16 -21
  178. package/dist/shims/cache-runtime.js +27 -11
  179. package/dist/shims/cache.d.ts +8 -7
  180. package/dist/shims/cache.js +17 -19
  181. package/dist/shims/cacheability-classification.d.ts +2 -0
  182. package/dist/shims/cdn-cache.d.ts +22 -5
  183. package/dist/shims/client-page-root.js +2 -2
  184. package/dist/shims/dynamic.js +9 -6
  185. package/dist/shims/error-boundary.js +2 -2
  186. package/dist/shims/fetch-cache-state.d.ts +5 -1
  187. package/dist/shims/fetch-cache-state.js +1 -3
  188. package/dist/shims/fetch-cache.d.ts +2 -1
  189. package/dist/shims/fetch-cache.js +34 -24
  190. package/dist/shims/form.js +2 -2
  191. package/dist/shims/headers.d.ts +8 -23
  192. package/dist/shims/headers.js +17 -67
  193. package/dist/shims/internal/navigation-untracked.js +1 -1
  194. package/dist/shims/link.js +3 -1
  195. package/dist/shims/metadata.d.ts +23 -21
  196. package/dist/shims/metadata.js +62 -24
  197. package/dist/shims/navigation-server.js +1 -1
  198. package/dist/shims/navigation.d.ts +74 -7
  199. package/dist/shims/navigation.js +183 -29
  200. package/dist/shims/navigation.react-server.js +2 -2
  201. package/dist/shims/request-state-types.d.ts +2 -2
  202. package/dist/shims/slot.d.ts +12 -0
  203. package/dist/shims/slot.js +37 -9
  204. package/dist/shims/unified-request-context.d.ts +1 -1
  205. package/dist/shims/unified-request-context.js +2 -3
  206. package/dist/utils/cache-control-metadata.d.ts +5 -0
  207. package/dist/utils/cache-control-metadata.js +9 -1
  208. package/dist/utils/project.d.ts +2 -2
  209. package/dist/utils/project.js +3 -16
  210. package/dist/utils/regex.d.ts +5 -0
  211. package/dist/utils/regex.js +11 -1
  212. package/dist/utils/text-stream.d.ts +10 -5
  213. package/dist/utils/text-stream.js +6 -6
  214. package/package.json +2 -1
  215. package/dist/build/layout-classification-types.d.ts +0 -60
  216. package/dist/build/layout-classification-types.js +0 -1
  217. package/dist/build/layout-classification.d.ts +0 -62
  218. package/dist/build/layout-classification.js +0 -98
  219. package/dist/build/route-classification-injector.d.ts +0 -33
  220. package/dist/build/route-classification-injector.js +0 -59
  221. package/dist/build/route-classification-manifest.d.ts +0 -54
  222. package/dist/build/route-classification-manifest.js +0 -143
  223. package/dist/server/app-browser-client-reuse-manifest.d.ts +0 -11
  224. package/dist/server/app-browser-client-reuse-manifest.js +0 -101
  225. package/dist/server/app-layout-param-observation.d.ts +0 -42
  226. package/dist/server/app-layout-param-observation.js +0 -168
  227. package/dist/server/client-reuse-manifest.d.ts +0 -103
  228. package/dist/server/client-reuse-manifest.js +0 -209
  229. package/dist/server/skip-cache-proof.d.ts +0 -60
  230. package/dist/server/skip-cache-proof.js +0 -168
  231. package/dist/server/static-layout-client-reuse-proof.d.ts +0 -14
  232. package/dist/server/static-layout-client-reuse-proof.js +0 -33
  233. package/dist/utils/sorted-array.d.ts +0 -8
  234. package/dist/utils/sorted-array.js +0 -20
@@ -1,101 +0,0 @@
1
- import { AppElementsWire } from "./app-elements-wire.js";
2
- import "./app-elements.js";
3
- import { DEFAULT_CACHE_VARIANT_BUDGET, buildCacheVariantWithRouteBudget } from "./cache-proof.js";
4
- import { DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS, countUtf8Bytes, serializeClientReuseManifest } from "./client-reuse-manifest.js";
5
- import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
6
- //#region src/server/app-browser-client-reuse-manifest.ts
7
- function capClientReuseManifestProducerLimits(limits) {
8
- return {
9
- ...limits,
10
- maxEntryCount: Math.min(limits.maxEntryCount, 8)
11
- };
12
- }
13
- function serializeBoundedClientReuseManifest(input) {
14
- const entries = input.entries.slice(0, input.limits.maxEntryCount);
15
- let low = 1;
16
- let high = entries.length;
17
- let best = null;
18
- while (low <= high) {
19
- const size = Math.floor((low + high) / 2);
20
- const serialized = serializeClientReuseManifest({
21
- entries: entries.slice(0, size),
22
- replayWindow: {
23
- validFromVisibleCommitVersion: input.visibleCommitVersion,
24
- validUntilVisibleCommitVersion: input.visibleCommitVersion
25
- },
26
- visibleCommitVersion: input.visibleCommitVersion
27
- });
28
- if (countUtf8Bytes(serialized) <= input.limits.maxManifestBytes) {
29
- best = serialized;
30
- low = size + 1;
31
- } else high = size - 1;
32
- }
33
- return best;
34
- }
35
- function hasRetainedElement(elements, elementId) {
36
- return Object.hasOwn(elements, elementId);
37
- }
38
- function createStaticLayoutEntry(input) {
39
- const routeId = createStaticLayoutClientReuseRouteId(input.layoutId);
40
- const output = {
41
- kind: "layout",
42
- layoutId: input.layoutId,
43
- rootBoundaryId: input.artifactCompatibility.rootBoundaryId,
44
- routeId
45
- };
46
- const candidateVariant = buildCacheVariantWithRouteBudget({
47
- budget: DEFAULT_CACHE_VARIANT_BUDGET,
48
- dimensions: [],
49
- output,
50
- routeBudget: {
51
- routeId: output.routeId,
52
- variantCacheKeys: []
53
- }
54
- });
55
- if (candidateVariant.kind !== "variant") return null;
56
- const artifactCompatibility = createStaticLayoutClientReuseArtifactCompatibility({
57
- artifactCompatibility: input.artifactCompatibility,
58
- layoutId: input.layoutId,
59
- rootBoundaryId: output.rootBoundaryId,
60
- routeId: output.routeId,
61
- variantCacheKey: candidateVariant.variant.cacheKey
62
- });
63
- return {
64
- artifactCompatibility,
65
- id: input.layoutId,
66
- payloadHash: createStaticLayoutClientReusePayloadHash({
67
- artifactCompatibility,
68
- layoutId: input.layoutId,
69
- rootBoundaryId: output.rootBoundaryId,
70
- routeId: output.routeId,
71
- variantCacheKey: candidateVariant.variant.cacheKey
72
- }),
73
- privacy: "public",
74
- variantCacheKey: candidateVariant.variant.cacheKey
75
- };
76
- }
77
- function createClientReuseManifestHeaderFromVisibleAppState(state, options = {}) {
78
- const limits = capClientReuseManifestProducerLimits(options.limits ?? DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS);
79
- const metadata = AppElementsWire.readMetadata(state.elements);
80
- const entries = [];
81
- for (const layoutId of metadata.layoutIds) {
82
- if (entries.length >= limits.maxEntryCount) break;
83
- if (layoutId.length > limits.maxEntryIdLength) continue;
84
- if (metadata.layoutFlags[layoutId] !== "s") continue;
85
- if (!hasRetainedElement(state.elements, layoutId)) continue;
86
- if (AppElementsWire.parseElementKey(layoutId)?.kind !== "layout") continue;
87
- const entry = createStaticLayoutEntry({
88
- artifactCompatibility: metadata.artifactCompatibility,
89
- layoutId
90
- });
91
- if (entry) entries.push(entry);
92
- }
93
- if (entries.length === 0) return null;
94
- return serializeBoundedClientReuseManifest({
95
- entries,
96
- limits,
97
- visibleCommitVersion: state.visibleCommitVersion
98
- });
99
- }
100
- //#endregion
101
- export { createClientReuseManifestHeaderFromVisibleAppState };
@@ -1,42 +0,0 @@
1
- import { RenderRequestApiKind } from "./cache-proof.js";
2
- import { ClientReuseManifestRejectionCode, ClientReuseManifestTraceFields } from "./client-reuse-manifest.js";
3
- import { ThenableParamsObserver } from "../shims/thenable-params.js";
4
- import { UnstableCacheObservation } from "../shims/cache-request-state.js";
5
- //#region src/server/app-layout-param-observation.d.ts
6
- export type AppLayoutParamAccessObservation = Readonly<{
7
- cacheLifeObserved: boolean;
8
- cacheTags: readonly string[];
9
- cacheableFetchCount: number;
10
- completeness: "complete" | "unknown";
11
- dynamicFetchCount: number;
12
- /**
13
- * `markDynamicUsage()` fired during the probe (e.g. `"use cache: private"`,
14
- * `connection()`) with no other observable trace. Folded in from the
15
- * isolated probe scope so this signal can't diverge from the Layer-3
16
- * `dynamicDetected` path it replaced.
17
- */
18
- dynamicUsageObserved: boolean;
19
- finiteRevalidateSeconds: number | null;
20
- keys: readonly string[];
21
- observed: boolean;
22
- paramScopeKeys: readonly string[];
23
- requestApis: readonly RenderRequestApiKind[];
24
- unstableCaches: readonly UnstableCacheObservation[];
25
- }>;
26
- export type AppLayoutParamAccessTracker = Readonly<{
27
- createThenableParamsObserver: (layoutId: string) => ThenableParamsObserver;
28
- getLayoutObservation: (layoutId: string) => AppLayoutParamAccessObservation;
29
- recordLayoutFiniteRevalidate: (layoutId: string, revalidateSeconds: number) => void;
30
- recordLayoutParamScope: (layoutId: string, paramScopeKeys: readonly string[]) => void;
31
- runLayoutProbe: (layoutId: string, probe: () => unknown) => unknown;
32
- }>;
33
- type StaticLayoutObservationSkipCode = Extract<ClientReuseManifestRejectionCode, `SKIP_LAYOUT_${string}`>;
34
- export type StaticLayoutObservationSkipRejection = Readonly<{
35
- code: StaticLayoutObservationSkipCode;
36
- fields: ClientReuseManifestTraceFields;
37
- }>;
38
- export declare function getStaticLayoutObservationSkipRejection(observation: AppLayoutParamAccessObservation): StaticLayoutObservationSkipRejection | null;
39
- export declare function isAppLayoutObservationUnsafeForStaticReuse(observation: AppLayoutParamAccessObservation): boolean;
40
- export declare function createAppLayoutParamAccessTracker(): AppLayoutParamAccessTracker;
41
- //#endregion
42
- export {};
@@ -1,168 +0,0 @@
1
- import { isInsideUnifiedScope, runWithUnifiedStateMutation } from "../shims/unified-request-context.js";
2
- import { isPromiseLike } from "../utils/promise.js";
3
- import { peekDynamicUsage, peekRenderRequestApiUsage } from "../shims/headers.js";
4
- import { _peekRequestScopedCacheLife, _peekUnstableCacheObservations } from "../shims/cache-request-state.js";
5
- import { getCollectedFetchTags, peekCacheableFetchObservations, peekDynamicFetchObservations } from "../shims/fetch-cache.js";
6
- //#region src/server/app-layout-param-observation.ts
7
- const STATIC_LAYOUT_OBSERVATION_SKIP_RULES = [
8
- ["SKIP_LAYOUT_PARAMS_OBSERVATION_INCOMPLETE", (observation) => observation.completeness !== "complete"],
9
- ["SKIP_LAYOUT_PARAMS_PRESENT", (observation) => observation.paramScopeKeys.length > 0],
10
- ["SKIP_LAYOUT_PARAMS_OBSERVED", (observation) => observation.observed],
11
- ["SKIP_LAYOUT_DYNAMIC_USAGE_OBSERVED", (observation) => observation.dynamicUsageObserved],
12
- ["SKIP_LAYOUT_REQUEST_API_OBSERVED", (observation) => observation.requestApis.length > 0],
13
- ["SKIP_LAYOUT_REVALIDATE_PRESENT", (observation) => observation.finiteRevalidateSeconds !== null],
14
- ["SKIP_LAYOUT_CACHE_LIFE_OBSERVED", (observation) => observation.cacheLifeObserved],
15
- ["SKIP_LAYOUT_UNSTABLE_CACHE_OBSERVED", (observation) => observation.unstableCaches.length > 0],
16
- ["SKIP_LAYOUT_CACHE_TAGS_OBSERVED", (observation) => observation.cacheTags.length > 0],
17
- ["SKIP_LAYOUT_CACHEABLE_FETCHES_OBSERVED", (observation) => observation.cacheableFetchCount > 0],
18
- ["SKIP_LAYOUT_DYNAMIC_FETCHES_OBSERVED", (observation) => observation.dynamicFetchCount > 0]
19
- ];
20
- function createStaticLayoutObservationTraceFields(observation) {
21
- return {
22
- cacheLifeObserved: observation.cacheLifeObserved,
23
- cacheTags: observation.cacheTags,
24
- cacheableFetchCount: observation.cacheableFetchCount,
25
- dynamicFetchCount: observation.dynamicFetchCount,
26
- dynamicUsageObserved: observation.dynamicUsageObserved,
27
- finiteRevalidateSeconds: observation.finiteRevalidateSeconds,
28
- observedParamKeys: observation.keys,
29
- paramScopeKeys: observation.paramScopeKeys,
30
- requestApis: observation.requestApis,
31
- unstableCacheCount: observation.unstableCaches.length,
32
- unstableCacheKeyHashes: observation.unstableCaches.map((cache) => cache.keyHash),
33
- unstableCacheRevalidates: observation.unstableCaches.map((cache) => String(cache.revalidate)),
34
- unstableCacheTagCounts: observation.unstableCaches.map((cache) => String(cache.tagCount)),
35
- unstableCacheTagHashes: observation.unstableCaches.map((cache) => cache.tagHash ?? "none")
36
- };
37
- }
38
- function getStaticLayoutObservationSkipRejection(observation) {
39
- for (const [code, matches] of STATIC_LAYOUT_OBSERVATION_SKIP_RULES) if (matches(observation)) return {
40
- code,
41
- fields: createStaticLayoutObservationTraceFields(observation)
42
- };
43
- return null;
44
- }
45
- function isAppLayoutObservationUnsafeForStaticReuse(observation) {
46
- return getStaticLayoutObservationSkipRejection(observation) !== null;
47
- }
48
- function createAppLayoutParamAccessTracker() {
49
- const observations = /* @__PURE__ */ new Map();
50
- const ensureObservation = (layoutId) => {
51
- const existing = observations.get(layoutId);
52
- if (existing) return existing;
53
- const created = {
54
- cacheLifeObserved: false,
55
- cacheTags: /* @__PURE__ */ new Set(),
56
- cacheableFetches: /* @__PURE__ */ new Set(),
57
- dynamicFetches: /* @__PURE__ */ new Set(),
58
- dynamicUsageObserved: false,
59
- finiteRevalidateSeconds: null,
60
- keys: /* @__PURE__ */ new Set(),
61
- observed: false,
62
- paramScopeKeys: /* @__PURE__ */ new Set(),
63
- probeComplete: false,
64
- requestApis: /* @__PURE__ */ new Set(),
65
- unstableCaches: /* @__PURE__ */ new Map()
66
- };
67
- observations.set(layoutId, created);
68
- return created;
69
- };
70
- const markObserved = (layoutId, keys) => {
71
- const observation = ensureObservation(layoutId);
72
- observation.observed = true;
73
- for (const key of keys) observation.keys.add(key);
74
- };
75
- const markProbeComplete = (layoutId) => {
76
- ensureObservation(layoutId).probeComplete = true;
77
- };
78
- const runWithIsolatedProbeDependencies = (probe) => {
79
- if (!isInsideUnifiedScope()) return probe();
80
- return runWithUnifiedStateMutation((ctx) => {
81
- ctx.cacheableFetchUrls = /* @__PURE__ */ new Set();
82
- ctx.currentRequestTags = [];
83
- ctx.currentFetchSoftTags = [];
84
- ctx.dynamicFetchUrls = /* @__PURE__ */ new Set();
85
- ctx.dynamicUsageDetected = false;
86
- ctx.renderRequestApiUsage = /* @__PURE__ */ new Set();
87
- ctx.requestScopedCacheLife = null;
88
- ctx.unstableCacheObservations = /* @__PURE__ */ new Map();
89
- }, probe);
90
- };
91
- const recordProbeDependencies = (layoutId) => {
92
- const observation = ensureObservation(layoutId);
93
- if (peekDynamicUsage()) observation.dynamicUsageObserved = true;
94
- if (_peekRequestScopedCacheLife() !== null) observation.cacheLifeObserved = true;
95
- for (const tag of getCollectedFetchTags()) observation.cacheTags.add(tag);
96
- for (const url of peekCacheableFetchObservations()) observation.cacheableFetches.add(url);
97
- for (const url of peekDynamicFetchObservations()) observation.dynamicFetches.add(url);
98
- for (const requestApi of peekRenderRequestApiUsage()) observation.requestApis.add(requestApi);
99
- for (const unstableCache of _peekUnstableCacheObservations()) observation.unstableCaches.set(unstableCache.keyHash, unstableCache);
100
- };
101
- return {
102
- createThenableParamsObserver(layoutId) {
103
- return { observeParamAccess(keys) {
104
- markObserved(layoutId, keys);
105
- } };
106
- },
107
- getLayoutObservation(layoutId) {
108
- const observation = observations.get(layoutId);
109
- if (!observation) return {
110
- cacheLifeObserved: false,
111
- cacheTags: [],
112
- cacheableFetchCount: 0,
113
- completeness: "unknown",
114
- dynamicFetchCount: 0,
115
- dynamicUsageObserved: false,
116
- finiteRevalidateSeconds: null,
117
- keys: [],
118
- observed: false,
119
- paramScopeKeys: [],
120
- requestApis: [],
121
- unstableCaches: []
122
- };
123
- return {
124
- cacheLifeObserved: observation.cacheLifeObserved,
125
- cacheTags: [...observation.cacheTags].sort(),
126
- cacheableFetchCount: observation.cacheableFetches.size,
127
- completeness: observation.probeComplete ? "complete" : "unknown",
128
- dynamicFetchCount: observation.dynamicFetches.size,
129
- dynamicUsageObserved: observation.dynamicUsageObserved,
130
- finiteRevalidateSeconds: observation.finiteRevalidateSeconds,
131
- keys: [...observation.keys].sort(),
132
- observed: observation.observed,
133
- paramScopeKeys: [...observation.paramScopeKeys].sort(),
134
- requestApis: [...observation.requestApis].sort(),
135
- unstableCaches: [...observation.unstableCaches.values()].sort((a, b) => a.keyHash.localeCompare(b.keyHash))
136
- };
137
- },
138
- recordLayoutFiniteRevalidate(layoutId, revalidateSeconds) {
139
- if (!Number.isFinite(revalidateSeconds) || revalidateSeconds <= 0) return;
140
- const observation = ensureObservation(layoutId);
141
- observation.finiteRevalidateSeconds = observation.finiteRevalidateSeconds === null ? revalidateSeconds : Math.min(observation.finiteRevalidateSeconds, revalidateSeconds);
142
- },
143
- recordLayoutParamScope(layoutId, paramScopeKeys) {
144
- const observation = ensureObservation(layoutId);
145
- for (const key of paramScopeKeys) observation.paramScopeKeys.add(key);
146
- },
147
- runLayoutProbe(layoutId, probe) {
148
- return runWithIsolatedProbeDependencies(() => {
149
- const result = probe();
150
- if (!isPromiseLike(result)) {
151
- recordProbeDependencies(layoutId);
152
- markProbeComplete(layoutId);
153
- return result;
154
- }
155
- return Promise.resolve(result).then((resolved) => {
156
- recordProbeDependencies(layoutId);
157
- markProbeComplete(layoutId);
158
- return resolved;
159
- }, (error) => {
160
- recordProbeDependencies(layoutId);
161
- throw error;
162
- });
163
- });
164
- }
165
- };
166
- }
167
- //#endregion
168
- export { createAppLayoutParamAccessTracker, getStaticLayoutObservationSkipRejection, isAppLayoutObservationUnsafeForStaticReuse };
@@ -1,103 +0,0 @@
1
- import { ArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
2
- //#region src/server/client-reuse-manifest.d.ts
3
- export declare const CLIENT_REUSE_MANIFEST_SCHEMA_VERSION = 1;
4
- type ClientReuseManifestSchemaVersion = 1;
5
- export declare const CLIENT_REUSE_MANIFEST_HASH_ALGORITHM = "fnv1a64";
6
- type ClientReuseManifestHashAlgorithm = typeof CLIENT_REUSE_MANIFEST_HASH_ALGORITHM;
7
- type ClientReuseManifestLimits = Readonly<{
8
- maxEntryCount: number;
9
- maxEntryIdLength: number;
10
- maxManifestBytes: number;
11
- maxPayloadHashLength: number;
12
- maxVariantCacheKeyLength: number;
13
- }>;
14
- export declare const DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS: {
15
- maxEntryCount: number;
16
- maxEntryIdLength: number;
17
- maxManifestBytes: number;
18
- maxPayloadHashLength: number;
19
- maxVariantCacheKeyLength: number;
20
- };
21
- export declare const CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET = 8;
22
- type ClientReuseManifestEntryKind = "layout" | "page" | "route" | "slot" | "template";
23
- type ClientReuseManifestEntryPrivacy = "private" | "public";
24
- type ClientReuseManifestReplayWindow = Readonly<{
25
- validFromVisibleCommitVersion: number;
26
- validUntilVisibleCommitVersion: number;
27
- }>;
28
- export type ClientReuseManifestEntry = Readonly<{
29
- artifactCompatibility: ArtifactCompatibilityEnvelope;
30
- id: string;
31
- kind: ClientReuseManifestEntryKind;
32
- payloadHash: string;
33
- privacy: "public";
34
- variantCacheKey: string;
35
- }>;
36
- type ClientReuseManifestWireEntry = Readonly<{
37
- artifactCompatibility: ArtifactCompatibilityEnvelope;
38
- id: string;
39
- payloadHash: string;
40
- privacy: ClientReuseManifestEntryPrivacy;
41
- variantCacheKey: string;
42
- }>;
43
- type ClientReuseManifest = Readonly<{
44
- entries: readonly ClientReuseManifestEntry[];
45
- hashAlgorithm: ClientReuseManifestHashAlgorithm;
46
- replayWindow: ClientReuseManifestReplayWindow;
47
- schemaVersion: ClientReuseManifestSchemaVersion;
48
- visibleCommitVersion: number;
49
- }>;
50
- type ClientReuseManifestWire = Readonly<{
51
- entries: readonly ClientReuseManifestWireEntry[];
52
- hashAlgorithm: ClientReuseManifestHashAlgorithm;
53
- replayWindow: ClientReuseManifestReplayWindow;
54
- schemaVersion: ClientReuseManifestSchemaVersion;
55
- visibleCommitVersion: number;
56
- }>;
57
- type CreateClientReuseManifestInput = Readonly<{
58
- entries: readonly ClientReuseManifestWireEntry[];
59
- replayWindow?: ClientReuseManifestReplayWindow;
60
- visibleCommitVersion: number;
61
- }>;
62
- export type ClientReuseManifestRejectionCode = "SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE" | "SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN" | "SKIP_CACHE_ARTIFACT_PROOF_MISMATCH" | "SKIP_CACHE_ENTRY_ID_MISMATCH" | "SKIP_CACHE_INVALIDATED" | "SKIP_CACHE_INVALIDATION_UNKNOWN" | "SKIP_CACHE_PAYLOAD_HASH_MISMATCH" | "SKIP_CACHE_PAYLOAD_HASH_MISSING" | "SKIP_CACHE_PROOF_MISSING" | "SKIP_CACHE_PROOF_REJECTED" | "SKIP_CACHE_REUSE_CLASS_UNSUPPORTED" | "SKIP_CACHE_VARIANT_MISMATCH" | "SKIP_LAYOUT_CACHE_LIFE_OBSERVED" | "SKIP_LAYOUT_CACHE_TAGS_OBSERVED" | "SKIP_LAYOUT_CACHEABLE_FETCHES_OBSERVED" | "SKIP_LAYOUT_DYNAMIC_FETCHES_OBSERVED" | "SKIP_LAYOUT_DYNAMIC_USAGE_OBSERVED" | "SKIP_LAYOUT_PARAMS_OBSERVED" | "SKIP_LAYOUT_PARAMS_OBSERVATION_INCOMPLETE" | "SKIP_LAYOUT_PARAMS_PRESENT" | "SKIP_LAYOUT_REVALIDATE_PRESENT" | "SKIP_LAYOUT_REQUEST_API_OBSERVED" | "SKIP_LAYOUT_UNSTABLE_CACHE_OBSERVED" | "SKIP_ARTIFACT_COMPATIBILITY_INVALID" | "SKIP_ENTRY_COUNT_EXCEEDED" | "SKIP_VERIFICATION_BUDGET_EXCEEDED" | "SKIP_ENTRY_HASH_INVALID" | "SKIP_ENTRY_ID_INVALID" | "SKIP_ENTRY_ID_TOO_LONG" | "SKIP_ENTRY_MALFORMED" | "SKIP_ENTRY_ORDER_NON_CANONICAL" | "SKIP_HASH_ALGORITHM_UNSUPPORTED" | "SKIP_MANIFEST_MALFORMED" | "SKIP_MANIFEST_SCHEMA_UNSUPPORTED" | "SKIP_MANIFEST_TOO_LARGE" | "SKIP_PRIVATE_ENTRY" | "SKIP_REPLAY_WINDOW_INVALID" | "SKIP_UNKNOWN_ENTRY" | "SKIP_VARIANT_CACHE_KEY_INVALID" | "SKIP_VARIANT_CACHE_KEY_TOO_LONG" | "SKIP_VISIBLE_COMMIT_VERSION_INVALID" | "SKIP_VISIBLE_COMMIT_VERSION_MISMATCH";
63
- type ClientReuseManifestTraceFieldValue = string | number | boolean | null | readonly string[];
64
- export type ClientReuseManifestTraceFields = Readonly<Record<string, ClientReuseManifestTraceFieldValue>>;
65
- export type ClientReuseManifestRejection = Readonly<{
66
- code: ClientReuseManifestRejectionCode;
67
- fields: ClientReuseManifestTraceFields;
68
- }>;
69
- export type ClientReuseManifestEntryRejection = ClientReuseManifestRejection & Readonly<{
70
- entryId: string | null;
71
- }>;
72
- export type ClientReuseManifestSkipDisposition = Readonly<{
73
- code: "SKIP_MODEL_DISABLED";
74
- enabled: false;
75
- mode: "renderAndSend";
76
- }> | Readonly<{
77
- code: "SKIP_STATIC_LAYOUT_VERIFIED";
78
- enabled: true;
79
- mode: "skipStaticLayout";
80
- skippedEntryIds: readonly string[];
81
- }>;
82
- export type ClientReuseManifestParseResult = Readonly<{
83
- kind: "absent";
84
- }> | Readonly<{
85
- kind: "rejected";
86
- rejection: ClientReuseManifestRejection;
87
- }> | Readonly<{
88
- entryRejections: readonly ClientReuseManifestEntryRejection[];
89
- kind: "parsed";
90
- manifest: ClientReuseManifest;
91
- skipDisposition: ClientReuseManifestSkipDisposition;
92
- }>;
93
- type ParseClientReuseManifestOptions = Readonly<{
94
- currentVisibleCommitVersion?: number;
95
- limits?: ClientReuseManifestLimits;
96
- }>;
97
- export declare function countUtf8Bytes(input: string): number;
98
- export declare function createClientReusePayloadHash(input: string): string;
99
- export declare function createClientReuseManifest(input: CreateClientReuseManifestInput): ClientReuseManifestWire;
100
- export declare function serializeClientReuseManifest(input: CreateClientReuseManifestInput): string;
101
- export declare function parseClientReuseManifestHeader(rawHeader: string | null | undefined, options?: ParseClientReuseManifestOptions): ClientReuseManifestParseResult;
102
- //#endregion
103
- export {};
@@ -1,209 +0,0 @@
1
- import { isUnknownRecord } from "../utils/record.js";
2
- import { parseAppElementsWireElementKey } from "./app-elements-wire-key.js";
3
- import { fnv1a64 } from "../utils/hash.js";
4
- import { parseArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
5
- import { isNonNegativeSafeInteger } from "../utils/number.js";
6
- //#region src/server/client-reuse-manifest.ts
7
- const CLIENT_REUSE_MANIFEST_SCHEMA_VERSION = 1;
8
- const CLIENT_REUSE_MANIFEST_HASH_ALGORITHM = "fnv1a64";
9
- const DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS = {
10
- maxEntryCount: 64,
11
- maxEntryIdLength: 512,
12
- maxManifestBytes: 4096,
13
- maxPayloadHashLength: 16,
14
- maxVariantCacheKeyLength: 256
15
- };
16
- const CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET = 8;
17
- const HASH_DIGEST_PATTERN = /^[0-9a-z]+$/;
18
- const textEncoder = new TextEncoder();
19
- function createRejection(code, fields = {}) {
20
- return {
21
- code,
22
- fields
23
- };
24
- }
25
- function rejectManifest(code, fields = {}) {
26
- return {
27
- kind: "rejected",
28
- rejection: createRejection(code, fields)
29
- };
30
- }
31
- function rejectEntry(code, entryId, fields = {}) {
32
- return {
33
- code,
34
- entryId,
35
- fields
36
- };
37
- }
38
- function compareManifestEntries(left, right) {
39
- if (left.id < right.id) return -1;
40
- if (left.id > right.id) return 1;
41
- return 0;
42
- }
43
- function createCanonicalWireEntries(entries) {
44
- const entriesById = /* @__PURE__ */ new Map();
45
- for (const entry of entries) if (!entriesById.has(entry.id)) entriesById.set(entry.id, entry);
46
- return Array.from(entriesById.values()).sort(compareManifestEntries);
47
- }
48
- function countUtf8Bytes(input) {
49
- return textEncoder.encode(input).length;
50
- }
51
- function parseReplayWindow(value, visibleCommitVersion) {
52
- if (!isUnknownRecord(value)) return {
53
- kind: "rejected",
54
- rejection: createRejection("SKIP_REPLAY_WINDOW_INVALID", { field: "replayWindow" })
55
- };
56
- const validFromVisibleCommitVersion = value.validFromVisibleCommitVersion;
57
- const validUntilVisibleCommitVersion = value.validUntilVisibleCommitVersion;
58
- if (!isNonNegativeSafeInteger(validFromVisibleCommitVersion) || !isNonNegativeSafeInteger(validUntilVisibleCommitVersion) || validFromVisibleCommitVersion > validUntilVisibleCommitVersion || visibleCommitVersion < validFromVisibleCommitVersion || visibleCommitVersion > validUntilVisibleCommitVersion) return {
59
- kind: "rejected",
60
- rejection: createRejection("SKIP_REPLAY_WINDOW_INVALID", {
61
- validFromVisibleCommitVersion: isNonNegativeSafeInteger(validFromVisibleCommitVersion) ? validFromVisibleCommitVersion : null,
62
- validUntilVisibleCommitVersion: isNonNegativeSafeInteger(validUntilVisibleCommitVersion) ? validUntilVisibleCommitVersion : null,
63
- visibleCommitVersion
64
- })
65
- };
66
- return {
67
- kind: "parsed",
68
- replayWindow: {
69
- validFromVisibleCommitVersion,
70
- validUntilVisibleCommitVersion
71
- }
72
- };
73
- }
74
- function currentCommitVersionMatchesReplayWindow(currentVisibleCommitVersion, replayWindow) {
75
- if (currentVisibleCommitVersion === void 0) return true;
76
- return currentVisibleCommitVersion >= replayWindow.validFromVisibleCommitVersion && currentVisibleCommitVersion <= replayWindow.validUntilVisibleCommitVersion;
77
- }
78
- function parseEntryKind(id) {
79
- const parsed = parseAppElementsWireElementKey(id);
80
- if (parsed === null) return null;
81
- return parsed.kind;
82
- }
83
- function isValidPayloadHash(value, limits) {
84
- return typeof value === "string" && value.length > 0 && value.length <= limits.maxPayloadHashLength && HASH_DIGEST_PATTERN.test(value);
85
- }
86
- function parseManifestEntry(value, limits, index) {
87
- if (!isUnknownRecord(value)) return rejectEntry("SKIP_ENTRY_MALFORMED", null, { index });
88
- const id = value.id;
89
- if (typeof id !== "string" || id.length === 0) return rejectEntry("SKIP_ENTRY_ID_INVALID", null, { index });
90
- if (id.length > limits.maxEntryIdLength) return rejectEntry("SKIP_ENTRY_ID_TOO_LONG", id, {
91
- idHash: createClientReusePayloadHash(id),
92
- maxEntryIdLength: limits.maxEntryIdLength
93
- });
94
- const kind = parseEntryKind(id);
95
- if (kind === null) return rejectEntry("SKIP_UNKNOWN_ENTRY", id, { idHash: createClientReusePayloadHash(id) });
96
- const privacy = value.privacy;
97
- if (privacy === "private") return rejectEntry("SKIP_PRIVATE_ENTRY", id, { privacy });
98
- if (privacy !== "public") return rejectEntry("SKIP_ENTRY_MALFORMED", id, { field: "privacy" });
99
- const payloadHash = value.payloadHash;
100
- if (!isValidPayloadHash(payloadHash, limits)) return rejectEntry("SKIP_ENTRY_HASH_INVALID", id, { maxPayloadHashLength: limits.maxPayloadHashLength });
101
- const variantCacheKey = value.variantCacheKey;
102
- if (typeof variantCacheKey !== "string" || variantCacheKey.length === 0) return rejectEntry("SKIP_VARIANT_CACHE_KEY_INVALID", id, { field: "variantCacheKey" });
103
- if (variantCacheKey.length > limits.maxVariantCacheKeyLength) return rejectEntry("SKIP_VARIANT_CACHE_KEY_TOO_LONG", id, {
104
- maxVariantCacheKeyLength: limits.maxVariantCacheKeyLength,
105
- variantCacheKeyHash: createClientReusePayloadHash(variantCacheKey)
106
- });
107
- const artifactCompatibility = parseArtifactCompatibilityEnvelope(value.artifactCompatibility);
108
- if (artifactCompatibility === null) return rejectEntry("SKIP_ARTIFACT_COMPATIBILITY_INVALID", id, { field: "artifactCompatibility" });
109
- return {
110
- artifactCompatibility,
111
- id,
112
- kind,
113
- payloadHash,
114
- privacy,
115
- variantCacheKey
116
- };
117
- }
118
- function createClientReusePayloadHash(input) {
119
- return fnv1a64(input);
120
- }
121
- function createClientReuseManifest(input) {
122
- const replayWindow = input.replayWindow ?? {
123
- validFromVisibleCommitVersion: input.visibleCommitVersion,
124
- validUntilVisibleCommitVersion: input.visibleCommitVersion
125
- };
126
- return {
127
- entries: createCanonicalWireEntries(input.entries),
128
- hashAlgorithm: CLIENT_REUSE_MANIFEST_HASH_ALGORITHM,
129
- replayWindow,
130
- schemaVersion: 1,
131
- visibleCommitVersion: input.visibleCommitVersion
132
- };
133
- }
134
- function serializeClientReuseManifest(input) {
135
- return JSON.stringify(createClientReuseManifest(input));
136
- }
137
- function parseClientReuseManifestHeader(rawHeader, options = {}) {
138
- const header = rawHeader?.trim();
139
- if (!header) return { kind: "absent" };
140
- const limits = options.limits ?? DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS;
141
- const manifestBytes = countUtf8Bytes(header);
142
- if (manifestBytes > limits.maxManifestBytes) return rejectManifest("SKIP_MANIFEST_TOO_LARGE", {
143
- manifestBytes,
144
- maxManifestBytes: limits.maxManifestBytes
145
- });
146
- let decoded;
147
- try {
148
- decoded = JSON.parse(header);
149
- } catch {
150
- return rejectManifest("SKIP_MANIFEST_MALFORMED");
151
- }
152
- if (!isUnknownRecord(decoded)) return rejectManifest("SKIP_MANIFEST_MALFORMED", { field: "manifest" });
153
- if (decoded.schemaVersion !== 1) return rejectManifest("SKIP_MANIFEST_SCHEMA_UNSUPPORTED", { schemaVersion: typeof decoded.schemaVersion === "number" || typeof decoded.schemaVersion === "string" ? decoded.schemaVersion : null });
154
- if (decoded.hashAlgorithm !== "fnv1a64") return rejectManifest("SKIP_HASH_ALGORITHM_UNSUPPORTED", { hashAlgorithm: typeof decoded.hashAlgorithm === "string" ? decoded.hashAlgorithm : null });
155
- const visibleCommitVersion = decoded.visibleCommitVersion;
156
- if (!isNonNegativeSafeInteger(visibleCommitVersion)) return rejectManifest("SKIP_VISIBLE_COMMIT_VERSION_INVALID", { visibleCommitVersion: null });
157
- const replayWindowResult = parseReplayWindow(decoded.replayWindow, visibleCommitVersion);
158
- if (replayWindowResult.kind === "rejected") return {
159
- kind: "rejected",
160
- rejection: replayWindowResult.rejection
161
- };
162
- const { replayWindow } = replayWindowResult;
163
- if (!currentCommitVersionMatchesReplayWindow(options.currentVisibleCommitVersion, replayWindow)) return rejectManifest("SKIP_VISIBLE_COMMIT_VERSION_MISMATCH", {
164
- currentVisibleCommitVersion: options.currentVisibleCommitVersion ?? null,
165
- validFromVisibleCommitVersion: replayWindow.validFromVisibleCommitVersion,
166
- validUntilVisibleCommitVersion: replayWindow.validUntilVisibleCommitVersion,
167
- visibleCommitVersion
168
- });
169
- const entriesValue = decoded.entries;
170
- if (!Array.isArray(entriesValue)) return rejectManifest("SKIP_MANIFEST_MALFORMED", { field: "entries" });
171
- if (entriesValue.length > limits.maxEntryCount) return rejectManifest("SKIP_ENTRY_COUNT_EXCEEDED", {
172
- entryCount: entriesValue.length,
173
- maxEntryCount: limits.maxEntryCount
174
- });
175
- const entries = [];
176
- const entryRejections = [];
177
- let previousEntryId = null;
178
- for (let index = 0; index < entriesValue.length; index++) {
179
- const value = entriesValue[index];
180
- if (isUnknownRecord(value) && typeof value.id === "string") {
181
- if (previousEntryId !== null && value.id <= previousEntryId) return rejectManifest("SKIP_ENTRY_ORDER_NON_CANONICAL", {
182
- entryIdHash: createClientReusePayloadHash(value.id),
183
- previousEntryIdHash: createClientReusePayloadHash(previousEntryId)
184
- });
185
- previousEntryId = value.id;
186
- }
187
- const parsedEntry = parseManifestEntry(value, limits, index);
188
- if ("code" in parsedEntry) entryRejections.push(parsedEntry);
189
- else entries.push(parsedEntry);
190
- }
191
- return {
192
- entryRejections,
193
- kind: "parsed",
194
- manifest: {
195
- entries,
196
- hashAlgorithm: CLIENT_REUSE_MANIFEST_HASH_ALGORITHM,
197
- replayWindow,
198
- schemaVersion: 1,
199
- visibleCommitVersion
200
- },
201
- skipDisposition: {
202
- code: "SKIP_MODEL_DISABLED",
203
- enabled: false,
204
- mode: "renderAndSend"
205
- }
206
- };
207
- }
208
- //#endregion
209
- export { CLIENT_REUSE_MANIFEST_HASH_ALGORITHM, CLIENT_REUSE_MANIFEST_SCHEMA_VERSION, CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET, DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS, countUtf8Bytes, createClientReuseManifest, createClientReusePayloadHash, parseClientReuseManifestHeader, serializeClientReuseManifest };