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

package/dist/cjs/routerProvider.js

@@ -30,10 +30,8 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     createRouterPlugin: ()=>createRouterPlugin,
     createRouterProviderRealm: ()=>createRouterProviderRealm,
-    registerRouterProvider: ()=>registerRouterProvider,
     reportUnsupportedProviderRegistryHooks: ()=>reportUnsupportedProviderRegistryHooks,
-    resolveRouterProvider: ()=>resolveRouterProvider,
-    unsafe_resetRouterProvidersForTesting: ()=>unsafe_resetRouterProvidersForTesting
+    resolveRouterProvider: ()=>resolveRouterProvider
 });
 const merge_namespaceObject = require("@modern-js/runtime-utils/merge");
 function reportUnsupportedProviderRegistryHooks(providerPlugin, routerProviderRegistryHooks) {
@@ -62,74 +60,15 @@ function createRouterProviderRealm(registrations) {
         names: ()=>providerNames
     });
 }
-const REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v3');
-const LEGACY_V2_REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v2');
-function getRegistry() {
-    const host = globalThis;
-    host[REGISTRY_SLOT] ??= {
-        providers: new Map(),
-        duplicateProviders: new Set(),
-        warnedDuplicates: new Set()
-    };
-    host[REGISTRY_SLOT].duplicateProviders ??= new Set();
-    host[REGISTRY_SLOT].warnedDuplicates ??= new Set();
-    return host[REGISTRY_SLOT];
-}
-function getLegacyV2Registry() {
-    const host = globalThis;
-    return host[LEGACY_V2_REGISTRY_SLOT];
-}
-function registerRouterProvider(name, factory, options = {}) {
-    const registry = getRegistry();
-    const existing = registry.providers.get(name);
-    if (void 0 !== existing) {
-        if (existing !== factory) registry.duplicateProviders.add(name);
-        return;
-    }
-    if (true === options.isDefault) registry.defaultProvider = name;
-    registry.providers.set(name, factory);
-}
-function resolveRouterProvider(framework, options = {}) {
-    if (void 0 !== options.realm) {
-        const name = framework || options.realm.defaultProvider;
-        const realmProviderNames = options.realm.names();
-        if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
-        const factory = options.realm.get(name);
-        if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}. Compatibility registry fallback is disabled for app-owned realms.`);
-        return factory;
-    }
-    const registry = getRegistry();
-    const legacyV2Registry = getLegacyV2Registry();
-    const name = framework || options.localDefault?.name || registry.defaultProvider || legacyV2Registry?.defaultProvider;
-    if (void 0 === name) throw new Error('[@modern-js/runtime] No default router provider is registered. This is a bug in the runtime setup.');
-    if (void 0 !== options.localDefault && name === options.localDefault.name) return options.localDefault.factory;
-    const factory = registry.providers.get(name);
-    if (void 0 !== factory) {
-        if (registry.duplicateProviders.has(name) && !registry.warnedDuplicates.has(name)) {
-            registry.warnedDuplicates.add(name);
-            console.warn(`[@modern-js/runtime] The router provider "${name}" was registered more than once with different module instances, and a router wrapper without an app-owned provider realm is resolving the mixed-version compatibility fallback. The fallback is keeping the first registration. Modern router wrappers isolate app-owned realms automatically. For an older wrapper, share the provider runtime between Module Federation host and remotes or upgrade every app to a realm-aware runtime.`);
-        }
-        return factory;
-    }
-    const legacyV2Factory = legacyV2Registry?.providers.get(name);
-    if (void 0 !== legacyV2Factory) return legacyV2Factory;
-    if ('tanstack' === name) throw new Error("[@modern-js/runtime] `runtime.router.framework` is set to \"tanstack\", but no TanStack router provider is registered. Install @modern-js/plugin-tanstack, add `tanstackRouterPlugin()` to the `plugins` array in modern.config.ts, and make sure '@modern-js/plugin-tanstack/runtime' is imported (e.g. in modern.runtime.ts).");
-    throw new Error(`[@modern-js/runtime] Unknown router framework "${name}". Registered providers: ${[
-        ...new Set([
-            ...registry.providers.keys(),
-            ...legacyV2Registry?.providers.keys() ?? []
-        ])
-    ].join(', ') || '(none)'}. Install and register the plugin that provides this router framework.`);
-}
-function unsafe_resetRouterProvidersForTesting() {
-    const host = globalThis;
-    delete host[REGISTRY_SLOT];
-    delete host[LEGACY_V2_REGISTRY_SLOT];
+function resolveRouterProvider(framework, options) {
+    const name = framework || options.realm.defaultProvider;
+    const realmProviderNames = options.realm.names();
+    if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    const factory = options.realm.get(name);
+    if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    return factory;
 }
 function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [] }) {
-    registerRouterProvider(defaultProvider.name, defaultProvider.factory, {
-        isDefault: true
-    });
     const realm = createRouterProviderRealm([
         {
             ...defaultProvider,
@@ -153,17 +92,13 @@ function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [
 }
 exports.createRouterPlugin = __webpack_exports__.createRouterPlugin;
 exports.createRouterProviderRealm = __webpack_exports__.createRouterProviderRealm;
-exports.registerRouterProvider = __webpack_exports__.registerRouterProvider;
 exports.reportUnsupportedProviderRegistryHooks = __webpack_exports__.reportUnsupportedProviderRegistryHooks;
 exports.resolveRouterProvider = __webpack_exports__.resolveRouterProvider;
-exports.unsafe_resetRouterProvidersForTesting = __webpack_exports__.unsafe_resetRouterProvidersForTesting;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "createRouterPlugin",
     "createRouterProviderRealm",
-    "registerRouterProvider",
     "reportUnsupportedProviderRegistryHooks",
-    "resolveRouterProvider",
-    "unsafe_resetRouterProvidersForTesting"
+    "resolveRouterProvider"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/esm/routerProvider.mjs

@@ -25,74 +25,15 @@ function createRouterProviderRealm(registrations) {
         names: ()=>providerNames
     });
 }
-const REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v3');
-const LEGACY_V2_REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v2');
-function getRegistry() {
-    const host = globalThis;
-    host[REGISTRY_SLOT] ??= {
-        providers: new Map(),
-        duplicateProviders: new Set(),
-        warnedDuplicates: new Set()
-    };
-    host[REGISTRY_SLOT].duplicateProviders ??= new Set();
-    host[REGISTRY_SLOT].warnedDuplicates ??= new Set();
-    return host[REGISTRY_SLOT];
-}
-function getLegacyV2Registry() {
-    const host = globalThis;
-    return host[LEGACY_V2_REGISTRY_SLOT];
-}
-function registerRouterProvider(name, factory, options = {}) {
-    const registry = getRegistry();
-    const existing = registry.providers.get(name);
-    if (void 0 !== existing) {
-        if (existing !== factory) registry.duplicateProviders.add(name);
-        return;
-    }
-    if (true === options.isDefault) registry.defaultProvider = name;
-    registry.providers.set(name, factory);
-}
-function resolveRouterProvider(framework, options = {}) {
-    if (void 0 !== options.realm) {
-        const name = framework || options.realm.defaultProvider;
-        const realmProviderNames = options.realm.names();
-        if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
-        const factory = options.realm.get(name);
-        if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}. Compatibility registry fallback is disabled for app-owned realms.`);
-        return factory;
-    }
-    const registry = getRegistry();
-    const legacyV2Registry = getLegacyV2Registry();
-    const name = framework || options.localDefault?.name || registry.defaultProvider || legacyV2Registry?.defaultProvider;
-    if (void 0 === name) throw new Error('[@modern-js/runtime] No default router provider is registered. This is a bug in the runtime setup.');
-    if (void 0 !== options.localDefault && name === options.localDefault.name) return options.localDefault.factory;
-    const factory = registry.providers.get(name);
-    if (void 0 !== factory) {
-        if (registry.duplicateProviders.has(name) && !registry.warnedDuplicates.has(name)) {
-            registry.warnedDuplicates.add(name);
-            console.warn(`[@modern-js/runtime] The router provider "${name}" was registered more than once with different module instances, and a router wrapper without an app-owned provider realm is resolving the mixed-version compatibility fallback. The fallback is keeping the first registration. Modern router wrappers isolate app-owned realms automatically. For an older wrapper, share the provider runtime between Module Federation host and remotes or upgrade every app to a realm-aware runtime.`);
-        }
-        return factory;
-    }
-    const legacyV2Factory = legacyV2Registry?.providers.get(name);
-    if (void 0 !== legacyV2Factory) return legacyV2Factory;
-    if ('tanstack' === name) throw new Error("[@modern-js/runtime] `runtime.router.framework` is set to \"tanstack\", but no TanStack router provider is registered. Install @modern-js/plugin-tanstack, add `tanstackRouterPlugin()` to the `plugins` array in modern.config.ts, and make sure '@modern-js/plugin-tanstack/runtime' is imported (e.g. in modern.runtime.ts).");
-    throw new Error(`[@modern-js/runtime] Unknown router framework "${name}". Registered providers: ${[
-        ...new Set([
-            ...registry.providers.keys(),
-            ...legacyV2Registry?.providers.keys() ?? []
-        ])
-    ].join(', ') || '(none)'}. Install and register the plugin that provides this router framework.`);
-}
-function unsafe_resetRouterProvidersForTesting() {
-    const host = globalThis;
-    delete host[REGISTRY_SLOT];
-    delete host[LEGACY_V2_REGISTRY_SLOT];
+function resolveRouterProvider(framework, options) {
+    const name = framework || options.realm.defaultProvider;
+    const realmProviderNames = options.realm.names();
+    if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    const factory = options.realm.get(name);
+    if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    return factory;
 }
 function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [] }) {
-    registerRouterProvider(defaultProvider.name, defaultProvider.factory, {
-        isDefault: true
-    });
     const realm = createRouterProviderRealm([
         {
             ...defaultProvider,
@@ -114,4 +55,4 @@ function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [
             }
         });
 }
-export { createRouterPlugin, createRouterProviderRealm, registerRouterProvider, reportUnsupportedProviderRegistryHooks, resolveRouterProvider, unsafe_resetRouterProvidersForTesting };
+export { createRouterPlugin, createRouterProviderRealm, reportUnsupportedProviderRegistryHooks, resolveRouterProvider };

package/dist/esm-node/routerProvider.mjs

@@ -26,74 +26,15 @@ function createRouterProviderRealm(registrations) {
         names: ()=>providerNames
     });
 }
