@bleedingdev/modern-js-federation-runtime 3.9.3-ultramodern.7 → 3.9.3-ultramodern.9

package/dist/types/module-federation/native-browser-dev-refresh.d.ts

@@ -0,0 +1,86 @@
+/** The normal MF instance surface used by a browser development replacement. */
+export interface NativeBrowserDevHost {
+    readonly name: string;
+    readonly options: Readonly<Record<string, unknown>>;
+    readonly shareScopeMap: Record<string, Record<string, Record<string, Shared>>>;
+    readonly moduleCache: Map<string, unknown>;
+    readonly loaderHook?: {
+        readonly lifecycle: {
+            readonly fetch: {
+                emit(url: string, init: RequestInit, remote: unknown, context: {
+                    readonly initiator: 'loadRemote';
+                    readonly id: string;
+                    readonly resourceType: 'manifest';
+                    readonly url: string;
+                }): Promise<unknown>;
+            };
+        };
+    };
+    initShareScopeMap(name: string, scope: Record<string, Record<string, Shared>>, options: {
+        hostShareScopeMap: NativeBrowserDevHost['shareScopeMap'];
+    }): void;
+    loadRemote<T>(id: string, options: {
+        loadFactory: false;
+    }): Promise<T | null>;
+}
+interface Shared {
+    readonly loaded?: boolean;
+    readonly loading?: unknown;
+    readonly lib?: unknown;
+    readonly get?: unknown;
+}
+export interface NativeBrowserDevGraph {
+    /** Existing completed graph revision, also used in immutable asset URLs. */
+    readonly revision: string;
+    /** Native JSON manifest whose entry AND chunks belong to this revision. */
+    readonly remote: Readonly<{
+        name: string;
+        alias: string;
+        entry: string;
+    }>;
+}
+interface StagingHost {
+    readonly host: NativeBrowserDevHost;
+    /** Rearm cached, unexecuted runtime hot listeners without starting a socket. */
+    prepareFactory?(): void;
+    /** Retire only this attempt's transport/listeners; never shared providers. */
+    release(): void;
+}
+interface PublisherReplacement {
+    readonly commitStarted: boolean;
+    execute<T>(factory: () => T): T;
+}
+declare const COMMIT_ERROR: unique symbol;
+/** Propagates an observed native mutation; it does not grant native authority. */
+declare class NativeBrowserDevCommitError extends Error {
+    readonly [COMMIT_ERROR] = true;
+    readonly revision: string;
+    constructor(revision: string, cause: unknown);
+}
+/** A remote runtime can receive this error from a different host runtime copy. */
+export declare function isNativeBrowserDevCommitError(error: unknown, revision: string): error is NativeBrowserDevCommitError;
+/** Trusted coordinators use this only after observing an actual native commit. */
+export declare function nativeBrowserDevCommitFailure(revision: string, cause: unknown): Error;
+/**
+ * Load a new container without evicting the working host. MF admission and async
+ * chunk loading finish before Octane executes the synchronous exposed graph.
+ * Native execution owns declaration rollback and retirement of the old graph.
+ * It cannot undo arbitrary module side effects or the browser's ESM cache: a
+ * consumed, failed graph needs a newer completed revision for another attempt.
+ *
+ * The compiler supplies a public ModuleFederation constructor adapter and an
+ * attempt-owned transport release function. No global MF cache is deleted here.
+ */
+export declare function createNativeBrowserDevRefresh<Boundary>(options: {
+    readonly host: NativeBrowserDevHost;
+    readonly id: string;
+    readonly boundary: Boundary;
+    readonly prepareReplacement: (boundary: Boundary) => PublisherReplacement;
+    readonly createHost: (options: Readonly<Record<string, unknown>>) => StagingHost;
+}): {
+    replace<T>(graph: NativeBrowserDevGraph): Promise<T>;
+    /** The original host remains untouched, including sibling remote loaders. */
+    readonly activeHost: NativeBrowserDevHost;
+    dispose(): void;
+};
+export {};

package/dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts

