@bleedingdev/modern-js-runtime-extensions 3.9.0-ultramodern.3 → 3.9.0-ultramodern.5

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 (200) hide show
  1. package/dist/cjs/buildIdentity.js +73 -0
  2. package/dist/cjs/contextExtensions.js +74 -0
  3. package/dist/cjs/headRuntime.js +91 -0
  4. package/dist/cjs/helmetContext.js +54 -0
  5. package/dist/cjs/index.js +18 -4
  6. package/dist/cjs/localisedLoaderIdentity.js +51 -0
  7. package/dist/cjs/prefetchPolicy.js +52 -0
  8. package/dist/cjs/reactContext.js +45 -0
  9. package/dist/cjs/request-policy/browser.js +139 -0
  10. package/dist/cjs/request-policy/client.js +234 -0
  11. package/dist/cjs/request-policy/node.js +149 -0
  12. package/dist/cjs/request-policy/policyCore.js +266 -0
  13. package/dist/cjs/request-policy/requestContext.js +137 -0
  14. package/dist/cjs/request-policy/traceparent.js +56 -0
  15. package/dist/cjs/request-policy/transport.js +234 -0
  16. package/dist/cjs/request-policy/types.js +57 -0
  17. package/dist/cjs/routeHydration.js +127 -0
  18. package/dist/cjs/routerPrefetchPolicy.js +153 -0
  19. package/dist/cjs/routerProvider.js +170 -0
  20. package/dist/cjs/routerState.js +167 -0
  21. package/dist/cjs/routerStatePlugin.js +86 -0
  22. package/dist/cjs/routerStateTypes.js +18 -0
  23. package/dist/cjs/rsc-disabled/rscDisabledClientBrowserRuntime.js +69 -0
  24. package/dist/cjs/rsc-disabled/rscDisabledClientEdgeRuntime.js +61 -0
  25. package/dist/cjs/rsc-disabled/rscDisabledClientNodeRuntime.js +65 -0
  26. package/dist/cjs/rsc-disabled/rscDisabledRuntimeError.js +42 -0
  27. package/dist/cjs/rsc-disabled/rscDisabledServerEdgeRuntime.js +93 -0
  28. package/dist/cjs/rsc-disabled/rscDisabledServerNodeRuntime.js +101 -0
  29. package/dist/cjs/runtimeContextProjection.js +112 -0
  30. package/dist/cjs/server-config/bffRuntime.js +18 -0
  31. package/dist/cjs/server-config/index.js +18 -0
  32. package/dist/cjs/server-config/serverTelemetry.js +18 -0
  33. package/dist/cjs/shellStream.js +34 -2
  34. package/dist/cjs/workspaceEvents.js +159 -0
  35. package/dist/esm/buildIdentity.mjs +35 -0
  36. package/dist/esm/contextExtensions.mjs +33 -0
  37. package/dist/esm/headRuntime.mjs +43 -0
  38. package/dist/esm/helmetContext.mjs +13 -0
  39. package/dist/esm/index.mjs +2 -0
  40. package/dist/esm/localisedLoaderIdentity.mjs +13 -0
  41. package/dist/esm/prefetchPolicy.mjs +11 -0
  42. package/dist/esm/reactContext.mjs +7 -0
  43. package/dist/esm/request-policy/browser.mjs +11 -0
  44. package/dist/esm/request-policy/client.mjs +195 -0
  45. package/dist/esm/request-policy/policyCore.mjs +171 -0
  46. package/dist/esm/request-policy/requestContext.mjs +75 -0
  47. package/dist/esm/request-policy/traceparent.mjs +18 -0
  48. package/dist/esm/request-policy/transport.mjs +196 -0
  49. package/dist/esm/request-policy/types.mjs +10 -0
  50. package/dist/esm/routeHydration.mjs +77 -0
  51. package/dist/esm/routerPrefetchPolicy.mjs +115 -0
  52. package/dist/esm/routerProvider.mjs +117 -0
  53. package/dist/esm/routerState.mjs +105 -0
  54. package/dist/esm/routerStatePlugin.mjs +48 -0
  55. package/dist/esm/routerStateTypes.mjs +0 -0
  56. package/dist/esm/rsc-disabled/rscDisabledClientBrowserRuntime.mjs +10 -0
  57. package/dist/esm/rsc-disabled/rscDisabledClientEdgeRuntime.mjs +8 -0
  58. package/dist/esm/rsc-disabled/rscDisabledClientNodeRuntime.mjs +9 -0
  59. package/dist/esm/rsc-disabled/rscDisabledRuntimeError.mjs +4 -0
  60. package/dist/esm/rsc-disabled/rscDisabledServerEdgeRuntime.mjs +16 -0
  61. package/dist/esm/rsc-disabled/rscDisabledServerNodeRuntime.mjs +18 -0
  62. package/dist/esm/runtimeContextProjection.mjs +74 -0
  63. package/dist/esm/server-config/bffRuntime.mjs +0 -0
  64. package/dist/esm/server-config/index.mjs +0 -0
  65. package/dist/esm/server-config/serverTelemetry.mjs +0 -0
  66. package/dist/esm/shellStream.mjs +34 -2
  67. package/dist/esm/workspaceEvents.mjs +66 -0
  68. package/dist/esm-node/buildIdentity.mjs +36 -0
  69. package/dist/esm-node/contextExtensions.mjs +34 -0
  70. package/dist/esm-node/headRuntime.mjs +44 -0
  71. package/dist/esm-node/helmetContext.mjs +14 -0
  72. package/dist/esm-node/index.mjs +2 -0
  73. package/dist/esm-node/localisedLoaderIdentity.mjs +14 -0
  74. package/dist/esm-node/prefetchPolicy.mjs +12 -0
  75. package/dist/esm-node/reactContext.mjs +8 -0
  76. package/dist/esm-node/request-policy/browser.mjs +12 -0
  77. package/dist/esm-node/request-policy/client.mjs +196 -0
  78. package/dist/esm-node/request-policy/node.mjs +22 -0
  79. package/dist/esm-node/request-policy/policyCore.mjs +172 -0
  80. package/dist/esm-node/request-policy/requestContext.mjs +76 -0
  81. package/dist/esm-node/request-policy/traceparent.mjs +19 -0
  82. package/dist/esm-node/request-policy/transport.mjs +197 -0
  83. package/dist/esm-node/request-policy/types.mjs +11 -0
  84. package/dist/esm-node/routeHydration.mjs +78 -0
  85. package/dist/esm-node/routerPrefetchPolicy.mjs +116 -0
  86. package/dist/esm-node/routerProvider.mjs +118 -0
  87. package/dist/esm-node/routerState.mjs +106 -0
  88. package/dist/esm-node/routerStatePlugin.mjs +49 -0
  89. package/dist/esm-node/routerStateTypes.mjs +1 -0
  90. package/dist/esm-node/rsc-disabled/rscDisabledClientBrowserRuntime.mjs +11 -0
  91. package/dist/esm-node/rsc-disabled/rscDisabledClientEdgeRuntime.mjs +9 -0
  92. package/dist/esm-node/rsc-disabled/rscDisabledClientNodeRuntime.mjs +10 -0
  93. package/dist/esm-node/rsc-disabled/rscDisabledRuntimeError.mjs +5 -0
  94. package/dist/esm-node/rsc-disabled/rscDisabledServerEdgeRuntime.mjs +17 -0
  95. package/dist/esm-node/rsc-disabled/rscDisabledServerNodeRuntime.mjs +19 -0
  96. package/dist/esm-node/runtimeContextProjection.mjs +75 -0
  97. package/dist/esm-node/server-config/bffRuntime.mjs +1 -0
  98. package/dist/esm-node/server-config/index.mjs +1 -0
  99. package/dist/esm-node/server-config/serverTelemetry.mjs +1 -0
  100. package/dist/esm-node/shellStream.mjs +34 -2
  101. package/dist/esm-node/workspaceEvents.mjs +67 -0
  102. package/dist/types/buildIdentity.d.ts +37 -0
  103. package/dist/types/contextExtensions.d.ts +34 -0
  104. package/dist/types/headRuntime.d.ts +12 -0
  105. package/dist/types/helmetContext.d.ts +10 -0
  106. package/dist/types/index.d.ts +2 -0
  107. package/dist/types/localisedLoaderIdentity.d.ts +10 -0
  108. package/dist/types/prefetchPolicy.d.ts +4 -0
  109. package/dist/types/reactContext.d.ts +6 -0
  110. package/dist/types/request-policy/browser.d.ts +10 -0
  111. package/dist/types/request-policy/client.d.ts +14 -0
  112. package/dist/types/request-policy/node.d.ts +10 -0
  113. package/dist/types/request-policy/policyCore.d.ts +107 -0
  114. package/dist/types/request-policy/requestContext.d.ts +22 -0
  115. package/dist/types/request-policy/traceparent.d.ts +10 -0
  116. package/dist/types/request-policy/transport.d.ts +12 -0
  117. package/dist/types/request-policy/types.d.ts +144 -0
  118. package/dist/types/routeHydration.d.ts +24 -0
  119. package/dist/types/routerPrefetchPolicy.d.ts +28 -0
  120. package/dist/types/routerProvider.d.ts +77 -0
  121. package/dist/types/routerState.d.ts +12 -0
  122. package/dist/types/routerStatePlugin.d.ts +19 -0
  123. package/dist/types/routerStateTypes.d.ts +40 -0
  124. package/dist/types/rsc-disabled/rscDisabledClientBrowserRuntime.d.ts +9 -0
  125. package/dist/types/rsc-disabled/rscDisabledClientEdgeRuntime.d.ts +7 -0
  126. package/dist/types/rsc-disabled/rscDisabledClientNodeRuntime.d.ts +8 -0
  127. package/dist/types/rsc-disabled/rscDisabledRuntimeError.d.ts +1 -0
  128. package/dist/types/rsc-disabled/rscDisabledServerEdgeRuntime.d.ts +15 -0
  129. package/dist/types/rsc-disabled/rscDisabledServerNodeRuntime.d.ts +17 -0
  130. package/dist/types/runtimeContextProjection.d.ts +30 -0
  131. package/dist/types/server-config/bffRuntime.d.ts +122 -0
  132. package/dist/types/server-config/index.d.ts +2 -0
  133. package/dist/types/server-config/serverTelemetry.d.ts +322 -0
  134. package/dist/types/workspaceEvents.d.ts +62 -0
  135. package/package.json +238 -13
  136. package/rslib.config.mts +17 -2
  137. package/rstest.config.mts +33 -2
  138. package/src/buildIdentity.ts +61 -0
  139. package/src/contextExtensions.ts +81 -0
  140. package/src/headRuntime.tsx +77 -0
  141. package/src/helmetContext.ts +31 -0
  142. package/src/index.ts +2 -0
  143. package/src/localisedLoaderIdentity.ts +30 -0
  144. package/src/prefetchPolicy.ts +33 -0
  145. package/src/reactContext.ts +16 -0
  146. package/src/request-policy/browser.ts +22 -0
  147. package/src/request-policy/client.ts +404 -0
  148. package/src/request-policy/node.ts +41 -0
  149. package/src/request-policy/policyCore.ts +424 -0
  150. package/src/request-policy/requestContext.ts +149 -0
  151. package/src/request-policy/traceparent.ts +43 -0
  152. package/src/request-policy/transport.ts +349 -0
  153. package/src/request-policy/types.ts +229 -0
  154. package/src/routeHydration.ts +208 -0
  155. package/src/routerPrefetchPolicy.ts +195 -0
  156. package/src/routerProvider.ts +340 -0
  157. package/src/routerState.ts +208 -0
  158. package/src/routerStatePlugin.ts +86 -0
  159. package/src/routerStateTypes.ts +46 -0
  160. package/src/rsc-disabled/rscDisabledClientBrowserRuntime.ts +10 -0
  161. package/src/rsc-disabled/rscDisabledClientEdgeRuntime.ts +8 -0
  162. package/src/rsc-disabled/rscDisabledClientNodeRuntime.ts +9 -0
  163. package/src/rsc-disabled/rscDisabledRuntimeError.ts +3 -0
  164. package/src/rsc-disabled/rscDisabledServerEdgeRuntime.ts +16 -0
  165. package/src/rsc-disabled/rscDisabledServerNodeRuntime.ts +18 -0
  166. package/src/runtimeContextProjection.ts +105 -0
  167. package/src/server-config/bffRuntime.ts +136 -0
  168. package/src/server-config/index.ts +2 -0
  169. package/src/server-config/serverTelemetry.ts +337 -0
  170. package/src/shellStream.ts +55 -25
  171. package/src/workspaceEvents.ts +324 -0
  172. package/tests/buildIdentity.test.ts +70 -0
  173. package/tests/contextExtensions.test.ts +71 -0
  174. package/tests/headRuntime.test.tsx +369 -0
  175. package/tests/nativeSafeFailureCompatibility.test.ts +117 -0
  176. package/tests/prefetchPolicy.test.ts +51 -0
  177. package/tests/rendererHead.test.ts +1 -72
  178. package/tests/request-policy/browser-policy.test.ts +608 -0
  179. package/tests/request-policy/client-isolation.test.ts +149 -0
  180. package/tests/request-policy/identityBinding.test.ts +75 -0
  181. package/tests/request-policy/node-policy.test.ts +741 -0
  182. package/tests/request-policy/policyCore.test.ts +250 -0
  183. package/tests/request-policy/requestContext.test.ts +80 -0
  184. package/tests/request-policy/requestFactory.outbound-contract.test.ts +691 -0
  185. package/tests/request-policy/traceparent.test.ts +55 -0
  186. package/tests/request-policy/transport-retry.test.ts +370 -0
  187. package/tests/routeHydration.test.ts +180 -0
  188. package/tests/routerPrefetchPolicy.test.ts +102 -0
  189. package/tests/routerProvider.test.ts +38 -0
  190. package/tests/routerState.test.ts +157 -0
  191. package/tests/routerStatePlugin.test.ts +108 -0
  192. package/tests/runtimeContextProjection.test.ts +135 -0
  193. package/tests/shellStream.test.ts +37 -0
  194. package/tests/workspaceEvents.test.ts +391 -0
  195. package/dist/cjs/rscHtmlStream.js +0 -128
  196. package/dist/esm/rscHtmlStream.mjs +0 -86
  197. package/dist/esm-node/rscHtmlStream.mjs +0 -87
  198. package/dist/types/rscHtmlStream.d.ts +0 -4
  199. package/src/rscHtmlStream.ts +0 -142
  200. package/tests/rscHtmlStream.test.ts +0 -153