-const REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v3');
-const LEGACY_V2_REGISTRY_SLOT = Symbol.for('@modern-js/runtime:router-providers:v2');
-function getRegistry() {
-    const host = globalThis;
-    host[REGISTRY_SLOT] ??= {
-        providers: new Map(),
-        duplicateProviders: new Set(),
-        warnedDuplicates: new Set()
-    };
-    host[REGISTRY_SLOT].duplicateProviders ??= new Set();
-    host[REGISTRY_SLOT].warnedDuplicates ??= new Set();
-    return host[REGISTRY_SLOT];
-}
-function getLegacyV2Registry() {
-    const host = globalThis;
-    return host[LEGACY_V2_REGISTRY_SLOT];
-}
-function registerRouterProvider(name, factory, options = {}) {
-    const registry = getRegistry();
-    const existing = registry.providers.get(name);
-    if (void 0 !== existing) {
-        if (existing !== factory) registry.duplicateProviders.add(name);
-        return;
-    }
-    if (true === options.isDefault) registry.defaultProvider = name;
-    registry.providers.set(name, factory);
-}
-function resolveRouterProvider(framework, options = {}) {
-    if (void 0 !== options.realm) {
-        const name = framework || options.realm.defaultProvider;
-        const realmProviderNames = options.realm.names();
-        if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
-        const factory = options.realm.get(name);
-        if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}. Compatibility registry fallback is disabled for app-owned realms.`);
-        return factory;
-    }
-    const registry = getRegistry();
-    const legacyV2Registry = getLegacyV2Registry();
-    const name = framework || options.localDefault?.name || registry.defaultProvider || legacyV2Registry?.defaultProvider;
-    if (void 0 === name) throw new Error('[@modern-js/runtime] No default router provider is registered. This is a bug in the runtime setup.');
-    if (void 0 !== options.localDefault && name === options.localDefault.name) return options.localDefault.factory;
-    const factory = registry.providers.get(name);
-    if (void 0 !== factory) {
-        if (registry.duplicateProviders.has(name) && !registry.warnedDuplicates.has(name)) {
-            registry.warnedDuplicates.add(name);
-            console.warn(`[@modern-js/runtime] The router provider "${name}" was registered more than once with different module instances, and a router wrapper without an app-owned provider realm is resolving the mixed-version compatibility fallback. The fallback is keeping the first registration. Modern router wrappers isolate app-owned realms automatically. For an older wrapper, share the provider runtime between Module Federation host and remotes or upgrade every app to a realm-aware runtime.`);
-        }
-        return factory;
-    }
-    const legacyV2Factory = legacyV2Registry?.providers.get(name);
-    if (void 0 !== legacyV2Factory) return legacyV2Factory;
-    if ('tanstack' === name) throw new Error("[@modern-js/runtime] `runtime.router.framework` is set to \"tanstack\", but no TanStack router provider is registered. Install @modern-js/plugin-tanstack, add `tanstackRouterPlugin()` to the `plugins` array in modern.config.ts, and make sure '@modern-js/plugin-tanstack/runtime' is imported (e.g. in modern.runtime.ts).");
-    throw new Error(`[@modern-js/runtime] Unknown router framework "${name}". Registered providers: ${[
-        ...new Set([
-            ...registry.providers.keys(),
-            ...legacyV2Registry?.providers.keys() ?? []
-        ])
-    ].join(', ') || '(none)'}. Install and register the plugin that provides this router framework.`);
-}
-function unsafe_resetRouterProvidersForTesting() {
-    const host = globalThis;
-    delete host[REGISTRY_SLOT];
-    delete host[LEGACY_V2_REGISTRY_SLOT];
+function resolveRouterProvider(framework, options) {
+    const name = framework || options.realm.defaultProvider;
+    const realmProviderNames = options.realm.names();
+    if (void 0 === name) throw new Error(`[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    const factory = options.realm.get(name);
+    if (void 0 === factory) throw new Error(`[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. Available realm providers: ${realmProviderNames.join(', ') || '(none)'}.`);
+    return factory;
 }
 function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [] }) {
-    registerRouterProvider(defaultProvider.name, defaultProvider.factory, {
-        isDefault: true
-    });
     const realm = createRouterProviderRealm([
         {
             ...defaultProvider,
@@ -115,4 +56,4 @@ function createRouterPlugin({ defaultProvider, registryHooks, localProviders = [
             }
         });
 }
-export { createRouterPlugin, createRouterProviderRealm, registerRouterProvider, reportUnsupportedProviderRegistryHooks, resolveRouterProvider, unsafe_resetRouterProvidersForTesting };
+export { createRouterPlugin, createRouterProviderRealm, reportUnsupportedProviderRegistryHooks, resolveRouterProvider };

package/dist/types/routerProvider.d.ts

@@ -32,31 +32,9 @@ export type RouterProviderRealm = Readonly<{
     names: () => readonly string[];
 }>;
 export declare function createRouterProviderRealm(registrations: readonly RouterProviderRegistration[]): RouterProviderRealm;
-export declare function registerRouterProvider(name: string, factory: RouterProviderFactory, options?: {
-    isDefault?: boolean;
-}): void;
-export declare function resolveRouterProvider(framework?: string, options?: {
-    /**
-     * Provider factories owned by the resolving app/runtime wrapper. A realm
-     * is the exclusive provider source when supplied because its factories
-     * close over the correct app module graph.
-     */
-    realm?: RouterProviderRealm;
-    /**
-     * Legacy single-provider override retained for published wrappers. New
-     * integrations should pass an app-owned `realm`, which supports every
-     * provider rather than only the default.
-     */
-    localDefault?: {
-        name: string;
-        factory: RouterProviderFactory;
-    };
+export declare function resolveRouterProvider(framework: string | undefined, options: {
+    realm: RouterProviderRealm;
 }): RouterProviderFactory;
-/**
- * Test-only escape hatch: compatibility registries live on `globalThis`, so
- * unit tests need a way to restore a pristine state between cases.
- */
-export declare function unsafe_resetRouterProvidersForTesting(): void;
 /** Compose app-owned providers without importing the native runtime graph. */
 export declare function createRouterPlugin<Hooks extends Record<string, unknown>>({ defaultProvider, registryHooks, localProviders, }: {
     defaultProvider: {

package/dist/types/server-config/bffRuntime.d.ts

@@ -109,10 +109,10 @@ export interface BffEffectUserConfig {
     /**
      * Enforce Effect-native API/runtime modules instead of raw request handlers.
      *
-     * When enabled, Effect API entries must export a `defineEffectBff(...)`
+     * Effect API entries must export a `defineEffectBff(...)`
      * definition or a `{ api, layer }` HttpApi module. Raw `handler` exports,
      * default request handlers, and unbranded custom `createHandler` factories
-     * are treated as legacy escape hatches.
+     * are rejected.
      *
      * @default true
      */

package/dist/types/server-config/serverTelemetry.d.ts

@@ -27,17 +27,17 @@ export interface ServerTelemetrySloUserConfig {
      */
     alertCooldownMs?: number;
 }
-export interface ServerTelemetryCanaryContractGateUserConfig {
+export interface ServerTelemetryHealthContractGateUserConfig {
     /**
      * Whether this contract gate currently passes.
      */
     passed: boolean;
     /**
-     * Optional failure reason used for rollback diagnostics.
+     * Optional failure reason used for health diagnostics.
      */
     reason?: string;
 }
-export interface ServerTelemetryCanaryAutopilotUserConfig {
+export interface ServerTelemetrySnapshotObservationUserConfig {
     /**
      * Enable automatic contract gate synchronization from a gate snapshot file.
      *
@@ -65,14 +65,14 @@ export interface ServerTelemetryCanaryAutopilotUserConfig {
     /**
      * Runtime MF fallback signal ingestion.
      */
-    runtimeFallbackSignal?: ServerTelemetryCanaryRuntimeFallbackSignalUserConfig;
+    runtimeFallbackSignal?: ServerTelemetryHealthRuntimeFallbackSignalUserConfig;
     /**
      * Optional pluggable state store backend for contract gate snapshots.
      * When omitted, snapshots are read/written from gateSnapshotPath on local disk.
      */
-    stateStore?: ServerTelemetryCanaryAutopilotStateStoreUserConfig;
+    stateStore?: ServerTelemetrySnapshotObservationStateStoreUserConfig;
 }
-export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
+export interface ServerTelemetrySnapshotObservationStateStoreUserConfig {
     /**
      * Path or package name of a module that exports
      * `createContractGateSnapshotStore(context)`.
@@ -83,7 +83,7 @@ export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
      */
     options?: Record<string, unknown>;
 }
-export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalUserConfig {
     /**
      * Enable runtime MF fallback signal ingestion endpoint.
      *
@@ -119,15 +119,15 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
     maxBodyBytes?: number;
     /**
      * Optional runtime trust policy for fallback signal ingestion.
-     * Use this to restrict who can mutate canary contract gates.
+     * Use this to restrict who can mutate health contract gates.
      */
-    trustPolicy?: ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig;
+    trustPolicy?: ServerTelemetryHealthRuntimeFallbackSignalTrustPolicyUserConfig;
     /**
      * Optional request authentication for runtime fallback signal endpoint.
      */
-    auth?: ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig;
+    auth?: ServerTelemetryHealthRuntimeFallbackSignalAuthUserConfig;
 }
-export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalAuthUserConfig {
     /**
      * Enable auth guard for runtime fallback signal endpoint.
      *
@@ -149,7 +149,7 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
      */
     expectedValueEnv?: string;
 }
-export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalTrustPolicyUserConfig {
     /**
      * Allowlist of app names accepted by runtime fallback signal endpoint.
      * Empty means no app-name allowlist check.
@@ -190,58 +190,58 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig
      */
     dedupeWindowMs?: number;
 }
-export interface ServerTelemetryCanaryUserConfig {
+export interface ServerTelemetryHealthUserConfig {
     /**
-     * Enable canary rollout/rollback orchestration.
+     * Enable telemetry health observation.
      *
      * @default false
      */
     enabled?: boolean;
     /**
-     * Periodic canary evaluation interval in milliseconds.
+     * Periodic health evaluation interval in milliseconds.
      *
      * @default 15000
      */
     evaluationIntervalMs?: number;
     /**
-     * Required consecutive healthy evaluations before promotion.
+     * Required consecutive healthy evaluations before reporting healthy.
      *
      * @default 3
      */
     minConsecutiveHealthyEvaluations?: number;
     /**
-     * Consecutive failing evaluations before automated rollback.
+     * Consecutive failing evaluations before reporting unhealthy.
      *
      * @default 2
      */
-    rollbackConsecutiveFailures?: number;
+    minConsecutiveFailedEvaluations?: number;
     /**
-     * Maximum queue utilization ratio allowed during canary.
+     * Maximum queue utilization ratio allowed for healthy telemetry.
      *
      * @default 0.8
      */
     maxQueueUtilization?: number;
     /**
-     * Maximum allowed total dropped envelopes during canary.
+     * Maximum allowed total dropped envelopes for healthy telemetry.
      *
      * @default 0
      */
     maxTotalDropped?: number;
     /**
-     * Maximum allowed unhealthy exporters during canary.
+     * Maximum allowed unhealthy exporters for healthy telemetry.
      *
      * @default 0
      */
     maxUnhealthyExporters?: number;
     /**
-     * Contract gate map used in rollout decisions.
+     * Contract gate map used in health evaluations.
      * `true` means passing, `false` means failing.
      */
-    contractGates?: Record<string, boolean | ServerTelemetryCanaryContractGateUserConfig>;
+    contractGates?: Record<string, boolean | ServerTelemetryHealthContractGateUserConfig>;
     /**
-     * Contract-gate autopilot settings.
+     * Contract-gate snapshot observation settings.
      */
-    autopilot?: ServerTelemetryCanaryAutopilotUserConfig;
+    snapshotObservation?: ServerTelemetrySnapshotObservationUserConfig;
 }
 export interface ServerTelemetryConfigExtension {
     telemetry?: ServerTelemetryUserConfig;
@@ -306,9 +306,9 @@ export interface ServerTelemetryUserConfig {
      */
     slo?: ServerTelemetrySloUserConfig;
     /**
-     * Canary rollout and automated rollback orchestration policy.
+     * Telemetry health observation policy.
      */
-    canary?: ServerTelemetryCanaryUserConfig;
+    health?: ServerTelemetryHealthUserConfig;
     exporters?: {
         /**
          * OpenTelemetry HTTP exporter.

package/package.json

@@ -11,7 +11,7 @@
     "directory": "packages/runtime/runtime-extensions"
   },
   "license": "MIT",
-  "version": "3.9.0-ultramodern.5",
+  "version": "3.9.0-ultramodern.6",
   "engines": {
     "node": ">=26.7.0"
   },
@@ -274,7 +274,7 @@
   },
   "devDependencies": {
     "@loadable/component": "5.16.7",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.5",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.6",
     "@rsbuild/core": "2.2.3",
     "@rslib/core": "1.0.0",
     "@scripts/rstest-config": "2.66.0",
@@ -303,8 +303,8 @@
     }
   },
   "dependencies": {
-    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.9.0-ultramodern.5",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.5",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.9.0-ultramodern.6",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.6",
     "react-helmet-async": "3.0.0"
   },
   "scripts": {

package/src/routerProvider.ts

@@ -97,209 +97,32 @@ export function createRouterProviderRealm(
   });
 }
 
-type RouterProviderRegistry = {
-  providers: Map<string, RouterProviderFactory>;
-  defaultProvider?: string;
-  /** Names that were registered by more than one module instance. */
-  duplicateProviders: Set<string>;
-  /** Duplicate names already reported when the compatibility fallback won. */
-  warnedDuplicates: Set<string>;
-};
-
-/**
- * Versioned compatibility-registry key. The unsuffixed key
- * ('@modern-js/runtime:router-providers') is owned by older published copies
- * of this module whose `registerRouterProvider` *throws* on a same-name
- * re-registration. `:v2` added keep-first registration but also enforced one
- * non-default provider across the whole JavaScript realm. `:v3` removes that
- * page-global app invariant: explicit runtime realms own provider selection,
- * while this registry remains only a mixed-version fallback. New copies read
- * but never mutate the v2 slot so older published copies remain compatible.
- */
-const REGISTRY_SLOT: unique symbol = Symbol.for(
-  '@modern-js/runtime:router-providers:v3',
-);
-const LEGACY_V2_REGISTRY_SLOT: unique symbol = Symbol.for(
-  '@modern-js/runtime:router-providers:v2',
-);
-
-function getRegistry(): RouterProviderRegistry {
-  const host = globalThis as { [REGISTRY_SLOT]?: RouterProviderRegistry };
-  host[REGISTRY_SLOT] ??= {
-    providers: new Map(),
-    duplicateProviders: new Set(),
-    warnedDuplicates: new Set(),
-  };
-  // Defense in depth within the v3 key: if a future v3-keyed copy of this
-  // module ever predates a later-added field (mixed v3 minors in a Module
-  // Federation setup), heal the shape instead of crashing on `undefined`.
-  host[REGISTRY_SLOT].duplicateProviders ??= new Set();
-  host[REGISTRY_SLOT].warnedDuplicates ??= new Set();
-  return host[REGISTRY_SLOT];
-}
-
-function getLegacyV2Registry():
-  | Pick<RouterProviderRegistry, 'providers' | 'defaultProvider'>
-  | undefined {
-  const host = globalThis as {
-    [LEGACY_V2_REGISTRY_SLOT]?: Pick<
-      RouterProviderRegistry,
-      'providers' | 'defaultProvider'
-    >;
-  };
-  return host[LEGACY_V2_REGISTRY_SLOT];
-}
-
-export function registerRouterProvider(
-  name: string,
-  factory: RouterProviderFactory,
-  options: { isDefault?: boolean } = {},
-): void {
-  const registry = getRegistry();
-  const existing = registry.providers.get(name);
-
-  if (existing !== undefined) {
-    // Keep-first semantics. A same-name re-registration with a *different*
-    // factory is almost always two bundled copies of the same provider
-    // module — e.g. a Module Federation remote that does not share
-    // '@modern-js/plugin-tanstack/runtime' evaluates its own copy, which
-    // creates a fresh factory function per evaluation. That must not crash
-    // the app; the first registration remains available for compatibility.
-    // Merely loading independent app-owned realms is valid, so defer the
-    // warning until a caller actually consumes this ambiguous fallback.
-    if (existing !== factory) {
-      registry.duplicateProviders.add(name);
-    }
-    return;
-  }
-
-  if (options.isDefault === true) {
-    registry.defaultProvider = name;
-  }
-
-  registry.providers.set(name, factory);
-}
-
 export function resolveRouterProvider(
-  framework?: string,
-  options: {
-    /**
-     * Provider factories owned by the resolving app/runtime wrapper. A realm
-     * is the exclusive provider source when supplied because its factories
-     * close over the correct app module graph.
-     */
-    realm?: RouterProviderRealm;
-    /**
-     * Legacy single-provider override retained for published wrappers. New
-     * integrations should pass an app-owned `realm`, which supports every
-     * provider rather than only the default.
-     */
-    localDefault?: { name: string; factory: RouterProviderFactory };
-  } = {},
+  framework: string | undefined,
+  options: { realm: RouterProviderRealm },
 ): RouterProviderFactory {
-  if (options.realm !== undefined) {
-    const name = framework || options.realm.defaultProvider;
-    const realmProviderNames = options.realm.names();
-
-    if (name === undefined) {
-      throw new Error(
-        `[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${
-          realmProviderNames.join(', ') || '(none)'
-        }.`,
-      );
-    }
-
-    const factory = options.realm.get(name);
-    if (factory === undefined) {
-      throw new Error(
-        `[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. ` +
-          `Available realm providers: ${
-            realmProviderNames.join(', ') || '(none)'
-          }. Compatibility registry fallback is disabled for app-owned realms.`,
-      );
-    }
-
-    return factory;
-  }
-
-  const registry = getRegistry();
-  const legacyV2Registry = getLegacyV2Registry();
-  // `||` on purpose: a falsy framework value (empty string from env
-  // templating, `false`, `undefined`) falls back to the default provider
-  // instead of erroring on an unknown framework "". Prefer the older
-  // localDefault contract before compatibility slots.
-  const name =
-    framework ||
-    options.localDefault?.name ||
-    registry.defaultProvider ||
-    legacyV2Registry?.defaultProvider;
+  const name = framework || options.realm.defaultProvider;
+  const realmProviderNames = options.realm.names();
 
   if (name === undefined) {
     throw new Error(
-      '[@modern-js/runtime] No default router provider is registered. This is a bug in the runtime setup.',
+      `[@modern-js/runtime] The app-owned router provider realm does not declare a default provider. Available realm providers: ${
+        realmProviderNames.join(', ') || '(none)'
+      }.`,
     );
   }
 
-  if (
-    options.localDefault !== undefined &&
-    name === options.localDefault.name
-  ) {
-    return options.localDefault.factory;
-  }
-
-  const factory = registry.providers.get(name);
-  if (factory !== undefined) {
-    if (
-      registry.duplicateProviders.has(name) &&
-      !registry.warnedDuplicates.has(name)
-    ) {
-      registry.warnedDuplicates.add(name);
-      console.warn(
-        `[@modern-js/runtime] The router provider "${name}" was registered more than once with different module instances, and a router wrapper without an app-owned provider realm is resolving the mixed-version compatibility fallback. The fallback is keeping the first registration. ` +
-          'Modern router wrappers isolate app-owned realms automatically. ' +
-          'For an older wrapper, share the provider runtime between Module Federation host and remotes or upgrade every app to a realm-aware runtime.',
-      );
-    }
-    return factory;
-  }
-
-  const legacyV2Factory = legacyV2Registry?.providers.get(name);
-  if (legacyV2Factory !== undefined) {
-    return legacyV2Factory;
-  }
-
-  if (name === 'tanstack') {
+  const factory = options.realm.get(name);
+  if (factory === undefined) {
     throw new Error(
-      '[@modern-js/runtime] `runtime.router.framework` is set to "tanstack", but no TanStack router provider is registered. ' +
-        'Install @modern-js/plugin-tanstack, add `tanstackRouterPlugin()` to the `plugins` array in modern.config.ts, ' +
-        "and make sure '@modern-js/plugin-tanstack/runtime' is imported (e.g. in modern.runtime.ts).",
+      `[@modern-js/runtime] Router provider "${name}" is not registered in the app-owned router provider realm. ` +
+        `Available realm providers: ${
+          realmProviderNames.join(', ') || '(none)'
+        }.`,
     );
   }
 
-  throw new Error(
-    `[@modern-js/runtime] Unknown router framework "${name}". ` +
-      `Registered providers: ${
-        [
-          ...new Set([
-            ...registry.providers.keys(),
-            ...(legacyV2Registry?.providers.keys() ?? []),
-          ]),
-        ].join(', ') || '(none)'
-      }. Install and register the plugin that provides this router framework.`,
-  );
-}
-
-/**
- * Test-only escape hatch: compatibility registries live on `globalThis`, so
- * unit tests need a way to restore a pristine state between cases.
- */
-export function unsafe_resetRouterProvidersForTesting(): void {
-  const host = globalThis as {
-    [REGISTRY_SLOT]?: RouterProviderRegistry;
-    [LEGACY_V2_REGISTRY_SLOT]?: unknown;
-  };
-  delete host[REGISTRY_SLOT];
-  delete host[LEGACY_V2_REGISTRY_SLOT];
+  return factory;
 }
 
 /** Compose app-owned providers without importing the native runtime graph. */
@@ -312,9 +135,6 @@ export function createRouterPlugin<Hooks extends Record<string, unknown>>({
   registryHooks: Hooks;
   localProviders?: readonly Omit<RouterProviderRegistration, 'isDefault'>[];
 }) {
-  registerRouterProvider(defaultProvider.name, defaultProvider.factory, {
-    isDefault: true,
-  });
   const realm = createRouterProviderRealm([
     { ...defaultProvider, isDefault: true },
     ...localProviders,

package/src/server-config/bffRuntime.ts

@@ -123,10 +123,10 @@ export interface BffEffectUserConfig {
   /**
    * Enforce Effect-native API/runtime modules instead of raw request handlers.
    *
-   * When enabled, Effect API entries must export a `defineEffectBff(...)`
+   * Effect API entries must export a `defineEffectBff(...)`
    * definition or a `{ api, layer }` HttpApi module. Raw `handler` exports,
    * default request handlers, and unbranded custom `createHandler` factories
-   * are treated as legacy escape hatches.
+   * are rejected.
    *
    * @default true
    */

package/src/server-config/serverTelemetry.ts

@@ -31,18 +31,18 @@ export interface ServerTelemetrySloUserConfig {
   alertCooldownMs?: number;
 }
 
-export interface ServerTelemetryCanaryContractGateUserConfig {
+export interface ServerTelemetryHealthContractGateUserConfig {
   /**
    * Whether this contract gate currently passes.
    */
   passed: boolean;
   /**
-   * Optional failure reason used for rollback diagnostics.
+   * Optional failure reason used for health diagnostics.
    */
   reason?: string;
 }
 
-export interface ServerTelemetryCanaryAutopilotUserConfig {
+export interface ServerTelemetrySnapshotObservationUserConfig {
   /**
    * Enable automatic contract gate synchronization from a gate snapshot file.
    *
@@ -70,15 +70,15 @@ export interface ServerTelemetryCanaryAutopilotUserConfig {
   /**
    * Runtime MF fallback signal ingestion.
    */
-  runtimeFallbackSignal?: ServerTelemetryCanaryRuntimeFallbackSignalUserConfig;
+  runtimeFallbackSignal?: ServerTelemetryHealthRuntimeFallbackSignalUserConfig;
   /**
    * Optional pluggable state store backend for contract gate snapshots.
    * When omitted, snapshots are read/written from gateSnapshotPath on local disk.
    */
-  stateStore?: ServerTelemetryCanaryAutopilotStateStoreUserConfig;
+  stateStore?: ServerTelemetrySnapshotObservationStateStoreUserConfig;
 }
 
-export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
+export interface ServerTelemetrySnapshotObservationStateStoreUserConfig {
   /**
    * Path or package name of a module that exports
    * `createContractGateSnapshotStore(context)`.
@@ -90,7 +90,7 @@ export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
   options?: Record<string, unknown>;
 }
 
-export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalUserConfig {
   /**
    * Enable runtime MF fallback signal ingestion endpoint.
    *
@@ -126,16 +126,16 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
   maxBodyBytes?: number;
   /**
    * Optional runtime trust policy for fallback signal ingestion.
-   * Use this to restrict who can mutate canary contract gates.
+   * Use this to restrict who can mutate health contract gates.
    */
-  trustPolicy?: ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig;
+  trustPolicy?: ServerTelemetryHealthRuntimeFallbackSignalTrustPolicyUserConfig;
   /**
    * Optional request authentication for runtime fallback signal endpoint.
    */
-  auth?: ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig;
+  auth?: ServerTelemetryHealthRuntimeFallbackSignalAuthUserConfig;
 }
 
-export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalAuthUserConfig {
   /**
    * Enable auth guard for runtime fallback signal endpoint.
    *
@@ -158,7 +158,7 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
   expectedValueEnv?: string;
 }
 
-export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig {
+export interface ServerTelemetryHealthRuntimeFallbackSignalTrustPolicyUserConfig {
   /**
    * Allowlist of app names accepted by runtime fallback signal endpoint.
    * Empty means no app-name allowlist check.
@@ -200,61 +200,61 @@ export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig
   dedupeWindowMs?: number;
 }
 
-export interface ServerTelemetryCanaryUserConfig {
+export interface ServerTelemetryHealthUserConfig {
   /**
-   * Enable canary rollout/rollback orchestration.
+   * Enable telemetry health observation.
    *
    * @default false
    */
   enabled?: boolean;
   /**
-   * Periodic canary evaluation interval in milliseconds.
+   * Periodic health evaluation interval in milliseconds.
    *
    * @default 15000
    */
   evaluationIntervalMs?: number;
   /**
-   * Required consecutive healthy evaluations before promotion.
+   * Required consecutive healthy evaluations before reporting healthy.
    *
    * @default 3
    */
   minConsecutiveHealthyEvaluations?: number;
   /**
-   * Consecutive failing evaluations before automated rollback.
+   * Consecutive failing evaluations before reporting unhealthy.
    *
    * @default 2
    */
-  rollbackConsecutiveFailures?: number;
+  minConsecutiveFailedEvaluations?: number;
   /**
-   * Maximum queue utilization ratio allowed during canary.
+   * Maximum queue utilization ratio allowed for healthy telemetry.
    *
    * @default 0.8
    */
   maxQueueUtilization?: number;
   /**
-   * Maximum allowed total dropped envelopes during canary.
+   * Maximum allowed total dropped envelopes for healthy telemetry.
    *
    * @default 0
    */
   maxTotalDropped?: number;
   /**
-   * Maximum allowed unhealthy exporters during canary.
+   * Maximum allowed unhealthy exporters for healthy telemetry.
    *
    * @default 0
    */
   maxUnhealthyExporters?: number;
   /**
-   * Contract gate map used in rollout decisions.
+   * Contract gate map used in health evaluations.
    * `true` means passing, `false` means failing.
    */
   contractGates?: Record<
     string,
-    boolean | ServerTelemetryCanaryContractGateUserConfig
+    boolean | ServerTelemetryHealthContractGateUserConfig
   >;
   /**
-   * Contract-gate autopilot settings.
+   * Contract-gate snapshot observation settings.
    */
-  autopilot?: ServerTelemetryCanaryAutopilotUserConfig;
+  snapshotObservation?: ServerTelemetrySnapshotObservationUserConfig;
 }
 
 export interface ServerTelemetryConfigExtension {
@@ -321,9 +321,9 @@ export interface ServerTelemetryUserConfig {
    */
   slo?: ServerTelemetrySloUserConfig;
   /**
-   * Canary rollout and automated rollback orchestration policy.
+   * Telemetry health observation policy.
    */
-  canary?: ServerTelemetryCanaryUserConfig;
+  health?: ServerTelemetryHealthUserConfig;
   exporters?: {
     /**
      * OpenTelemetry HTTP exporter.

package/tests/routerProvider.test.ts

@@ -1,10 +1,4 @@
-import {
-  createRouterPlugin,
-  registerRouterProvider,
-  unsafe_resetRouterProvidersForTesting,
-} from '../src/routerProvider';
-
-afterEach(() => unsafe_resetRouterProvidersForTesting());
+import { createRouterPlugin } from '../src/routerProvider';
 
 test('selects the injected app-local factory from runtime config and preserves native hook objects', () => {
   const registryHooks = { afterCreate: { call() {} } };
@@ -24,9 +18,7 @@ test('selects the injected app-local factory from runtime config and preserves n
   expect(defaultFactory).not.toHaveBeenCalled();
 });
 
-test('does not resolve missing local providers through the global compatibility registry', () => {
-  const foreign = rstest.fn(() => ({}));
-  registerRouterProvider('foreign', foreign);
+test('rejects missing local providers', () => {
   const factory = createRouterPlugin({
     defaultProvider: { name: 'native', factory: () => ({}) },
     registryHooks: {},
@@ -34,5 +26,4 @@ test('does not resolve missing local providers through the global compatibility
   expect(() =>
     factory({ framework: 'foreign' }).setup({ getRuntimeConfig: () => ({}) }),
   ).toThrow(/app-owned router provider realm/);
-  expect(foreign).not.toHaveBeenCalled();
 });