@@ -0,0 +1,40 @@
+import { createNativeBrowserDevRefresh, type NativeBrowserDevGraph, type NativeBrowserDevHost } from './native-browser-dev-refresh.js';
+export declare const NATIVE_BROWSER_DEV_BOUNDARY: unique symbol;
+interface Replacement {
+    readonly commitStarted: boolean;
+    execute<T>(factory: () => T): T;
+}
+interface Reference {
+    readonly host: NativeBrowserDevHost;
+    readonly remote: NativeBrowserDevGraph['remote'];
+    readonly boundary: object;
+    readonly prepare: (boundary: object) => Replacement;
+}
+/**
+ * This registry routes work to actual mounted boundary references; its names
+ * grant no native authority. Octane revalidates the exact compiled root, lease,
+ * physical document and every surviving owner inside the opaque capability.
+ */
+export declare function createNativeBrowserDevRuntimePlugin(options: {
+    readonly remotes: readonly NativeBrowserDevGraph['remote'][];
+    readonly prepareReplacement: Reference['prepare'];
+    readonly createHost: Parameters<typeof createNativeBrowserDevRefresh>[0]['createHost'];
+}): {
+    name: string;
+    beforeInit<T extends {
+        origin: NativeBrowserDevHost;
+    }>(args: T): T;
+};
+/** One synchronous exposed graph execution serves all of its mounted instances. */
+export declare function replaceNativeBrowserDevRemote(graph: NativeBrowserDevGraph): Promise<number>;
+export interface NativeBrowserDevPublication extends NativeBrowserDevGraph {
+    readonly buildId: string;
+    readonly runtimeHash: string;
+}
+/** Discover the latest completed graph through this mounted host's transport. */
+export declare function readNativeBrowserDevPublication(remoteName: string, options: {
+    readonly signal: AbortSignal;
+    readonly revisionHeader: string;
+}): Promise<NativeBrowserDevPublication>;
+export declare function hasNativeBrowserDevPublisher(remoteName: string): boolean;
+export {};

package/dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts

@@ -0,0 +1,90 @@
+interface ManifestRemote {
+    readonly name: string;
+    readonly alias: string;
+    readonly entry: string;
+}
+interface RemoteInfo {
+    readonly name: string;
+    readonly entry: string;
+}
+interface NativeHost {
+    readonly options?: unknown;
+    readonly shareScopeMap?: Record<string, Record<string, Record<string, {
+        loaded?: boolean;
+        loading?: unknown;
+        lib?: unknown;
+    }>>>;
+    loadShare?(pkgName: string): Promise<unknown>;
+    loadRemote<T>(id: string, options?: unknown): Promise<T | null>;
+    registerRemotes(remotes: ManifestRemote[], options: {
+        force: true;
+    }): void;
+    readonly loaderHook: {
+        readonly lifecycle: {
+            readonly fetch: {
+                emit(url: string, init: RequestInit, remoteInfo: RemoteInfo, context: {
+                    initiator: 'loadRemote';
+                    id: string;
+                    resourceType: 'remoteEntry';
+                    url: string;
+                    expose?: string;
+                }): Promise<Response | false | void>;
+            };
+        };
+    };
+    [LOAD_WITH_CAPTURE]?: <T, Captured>(id: string, capture: (module: T | null, resolution?: LoadResolution) => Captured) => Promise<{
+        module: T | null;
+        captured: Captured | undefined;
+    }>;
+}
+declare const LOAD_WITH_CAPTURE: unique symbol;
+interface LoadResolution {
+    readonly remoteSnapshot: unknown;
+    readonly expose: string;
+}
+export interface NativeDevRefreshOptions {
+    readonly remotes: readonly ManifestRemote[];
+    readonly revisionHeader: string;
+    readonly requestTimeout: number;
+    /** Exact and prefix singleton keys owned by the selected native adapter. */
+    readonly shared?: readonly string[];
+}
+/**
+ * Retain the host and its shared factories while refreshing one completed
+ * development remote. Production remotes without a revision keep native MF's
+ * ordinary cache. The compiler registers this plugin only on Node dev hosts.
+ */
+export default function nativeDevRefreshRuntimePlugin(options: NativeDevRefreshOptions): {
+    name: string;
+    beforeInit<T extends {
+        origin: NativeHost;
+    }>(args: T): T;
+    beforeRequest<T extends {
+        origin: NativeHost;
+        id: string;
+    }>(args: T): Promise<T>;
+    loadSnapshot<T extends {
+        options: unknown;
+        moduleInfo: {
+            name: string;
+        };
+        remoteSnapshot?: unknown;
+    }>(args: T): T;
+    afterLoadSnapshot<T extends {
+        host: NativeHost;
+        moduleInfo: {
+            name: string;
+        };
+        remoteSnapshot: unknown;
+    }>(args: T): T;
+    afterResolve<T extends {
+        origin: NativeHost;
+        remote: {
+            name: string;
+        };
+        remoteInfo: RemoteInfo;
+        remoteSnapshot: unknown;
+        expose: string;
+    }>(args: T): Promise<T>;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bleedingdev/modern-js-federation-runtime",
-  "version": "3.9.3-ultramodern.7",
+  "version": "3.9.3-ultramodern.9",
   "description": "Federated surface consumption, distributed SSR, and bounded manifest recovery.",
   "license": "MIT",
   "repository": {
@@ -9,7 +9,7 @@
     "directory": "packages/runtime/federation-runtime"
   },
   "engines": {
-    "node": ">=26.10.0"
+    "node": ">=26.12.0"
   },
   "types": "./dist/types/module-federation/index.d.ts",
   "main": "./dist/cjs/module-federation/index.js",
@@ -54,6 +54,37 @@
         "require": "./dist/cjs/module-federation/manifest-recovery-runtime-plugin.js"
       },
       "default": "./dist/esm/module-federation/manifest-recovery-runtime-plugin.mjs"