@@ -0,0 +1,322 @@
1
+ export interface ServerTelemetryExporterOptions {
2
+ enabled?: boolean;
3
+ endpoint?: string;
4
+ headers?: Record<string, string>;
5
+ timeoutMs?: number;
6
+ }
7
+ export interface ServerTelemetryVictoriaMetricsOptions extends ServerTelemetryExporterOptions {
8
+ metricPrefix?: string;
9
+ }
10
+ export interface ServerTelemetrySloUserConfig {
11
+ /**
12
+ * Queue utilization ratio threshold that emits SLO degradation alerts.
13
+ *
14
+ * @default 0.8
15
+ */
16
+ queueUtilizationWarnThreshold?: number;
17
+ /**
18
+ * Total dropped-envelope threshold that emits SLO degradation alerts.
19
+ *
20
+ * @default 1
21
+ */
22
+ queueDroppedWarnThreshold?: number;
23
+ /**
24
+ * Cooldown between SLO alert emissions for the same alert type.
25
+ *
26
+ * @default 60000
27
+ */
28
+ alertCooldownMs?: number;
29
+ }
30
+ export interface ServerTelemetryCanaryContractGateUserConfig {
31
+ /**
32
+ * Whether this contract gate currently passes.
33
+ */
34
+ passed: boolean;
35
+ /**
36
+ * Optional failure reason used for rollback diagnostics.
37
+ */
38
+ reason?: string;
39
+ }
40
+ export interface ServerTelemetryCanaryAutopilotUserConfig {
41
+ /**
42
+ * Enable automatic contract gate synchronization from a gate snapshot file.
43
+ *
44
+ * @default true
45
+ */
46
+ enabled?: boolean;
47
+ /**
48
+ * Path to contract gate snapshot JSON file.
49
+ *
50
+ * @default ".modern/contract-gates.json"
51
+ */
52
+ gateSnapshotPath?: string;
53
+ /**
54
+ * Poll interval for reading gate snapshot changes.
55
+ *
56
+ * @default 15000
57
+ */
58
+ pollIntervalMs?: number;
59
+ /**
60
+ * Marks gate entries as failed when they are older than this threshold.
61
+ *
62
+ * @default 600000
63
+ */
64
+ gateStaleAfterMs?: number;
65
+ /**
66
+ * Runtime MF fallback signal ingestion.
67
+ */
68
+ runtimeFallbackSignal?: ServerTelemetryCanaryRuntimeFallbackSignalUserConfig;
69
+ /**
70
+ * Optional pluggable state store backend for contract gate snapshots.
71
+ * When omitted, snapshots are read/written from gateSnapshotPath on local disk.
72
+ */
73
+ stateStore?: ServerTelemetryCanaryAutopilotStateStoreUserConfig;
74
+ }
75
+ export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
76
+ /**
77
+ * Path or package name of a module that exports
78
+ * `createContractGateSnapshotStore(context)`.
79
+ */
80
+ module: string;
81
+ /**
82
+ * Optional adapter-specific configuration.
83
+ */
84
+ options?: Record<string, unknown>;
85
+ }
86
+ export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
87
+ /**
88
+ * Enable runtime MF fallback signal ingestion endpoint.
89
+ *
90
+ * Opt-in: when enabled, `auth` must be configured with a token
91
+ * (`expectedValue` or `expectedValueEnv`) or server setup throws.
92
+ *
93
+ * @default false
94
+ */
95
+ enabled?: boolean;
96
+ /**
97
+ * HTTP endpoint path for runtime fallback events.
98
+ *
99
+ * @default "/_modern/contract-gates/runtime-fallback"
100
+ */
101
+ endpoint?: string;
102
+ /**
103
+ * Contract gate name updated by runtime fallback events.
104
+ *
105
+ * @default "runtime-mf-fallback-health"
106
+ */
107
+ gateName?: string;
108
+ /**
109
+ * How long a runtime fallback signal should hold gate failure status.
110
+ *
111
+ * @default 300000
112
+ */
113
+ failureHoldMs?: number;
114
+ /**
115
+ * Maximum accepted request body size in bytes.
116
+ *
117
+ * @default 16384
118
+ */
119
+ maxBodyBytes?: number;
120
+ /**
121
+ * Optional runtime trust policy for fallback signal ingestion.
122
+ * Use this to restrict who can mutate canary contract gates.
123
+ */
124
+ trustPolicy?: ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig;
125
+ /**
126
+ * Optional request authentication for runtime fallback signal endpoint.
127
+ */
128
+ auth?: ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig;
129
+ }
130
+ export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
131
+ /**
132
+ * Enable auth guard for runtime fallback signal endpoint.
133
+ *
134
+ * @default false
135
+ */
136
+ enabled?: boolean;
137
+ /**
138
+ * Header name carrying runtime fallback auth token.
139
+ *
140
+ * @default "x-modernjs-runtime-signal-token"
141
+ */
142
+ headerName?: string;
143
+ /**
144
+ * Expected token value. Prefer using expectedValueEnv in production.
145
+ */
146
+ expectedValue?: string;
147
+ /**
148
+ * Name of environment variable that stores expected token value.
149
+ */
150
+ expectedValueEnv?: string;
151
+ }
152
+ export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig {
153
+ /**
154
+ * Allowlist of app names accepted by runtime fallback signal endpoint.
155
+ * Empty means no app-name allowlist check.
156
+ */
157
+ allowedApps?: string[];
158
+ /**
159
+ * Allowlist of entry origins accepted by runtime fallback signal endpoint.
160
+ * Values should be URL origins (for example https://erp.example.com).
161
+ * Empty means no entry-origin allowlist check.
162
+ */
163
+ allowedEntryOrigins?: string[];
164
+ /**
165
+ * Expected runtime digest per appName.
166
+ */
167
+ expectedRuntimeDigests?: Record<string, string>;
168
+ /**
169
+ * Require runtimeDigest to be present in signal payload metadata.
170
+ *
171
+ * @default false
172
+ */
173
+ enforceRuntimeDigest?: boolean;
174
+ /**
175
+ * Maximum accepted signals per app+origin window.
176
+ *
177
+ * @default 30
178
+ */
179
+ maxSignalsPerWindow?: number;
180
+ /**
181
+ * Sliding window size in milliseconds for maxSignalsPerWindow.
182
+ *
183
+ * @default 60000
184
+ */
185
+ windowMs?: number;
186
+ /**
187
+ * Drop duplicate fallback events with the same fingerprint during this window.
188
+ *
189
+ * @default 10000
190
+ */
191
+ dedupeWindowMs?: number;
192
+ }
193
+ export interface ServerTelemetryCanaryUserConfig {
194
+ /**
195
+ * Enable canary rollout/rollback orchestration.
196
+ *
197
+ * @default false
198
+ */
199
+ enabled?: boolean;
200
+ /**
201
+ * Periodic canary evaluation interval in milliseconds.
202
+ *
203
+ * @default 15000
204
+ */
205
+ evaluationIntervalMs?: number;
206
+ /**
207
+ * Required consecutive healthy evaluations before promotion.
208
+ *
209
+ * @default 3
210
+ */
211
+ minConsecutiveHealthyEvaluations?: number;
212
+ /**
213
+ * Consecutive failing evaluations before automated rollback.
214
+ *
215
+ * @default 2
216
+ */
217
+ rollbackConsecutiveFailures?: number;
218
+ /**
219
+ * Maximum queue utilization ratio allowed during canary.
220
+ *
221
+ * @default 0.8
222
+ */
223
+ maxQueueUtilization?: number;
224
+ /**
225
+ * Maximum allowed total dropped envelopes during canary.
226
+ *
227
+ * @default 0
228
+ */
229
+ maxTotalDropped?: number;
230
+ /**
231
+ * Maximum allowed unhealthy exporters during canary.
232
+ *
233
+ * @default 0
234
+ */
235
+ maxUnhealthyExporters?: number;
236
+ /**
237
+ * Contract gate map used in rollout decisions.
238
+ * `true` means passing, `false` means failing.
239
+ */
240
+ contractGates?: Record<string, boolean | ServerTelemetryCanaryContractGateUserConfig>;
241
+ /**
242
+ * Contract-gate autopilot settings.
243
+ */
244
+ autopilot?: ServerTelemetryCanaryAutopilotUserConfig;
245
+ }
246
+ export interface ServerTelemetryConfigExtension {
247
+ telemetry?: ServerTelemetryUserConfig;
248
+ }
249
+ export interface ServerTelemetryUserConfig {
250
+ /**
251
+ * Enable framework telemetry envelope emission.
252
+ * @default false
253
+ */
254
+ enabled?: boolean;
255
+ /**
256
+ * Logical service name attached to every telemetry envelope.
257
+ * @default server.metaName
258
+ */
259
+ service?: string;
260
+ /**
261
+ * Logical module name attached to every telemetry envelope.
262
+ * @default "server"
263
+ */
264
+ module?: string;
265
+ /**
266
+ * Environment attached to every telemetry envelope.
267
+ * @default process.env.NODE_ENV || "development"
268
+ */
269
+ environment?: string;
270
+ /**
271
+ * Sampling rate for monitor events.
272
+ * @default 1
273
+ */
274
+ samplingRate?: number;
275
+ /**
276
+ * Flush window in milliseconds for exporter batches.
277
+ * @default 1000
278
+ */
279
+ flushIntervalMs?: number;
280
+ /**
281
+ * Maximum envelopes in one emitted batch.
282
+ * @default 50
283
+ */
284
+ maxBatchSize?: number;
285
+ /**
286
+ * Maximum envelopes buffered before backpressure drops oldest.
287
+ * @default 1000
288
+ */
289
+ maxQueueSize?: number;
290
+ /**
291
+ * Envelope attribute keys that should be redacted.
292
+ */
293
+ redactionKeys?: string[];
294
+ /**
295
+ * Control startup exporter health probe behavior.
296
+ * When enabled (default), server initialization emits a startup probe and
297
+ * marks exporters healthy/unhealthy before serving traffic.
298
+ * When fail-loud mode is enabled (default), initialization throws if at
299
+ * least one configured exporter is unhealthy.
300
+ *
301
+ * @default true
302
+ */
303
+ failLoudStartup?: boolean;
304
+ /**
305
+ * Queue backpressure/degradation SLO alert thresholds.
306
+ */
307
+ slo?: ServerTelemetrySloUserConfig;
308
+ /**
309
+ * Canary rollout and automated rollback orchestration policy.
310
+ */
311
+ canary?: ServerTelemetryCanaryUserConfig;
312
+ exporters?: {
313
+ /**
314
+ * OpenTelemetry HTTP exporter.
315
+ */
316
+ otlp?: ServerTelemetryExporterOptions;
317
+ /**
318
+ * VictoriaMetrics Prometheus import exporter.
319
+ */
320
+ victoriaMetrics?: ServerTelemetryVictoriaMetricsOptions;
321
+ };
322
+ }
@@ -0,0 +1,62 @@
1
+ export type UltramodernPerformanceReadinessSignalId = 'bfcache' | 'core-web-vitals-rum' | 'duplicate-prefetch-warmup' | 'cache-policy-sanity' | 'save-data-behavior' | 'cloudflare-ssr-cache-hints';
2
+ export type UltramodernWorkspaceLocale = 'en' | 'cs';
3
+ export type UltramodernPerformanceReadinessSignalStatus = 'pass' | 'warn' | 'fail';
4
+ export declare const ultramodernWorkspaceEventNames: {
5
+ readonly navigate: 'ultramodern:navigate';
6
+ readonly performanceSignal: 'ultramodern:performance-signal';
7
+ readonly remoteReady: 'ultramodern:remote-ready';
8
+ readonly routeSettled: 'ultramodern:route-settled';
9
+ };
10
+ export type UltramodernWorkspaceEventName = (typeof ultramodernWorkspaceEventNames)[keyof typeof ultramodernWorkspaceEventNames];
11
+ export interface UltramodernNavigatePayload {
12
+ to: string;
13
+ replace?: boolean;
14
+ state?: Record<string, unknown>;
15
+ }
16
+ export interface UltramodernRouteSettledPayload {
17
+ pathname: string;
18
+ locale?: UltramodernWorkspaceLocale;
19
+ title?: string;
20
+ }
21
+ export interface UltramodernRemoteReadyPayload {
22
+ appId: string;
23
+ build?: string;
24
+ surface?: string;
25
+ version?: string;
26
+ }
27
+ export interface UltramodernPerformanceSignalPayload {
28
+ signalId: UltramodernPerformanceReadinessSignalId;
29
+ status: UltramodernPerformanceReadinessSignalStatus;
30
+ durationMs?: number;
31
+ detail?: Record<string, unknown>;
32
+ }
33
+ export interface UltramodernWorkspaceEventPayloadMap {
34
+ 'ultramodern:navigate': UltramodernNavigatePayload;
35
+ 'ultramodern:performance-signal': UltramodernPerformanceSignalPayload;
36
+ 'ultramodern:remote-ready': UltramodernRemoteReadyPayload;
37
+ 'ultramodern:route-settled': UltramodernRouteSettledPayload;
38
+ }
39
+ export declare class UltramodernWorkspaceEventValidationError {
40
+ readonly message: string;
41
+ readonly name = "UltramodernWorkspaceEventValidationError";
42
+ readonly eventName: UltramodernWorkspaceEventName;
43
+ readonly payload: unknown;
44
+ constructor(eventName: UltramodernWorkspaceEventName, payload: unknown);
45
+ }
46
+ export declare const isUltramodernNavigatePayload: (payload: unknown) => payload is UltramodernNavigatePayload;
47
+ export declare const isUltramodernRouteSettledPayload: (payload: unknown) => payload is UltramodernRouteSettledPayload;
48
+ export declare const isUltramodernRemoteReadyPayload: (payload: unknown) => payload is UltramodernRemoteReadyPayload;
49
+ export declare const isUltramodernPerformanceSignalPayload: (payload: unknown) => payload is UltramodernPerformanceSignalPayload;
50
+ export declare const isUltramodernWorkspaceEventPayload: <Name extends UltramodernWorkspaceEventName>(eventName: Name, payload: unknown) => payload is UltramodernWorkspaceEventPayloadMap[Name];
51
+ export declare const assertUltramodernWorkspaceEventPayload: <Name extends UltramodernWorkspaceEventName>(eventName: Name, payload: unknown) => UltramodernWorkspaceEventPayloadMap[Name];
52
+ export declare const createUltramodernWorkspaceEvent: <Name extends UltramodernWorkspaceEventName>(eventName: Name, payload: UltramodernWorkspaceEventPayloadMap[Name]) => CustomEvent<UltramodernWorkspaceEventPayloadMap[Name]>;
53
+ export declare const dispatchUltramodernWorkspaceEvent: <Name extends UltramodernWorkspaceEventName>(target: EventTarget, eventName: Name, payload: UltramodernWorkspaceEventPayloadMap[Name]) => boolean;
54
+ export declare const onUltramodernWorkspaceEvent: <Name extends UltramodernWorkspaceEventName>(target: EventTarget, eventName: Name, handler: (payload: UltramodernWorkspaceEventPayloadMap[Name], event: CustomEvent<UltramodernWorkspaceEventPayloadMap[Name]>) => void) => () => void;
55
+ export declare const dispatchUltramodernNavigate: (target: EventTarget, payload: UltramodernNavigatePayload) => boolean;
56
+ export declare const dispatchUltramodernRouteSettled: (target: EventTarget, payload: UltramodernRouteSettledPayload) => boolean;
57
+ export declare const dispatchUltramodernRemoteReady: (target: EventTarget, payload: UltramodernRemoteReadyPayload) => boolean;
58
+ export declare const dispatchUltramodernPerformanceSignal: (target: EventTarget, payload: UltramodernPerformanceSignalPayload) => boolean;
59
+ export declare const onUltramodernNavigate: (target: EventTarget, handler: (payload: UltramodernNavigatePayload, event: CustomEvent<UltramodernNavigatePayload>) => void) => () => void;
60
+ export declare const onUltramodernRouteSettled: (target: EventTarget, handler: (payload: UltramodernRouteSettledPayload, event: CustomEvent<UltramodernRouteSettledPayload>) => void) => () => void;
61
+ export declare const onUltramodernRemoteReady: (target: EventTarget, handler: (payload: UltramodernRemoteReadyPayload, event: CustomEvent<UltramodernRemoteReadyPayload>) => void) => () => void;
62
+ export declare const onUltramodernPerformanceSignal: (target: EventTarget, handler: (payload: UltramodernPerformanceSignalPayload, event: CustomEvent<UltramodernPerformanceSignalPayload>) => void) => () => void;
package/package.json CHANGED
@@ -11,7 +11,7 @@
11
11
  "directory": "packages/runtime/runtime-extensions"
