@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.30 → 3.5.0-ultramodern.31

package/dist/esm/runtime/effect/backend-federation-manifest/metadata.mjs

@@ -0,0 +1,42 @@
+import { backendFederationMetadata, backendFederationVersionBoundary } from "@modern-js/utils/universal";
+function stringValue(value) {
+    return 'string' == typeof value && value.length > 0 ? value : void 0;
+}
+function isRecord(value) {
+    return 'object' == typeof value && null !== value;
+}
+function recordField(value, field) {
+    const fieldValue = value?.[field];
+    return isRecord(fieldValue) ? fieldValue : void 0;
+}
+function resolveRemoteEntryFromMetadata(manifest) {
+    const metaData = recordField(manifest, 'metaData');
+    const remoteEntry = recordField(metaData, 'remoteEntry');
+    const publicPath = stringValue(metaData?.publicPath) ?? stringValue(metaData?.ssrPublicPath);
+    const entryName = stringValue(remoteEntry?.name);
+    if (!publicPath || !entryName) return;
+    const entryPath = stringValue(remoteEntry?.path) ?? '';
+    const normalizedBase = publicPath.replace(/\/+$/u, '');
+    const normalizedPath = entryPath.replace(/^\/+|\/+$/gu, '');
+    return [
+        normalizedBase,
+        normalizedPath,
+        entryName
+    ].filter(Boolean).join('/');
+}
+function metadata_backendFederationMetadata(manifest) {
+    return backendFederationMetadata(manifest);
+}
+function versionBoundaryMetadata(manifest) {
+    return backendFederationVersionBoundary(manifest);
+}
+function deliveryUnitMetadata(record) {
+    return recordField(record, 'deliveryUnit');
+}
+function manifestDeliveryUnit(backendFederation, boundary) {
+    return {
+        boundary: deliveryUnitMetadata(boundary),
+        top: deliveryUnitMetadata(backendFederation)
+    };
+}
+export { deliveryUnitMetadata, isRecord, manifestDeliveryUnit, metadata_backendFederationMetadata as backendFederationMetadata, recordField, resolveRemoteEntryFromMetadata, stringValue, versionBoundaryMetadata };

package/dist/esm/runtime/effect/backend-federation-manifest/reference.mjs

