@bleedingdev/modern-js-federation-runtime 3.9.0-ultramodern.9 → 3.9.3-ultramodern.10
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.
- package/dist/cjs/module-federation/consume-surface.js +6 -16
- package/dist/cjs/module-federation/distributed-ssr.js +6 -1
- package/dist/cjs/module-federation/index.js +13 -239
- package/dist/cjs/module-federation/manifest-recovery-runtime-plugin.js +1 -1
- package/dist/cjs/module-federation/native-browser-dev-client.js +320 -0
- package/dist/cjs/module-federation/native-browser-dev-refresh.js +226 -0
- package/dist/cjs/module-federation/native-browser-dev-runtime-plugin.js +233 -0
- package/dist/cjs/module-federation/native-dev-refresh-runtime-plugin.js +267 -0
- package/dist/cjs/module-federation/renderer-contract.js +159 -0
- package/dist/cjs/module-federation/renderer-runtime-plugin.js +268 -0
- package/dist/cjs/module-federation/telemetry.js +214 -0
- package/dist/esm/module-federation/consume-surface.mjs +3 -13
- package/dist/esm/module-federation/distributed-ssr.mjs +6 -1
- package/dist/esm/module-federation/index.mjs +1 -111
- package/dist/esm/module-federation/manifest-recovery-runtime-plugin.mjs +1 -1
- package/dist/esm/module-federation/native-browser-dev-client.mjs +276 -0
- package/dist/esm/module-federation/native-browser-dev-refresh.mjs +182 -0
- package/dist/esm/module-federation/native-browser-dev-runtime-plugin.mjs +183 -0
- package/dist/esm/module-federation/native-dev-refresh-runtime-plugin.mjs +229 -0
- package/dist/esm/module-federation/renderer-contract.mjs +103 -0
- package/dist/esm/module-federation/renderer-runtime-plugin.mjs +225 -0
- package/dist/esm/module-federation/telemetry.mjs +142 -0
- package/dist/esm-node/module-federation/consume-surface.mjs +3 -13
- package/dist/esm-node/module-federation/distributed-ssr.mjs +6 -1
- package/dist/esm-node/module-federation/index.mjs +1 -111
- package/dist/esm-node/module-federation/manifest-recovery-runtime-plugin.mjs +1 -1
- package/dist/esm-node/module-federation/native-browser-dev-client.mjs +277 -0
- package/dist/esm-node/module-federation/native-browser-dev-refresh.mjs +183 -0
- package/dist/esm-node/module-federation/native-browser-dev-runtime-plugin.mjs +184 -0
- package/dist/esm-node/module-federation/native-dev-refresh-runtime-plugin.mjs +230 -0
- package/dist/esm-node/module-federation/renderer-contract.mjs +104 -0
- package/dist/esm-node/module-federation/renderer-runtime-plugin.mjs +226 -0
- package/dist/esm-node/module-federation/telemetry.mjs +143 -0
- package/dist/types/module-federation/consume-surface.d.ts +5 -5
- package/dist/types/module-federation/distributed-ssr.d.ts +18 -1
- package/dist/types/module-federation/index.d.ts +1 -67
- package/dist/types/module-federation/native-browser-dev-client.d.ts +41 -0
- package/dist/types/module-federation/native-browser-dev-refresh.d.ts +86 -0
- package/dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts +40 -0
- package/dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts +90 -0
- package/dist/types/module-federation/renderer-contract.d.ts +20 -0
- package/dist/types/module-federation/renderer-runtime-plugin.d.ts +98 -0
- package/dist/types/module-federation/telemetry.d.ts +71 -0
- package/package.json +102 -19
- package/src/module-federation/consume-surface.ts +18 -33
- package/src/module-federation/distributed-ssr.tsx +27 -2
- package/src/module-federation/index.ts +1 -267
- package/src/module-federation/manifest-recovery-runtime-plugin.ts +5 -1
- package/src/module-federation/native-browser-dev-client.ts +424 -0
- package/src/module-federation/native-browser-dev-refresh.ts +373 -0
- package/src/module-federation/native-browser-dev-runtime-plugin.ts +276 -0
- package/src/module-federation/native-dev-refresh-runtime-plugin.ts +445 -0
- package/src/module-federation/renderer-contract.ts +176 -0
- package/src/module-federation/renderer-runtime-plugin.ts +401 -0
- package/src/module-federation/telemetry.ts +297 -0
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/** The normal MF instance surface used by a browser development replacement. */
|
|
2
|
+
export interface NativeBrowserDevHost {
|
|
3
|
+
readonly name: string;
|
|
4
|
+
readonly options: Readonly<Record<string, unknown>>;
|
|
5
|
+
readonly shareScopeMap: Record<string, Record<string, Record<string, Shared>>>;
|
|
6
|
+
readonly moduleCache: Map<string, unknown>;
|
|
7
|
+
readonly loaderHook?: {
|
|
8
|
+
readonly lifecycle: {
|
|
9
|
+
readonly fetch: {
|
|
10
|
+
emit(url: string, init: RequestInit, remote: unknown, context: {
|
|
11
|
+
readonly initiator: 'loadRemote';
|
|
12
|
+
readonly id: string;
|
|
13
|
+
readonly resourceType: 'manifest';
|
|
14
|
+
readonly url: string;
|
|
15
|
+
}): Promise<unknown>;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
};
|
|
19
|
+
initShareScopeMap(name: string, scope: Record<string, Record<string, Shared>>, options: {
|
|
20
|
+
hostShareScopeMap: NativeBrowserDevHost['shareScopeMap'];
|
|
21
|
+
}): void;
|
|
22
|
+
loadRemote<T>(id: string, options: {
|
|
23
|
+
loadFactory: false;
|
|
24
|
+
}): Promise<T | null>;
|
|
25
|
+
}
|
|
26
|
+
interface Shared {
|
|
27
|
+
readonly loaded?: boolean;
|
|
28
|
+
readonly loading?: unknown;
|
|
29
|
+
readonly lib?: unknown;
|
|
30
|
+
readonly get?: unknown;
|
|
31
|
+
}
|
|
32
|
+
export interface NativeBrowserDevGraph {
|
|
33
|
+
/** Existing completed graph revision, also used in immutable asset URLs. */
|
|
34
|
+
readonly revision: string;
|
|
35
|
+
/** Native JSON manifest whose entry AND chunks belong to this revision. */
|
|
36
|
+
readonly remote: Readonly<{
|
|
37
|
+
name: string;
|
|
38
|
+
alias: string;
|
|
39
|
+
entry: string;
|
|
40
|
+
}>;
|
|
41
|
+
}
|
|
42
|
+
interface StagingHost {
|
|
43
|
+
readonly host: NativeBrowserDevHost;
|
|
44
|
+
/** Rearm cached, unexecuted runtime hot listeners without starting a socket. */
|
|
45
|
+
prepareFactory?(): void;
|
|
46
|
+
/** Retire only this attempt's transport/listeners; never shared providers. */
|
|
47
|
+
release(): void;
|
|
48
|
+
}
|
|
49
|
+
interface PublisherReplacement {
|
|
50
|
+
readonly commitStarted: boolean;
|
|
51
|
+
execute<T>(factory: () => T): T;
|
|
52
|
+
}
|
|
53
|
+
declare const COMMIT_ERROR: unique symbol;
|
|
54
|
+
/** Propagates an observed native mutation; it does not grant native authority. */
|
|
55
|
+
declare class NativeBrowserDevCommitError extends Error {
|
|
56
|
+
readonly [COMMIT_ERROR] = true;
|
|
57
|
+
readonly revision: string;
|
|
58
|
+
constructor(revision: string, cause: unknown);
|
|
59
|
+
}
|
|
60
|
+
/** A remote runtime can receive this error from a different host runtime copy. */
|
|
61
|
+
export declare function isNativeBrowserDevCommitError(error: unknown, revision: string): error is NativeBrowserDevCommitError;
|
|
62
|
+
/** Trusted coordinators use this only after observing an actual native commit. */
|
|
63
|
+
export declare function nativeBrowserDevCommitFailure(revision: string, cause: unknown): Error;
|
|
64
|
+
/**
|
|
65
|
+
* Load a new container without evicting the working host. MF admission and async
|
|
66
|
+
* chunk loading finish before Octane executes the synchronous exposed graph.
|
|
67
|
+
* Native execution owns declaration rollback and retirement of the old graph.
|
|
68
|
+
* It cannot undo arbitrary module side effects or the browser's ESM cache: a
|
|
69
|
+
* consumed, failed graph needs a newer completed revision for another attempt.
|
|
70
|
+
*
|
|
71
|
+
* The compiler supplies a public ModuleFederation constructor adapter and an
|
|
72
|
+
* attempt-owned transport release function. No global MF cache is deleted here.
|
|
73
|
+
*/
|
|
74
|
+
export declare function createNativeBrowserDevRefresh<Boundary>(options: {
|
|
75
|
+
readonly host: NativeBrowserDevHost;
|
|
76
|
+
readonly id: string;
|
|
77
|
+
readonly boundary: Boundary;
|
|
78
|
+
readonly prepareReplacement: (boundary: Boundary) => PublisherReplacement;
|
|
79
|
+
readonly createHost: (options: Readonly<Record<string, unknown>>) => StagingHost;
|
|
80
|
+
}): {
|
|
81
|
+
replace<T>(graph: NativeBrowserDevGraph): Promise<T>;
|
|
82
|
+
/** The original host remains untouched, including sibling remote loaders. */
|
|
83
|
+
readonly activeHost: NativeBrowserDevHost;
|
|
84
|
+
dispose(): void;
|
|
85
|
+
};
|
|
86
|
+
export {};
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { createNativeBrowserDevRefresh, type NativeBrowserDevGraph, type NativeBrowserDevHost } from './native-browser-dev-refresh.js';
|
|
2
|
+
export declare const NATIVE_BROWSER_DEV_BOUNDARY: unique symbol;
|
|
3
|
+
interface Replacement {
|
|
4
|
+
readonly commitStarted: boolean;
|
|
5
|
+
execute<T>(factory: () => T): T;
|
|
6
|
+
}
|
|
7
|
+
interface Reference {
|
|
8
|
+
readonly host: NativeBrowserDevHost;
|
|
9
|
+
readonly remote: NativeBrowserDevGraph['remote'];
|
|
10
|
+
readonly boundary: object;
|
|
11
|
+
readonly prepare: (boundary: object) => Replacement;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* This registry routes work to actual mounted boundary references; its names
|
|
15
|
+
* grant no native authority. Octane revalidates the exact compiled root, lease,
|
|
16
|
+
* physical document and every surviving owner inside the opaque capability.
|
|
17
|
+
*/
|
|
18
|
+
export declare function createNativeBrowserDevRuntimePlugin(options: {
|
|
19
|
+
readonly remotes: readonly NativeBrowserDevGraph['remote'][];
|
|
20
|
+
readonly prepareReplacement: Reference['prepare'];
|
|
21
|
+
readonly createHost: Parameters<typeof createNativeBrowserDevRefresh>[0]['createHost'];
|
|
22
|
+
}): {
|
|
23
|
+
name: string;
|
|
24
|
+
beforeInit<T extends {
|
|
25
|
+
origin: NativeBrowserDevHost;
|
|
26
|
+
}>(args: T): T;
|
|
27
|
+
};
|
|
28
|
+
/** One synchronous exposed graph execution serves all of its mounted instances. */
|
|
29
|
+
export declare function replaceNativeBrowserDevRemote(graph: NativeBrowserDevGraph): Promise<number>;
|
|
30
|
+
export interface NativeBrowserDevPublication extends NativeBrowserDevGraph {
|
|
31
|
+
readonly buildId: string;
|
|
32
|
+
readonly runtimeHash: string;
|
|
33
|
+
}
|
|
34
|
+
/** Discover the latest completed graph through this mounted host's transport. */
|
|
35
|
+
export declare function readNativeBrowserDevPublication(remoteName: string, options: {
|
|
36
|
+
readonly signal: AbortSignal;
|
|
37
|
+
readonly revisionHeader: string;
|
|
38
|
+
}): Promise<NativeBrowserDevPublication>;
|
|
39
|
+
export declare function hasNativeBrowserDevPublisher(remoteName: string): boolean;
|
|
40
|
+
export {};
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
interface ManifestRemote {
|
|
2
|
+
readonly name: string;
|
|
3
|
+
readonly alias: string;
|
|
4
|
+
readonly entry: string;
|
|
5
|
+
}
|
|
6
|
+
interface RemoteInfo {
|
|
7
|
+
readonly name: string;
|
|
8
|
+
readonly entry: string;
|
|
9
|
+
}
|
|
10
|
+
interface NativeHost {
|
|
11
|
+
readonly options?: unknown;
|
|
12
|
+
readonly shareScopeMap?: Record<string, Record<string, Record<string, {
|
|
13
|
+
loaded?: boolean;
|
|
14
|
+
loading?: unknown;
|
|
15
|
+
lib?: unknown;
|
|
16
|
+
}>>>;
|
|
17
|
+
loadShare?(pkgName: string): Promise<unknown>;
|
|
18
|
+
loadRemote<T>(id: string, options?: unknown): Promise<T | null>;
|
|
19
|
+
registerRemotes(remotes: ManifestRemote[], options: {
|
|
20
|
+
force: true;
|
|
21
|
+
}): void;
|
|
22
|
+
readonly loaderHook: {
|
|
23
|
+
readonly lifecycle: {
|
|
24
|
+
readonly fetch: {
|
|
25
|
+
emit(url: string, init: RequestInit, remoteInfo: RemoteInfo, context: {
|
|
26
|
+
initiator: 'loadRemote';
|
|
27
|
+
id: string;
|
|
28
|
+
resourceType: 'remoteEntry';
|
|
29
|
+
url: string;
|
|
30
|
+
expose?: string;
|
|
31
|
+
}): Promise<Response | false | void>;
|
|
32
|
+
};
|
|
33
|
+
};
|
|
34
|
+
};
|
|
35
|
+
[LOAD_WITH_CAPTURE]?: <T, Captured>(id: string, capture: (module: T | null, resolution?: LoadResolution) => Captured) => Promise<{
|
|
36
|
+
module: T | null;
|
|
37
|
+
captured: Captured | undefined;
|
|
38
|
+
}>;
|
|
39
|
+
}
|
|
40
|
+
declare const LOAD_WITH_CAPTURE: unique symbol;
|
|
41
|
+
interface LoadResolution {
|
|
42
|
+
readonly remoteSnapshot: unknown;
|
|
43
|
+
readonly expose: string;
|
|
44
|
+
}
|
|
45
|
+
export interface NativeDevRefreshOptions {
|
|
46
|
+
readonly remotes: readonly ManifestRemote[];
|
|
47
|
+
readonly revisionHeader: string;
|
|
48
|
+
readonly requestTimeout: number;
|
|
49
|
+
/** Exact and prefix singleton keys owned by the selected native adapter. */
|
|
50
|
+
readonly shared?: readonly string[];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Retain the host and its shared factories while refreshing one completed
|
|
54
|
+
* development remote. Production remotes without a revision keep native MF's
|
|
55
|
+
* ordinary cache. The compiler registers this plugin only on Node dev hosts.
|
|
56
|
+
*/
|
|
57
|
+
export default function nativeDevRefreshRuntimePlugin(options: NativeDevRefreshOptions): {
|
|
58
|
+
name: string;
|
|
59
|
+
beforeInit<T extends {
|
|
60
|
+
origin: NativeHost;
|
|
61
|
+
}>(args: T): T;
|
|
62
|
+
beforeRequest<T extends {
|
|
63
|
+
origin: NativeHost;
|
|
64
|
+
id: string;
|
|
65
|
+
}>(args: T): Promise<T>;
|
|
66
|
+
loadSnapshot<T extends {
|
|
67
|
+
options: unknown;
|
|
68
|
+
moduleInfo: {
|
|
69
|
+
name: string;
|
|
70
|
+
};
|
|
71
|
+
remoteSnapshot?: unknown;
|
|
72
|
+
}>(args: T): T;
|
|
73
|
+
afterLoadSnapshot<T extends {
|
|
74
|
+
host: NativeHost;
|
|
75
|
+
moduleInfo: {
|
|
76
|
+
name: string;
|
|
77
|
+
};
|
|
78
|
+
remoteSnapshot: unknown;
|
|
79
|
+
}>(args: T): T;
|
|
80
|
+
afterResolve<T extends {
|
|
81
|
+
origin: NativeHost;
|
|
82
|
+
remote: {
|
|
83
|
+
name: string;
|
|
84
|
+
};
|
|
85
|
+
remoteInfo: RemoteInfo;
|
|
86
|
+
remoteSnapshot: unknown;
|
|
87
|
+
expose: string;
|
|
88
|
+
}>(args: T): Promise<T>;
|
|
89
|
+
};
|
|
90
|
+
export {};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { type RendererIdentity, type RendererPackageIdentity, type RendererProfile } from '@modern-js/backend-federation-contracts';
|
|
2
|
+
export declare const RENDERER_FEDERATION_METADATA_KEY = "ultramodernRenderer";
|
|
3
|
+
export declare const RENDERER_FEDERATION_SCHEMA = "ultramodern.renderer-federation";
|
|
4
|
+
export declare const RENDERER_FEDERATION_SCHEMA_VERSION = 1;
|
|
5
|
+
/** The consuming renderer tuple; application and source identities are independent. */
|
|
6
|
+
export interface RendererFederationCompatibility {
|
|
7
|
+
readonly profile: RendererProfile;
|
|
8
|
+
readonly runtime: RendererPackageIdentity;
|
|
9
|
+
readonly bootstrap: RendererPackageIdentity;
|
|
10
|
+
}
|
|
11
|
+
/** Finalized native build authority for both browser and SSR remote entries. */
|
|
12
|
+
export interface RendererFederationContract extends RendererFederationCompatibility {
|
|
13
|
+
readonly schema: typeof RENDERER_FEDERATION_SCHEMA;
|
|
14
|
+
readonly schemaVersion: typeof RENDERER_FEDERATION_SCHEMA_VERSION;
|
|
15
|
+
readonly identities: Readonly<Record<string, RendererIdentity>>;
|
|
16
|
+
}
|
|
17
|
+
export declare const rendererFederationError: (message: string) => Error;
|
|
18
|
+
export declare function readRendererFederationCompatibility(value: unknown): RendererFederationCompatibility;
|
|
19
|
+
export declare function readRendererFederationContract(value: unknown): RendererFederationContract;
|
|
20
|
+
export declare function assertRendererFederationCompatibility(expected: RendererFederationCompatibility, actual: RendererFederationCompatibility): void;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { type RendererFederationCompatibility } from './renderer-contract.js';
|
|
2
|
+
type Snapshot = Record<string, unknown>;
|
|
3
|
+
type SnapshotArgs = {
|
|
4
|
+
remoteSnapshot: Snapshot;
|
|
5
|
+
from: 'global' | 'manifest';
|
|
6
|
+
manifestJson?: unknown;
|
|
7
|
+
};
|
|
8
|
+
type Shared = Record<string, unknown> & {
|
|
9
|
+
version?: string;
|
|
10
|
+
};
|
|
11
|
+
type ShareResolution = {
|
|
12
|
+
shared: Shared;
|
|
13
|
+
useTreesShaking?: boolean;
|
|
14
|
+
} | undefined;
|
|
15
|
+
type ResolveShareArgs = {
|
|
16
|
+
pkgName: string;
|
|
17
|
+
shareScopeMap: Record<string, Record<string, Record<string, Shared>>>;
|
|
18
|
+
resolver: () => ShareResolution;
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* Exact versions every shared copy of the consuming renderer tuple must carry.
|
|
22
|
+
* React keeps its established package set; native renderers derive theirs from
|
|
23
|
+
* the tuple's runtime, hydration, bootstrap and router owners.
|
|
24
|
+
*/
|
|
25
|
+
export declare function rendererShareVersions(expected: RendererFederationCompatibility): ReadonlyMap<string, string>;
|
|
26
|
+
/** Gate the native snapshot and share lifecycles before executing component factories. */
|
|
27
|
+
export declare function createRendererFederationRuntimePlugin(options: RendererFederationCompatibility): {
|
|
28
|
+
name: string;
|
|
29
|
+
beforeRegisterRemote(args: {
|
|
30
|
+
remote: unknown;
|
|
31
|
+
}): {
|
|
32
|
+
remote: unknown;
|
|
33
|
+
};
|
|
34
|
+
afterMatchRemote(args: {
|
|
35
|
+
remote?: unknown;
|
|
36
|
+
error?: unknown;
|
|
37
|
+
}): Promise<{
|
|
38
|
+
remote?: unknown;
|
|
39
|
+
error?: unknown;
|
|
40
|
+
}>;
|
|
41
|
+
loadRemoteSnapshot(args: SnapshotArgs): Promise<SnapshotArgs>;
|
|
42
|
+
afterLoadSnapshot(args: {
|
|
43
|
+
remoteSnapshot: Snapshot;
|
|
44
|
+
moduleInfo?: {
|
|
45
|
+
name: string;
|
|
46
|
+
};
|
|
47
|
+
}): Promise<{
|
|
48
|
+
remoteSnapshot: Snapshot;
|
|
49
|
+
moduleInfo?: {
|
|
50
|
+
name: string;
|
|
51
|
+
};
|
|
52
|
+
}>;
|
|
53
|
+
afterResolve(args: {
|
|
54
|
+
remote: {
|
|
55
|
+
name: string;
|
|
56
|
+
};
|
|
57
|
+
remoteInfo: Record<string, unknown>;
|
|
58
|
+
remoteSnapshot?: Snapshot;
|
|
59
|
+
origin: {
|
|
60
|
+
moduleCache: Map<string, {
|
|
61
|
+
remoteInfo: Record<string, unknown>;
|
|
62
|
+
}>;
|
|
63
|
+
};
|
|
64
|
+
}): Promise<{
|
|
65
|
+
remote: {
|
|
66
|
+
name: string;
|
|
67
|
+
};
|
|
68
|
+
remoteInfo: Record<string, unknown>;
|
|
69
|
+
remoteSnapshot?: Snapshot;
|
|
70
|
+
origin: {
|
|
71
|
+
moduleCache: Map<string, {
|
|
72
|
+
remoteInfo: Record<string, unknown>;
|
|
73
|
+
}>;
|
|
74
|
+
};
|
|
75
|
+
}>;
|
|
76
|
+
loadEntry(args: {
|
|
77
|
+
remoteInfo: Record<string, unknown>;
|
|
78
|
+
}): void;
|
|
79
|
+
afterLoadEntry(args: {
|
|
80
|
+
remoteInfo: Record<string, unknown>;
|
|
81
|
+
remoteEntryExports?: unknown;
|
|
82
|
+
cached?: boolean;
|
|
83
|
+
error?: unknown;
|
|
84
|
+
recovered?: boolean;
|
|
85
|
+
}): Promise<{
|
|
86
|
+
remoteInfo: Record<string, unknown>;
|
|
87
|
+
remoteEntryExports?: unknown;
|
|
88
|
+
cached?: boolean;
|
|
89
|
+
error?: unknown;
|
|
90
|
+
recovered?: boolean;
|
|
91
|
+
}>;
|
|
92
|
+
resolveShare(args: ResolveShareArgs): ResolveShareArgs;
|
|
93
|
+
afterLoadShare(args: {
|
|
94
|
+
pkgName: string;
|
|
95
|
+
selectedShared?: Shared;
|
|
96
|
+
}): void;
|
|
97
|
+
};
|
|
98
|
+
export default createRendererFederationRuntimePlugin;
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
export declare const MODULE_FEDERATION_FALLBACK_SIGNAL_EVENT = "modernjs:mf-runtime-fallback";
|
|
2
|
+
export declare const MODULE_FEDERATION_RECOVERY_SIGNAL_EVENT = "modernjs:mf-runtime-recovery";
|
|
3
|
+
export declare const DEFAULT_RUNTIME_FALLBACK_SIGNAL_ENDPOINT = "/_modern/contract-gates/runtime-fallback";
|
|
4
|
+
export declare const DEFAULT_RUNTIME_FALLBACK_SIGNAL_AUTH_HEADER = "x-modernjs-runtime-signal-token";
|
|
5
|
+
export type ModuleFederationFallbackClassification = 'timeout' | 'network' | 'contract' | 'version-skew' | 'remote-unavailable';
|
|
6
|
+
export type ModuleFederationFallbackStatus = 'degraded' | 'failed' | 'recovered';
|
|
7
|
+
export type ModuleFederationFallbackTelemetryInput = {
|
|
8
|
+
appName: string;
|
|
9
|
+
classification: ModuleFederationFallbackClassification;
|
|
10
|
+
entry?: string;
|
|
11
|
+
error?: unknown;
|
|
12
|
+
eventName?: string;
|
|
13
|
+
exportName?: string;
|
|
14
|
+
metadata?: Record<string, unknown>;
|
|
15
|
+
phase: 'discovery' | 'load' | 'mount' | 'hydrate' | 'recover';
|
|
16
|
+
remote: string;
|
|
17
|
+
runtimeDigest?: string;
|
|
18
|
+
status?: ModuleFederationFallbackStatus;
|
|
19
|
+
};
|
|
20
|
+
export type ModuleFederationFallbackTelemetryPayload = {
|
|
21
|
+
appName: string;
|
|
22
|
+
entry?: string;
|
|
23
|
+
eventName: string;
|
|
24
|
+
phase: ModuleFederationFallbackTelemetryInput['phase'];
|
|
25
|
+
reason: ModuleFederationFallbackClassification;
|
|
26
|
+
runtimeDigest?: string;
|
|
27
|
+
schemaVersion: 1;
|
|
28
|
+
metadata: {
|
|
29
|
+
classification: ModuleFederationFallbackClassification;
|
|
30
|
+
errorMessage?: string;
|
|
31
|
+
errorName?: string;
|
|
32
|
+
exportName?: string;
|
|
33
|
+
remote: string;
|
|
34
|
+
runtimeDigest?: string;
|
|
35
|
+
status: ModuleFederationFallbackStatus;
|
|
36
|
+
} & Record<string, unknown>;
|
|
37
|
+
};
|
|
38
|
+
export type ModuleFederationFallbackTelemetryEmitOptions = {
|
|
39
|
+
authHeaderName?: string;
|
|
40
|
+
authToken?: string;
|
|
41
|
+
endpoint?: string;
|
|
42
|
+
fetchImpl?: typeof fetch;
|
|
43
|
+
postSignal?: boolean;
|
|
44
|
+
/** Positive reporting deadline; defaults to one second. */
|
|
45
|
+
timeoutMs?: number;
|
|
46
|
+
/** Observe the exact payload and await delivery explicitly in tests. */
|
|
47
|
+
observe?: (payload: ModuleFederationFallbackTelemetryPayload, delivery: Promise<ModuleFederationFallbackTelemetryEmitResult>) => void;
|
|
48
|
+
};
|
|
49
|
+
export type ModuleFederationFallbackTelemetryEmitResult = {
|
|
50
|
+
dispatched: boolean;
|
|
51
|
+
posted: boolean;
|
|
52
|
+
postStatus?: number;
|
|
53
|
+
};
|
|
54
|
+
export declare class ModuleFederationRemoteLoadTimeoutError extends Error {
|
|
55
|
+
constructor(remote: string, timeoutMs: number);
|
|
56
|
+
}
|
|
57
|
+
export declare class ModuleFederationRemoteLoadError extends Error {
|
|
58
|
+
readonly remote: string;
|
|
59
|
+
readonly attempts: number;
|
|
60
|
+
readonly causeError: Error;
|
|
61
|
+
constructor(remote: string, attempts: number, causeError: Error);
|
|
62
|
+
}
|
|
63
|
+
export declare class ModuleFederationRemoteComponentContractError extends Error {
|
|
64
|
+
constructor(remote: string, exportName: string);
|
|
65
|
+
}
|
|
66
|
+
export declare function classifyModuleFederationFallback(error: unknown): ModuleFederationFallbackClassification;
|
|
67
|
+
export declare function createModuleFederationFallbackTelemetry(input: ModuleFederationFallbackTelemetryInput): ModuleFederationFallbackTelemetryPayload;
|
|
68
|
+
export declare function toModuleFederationFallbackAttributes(payload: ModuleFederationFallbackTelemetryPayload): Record<string, string>;
|
|
69
|
+
export declare function emitModuleFederationFallbackTelemetry(input: ModuleFederationFallbackTelemetryInput, options?: ModuleFederationFallbackTelemetryEmitOptions): Promise<ModuleFederationFallbackTelemetryEmitResult>;
|
|
70
|
+
/** Dispatch once locally; remote delivery is bounded and best effort. */
|
|
71
|
+
export declare function emitModuleFederationFallbackPayload(payload: ModuleFederationFallbackTelemetryPayload, options?: ModuleFederationFallbackTelemetryEmitOptions): Promise<ModuleFederationFallbackTelemetryEmitResult>;
|
package/package.json
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bleedingdev/modern-js-federation-runtime",
|
|
3
|
-
"version": "3.9.
|
|
3
|
+
"version": "3.9.3-ultramodern.10",
|
|
4
4
|
"description": "Federated surface consumption, distributed SSR, and bounded manifest recovery.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
|
-
"url": "git+https://github.com/
|
|
8
|
+
"url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
|
|
9
9
|
"directory": "packages/runtime/federation-runtime"
|
|
10
10
|
},
|
|
11
11
|
"engines": {
|
|
12
|
-
"node": ">=26.
|
|
12
|
+
"node": ">=26.12.0"
|
|
13
13
|
},
|
|
14
14
|
"types": "./dist/types/module-federation/index.d.ts",
|
|
15
15
|
"main": "./dist/cjs/module-federation/index.js",
|
|
@@ -23,6 +23,22 @@
|
|
|
23
23
|
},
|
|
24
24
|
"default": "./dist/esm/module-federation/index.mjs"
|
|
25
25
|
},
|
|
26
|
+
"./renderer-contract": {
|
|
27
|
+
"types": "./dist/types/module-federation/renderer-contract.d.ts",
|
|
28
|
+
"node": {
|
|
29
|
+
"import": "./dist/esm-node/module-federation/renderer-contract.mjs",
|
|
30
|
+
"require": "./dist/cjs/module-federation/renderer-contract.js"
|
|
31
|
+
},
|
|
32
|
+
"default": "./dist/esm/module-federation/renderer-contract.mjs"
|
|
33
|
+
},
|
|
34
|
+
"./renderer-runtime-plugin": {
|
|
35
|
+
"types": "./dist/types/module-federation/renderer-runtime-plugin.d.ts",
|
|
36
|
+
"node": {
|
|
37
|
+
"import": "./dist/esm-node/module-federation/renderer-runtime-plugin.mjs",
|
|
38
|
+
"require": "./dist/cjs/module-federation/renderer-runtime-plugin.js"
|
|
39
|
+
},
|
|
40
|
+
"default": "./dist/esm/module-federation/renderer-runtime-plugin.mjs"
|
|
41
|
+
},
|
|
26
42
|
"./distributed-ssr": {
|
|
27
43
|
"types": "./dist/types/module-federation/distributed-ssr.d.ts",
|
|
28
44
|
"node": {
|
|
@@ -38,6 +54,37 @@
|
|
|
38
54
|
"require": "./dist/cjs/module-federation/manifest-recovery-runtime-plugin.js"
|
|
39
55
|
},
|
|
40
56
|
"default": "./dist/esm/module-federation/manifest-recovery-runtime-plugin.mjs"
|
|
57
|
+
},
|
|
58
|
+
"./native-dev-refresh-runtime-plugin": {
|
|
59
|
+
"types": "./dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts",
|
|
60
|
+
"node": {
|
|
61
|
+
"import": "./dist/esm-node/module-federation/native-dev-refresh-runtime-plugin.mjs",
|
|
62
|
+
"require": "./dist/cjs/module-federation/native-dev-refresh-runtime-plugin.js"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"./native-browser-dev-refresh": {
|
|
66
|
+
"types": "./dist/types/module-federation/native-browser-dev-refresh.d.ts",
|
|
67
|
+
"node": {
|
|
68
|
+
"import": "./dist/esm-node/module-federation/native-browser-dev-refresh.mjs",
|
|
69
|
+
"require": "./dist/cjs/module-federation/native-browser-dev-refresh.js"
|
|
70
|
+
},
|
|
71
|
+
"default": "./dist/esm/module-federation/native-browser-dev-refresh.mjs"
|
|
72
|
+
},
|
|
73
|
+
"./native-browser-dev-runtime-plugin": {
|
|
74
|
+
"types": "./dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts",
|
|
75
|
+
"node": {
|
|
76
|
+
"import": "./dist/esm-node/module-federation/native-browser-dev-runtime-plugin.mjs",
|
|
77
|
+
"require": "./dist/cjs/module-federation/native-browser-dev-runtime-plugin.js"
|
|
78
|
+
},
|
|
79
|
+
"default": "./dist/esm/module-federation/native-browser-dev-runtime-plugin.mjs"
|
|
80
|
+
},
|
|
81
|
+
"./native-browser-dev-client": {
|
|
82
|
+
"types": "./dist/types/module-federation/native-browser-dev-client.d.ts",
|
|
83
|
+
"node": {
|
|
84
|
+
"import": "./dist/esm-node/module-federation/native-browser-dev-client.mjs",
|
|
85
|
+
"require": "./dist/cjs/module-federation/native-browser-dev-client.js"
|
|
86
|
+
},
|
|
87
|
+
"default": "./dist/esm/module-federation/native-browser-dev-client.mjs"
|
|
41
88
|
}
|
|
42
89
|
},
|
|
43
90
|
"typesVersions": {
|
|
@@ -46,6 +93,14 @@
|
|
|
46
93
|
"./dist/types/module-federation/index.d.ts",
|
|
47
94
|
"./src/module-federation/index.ts"
|
|
48
95
|
],
|
|
96
|
+
"renderer-contract": [
|
|
97
|
+
"./dist/types/module-federation/renderer-contract.d.ts",
|
|
98
|
+
"./src/module-federation/renderer-contract.ts"
|
|
99
|
+
],
|
|
100
|
+
"renderer-runtime-plugin": [
|
|
101
|
+
"./dist/types/module-federation/renderer-runtime-plugin.d.ts",
|
|
102
|
+
"./src/module-federation/renderer-runtime-plugin.ts"
|
|
103
|
+
],
|
|
49
104
|
"distributed-ssr": [
|
|
50
105
|
"./dist/types/module-federation/distributed-ssr.d.ts",
|
|
51
106
|
"./src/module-federation/distributed-ssr.tsx"
|
|
@@ -53,6 +108,22 @@
|
|
|
53
108
|
"manifest-recovery-runtime-plugin": [
|
|
54
109
|
"./dist/types/module-federation/manifest-recovery-runtime-plugin.d.ts",
|
|
55
110
|
"./src/module-federation/manifest-recovery-runtime-plugin.ts"
|
|
111
|
+
],
|
|
112
|
+
"native-dev-refresh-runtime-plugin": [
|
|
113
|
+
"./dist/types/module-federation/native-dev-refresh-runtime-plugin.d.ts",
|
|
114
|
+
"./src/module-federation/native-dev-refresh-runtime-plugin.ts"
|
|
115
|
+
],
|
|
116
|
+
"native-browser-dev-refresh": [
|
|
117
|
+
"./dist/types/module-federation/native-browser-dev-refresh.d.ts",
|
|
118
|
+
"./src/module-federation/native-browser-dev-refresh.ts"
|
|
119
|
+
],
|
|
120
|
+
"native-browser-dev-runtime-plugin": [
|
|
121
|
+
"./dist/types/module-federation/native-browser-dev-runtime-plugin.d.ts",
|
|
122
|
+
"./src/module-federation/native-browser-dev-runtime-plugin.ts"
|
|
123
|
+
],
|
|
124
|
+
"native-browser-dev-client": [
|
|
125
|
+
"./dist/types/module-federation/native-browser-dev-client.d.ts",
|
|
126
|
+
"./src/module-federation/native-browser-dev-client.ts"
|
|
56
127
|
]
|
|
57
128
|
}
|
|
58
129
|
},
|
|
@@ -62,26 +133,35 @@
|
|
|
62
133
|
],
|
|
63
134
|
"sideEffects": false,
|
|
64
135
|
"dependencies": {
|
|
65
|
-
"@modern-js/
|
|
136
|
+
"@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.10",
|
|
137
|
+
"@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.3-ultramodern.10",
|
|
138
|
+
"@module-federation/sdk": "npm:@bleedingdev/mf-sdk@2.9.2"
|
|
66
139
|
},
|
|
67
140
|
"peerDependencies": {
|
|
68
|
-
"@modern-js/runtime": "3.9.
|
|
69
|
-
"react": "^19.
|
|
141
|
+
"@modern-js/runtime": "3.9.3-ultramodern.10",
|
|
142
|
+
"react": "^19.3.1"
|
|
143
|
+
},
|
|
144
|
+
"peerDependenciesMeta": {
|
|
145
|
+
"@modern-js/runtime": {
|
|
146
|
+
"optional": true
|
|
147
|
+
},
|
|
148
|
+
"react": {
|
|
149
|
+
"optional": true
|
|
150
|
+
}
|
|
70
151
|
},
|
|
71
152
|
"devDependencies": {
|
|
72
|
-
"@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.
|
|
73
|
-
"@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.
|
|
74
|
-
"@rsbuild/core": "2.2.
|
|
75
|
-
"@rslib/core": "1.0.
|
|
153
|
+
"@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.10",
|
|
154
|
+
"@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.10",
|
|
155
|
+
"@rsbuild/core": "2.2.13",
|
|
156
|
+
"@rslib/core": "1.0.3",
|
|
76
157
|
"@scripts/rstest-config": "2.66.0",
|
|
77
|
-
"@types/node": "^26.
|
|
78
|
-
"@types/react": "^19.
|
|
79
|
-
"@types/react-dom": "^19.
|
|
80
|
-
"@typescript/native-preview": "7.0.0-dev.20260707.2",
|
|
158
|
+
"@types/node": "^26.6.5",
|
|
159
|
+
"@types/react": "^19.3.0",
|
|
160
|
+
"@types/react-dom": "^19.3.0",
|
|
81
161
|
"esbuild": "^0.28.2",
|
|
82
|
-
"react": "^19.
|
|
83
|
-
"react-dom": "^19.
|
|
84
|
-
"typescript": "
|
|
162
|
+
"react": "^19.3.1",
|
|
163
|
+
"react-dom": "^19.3.1",
|
|
164
|
+
"typescript": "7.0.2"
|
|
85
165
|
},
|
|
86
166
|
"publishConfig": {
|
|
87
167
|
"access": "public"
|
|
@@ -91,8 +171,11 @@
|
|
|
91
171
|
"build": "rslib build",
|
|
92
172
|
"test": "rstest run"
|
|
93
173
|
},
|
|
94
|
-
"homepage": "https://github.com/
|
|
174
|
+
"homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
|
|
95
175
|
"bugs": {
|
|
96
|
-
"url": "https://github.com/
|
|
176
|
+
"url": "https://github.com/ultramodernjs/ultramodern.js/issues"
|
|
177
|
+
},
|
|
178
|
+
"ultramodern": {
|
|
179
|
+
"sourceName": "@modern-js/federation-runtime"
|
|
97
180
|
}
|
|
98
181
|
}
|