12
12
  },
13
13
  "license": "MIT",
14
- "version": "3.9.0-ultramodern.3",
14
+ "version": "3.9.0-ultramodern.5",
15
15
  "engines": {
16
16
  "node": ">=26.7.0"
17
17
  },
@@ -34,14 +34,6 @@
34
34
  },
35
35
  "default": "./dist/esm-node/node.mjs"
36
36
  },
37
- "./rsc-html-stream": {
38
- "types": "./dist/types/rscHtmlStream.d.ts",
39
- "node": {
40
- "import": "./dist/esm-node/rscHtmlStream.mjs",
41
- "require": "./dist/cjs/rscHtmlStream.js"
42
- },
43
- "default": "./dist/esm-node/rscHtmlStream.mjs"
44
- },
45
37
  "./safe-failure": {
46
38
  "types": "./dist/types/safeFailure.d.ts",
47
39
  "node": {
@@ -49,6 +41,151 @@
49
41
  "require": "./dist/cjs/safeFailure.js"
50
42
  },
51
43
  "default": "./dist/esm/safeFailure.mjs"
44
+ },
45
+ "./build-identity": {
46
+ "types": "./dist/types/buildIdentity.d.ts",
47
+ "node": {
48
+ "import": "./dist/esm-node/buildIdentity.mjs",
49
+ "require": "./dist/cjs/buildIdentity.js"
50
+ },
51
+ "default": "./dist/esm/buildIdentity.mjs"
52
+ },
53
+ "./workspace-events": {
54
+ "types": "./dist/types/workspaceEvents.d.ts",
55
+ "node": {
56
+ "import": "./dist/esm-node/workspaceEvents.mjs",
57
+ "require": "./dist/cjs/workspaceEvents.js"
58
+ },
59
+ "default": "./dist/esm/workspaceEvents.mjs"
60
+ },
61
+ "./rsc-disabled/*": {
62
+ "types": "./dist/types/rsc-disabled/*.d.ts",
63
+ "default": "./dist/esm/rsc-disabled/*.mjs"
64
+ },
65
+ "./localised-loader-identity": {
66
+ "types": "./dist/types/localisedLoaderIdentity.d.ts",
67
+ "node": {
68
+ "import": "./dist/esm-node/localisedLoaderIdentity.mjs",
69
+ "require": "./dist/cjs/localisedLoaderIdentity.js"
70
+ },
71
+ "default": "./dist/esm/localisedLoaderIdentity.mjs"
72
+ },
73
+ "./react-context": {
74
+ "types": "./dist/types/reactContext.d.ts",
75
+ "node": {
76
+ "import": "./dist/esm-node/reactContext.mjs",
77
+ "require": "./dist/cjs/reactContext.js"
78
+ },
79
+ "default": "./dist/esm/reactContext.mjs"
80
+ },
81
+ "./context-extensions": {
82
+ "types": "./dist/types/contextExtensions.d.ts",
83
+ "node": {
84
+ "import": "./dist/esm-node/contextExtensions.mjs",
85
+ "require": "./dist/cjs/contextExtensions.js"
86
+ },
87
+ "default": "./dist/esm/contextExtensions.mjs"
88
+ },
89
+ "./helmet-context": {
90
+ "types": "./dist/types/helmetContext.d.ts",
91
+ "node": {
92
+ "import": "./dist/esm-node/helmetContext.mjs",
93
+ "require": "./dist/cjs/helmetContext.js"
94
+ },
95
+ "default": "./dist/esm/helmetContext.mjs"
96
+ },
97
+ "./head-runtime": {
98
+ "types": "./dist/types/headRuntime.d.ts",
99
+ "node": {
100
+ "import": "./dist/esm-node/headRuntime.mjs",
101
+ "require": "./dist/cjs/headRuntime.js"
102
+ },
103
+ "default": "./dist/esm/headRuntime.mjs"
104
+ },
105
+ "./context-projection": {
106
+ "types": "./dist/types/runtimeContextProjection.d.ts",
107
+ "node": {
108
+ "import": "./dist/esm-node/runtimeContextProjection.mjs",
109
+ "require": "./dist/cjs/runtimeContextProjection.js"
110
+ },
111
+ "default": "./dist/esm/runtimeContextProjection.mjs"
112
+ },
113
+ "./server-config": {
114
+ "types": "./dist/types/server-config/index.d.ts",
115
+ "node": {
116
+ "import": "./dist/esm-node/server-config/index.mjs",
117
+ "require": "./dist/cjs/server-config/index.js"
118
+ },
119
+ "default": "./dist/esm/server-config/index.mjs"
120
+ },
121
+ "./router-state": {
122
+ "types": "./dist/types/routerState.d.ts",
123
+ "node": {
124
+ "import": "./dist/esm-node/routerState.mjs",
125
+ "require": "./dist/cjs/routerState.js"
126
+ },
127
+ "default": "./dist/esm/routerState.mjs"
128
+ },
129
+ "./request-policy": {
130
+ "types": "./dist/types/request-policy/browser.d.ts",
131
+ "node": {
132
+ "import": "./dist/esm-node/request-policy/node.mjs",
133
+ "require": "./dist/esm-node/request-policy/node.mjs",
134
+ "default": "./dist/esm-node/request-policy/node.mjs"
135
+ },
136
+ "import": "./dist/esm/request-policy/browser.mjs",
137
+ "require": "./dist/esm/request-policy/browser.mjs",
138
+ "default": "./dist/esm/request-policy/browser.mjs"
139
+ },
140
+ "./request-policy/client": {
141
+ "types": "./dist/types/request-policy/browser.d.ts",
142
+ "import": "./dist/esm/request-policy/browser.mjs",
143
+ "require": "./dist/esm/request-policy/browser.mjs",
144
+ "default": "./dist/esm/request-policy/browser.mjs"
145
+ },
146
+ "./request-policy/server": {
147
+ "types": "./dist/types/request-policy/node.d.ts",
148
+ "node": {
149
+ "import": "./dist/esm-node/request-policy/node.mjs",
150
+ "require": "./dist/esm-node/request-policy/node.mjs",
151
+ "default": "./dist/esm-node/request-policy/node.mjs"
152
+ }
153
+ },
154
+ "./request-context": {
155
+ "types": "./dist/types/request-policy/requestContext.d.ts",
156
+ "node": {
157
+ "import": "./dist/esm-node/request-policy/requestContext.mjs",
158
+ "require": "./dist/esm-node/request-policy/requestContext.mjs",
159
+ "default": "./dist/esm-node/request-policy/requestContext.mjs"
160
+ },
161
+ "import": "./dist/esm/request-policy/requestContext.mjs",
162
+ "require": "./dist/esm/request-policy/requestContext.mjs",
163
+ "default": "./dist/esm/request-policy/requestContext.mjs"
164
+ },
165
+ "./package.json": "./package.json",
166
+ "./router-state-plugin": {
167
+ "types": "./dist/types/routerStatePlugin.d.ts",
168
+ "node": {
169
+ "import": "./dist/esm-node/routerStatePlugin.mjs",
170
+ "require": "./dist/cjs/routerStatePlugin.js"
171
+ },
172
+ "default": "./dist/esm/routerStatePlugin.mjs"
173
+ },
174
+ "./router-provider": {
175
+ "types": "./dist/types/routerProvider.d.ts",
176
+ "node": {
177
+ "import": "./dist/esm-node/routerProvider.mjs",
178
+ "require": "./dist/cjs/routerProvider.js"
179
+ },
180
+ "default": "./dist/esm/routerProvider.mjs"
181
+ },
182
+ "./router-prefetch-policy": {
183
+ "types": "./dist/types/routerPrefetchPolicy.d.ts",
184
+ "node": {
185
+ "import": "./dist/esm-node/routerPrefetchPolicy.mjs",
186
+ "require": "./dist/cjs/routerPrefetchPolicy.js"
187
+ },
188
+ "default": "./dist/esm/routerPrefetchPolicy.mjs"
52
189
  }