+    },
+    "./native-dev-refresh-runtime-plugin": {
+      "types": "./dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts",
+      "node": {
+        "import": "./dist/esm-node/module-federation/native-dev-refresh-runtime-plugin.mjs",
+        "require": "./dist/cjs/module-federation/native-dev-refresh-runtime-plugin.js"
+      }
+    },
+    "./native-browser-dev-refresh": {
+      "types": "./dist/types/module-federation/native-browser-dev-refresh.d.ts",
+      "node": {
+        "import": "./dist/esm-node/module-federation/native-browser-dev-refresh.mjs",
+        "require": "./dist/cjs/module-federation/native-browser-dev-refresh.js"
+      },
+      "default": "./dist/esm/module-federation/native-browser-dev-refresh.mjs"
+    },
+    "./native-browser-dev-runtime-plugin": {
+      "types": "./dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts",
+      "node": {
+        "import": "./dist/esm-node/module-federation/native-browser-dev-runtime-plugin.mjs",
+        "require": "./dist/cjs/module-federation/native-browser-dev-runtime-plugin.js"
+      },
+      "default": "./dist/esm/module-federation/native-browser-dev-runtime-plugin.mjs"
+    },
+    "./native-browser-dev-client": {
+      "types": "./dist/types/module-federation/native-browser-dev-client.d.ts",
+      "node": {
+        "import": "./dist/esm-node/module-federation/native-browser-dev-client.mjs",
+        "require": "./dist/cjs/module-federation/native-browser-dev-client.js"
+      },
+      "default": "./dist/esm/module-federation/native-browser-dev-client.mjs"
     }
   },
   "typesVersions": {
@@ -77,6 +108,22 @@
       "manifest-recovery-runtime-plugin": [
         "./dist/types/module-federation/manifest-recovery-runtime-plugin.d.ts",
         "./src/module-federation/manifest-recovery-runtime-plugin.ts"
+      ],
+      "native-dev-refresh-runtime-plugin": [
+        "./dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts",
+        "./src/module-federation/native-dev-refresh-runtime-plugin.ts"
+      ],
+      "native-browser-dev-refresh": [
+        "./dist/types/module-federation/native-browser-dev-refresh.d.ts",
+        "./src/module-federation/native-browser-dev-refresh.ts"
+      ],
+      "native-browser-dev-runtime-plugin": [
+        "./dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts",
+        "./src/module-federation/native-browser-dev-runtime-plugin.ts"
+      ],
+      "native-browser-dev-client": [
+        "./dist/types/module-federation/native-browser-dev-client.d.ts",
+        "./src/module-federation/native-browser-dev-client.ts"
       ]
     }
   },
@@ -86,13 +133,13 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.7",
-    "@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.3-ultramodern.7",
-    "@module-federation/sdk": "2.9.2"
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.9",
+    "@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.3-ultramodern.9",
+    "@module-federation/sdk": "npm:@bleedingdev/mf-sdk@2.9.2"
   },
   "peerDependencies": {
-    "@modern-js/runtime": "3.9.3-ultramodern.7",
-    "react": "^19.2.8"
+    "@modern-js/runtime": "3.9.3-ultramodern.9",
+    "react": "^19.3.1"
   },
   "peerDependenciesMeta": {
     "@modern-js/runtime": {
@@ -103,17 +150,17 @@
     }
   },
   "devDependencies": {
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.7",
-    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.7",
-    "@rsbuild/core": "2.2.11",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.9",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.9",
+    "@rsbuild/core": "2.2.13",
     "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "esbuild": "^0.28.2",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
     "typescript": "7.0.2"
   },
   "publishConfig": {