@@ -0,0 +1,76 @@
+import { BACKEND_FEDERATION_MANIFEST_FILE } from "../backend-federation.mjs";
+import { BackendFederationManifestAdapterError, assertManifestAdapter } from "./errors.mjs";
+import { isRecord } from "./metadata.mjs";
+function getProcessEnv() {
+    return "u" > typeof process ? process.env : void 0;
+}
+function resolveManifestReferenceSource(options) {
+    if (options.manifestPath) return 'path';
+    if (options.manifestUrl) return 'url';
+    if (options.manifestEnv) return 'env';
+}
+function resolveManifestReference(options) {
+    if (options.manifestPath) return options.manifestPath;
+    if (options.manifestUrl) return options.manifestUrl;
+    if (!options.manifestEnv) return;
+    return options.env?.[options.manifestEnv] ?? getProcessEnv()?.[options.manifestEnv];
+}
+function assertExpectedIdentityForReference(options, source) {
+    if (void 0 === source || 'path' === source || options.allowLegacyManifest) return;
+    if (options.expected?.unitId && options.expected.buildMarker) return;
+    throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation ${source} manifest references require expected.unitId and expected.buildMarker. Pass allowLegacyManifest: true to load legacy manifest references.`, void 0, {
+        label: 'expected.deliveryUnit',
+        expected: 'unitId + buildMarker',
+        received: options.expected,
+        referenceSource: source
+    });
+}
+function isHttpUrl(value) {
+    return /^https?:\/\//iu.test(value);
+}
+async function readFileReference(reference) {
+    const [{ fileURLToPath }, fs] = await Promise.all([
+        import("node:url"),
+        import("node:fs/promises")
+    ]);
+    const filePath = reference.startsWith('file:') ? fileURLToPath(reference) : reference;
+    return fs.readFile(filePath, 'utf8');
+}
+async function withTimeout(promise, timeoutMs, label) {
+    if (!timeoutMs || timeoutMs <= 0) return promise;
+    let timeout;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject)=>{
+                timeout = setTimeout(()=>{
+                    reject(new BackendFederationManifestAdapterError('timeout', `[BFF][Effect] ${label} timed out after ${timeoutMs}ms.`));
+                }, timeoutMs);
+            })
+        ]);
+    } finally{
+        if (timeout) clearTimeout(timeout);
+    }
+}
+async function loadBackendFederationManifest(options) {
+    if (options.manifest) return options.manifest;
+    const reference = resolveManifestReference(options);
+    if (!reference) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest reference is missing. Pass manifest, manifestPath, manifestUrl, or manifestEnv for ${BACKEND_FEDERATION_MANIFEST_FILE}.`);
+    assertExpectedIdentityForReference(options, resolveManifestReferenceSource(options));
+    try {
+        const source = isHttpUrl(reference) ? await (async ()=>{
+            const fetchManifest = options.fetch ?? globalThis.fetch;
+            if (!fetchManifest) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} requires a fetch implementation.`);
+            const response = await withTimeout(fetchManifest(reference), options.timeoutMs, `Backend federation manifest ${reference}`);
+            if (!response.ok) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} returned HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ''}.`);
+            return response.text();
+        })() : await withTimeout(readFileReference(reference), options.timeoutMs, `Backend federation manifest ${reference}`);
+        const manifest = JSON.parse(source);
+        assertManifestAdapter(isRecord(manifest), 'manifest_invalid', `[BFF][Effect] Backend federation manifest ${reference} must be a JSON object.`);
+        return manifest;
+    } catch (error) {
+        if (error instanceof BackendFederationManifestAdapterError) throw error;
+        throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} could not be loaded.`, error);
+    }
+}
+export { loadBackendFederationManifest, withTimeout };

package/dist/esm/runtime/effect/backend-federation-manifest/remote.mjs

@@ -0,0 +1,30 @@
+import { backendFederationExposeNames } from "@modern-js/utils/universal";
+import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "../backend-federation.mjs";
+import { assertManifestAdapter } from "./errors.mjs";
+import { backendFederationMetadata, recordField, resolveRemoteEntryFromMetadata, stringValue } from "./metadata.mjs";
+function resolveBackendFederationRemoteFromManifest(manifest, remoteOverride = {}) {
+    const backendFederation = backendFederationMetadata(manifest);
+    const entry = recordField(manifest, 'entry');
+    const metaData = recordField(manifest, 'metaData');
+    const remoteEntry = recordField(metaData, 'remoteEntry');
+    const remoteName = remoteOverride.name ?? stringValue(backendFederation?.name) ?? stringValue(manifest.name) ?? stringValue(manifest.id);
+    const remoteEntryUrl = remoteOverride.entry ?? stringValue(backendFederation?.containerEntry) ?? stringValue(entry?.url) ?? resolveRemoteEntryFromMetadata(manifest);
+    const remoteType = remoteOverride.type ?? stringValue(backendFederation?.remoteType) ?? stringValue(entry?.type) ?? stringValue(remoteEntry?.type) ?? 'module';
+    const expose = remoteOverride.expose ?? backendFederationExposeNames(backendFederation)[0] ?? BACKEND_FEDERATION_EFFECT_EXPOSE;
+    assertManifestAdapter(remoteName, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare a remote name.');
+    assertManifestAdapter(remoteEntryUrl, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare a backend remote entry URL.');
+    assertManifestAdapter(expose === BACKEND_FEDERATION_EFFECT_EXPOSE, 'manifest_invalid', `[BFF][Effect] Backend federation manifest expose must be ${BACKEND_FEDERATION_EFFECT_EXPOSE}.`);
+    return {
+        name: remoteName,
+        entry: remoteEntryUrl,
+        type: remoteType,
+        ...remoteOverride.entryGlobalName ? {
+            entryGlobalName: remoteOverride.entryGlobalName
+        } : {},
+        expose,
+        ...remoteOverride.shareScope ? {
+            shareScope: remoteOverride.shareScope
+        } : {}
+    };
+}
+export { resolveBackendFederationRemoteFromManifest };

package/dist/esm/runtime/effect/backend-federation-manifest/validation.mjs

@@ -0,0 +1,64 @@
+import { formatBackendFederationValidationErrors, validateBackendFederationManifest } from "@modern-js/utils/universal";
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "../backend-federation.mjs";
+import { BackendFederationManifestAdapterError, assertConsistentValue, assertManifestAdapter, assertVersionValue } from "./errors.mjs";
+import { backendFederationMetadata, manifestDeliveryUnit, recordField, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
+function resolveExpectedBuildMarker(expected) {
+    if (void 0 !== expected.buildVersion && void 0 !== expected.buildMarker && expected.buildVersion !== expected.buildMarker) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation expected buildVersion/buildMarker mismatch: buildVersion ${expected.buildVersion}, buildMarker ${expected.buildMarker}.`, void 0, {
+        label: 'expected.buildVersion/buildMarker',
+        expected: expected.buildVersion,
+        received: expected.buildMarker
+    });
+    return expected.buildMarker;
+}
+function validation_validateBackendFederationManifest(manifest, expected = {}) {
+    const expectedBuildMarker = resolveExpectedBuildMarker(expected);
+    const backendFederation = backendFederationMetadata(manifest);
+    assertManifestAdapter(backendFederation, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare backendFederation metadata.');
+    const manifestShape = validateBackendFederationManifest(manifest, {
+        expectedContractVersion: false,
+        expectedNodeAdapterVersion: false,
+        validateDeliveryUnit: false
+    });
+    assertManifestAdapter(manifestShape.ok, 'manifest_invalid', `[BFF][Effect] Backend federation manifest schema invalid: ${formatBackendFederationValidationErrors(manifestShape.errors)}.`);
+    assertManifestAdapter('effect' === backendFederation.runtimeFramework, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare runtimeFramework: "effect".');
+    assertManifestAdapter(true === backendFederation.strictEffectApproach, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare strictEffectApproach: true.');
+    assertVersionValue(stringValue(backendFederation.contractVersion), expected.contractVersion ?? BACKEND_FEDERATION_CONTRACT_VERSION, 'manifest contractVersion');
+    assertVersionValue(stringValue(backendFederation.nodeAdapterVersion), expected.nodeAdapterVersion ?? BACKEND_FEDERATION_NODE_ADAPTER_VERSION, 'manifest nodeAdapterVersion');
+    const boundary = versionBoundaryMetadata(manifest);
+    assertVersionValue(stringValue(backendFederation.name) ?? stringValue(manifest.name) ?? stringValue(manifest.id), expected.remoteName, 'manifest remoteName');
+    assertVersionValue(stringValue(boundary?.packageName), expected.packageName, 'versionBoundary.packageName');
+    assertVersionValue(stringValue(boundary?.version), expected.version, 'versionBoundary.version');
+    assertVersionValue(stringValue(boundary?.buildVersion), expected.buildVersion, 'versionBoundary.buildVersion');
+    assertConsistentValue(stringValue(manifest.version), stringValue(boundary?.version), 'manifest versionBoundary.version');
+    assertConsistentValue(stringValue(manifest.buildVersion), stringValue(boundary?.buildVersion), 'manifest versionBoundary.buildVersion');
+    const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
+    assertConsistentValue(stringValue(deliveryUnit.boundary?.buildMarker), stringValue(boundary?.buildVersion), 'versionBoundary.deliveryUnit.buildMarker vs versionBoundary.buildVersion');
+    assertConsistentValue(stringValue(deliveryUnit.top?.unitId), stringValue(deliveryUnit.boundary?.unitId), 'backendFederation.deliveryUnit.unitId vs versionBoundary.deliveryUnit.unitId');
+    const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
+    assertVersionValue(manifestUnitId, expected.unitId, 'deliveryUnit.unitId');
+    assertVersionValue(stringValue(deliveryUnit.boundary?.buildMarker), expectedBuildMarker, 'deliveryUnit.buildMarker');
+}
+function validateLoadedBackendFederationContract(loaded, manifest, remote) {
+    const loadedContract = loaded.backendFederationContract;
+    const backendFederation = backendFederationMetadata(manifest);
+    const boundary = versionBoundaryMetadata(manifest);
+    const compatibility = recordField(loadedContract, 'compatibility');
+    assertManifestAdapter(compatibility, 'version_mismatch', `[BFF][Effect] Backend federation expose ${remote.name}/${remote.expose?.replace(/^\.\//u, '')} must declare compatibility metadata.`);
+    assertVersionValue(stringValue(loadedContract?.role), 'microvertical-server', 'expose role');
+    assertVersionValue(stringValue(loadedContract?.name), remote.name, 'expose name');
+    assertVersionValue(stringValue(compatibility.contractVersion), stringValue(backendFederation?.contractVersion), 'expose contractVersion');
+    assertVersionValue(stringValue(compatibility.nodeAdapterVersion), stringValue(backendFederation?.nodeAdapterVersion), 'expose nodeAdapterVersion');
+    assertVersionValue(stringValue(compatibility.packageName), stringValue(boundary?.packageName), 'expose packageName');
+    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
+    const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
+    const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
+    const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
+    assertConsistentValue(manifestUnitId, stringValue(compatibility.unitId), 'deliveryUnit.unitId vs expose compatibility.unitId');
+    assertConsistentValue(manifestBuildMarker, stringValue(compatibility.build), 'deliveryUnit.buildMarker vs expose compatibility.build');
+}
+function classifyLoadError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes('strictEffectApproach') || message.includes('runtimeFramework')) return 'strict_effect_required';
+    return 'remote_unavailable';
+}
+export { classifyLoadError, validateLoadedBackendFederationContract, validation_validateBackendFederationManifest as validateBackendFederationManifest };

package/dist/esm/runtime/effect/backend-federation-manifest.mjs

@@ -1,237 +1 @@
-import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, loadBackendFederatedEffectApi } from "./backend-federation.mjs";
-const BACKEND_FEDERATION_MANIFEST_ADAPTER_FAILURE_EVENT = 'modernjs:microvertical-server-fallback';
-class BackendFederationManifestAdapterError extends Error {
-    constructor(code, message, cause, details){
-        super(message), this.failureEvent = BACKEND_FEDERATION_MANIFEST_ADAPTER_FAILURE_EVENT;
-        this.name = 'BackendFederationManifestAdapterError';
-        this.code = code;
-        if (details) this.details = details;
-        if (void 0 !== cause) this.cause = cause;
-    }
-}
-function stringValue(value) {
-    return 'string' == typeof value && value.length > 0 ? value : void 0;
-}
-function isRecord(value) {
-    return 'object' == typeof value && null !== value;
-}
-function recordField(value, field) {
-    const fieldValue = value?.[field];
-    return isRecord(fieldValue) ? fieldValue : void 0;
-}
-function assertManifestAdapter(condition, code, message) {
-    if (!condition) throw new BackendFederationManifestAdapterError(code, message);
-}
-function assertVersionValue(actual, expected, label, details) {
-    if (void 0 === expected) return;
-    if (actual !== expected) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation ${label} mismatch: expected ${expected}, received ${actual ?? 'undefined'}.`, void 0, {
-        label,
-        expected,
-        received: actual,
-        ...details
-    });
-}
-function assertConsistentValue(left, right, label, details) {
-    if (void 0 === left || void 0 === right || left === right) return;
-    throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation ${label} mismatch: expected ${left}, received ${right}.`, void 0, {
-        label,
-        expected: left,
-        received: right,
-        ...details
-    });
-}
-function getProcessEnv() {
-    return "u" > typeof process ? process.env : void 0;
-}
-function resolveManifestReference(options) {
-    if (options.manifestPath) return options.manifestPath;
-    if (options.manifestUrl) return options.manifestUrl;
-    if (!options.manifestEnv) return;
-    return options.env?.[options.manifestEnv] ?? getProcessEnv()?.[options.manifestEnv];
-}
-function isHttpUrl(value) {
-    return /^https?:\/\//iu.test(value);
-}
-async function readFileReference(reference) {
-    const [{ fileURLToPath }, fs] = await Promise.all([
-        import("node:url"),
-        import("node:fs/promises")
-    ]);
-    const filePath = reference.startsWith('file:') ? fileURLToPath(reference) : reference;
-    return fs.readFile(filePath, 'utf8');
-}
-async function withTimeout(promise, timeoutMs, label) {
-    if (!timeoutMs || timeoutMs <= 0) return promise;
-    let timeout;
-    try {
-        return await Promise.race([
-            promise,
-            new Promise((_, reject)=>{
-                timeout = setTimeout(()=>{
-                    reject(new BackendFederationManifestAdapterError('timeout', `[BFF][Effect] ${label} timed out after ${timeoutMs}ms.`));
-                }, timeoutMs);
-            })
-        ]);
-    } finally{
-        if (timeout) clearTimeout(timeout);
-    }
-}
-function resolveRemoteEntryFromMetadata(manifest) {
-    const metaData = recordField(manifest, 'metaData');
-    const remoteEntry = recordField(metaData, 'remoteEntry');
-    const publicPath = stringValue(metaData?.publicPath) ?? stringValue(metaData?.ssrPublicPath);
-    const entryName = stringValue(remoteEntry?.name);
-    if (!publicPath || !entryName) return;
-    const entryPath = stringValue(remoteEntry?.path) ?? '';
-    const normalizedBase = publicPath.replace(/\/+$/u, '');
-    const normalizedPath = entryPath.replace(/^\/+|\/+$/gu, '');
-    return [
-        normalizedBase,
-        normalizedPath,
-        entryName
-    ].filter(Boolean).join('/');
-}
-function backendFederationMetadata(manifest) {
-    return recordField(manifest, 'backendFederation');
-}
-function versionBoundaryMetadata(manifest) {
-    return recordField(backendFederationMetadata(manifest), 'versionBoundary');
-}
-function deliveryUnitMetadata(record) {
-    return recordField(record, 'deliveryUnit');
-}
-function manifestDeliveryUnit(backendFederation, boundary) {
-    return {
-        boundary: deliveryUnitMetadata(boundary),
-        top: deliveryUnitMetadata(backendFederation)
-    };
-}
-function resolveExpectedBuildMarker(expected) {
-    if (void 0 !== expected.buildVersion && void 0 !== expected.buildMarker && expected.buildVersion !== expected.buildMarker) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation expected buildVersion/buildMarker mismatch: buildVersion ${expected.buildVersion}, buildMarker ${expected.buildMarker}.`, void 0, {
-        label: 'expected.buildVersion/buildMarker',
-        expected: expected.buildVersion,
-        received: expected.buildMarker
-    });
-    return expected.buildMarker;
-}
-function validateBackendFederationManifest(manifest, expected = {}) {
-    const expectedBuildMarker = resolveExpectedBuildMarker(expected);
-    const backendFederation = backendFederationMetadata(manifest);
-    assertManifestAdapter(backendFederation, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare backendFederation metadata.');
-    assertManifestAdapter('effect' === backendFederation.runtimeFramework, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare runtimeFramework: "effect".');
-    assertManifestAdapter(true === backendFederation.strictEffectApproach, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare strictEffectApproach: true.');
-    assertVersionValue(stringValue(backendFederation.contractVersion), expected.contractVersion ?? BACKEND_FEDERATION_CONTRACT_VERSION, 'manifest contractVersion');
-    assertVersionValue(stringValue(backendFederation.nodeAdapterVersion), expected.nodeAdapterVersion ?? BACKEND_FEDERATION_NODE_ADAPTER_VERSION, 'manifest nodeAdapterVersion');
-    const boundary = versionBoundaryMetadata(manifest);
-    assertVersionValue(stringValue(backendFederation.name) ?? stringValue(manifest.name) ?? stringValue(manifest.id), expected.remoteName, 'manifest remoteName');
-    assertVersionValue(stringValue(boundary?.packageName), expected.packageName, 'versionBoundary.packageName');
-    assertVersionValue(stringValue(boundary?.version), expected.version, 'versionBoundary.version');
-    assertVersionValue(stringValue(boundary?.buildVersion), expected.buildVersion, 'versionBoundary.buildVersion');
-    assertConsistentValue(stringValue(manifest.version), stringValue(boundary?.version), 'manifest versionBoundary.version');
-    assertConsistentValue(stringValue(manifest.buildVersion), stringValue(boundary?.buildVersion), 'manifest versionBoundary.buildVersion');
-    const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
-    assertConsistentValue(stringValue(deliveryUnit.boundary?.buildMarker), stringValue(boundary?.buildVersion), 'versionBoundary.deliveryUnit.buildMarker vs versionBoundary.buildVersion');
-    assertConsistentValue(stringValue(deliveryUnit.top?.unitId), stringValue(deliveryUnit.boundary?.unitId), 'backendFederation.deliveryUnit.unitId vs versionBoundary.deliveryUnit.unitId');
-    const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
-    assertVersionValue(manifestUnitId, expected.unitId, 'deliveryUnit.unitId');
-    assertVersionValue(stringValue(deliveryUnit.boundary?.buildMarker), expectedBuildMarker, 'deliveryUnit.buildMarker');
-}
-function validateLoadedBackendFederationContract(loaded, manifest, remote) {
-    const loadedContract = loaded.backendFederationContract;
-    const backendFederation = backendFederationMetadata(manifest);
-    const boundary = versionBoundaryMetadata(manifest);
-    const compatibility = recordField(loadedContract, 'compatibility');
-    assertManifestAdapter(compatibility, 'version_mismatch', `[BFF][Effect] Backend federation expose ${remote.name}/${remote.expose?.replace(/^\.\//u, '')} must declare compatibility metadata.`);
-    assertVersionValue(stringValue(loadedContract?.role), 'microvertical-server', 'expose role');
-    assertVersionValue(stringValue(loadedContract?.name), remote.name, 'expose name');
-    assertVersionValue(stringValue(compatibility.contractVersion), stringValue(backendFederation?.contractVersion), 'expose contractVersion');
-    assertVersionValue(stringValue(compatibility.nodeAdapterVersion), stringValue(backendFederation?.nodeAdapterVersion), 'expose nodeAdapterVersion');
-    assertVersionValue(stringValue(compatibility.packageName), stringValue(boundary?.packageName), 'expose packageName');
-    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
-    const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
-    const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
-    const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
-    assertConsistentValue(manifestUnitId, stringValue(compatibility.unitId), 'deliveryUnit.unitId vs expose compatibility.unitId');
-    assertConsistentValue(manifestBuildMarker, stringValue(compatibility.build), 'deliveryUnit.buildMarker vs expose compatibility.build');
-}
-function classifyLoadError(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (message.includes('strictEffectApproach') || message.includes('runtimeFramework')) return 'strict_effect_required';
-    return 'remote_unavailable';
-}
-async function loadBackendFederationManifest(options) {
-    if (options.manifest) return options.manifest;
-    const reference = resolveManifestReference(options);
-    if (!reference) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest reference is missing. Pass manifest, manifestPath, manifestUrl, or manifestEnv for ${BACKEND_FEDERATION_MANIFEST_FILE}.`);
-    try {
-        const source = isHttpUrl(reference) ? await (async ()=>{
-            const fetchManifest = options.fetch ?? globalThis.fetch;
-            if (!fetchManifest) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} requires a fetch implementation.`);
-            const response = await withTimeout(fetchManifest(reference), options.timeoutMs, `Backend federation manifest ${reference}`);
-            if (!response.ok) throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} returned HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ''}.`);
-            return response.text();
-        })() : await withTimeout(readFileReference(reference), options.timeoutMs, `Backend federation manifest ${reference}`);
-        const manifest = JSON.parse(source);
-        assertManifestAdapter(isRecord(manifest), 'manifest_invalid', `[BFF][Effect] Backend federation manifest ${reference} must be a JSON object.`);
-        return manifest;
-    } catch (error) {
-        if (error instanceof BackendFederationManifestAdapterError) throw error;
-        throw new BackendFederationManifestAdapterError('manifest_unavailable', `[BFF][Effect] Backend federation manifest ${reference} could not be loaded.`, error);
-    }
-}
-function resolveBackendFederationRemoteFromManifest(manifest, remoteOverride = {}) {
-    const backendFederation = backendFederationMetadata(manifest);
-    const entry = recordField(manifest, 'entry');
-    const metaData = recordField(manifest, 'metaData');
-    const remoteEntry = recordField(metaData, 'remoteEntry');
-    const remoteName = remoteOverride.name ?? stringValue(backendFederation?.name) ?? stringValue(manifest.name) ?? stringValue(manifest.id);
-    const remoteEntryUrl = remoteOverride.entry ?? stringValue(backendFederation?.containerEntry) ?? stringValue(entry?.url) ?? resolveRemoteEntryFromMetadata(manifest);
-    const remoteType = remoteOverride.type ?? stringValue(backendFederation?.remoteType) ?? stringValue(entry?.type) ?? stringValue(remoteEntry?.type) ?? 'module';
-    const expose = remoteOverride.expose ?? stringValue(backendFederation?.expose) ?? BACKEND_FEDERATION_EFFECT_EXPOSE;
-    assertManifestAdapter(remoteName, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare a remote name.');
-    assertManifestAdapter(remoteEntryUrl, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare a backend remote entry URL.');
-    assertManifestAdapter(expose === BACKEND_FEDERATION_EFFECT_EXPOSE, 'manifest_invalid', `[BFF][Effect] Backend federation manifest expose must be ${BACKEND_FEDERATION_EFFECT_EXPOSE}.`);
-    return {
-        name: remoteName,
-        entry: remoteEntryUrl,
-        type: remoteType,
-        ...remoteOverride.entryGlobalName ? {
-            entryGlobalName: remoteOverride.entryGlobalName
-        } : {},
-        expose,
-        ...remoteOverride.shareScope ? {
-            shareScope: remoteOverride.shareScope
-        } : {}
-    };
-}
-async function loadBackendFederatedEffectApiFromManifest(options) {
-    let manifest;
-    let remote;
-    try {
-        manifest = await loadBackendFederationManifest(options);
-        validateBackendFederationManifest(manifest, options.expected);
-        remote = resolveBackendFederationRemoteFromManifest(manifest, options.remote);
-        const loaded = await withTimeout(loadBackendFederatedEffectApi({
-            hostName: options.hostName,
-            remote,
-            ...options.plugins ? {
-                plugins: options.plugins
-            } : {},
-            ...options.runtime ? {
-                runtime: options.runtime
-            } : {}
-        }), options.timeoutMs, `Backend federation remote ${remote.name}`).catch((error)=>{
-            throw new BackendFederationManifestAdapterError(classifyLoadError(error), `[BFF][Effect] Backend federation remote ${remote?.name ?? 'unknown'} could not load ${remote?.expose ?? BACKEND_FEDERATION_EFFECT_EXPOSE}.`, error);
-        });
-        validateLoadedBackendFederationContract(loaded, manifest, remote);
-        return loaded;
-    } catch (error) {
-        const adapterError = error instanceof BackendFederationManifestAdapterError ? error : new BackendFederationManifestAdapterError('remote_unavailable', '[BFF][Effect] Backend federation manifest adapter failed.', error);
-        if (options.fallback) return options.fallback(adapterError, {
-            manifest,
-            remote
-        });
-        throw adapterError;
-    }
-}
-export { BACKEND_FEDERATION_MANIFEST_ADAPTER_FAILURE_EVENT, BackendFederationManifestAdapterError, loadBackendFederatedEffectApiFromManifest, loadBackendFederationManifest, resolveBackendFederationRemoteFromManifest };
+export * from "./backend-federation-manifest/index.mjs";

package/dist/esm/runtime/effect/backend-federation.mjs

@@ -1,132 +1,4 @@
-const BACKEND_FEDERATION_EFFECT_EXPOSE = './effect-api';
-const BACKEND_FEDERATION_MANIFEST_FILE = 'backend-mf-manifest.json';
-const BACKEND_FEDERATION_CONTRACT_VERSION = 'microvertical-server-effect-v1';
-const BACKEND_FEDERATION_NODE_ADAPTER_VERSION = 'backend-mf-effect-v1';
-function normalizeExpose(expose) {
-    return expose.replace(/^\.\//u, '');
-}
-function exposeForRemoteRequest(expose) {
-    return `./${normalizeExpose(expose)}`;
-}
-function isRecord(value) {
-    return 'object' == typeof value && null !== value;
-}
-function collectRemotes(options) {
-    const remotes = [
-        ...options.remotes ?? []
-    ];
-    if (options.remote) {
-        const existingIndex = remotes.findIndex((remote)=>remote.name === options.remote?.name);
-        if (existingIndex >= 0) remotes[existingIndex] = options.remote;
-        else remotes.push(options.remote);
-    }
-    return remotes;
-}
-function parseRemoteRequest(request) {
-    const [remoteName, ...exposeParts] = request.split('/');
-    if (!remoteName || 0 === exposeParts.length) throw new Error(`[BFF][Effect] Invalid backend federation request ${request}.`);
-    return {
-        remoteName,
-        expose: exposeForRemoteRequest(exposeParts.join('/'))
-    };
-}
-function decodeDataUrl(url) {
-    const commaIndex = url.indexOf(',');
-    if (commaIndex < 0) throw new Error('[BFF][Effect] Invalid backend federation data URL entry.');
-    return decodeURIComponent(url.slice(commaIndex + 1));
-}
-async function readCommonJsEntrySource(remote) {
-    if (remote.entry.startsWith('data:')) return decodeDataUrl(remote.entry);
-    if (remote.entry.startsWith('http://') || remote.entry.startsWith('https://')) {
-        const response = await fetch(remote.entry);
-        if (!response.ok) throw new Error(`[BFF][Effect] Failed to load backend federation remote ${remote.name}: ${response.status}`);
-        return response.text();
-    }
-    throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} cannot load CommonJS entry ${remote.entry}.`);
-}
-function evaluateCommonJsEntry(remote, source) {
-    const module = {
-        exports: {}
-    };
-    const exports = module.exports;
-    const evaluate = new Function('module', 'exports', 'globalThis', source);
-    evaluate(module, exports, globalThis);
-    const entry = module.exports.default ?? module.exports;
-    if (!isRecord(entry)) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} entry must load object module.`);
-    return entry;
-}
-async function importModuleEntry(remote) {
-    const entry = await import(remote.entry);
-    return entry.default ?? entry;
-}
-async function resolvePluginEntry(remote, plugins) {
-    for (const plugin of plugins ?? []){
-        const loadEntry = plugin.loadEntry;
-        if ('function' != typeof loadEntry) continue;
-        const entry = await loadEntry({
-            remoteInfo: remote
-        });
-        if (entry) return entry;
-    }
-}
-async function loadBackendFederationEntry(remote, plugins) {
-    const pluginEntry = await resolvePluginEntry(remote, plugins);
-    if (pluginEntry) return pluginEntry;
-    if (remote.entryGlobalName) {
-        const globalEntry = globalThis[remote.entryGlobalName];
-        if (isRecord(globalEntry)) return globalEntry;
-    }
-    if ('module' === remote.type || remote.entry.startsWith('file:')) return importModuleEntry(remote);
-    return evaluateCommonJsEntry(remote, await readCommonJsEntrySource(remote));
-}
-async function loadBackendFederationExpose(remote, expose, options) {
-    const entry = await loadBackendFederationEntry(remote, options.plugins);
-    if ('function' == typeof entry.init) await entry.init({
-        hostName: options.hostName
-    });
-    if ('function' != typeof entry.get) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} entry must expose get().`);
-    const factory = await entry.get(expose);
-    if ('function' != typeof factory) throw new Error(`[BFF][Effect] Backend federation expose ${remote.name}/${normalizeExpose(expose)} must load factory function.`);
-    return factory();
-}
-function createBackendFederationRuntime(options) {
-    const remotes = collectRemotes(options);
-    return {
-        async loadRemote (request) {
-            const { remoteName, expose } = parseRemoteRequest(request);
-            const remote = remotes.find((candidate)=>candidate.name === remoteName);
-            if (!remote) throw new Error(`[BFF][Effect] Missing backend federation remote ${remoteName}.`);
-            return loadBackendFederationExpose(remote, expose, options);
-        }
-    };
-}
-function createBackendFederationLoadEntryPlugin(options) {
-    return {
-        name: 'modernjs-backend-federation-load-entry',
-        async loadEntry ({ remoteInfo }) {
-            return options.resolveEntry({
-                name: remoteInfo.name,
-                entry: remoteInfo.entry,
-                type: remoteInfo.type,
-                entryGlobalName: remoteInfo.entryGlobalName,
-                shareScope: remoteInfo.shareScope
-            });
-        }
-    };
-}
-async function loadBackendFederatedEffectApi(options) {
-    const remoteName = options.remote?.name ?? options.remoteName;
-    if (!remoteName) throw new Error('[BFF][Effect] Missing backend federation remote name.');
-    const runtime = options.runtime ?? createBackendFederationRuntime(options);
-    const expose = options.expose ?? options.remote?.expose ?? BACKEND_FEDERATION_EFFECT_EXPOSE;
-    const remoteRequest = `${remoteName}/${normalizeExpose(expose)}`;
-    const loaded = await runtime.loadRemote(remoteRequest);
-    if (!isRecord(loaded)) throw new Error(`[BFF][Effect] Backend federation expose ${remoteRequest} must load an object module.`);
-    const backendContract = loaded.backendFederationContract;
-    if (!isRecord(backendContract) || true !== backendContract.strictEffectApproach) throw new Error(`[BFF][Effect] Backend federation expose ${remoteRequest} must expose strict Effect metadata (strictEffectApproach: true).`);
-    if ('effect' !== backendContract.runtimeFramework) throw new Error(`[BFF][Effect] Backend federation expose ${remoteRequest} must expose strict Effect metadata (runtimeFramework: "effect").`);
-    if ('string' == typeof backendContract.name && backendContract.name !== remoteName) throw new Error(`[BFF][Effect] Backend federation expose ${remoteRequest} metadata name mismatch: expected ${remoteName}, received ${backendContract.name}.`);
-    if (!('runtime' in loaded)) throw new Error(`[BFF][Effect] Backend federation expose ${remoteRequest} must expose api and runtime.`);
-    return loaded;
-}
-export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, createBackendFederationLoadEntryPlugin, createBackendFederationRuntime, loadBackendFederatedEffectApi };
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "@modern-js/utils/universal";
+export { loadBackendFederatedEffectApi } from "./backend-federation/load.mjs";
+export { createBackendFederationLoadEntryPlugin } from "./backend-federation/plugin.mjs";
+export { createBackendFederationRuntime } from "./backend-federation/runtime.mjs";