53
190
  },
54
191
  "typesVersions": {
@@ -61,27 +198,115 @@
61
198
  "./dist/types/node.d.ts",
62
199
  "./src/node.ts"
63
200
  ],
64
- "rsc-html-stream": [
65
- "./dist/types/rscHtmlStream.d.ts",
66
- "./src/rscHtmlStream.ts"
67
- ],
68
201
  "safe-failure": [
69
202
  "./dist/types/safeFailure.d.ts",
70
203
  "./src/safeFailure.ts"
204
+ ],
205
+ "build-identity": [
206
+ "./dist/types/buildIdentity.d.ts",
207
+ "./src/buildIdentity.ts"
208
+ ],
209
+ "workspace-events": [
210
+ "./dist/types/workspaceEvents.d.ts",
211
+ "./src/workspaceEvents.ts"
212
+ ],
213
+ "localised-loader-identity": [
214
+ "./dist/types/localisedLoaderIdentity.d.ts",
215
+ "./src/localisedLoaderIdentity.ts"
216
+ ],
217
+ "react-context": [
218
+ "./dist/types/reactContext.d.ts",
219
+ "./src/reactContext.ts"
220
+ ],
221
+ "context-extensions": [
222
+ "./dist/types/contextExtensions.d.ts",
223
+ "./src/contextExtensions.ts"
224
+ ],
225
+ "helmet-context": [
226
+ "./dist/types/helmetContext.d.ts",
227
+ "./src/helmetContext.ts"
228
+ ],
229
+ "head-runtime": [
230
+ "./dist/types/headRuntime.d.ts",
231
+ "./src/headRuntime.tsx"
232
+ ],
233
+ "context-projection": [
234
+ "./dist/types/runtimeContextProjection.d.ts",
235
+ "./src/runtimeContextProjection.ts"
236
+ ],
237
+ "server-config": [
238
+ "./dist/types/server-config/index.d.ts",
239
+ "./src/server-config/index.ts"
240
+ ],
241
+ "router-state": [
242
+ "./dist/types/routerState.d.ts",
243
+ "./src/routerState.ts"
244
+ ],
245
+ "request-policy": [
246
+ "./dist/types/request-policy/browser.d.ts",
247
+ "./src/request-policy/browser.ts"
248
+ ],
249
+ "request-policy/client": [
250
+ "./dist/types/request-policy/browser.d.ts",
251
+ "./src/request-policy/browser.ts"
252
+ ],
253
+ "request-policy/server": [
254
+ "./dist/types/request-policy/node.d.ts",
255
+ "./src/request-policy/node.ts"
256
+ ],
257
+ "request-context": [
258
+ "./dist/types/request-policy/requestContext.d.ts",
259
+ "./src/request-policy/requestContext.ts"
260
+ ],
261
+ "router-state-plugin": [
262
+ "./dist/types/routerStatePlugin.d.ts",
263
+ "./src/routerStatePlugin.ts"
264
+ ],
265
+ "router-provider": [
266
+ "./dist/types/routerProvider.d.ts",
267
+ "./src/routerProvider.ts"
268
+ ],
269
+ "router-prefetch-policy": [
270
+ "./dist/types/routerPrefetchPolicy.d.ts",
271
+ "./src/routerPrefetchPolicy.ts"
71
272
  ]
72
273
  }
73
274
  },
74
275
  "devDependencies": {
276
+ "@loadable/component": "5.16.7",
277
+ "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.5",
278
+ "@rsbuild/core": "2.2.3",
75
279
  "@rslib/core": "1.0.0",
76
280
  "@scripts/rstest-config": "2.66.0",
281
+ "@testing-library/dom": "^10.4.1",
282
+ "@testing-library/react": "^16.3.3",
77
283
  "@types/node": "^26.4.1",
284
+ "@types/react": "^19.2.18",
285
+ "@types/react-dom": "^19.2.7",
78
286
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
287
+ "esbuild": "^0.28.2",
288
+ "nock": "^14.0.17",
289
+ "react": "^19.2.8",
290
+ "react-dom": "^19.2.8",
79
291
  "typescript": "^7.0.2"
80
292
  },
81
293
  "sideEffects": false,
82
294
  "publishConfig": {
83
295
  "access": "public"
84
296
  },
297
+ "peerDependencies": {
298
+ "react": "^19.2.8"
299
+ },
300
+ "peerDependenciesMeta": {
301
+ "react": {
302
+ "optional": true
303
+ }
304
+ },
305
+ "dependencies": {
306
+ "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.9.0-ultramodern.5",
307
+ "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.5",
308
+ "react-helmet-async": "3.0.0"
309
+ },
85
310
  "scripts": {
86
311
  "dev": "rslib build --watch",
87
312
  "build": "rslib build",