@bleedingdev/modern-js-backend-federation-contracts 3.9.0-ultramodern.8 → 3.9.3-ultramodern.1

package/dist/cjs/backend-federation-contract/build-artifact.js

@@ -28,6 +28,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    assertUltramodernBuildArtifact: ()=>assertUltramodernBuildArtifact,
     createUltramodernBuildArtifact: ()=>createUltramodernBuildArtifact,
     isUltramodernBuildArtifact: ()=>isUltramodernBuildArtifact,
     stampUltramodernBuildArtifactIdentity: ()=>stampUltramodernBuildArtifactIdentity,
@@ -36,8 +37,42 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_constants_js_namespaceObject = require("./constants.js");
 const external_delivery_unit_js_namespaceObject = require("./delivery-unit.js");
+const external_renderer_profile_js_namespaceObject = require("./renderer-profile.js");
+const external_renderer_router_bindings_js_namespaceObject = require("./renderer-router-bindings.js");
 const external_validation_core_js_namespaceObject = require("./validation-core.js");
-const createUltramodernBuildArtifact = (record)=>{
+const immutableRendererProfile = (profile)=>Object.freeze({
+        ...profile,
+        compiler: Object.freeze({
+            ...profile.compiler
+        }),
+        hydration: Object.freeze({
+            ...profile.hydration
+        }),
+        router: Object.freeze({
+            ...profile.router
+        })
+    });
+const validateUiRouterBindings = (ui, primaryEntryName, path)=>{
+    const errors = [];
+    if (!Object.hasOwn(ui, 'routerBindings')) {
+        (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'is required on the UI surface.');
+        return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+    }
+    const bindings = ui.routerBindings;
+    errors.push(...(0, external_renderer_router_bindings_js_namespaceObject.validateRendererRouterBindings)(bindings, (0, external_validation_core_js_namespaceObject.isRecord)(bindings) ? Object.keys(bindings) : [], path).errors);
+    if ('string' == typeof primaryEntryName && (!(0, external_validation_core_js_namespaceObject.isRecord)(bindings) || !Object.hasOwn(bindings, primaryEntryName))) (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'must include the primary renderer entry.');
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const createUltramodernBuildArtifact = (record, options = {})=>{
+    if (Object.hasOwn(options, 'ui')) {
+        if (!options.ui) throw new Error('artifact.ui must contain an explicit identity and profile.');
+        const errors = [
+            ...(0, external_renderer_profile_js_namespaceObject.validateRendererIdentity)(options.ui.identity, 'artifact.ui.identity').errors,
+            ...(0, external_renderer_profile_js_namespaceObject.validateRendererProfile)(options.ui.profile, 'artifact.ui.profile').errors,
+            ...validateUiRouterBindings(options.ui, (0, external_validation_core_js_namespaceObject.isRecord)(options.ui.identity) ? options.ui.identity.entryName : void 0, 'artifact.ui.routerBindings').errors
+        ];
+        if (errors.length) throw new Error((0, external_validation_core_js_namespaceObject.formatBackendFederationValidationErrors)(errors));
+    }
     const deliveryUnit = {
         appId: record.appId,
         build: record.buildMarker,
@@ -50,41 +85,30 @@ const createUltramodernBuildArtifact = (record)=>{
         unitId: record.unitId,
         version: record.version
     };
-    const api = {
-        appId: deliveryUnit.appId,
-        build: deliveryUnit.build,
-        buildMarker: deliveryUnit.buildMarker,
-        deployProfile: deliveryUnit.deployProfile,
-        kind: deliveryUnit.kind,
-        packageName: deliveryUnit.packageName,
-        schemaVersion: deliveryUnit.schemaVersion,
-        sourceRevision: deliveryUnit.sourceRevision,
-        surface: 'api',
-        unitId: deliveryUnit.unitId,
-        version: deliveryUnit.version
-    };
-    const ui = {
-        appId: deliveryUnit.appId,
-        build: deliveryUnit.build,
-        buildMarker: deliveryUnit.buildMarker,
-        deployProfile: deliveryUnit.deployProfile,
-        kind: deliveryUnit.kind,
-        packageName: deliveryUnit.packageName,
-        schemaVersion: deliveryUnit.schemaVersion,
-        sourceRevision: deliveryUnit.sourceRevision,
-        surface: 'ui',
-        unitId: deliveryUnit.unitId,
-        version: deliveryUnit.version
-    };
-    return {
+    const artifact = {
         deliveryUnit,
         kind: 'ultramodern-build-artifact',
-        schemaVersion: external_constants_js_namespaceObject.DELIVERY_UNIT_SCHEMA_VERSION,
+        schemaVersion: external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION,
         surfaces: {
-            api,
-            ui
+            api: {
+                ...deliveryUnit,
+                surface: 'api'
+            },
+            ...options.ui ? {
+                ui: {
+                    ...deliveryUnit,
+                    surface: 'ui',
+                    rendererIdentity: Object.freeze({
+                        ...options.ui.identity
+                    }),
+                    rendererProfile: immutableRendererProfile(options.ui.profile),
+                    routerBindings: (0, external_renderer_router_bindings_js_namespaceObject.immutableRendererRouterBindings)(options.ui.routerBindings)
+                }
+            } : {}
         }
     };
+    assertUltramodernBuildArtifact(artifact);
+    return artifact;
 };
 const validateUltramodernBuildArtifact = (value, path = 'artifact')=>{
     const errors = [];
@@ -92,14 +116,24 @@ const validateUltramodernBuildArtifact = (value, path = 'artifact')=>{
         (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'must be an object.');
         return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
     }
-    if (value.schemaVersion !== external_constants_js_namespaceObject.DELIVERY_UNIT_SCHEMA_VERSION) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.schemaVersion`, `must be ${external_constants_js_namespaceObject.DELIVERY_UNIT_SCHEMA_VERSION}.`);
+    for (const field of Object.keys(value))if (![
+        'schemaVersion',
+        'kind',
+        'deliveryUnit',
+        'surfaces'
+    ].includes(field)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.${field}`, 'is not a supported field.');
+    if (value.schemaVersion !== external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.schemaVersion`, `must be ${external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION}.`);
     if ('ultramodern-build-artifact' !== value.kind) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.kind`, 'must be "ultramodern-build-artifact".');
     const deliveryUnit = value.deliveryUnit;
     errors.push(...(0, external_delivery_unit_js_namespaceObject.validateDeliveryUnitRecord)(deliveryUnit, {
-        path: `${path}.deliveryUnit`,
-        allowBuildAlias: true
+        path: `${path}.deliveryUnit`
     }).errors);
     if ((0, external_validation_core_js_namespaceObject.isRecord)(deliveryUnit)) {
+        for (const field of [
+            'rendererIdentity',
+            'rendererProfile',
+            'routerBindings'
+        ])if (Object.hasOwn(deliveryUnit, field)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.deliveryUnit.${field}`, 'is only allowed on the UI surface.');
         const build = (0, external_validation_core_js_namespaceObject.nonEmptyString)(deliveryUnit.build);
         const buildMarker = (0, external_validation_core_js_namespaceObject.nonEmptyString)(deliveryUnit.buildMarker);
         if (build) {
@@ -111,15 +145,16 @@ const validateUltramodernBuildArtifact = (value, path = 'artifact')=>{
         (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.surfaces`, 'must be an object.');
         return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
     }
+    for (const surface of Object.keys(surfaces))if ('api' !== surface && 'ui' !== surface) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.surfaces.${surface}`, 'is not a supported surface.');
     for (const surface of [
         'ui',
         'api'
     ]){
+        if ('ui' === surface && !Object.hasOwn(surfaces, 'ui')) continue;
         const marker = surfaces[surface];
         const markerPath = `${path}.surfaces.${surface}`;
         errors.push(...(0, external_delivery_unit_js_namespaceObject.validateDeliveryUnitRecord)(marker, {
-            path: markerPath,
-            allowBuildAlias: true
+            path: markerPath
         }).errors);
         if (!(0, external_validation_core_js_namespaceObject.isRecord)(marker)) continue;
         const markerBuild = (0, external_validation_core_js_namespaceObject.nonEmptyString)(marker.build);
@@ -128,52 +163,95 @@ const validateUltramodernBuildArtifact = (value, path = 'artifact')=>{
             if (markerBuildMarker && markerBuild !== markerBuildMarker) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.build`, 'must match buildMarker.');
         } else (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.build`, 'must be non-empty string.');
         if (marker.surface !== surface) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.surface`, `must be "${surface}".`);
+        if ('api' === surface) {
+            for (const field of [
+                'rendererIdentity',
+                'rendererProfile',
+                'routerBindings'
+            ])if (Object.hasOwn(marker, field)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.${field}`, 'is forbidden on the API surface.');
+        } else {
+            errors.push(...(0, external_renderer_profile_js_namespaceObject.validateRendererIdentity)(marker.rendererIdentity, `${markerPath}.rendererIdentity`).errors, ...(0, external_renderer_profile_js_namespaceObject.validateRendererProfile)(marker.rendererProfile, `${markerPath}.rendererProfile`).errors);
+            const rendererIdentity = (0, external_validation_core_js_namespaceObject.recordField)(marker, 'rendererIdentity');
+            const rendererProfile = (0, external_validation_core_js_namespaceObject.recordField)(marker, 'rendererProfile');
+            errors.push(...validateUiRouterBindings(marker, rendererIdentity?.entryName, `${markerPath}.routerBindings`).errors);
+            if (rendererIdentity) {
+                if (rendererIdentity.appId !== marker.appId) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.rendererIdentity.appId`, 'must match the UI delivery-unit appId.');
+                if (rendererIdentity.buildId !== marker.buildMarker) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.rendererIdentity.buildId`, 'must match the UI delivery-unit buildMarker.');
+            }
+            if (rendererIdentity && rendererProfile) {
+                for (const field of [
+                    'renderer',
+                    'protocolVersion'
+                ])if (rendererIdentity[field] !== rendererProfile[field]) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.rendererProfile.${field}`, 'must match the renderer identity.');
+            }
+        }
         for (const field of external_constants_js_namespaceObject.DELIVERY_UNIT_IDENTITY_FIELDS){
-            const deliveryUnitValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(deliveryUnit, field, {
-                allowBuildAlias: true
-            });
-            const markerValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(marker, field, {
-                allowBuildAlias: true
-            });
+            const deliveryUnitValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(deliveryUnit, field);
+            const markerValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(marker, field);
             if (void 0 !== deliveryUnitValue && void 0 !== markerValue && deliveryUnitValue !== markerValue) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.${field}`, `must match ${path}.deliveryUnit.${field}.`);
         }
+        if ((0, external_validation_core_js_namespaceObject.isRecord)(deliveryUnit)) {
+            for (const field of [
+                'appId',
+                'packageName',
+                'version',
+                'deployProfile',
+                'schemaVersion',
+                'kind'
+            ])if (marker[field] !== deliveryUnit[field]) (0, external_validation_core_js_namespaceObject.addError)(errors, `${markerPath}.${field}`, `must match ${path}.deliveryUnit.${field}.`);
+        }
     }
     return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
 };
 const isUltramodernBuildArtifact = (value)=>validateUltramodernBuildArtifact(value).ok;
-const stampUltramodernBuildArtifactIdentity = (artifact, identity)=>({
+function assertUltramodernBuildArtifact(value, path = 'artifact') {
+    const result = validateUltramodernBuildArtifact(value, path);
+    if (!result.ok) throw new Error((0, external_validation_core_js_namespaceObject.formatBackendFederationValidationErrors)(result.errors));
+}
+const stampUltramodernBuildArtifactIdentity = (artifact, identity)=>{
+    assertUltramodernBuildArtifact(artifact);
+    const stamped = {
+        build: identity.buildMarker,
+        buildMarker: identity.buildMarker,
+        sourceRevision: identity.sourceRevision
+    };
+    const stamp = (value)=>({
+            ...value,
+            ...stamped
+        });
+    const result = {
         ...artifact,
-        deliveryUnit: {
-            ...artifact.deliveryUnit,
-            build: identity.buildMarker,
-            buildMarker: identity.buildMarker,
-            sourceRevision: identity.sourceRevision
-        },
+        deliveryUnit: stamp(artifact.deliveryUnit),
         surfaces: {
-            ui: {
-                ...artifact.surfaces.ui,
-                build: identity.buildMarker,
-                buildMarker: identity.buildMarker,
-                sourceRevision: identity.sourceRevision
-            },
-            api: {
-                ...artifact.surfaces.api,
-                build: identity.buildMarker,
-                buildMarker: identity.buildMarker,
-                sourceRevision: identity.sourceRevision
-            }
+            api: stamp(artifact.surfaces.api),
+            ...artifact.surfaces.ui ? {
+                ui: {
+                    ...stamp(artifact.surfaces.ui),
+                    rendererIdentity: Object.freeze({
+                        ...artifact.surfaces.ui.rendererIdentity,
+                        buildId: identity.buildMarker
+                    }),
+                    rendererProfile: immutableRendererProfile(artifact.surfaces.ui.rendererProfile),
+                    routerBindings: (0, external_renderer_router_bindings_js_namespaceObject.immutableRendererRouterBindings)(artifact.surfaces.ui.routerBindings)
+                }
+            } : {}
         }
-    });
+    };
+    assertUltramodernBuildArtifact(result);
+    return result;
+};
 const stampUltramodernBuildArtifactSourceRevision = (artifact, sourceRevision)=>stampUltramodernBuildArtifactIdentity(artifact, {
         buildMarker: artifact.deliveryUnit.buildMarker,
         sourceRevision
     });
+exports.assertUltramodernBuildArtifact = __webpack_exports__.assertUltramodernBuildArtifact;
 exports.createUltramodernBuildArtifact = __webpack_exports__.createUltramodernBuildArtifact;
 exports.isUltramodernBuildArtifact = __webpack_exports__.isUltramodernBuildArtifact;
 exports.stampUltramodernBuildArtifactIdentity = __webpack_exports__.stampUltramodernBuildArtifactIdentity;
 exports.stampUltramodernBuildArtifactSourceRevision = __webpack_exports__.stampUltramodernBuildArtifactSourceRevision;
 exports.validateUltramodernBuildArtifact = __webpack_exports__.validateUltramodernBuildArtifact;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "assertUltramodernBuildArtifact",
     "createUltramodernBuildArtifact",
     "isUltramodernBuildArtifact",
     "stampUltramodernBuildArtifactIdentity",

package/dist/cjs/backend-federation-contract/constants.js

@@ -31,7 +31,7 @@ const BACKEND_FEDERATION_EFFECT_EXPOSE = './effect-api';
 const BACKEND_FEDERATION_MANIFEST_FILE = 'backend-mf-manifest.json';
 const BACKEND_FEDERATION_REMOTE_ENTRY_FILE = 'backendRemoteEntry.cjs';
 const BACKEND_FEDERATION_CONTRACT_VERSION = 'microvertical-server-effect-v1';
-const BACKEND_FEDERATION_NODE_ADAPTER_VERSION = 'backend-mf-effect-v1';
+const BACKEND_FEDERATION_NODE_ADAPTER_VERSION = 'backend-mf-effect-v2';
 const DELIVERY_UNIT_SCHEMA_VERSION = 1;
 const DELIVERY_UNIT_KIND = 'microvertical-delivery-unit';
 const DELIVERY_UNIT_DEPLOY_PROFILE = 'cloudflare-ssr-mf-effect-v1';
@@ -41,6 +41,7 @@ const DELIVERY_UNIT_IDENTITY_FIELDS = [
     'sourceRevision'
 ];
 const ULTRAMODERN_BUILD_ARTIFACT_FILE = 'ultramodern-build.json';
+const ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION = 2;
 const ULTRAMODERN_BUILD_ARTIFACT_PATH = `shared/${ULTRAMODERN_BUILD_ARTIFACT_FILE}`;
 const ULTRAMODERN_BUILD_MODULE_FILE = 'ultramodern-build.ts';
 const ULTRAMODERN_BUILD_MODULE_PATH = `shared/${ULTRAMODERN_BUILD_MODULE_FILE}`;
@@ -56,6 +57,7 @@ __webpack_require__.d(__webpack_exports__, {}, {
     DELIVERY_UNIT_SCHEMA_VERSION: DELIVERY_UNIT_SCHEMA_VERSION,
     ULTRAMODERN_BUILD_ARTIFACT_FILE: ULTRAMODERN_BUILD_ARTIFACT_FILE,
     ULTRAMODERN_BUILD_ARTIFACT_PATH: ULTRAMODERN_BUILD_ARTIFACT_PATH,
+    ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION: ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION,
     ULTRAMODERN_BUILD_MODULE_FILE: ULTRAMODERN_BUILD_MODULE_FILE,
     ULTRAMODERN_BUILD_MODULE_PATH: ULTRAMODERN_BUILD_MODULE_PATH
 });
@@ -70,6 +72,7 @@ exports.DELIVERY_UNIT_KIND = __webpack_exports__.DELIVERY_UNIT_KIND;
 exports.DELIVERY_UNIT_SCHEMA_VERSION = __webpack_exports__.DELIVERY_UNIT_SCHEMA_VERSION;
 exports.ULTRAMODERN_BUILD_ARTIFACT_FILE = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_FILE;
 exports.ULTRAMODERN_BUILD_ARTIFACT_PATH = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_PATH;
+exports.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION;
 exports.ULTRAMODERN_BUILD_MODULE_FILE = __webpack_exports__.ULTRAMODERN_BUILD_MODULE_FILE;
 exports.ULTRAMODERN_BUILD_MODULE_PATH = __webpack_exports__.ULTRAMODERN_BUILD_MODULE_PATH;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
@@ -84,6 +87,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "DELIVERY_UNIT_SCHEMA_VERSION",
     "ULTRAMODERN_BUILD_ARTIFACT_FILE",
     "ULTRAMODERN_BUILD_ARTIFACT_PATH",
+    "ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION",
     "ULTRAMODERN_BUILD_MODULE_FILE",
     "ULTRAMODERN_BUILD_MODULE_PATH"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/cjs/backend-federation-contract/index.js

@@ -37,10 +37,14 @@ __webpack_require__.d(__webpack_exports__, {
     DELIVERY_UNIT_IDENTITY_FIELDS: ()=>external_constants_js_namespaceObject.DELIVERY_UNIT_IDENTITY_FIELDS,
     DELIVERY_UNIT_KIND: ()=>external_constants_js_namespaceObject.DELIVERY_UNIT_KIND,
     DELIVERY_UNIT_SCHEMA_VERSION: ()=>external_constants_js_namespaceObject.DELIVERY_UNIT_SCHEMA_VERSION,
+    RENDERER_PROTOCOL_VERSION: ()=>external_renderer_profile_js_namespaceObject.RENDERER_PROTOCOL_VERSION,
     ULTRAMODERN_BUILD_ARTIFACT_FILE: ()=>external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_FILE,
     ULTRAMODERN_BUILD_ARTIFACT_PATH: ()=>external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_PATH,
+    ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION: ()=>external_constants_js_namespaceObject.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION,
     ULTRAMODERN_BUILD_MODULE_FILE: ()=>external_constants_js_namespaceObject.ULTRAMODERN_BUILD_MODULE_FILE,
     ULTRAMODERN_BUILD_MODULE_PATH: ()=>external_constants_js_namespaceObject.ULTRAMODERN_BUILD_MODULE_PATH,
+    assertRendererProfileCompatibility: ()=>external_renderer_profile_js_namespaceObject.assertRendererProfileCompatibility,
+    assertUltramodernBuildArtifact: ()=>external_build_artifact_js_namespaceObject.assertUltramodernBuildArtifact,
     backendFederationExposeNames: ()=>external_metadata_js_namespaceObject.backendFederationExposeNames,
     backendFederationMetadata: ()=>external_metadata_js_namespaceObject.backendFederationMetadata,
     backendFederationVersionBoundary: ()=>external_metadata_js_namespaceObject.backendFederationVersionBoundary,
@@ -48,8 +52,10 @@ __webpack_require__.d(__webpack_exports__, {
     deliveryUnitContractBlock: ()=>external_delivery_unit_js_namespaceObject.deliveryUnitContractBlock,
     deliveryUnitIdentityFieldValue: ()=>external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue,
     formatBackendFederationValidationErrors: ()=>external_validation_core_js_namespaceObject.formatBackendFederationValidationErrors,
+    immutableRendererRouterBindings: ()=>external_renderer_router_bindings_js_namespaceObject.immutableRendererRouterBindings,
     isUltramodernBuildArtifact: ()=>external_build_artifact_js_namespaceObject.isUltramodernBuildArtifact,
     nonEmptyString: ()=>external_validation_core_js_namespaceObject.nonEmptyString,
+    resolveUltramodernBuildArtifact: ()=>external_runtime_build_artifact_js_namespaceObject.resolveUltramodernBuildArtifact,
     stampUltramodernBuildArtifactIdentity: ()=>external_build_artifact_js_namespaceObject.stampUltramodernBuildArtifactIdentity,
     stampUltramodernBuildArtifactSourceRevision: ()=>external_build_artifact_js_namespaceObject.stampUltramodernBuildArtifactSourceRevision,
     toBackendFederationExposeNames: ()=>external_metadata_js_namespaceObject.toBackendFederationExposeNames,
@@ -59,12 +65,20 @@ __webpack_require__.d(__webpack_exports__, {
     validateDeliveryUnitContractBlock: ()=>external_delivery_unit_js_namespaceObject.validateDeliveryUnitContractBlock,
     validateDeliveryUnitIdentity: ()=>external_delivery_unit_js_namespaceObject.validateDeliveryUnitIdentity,
     validateDeliveryUnitRecord: ()=>external_delivery_unit_js_namespaceObject.validateDeliveryUnitRecord,
+    validateRendererIdentity: ()=>external_renderer_profile_js_namespaceObject.validateRendererIdentity,
+    validateRendererProfile: ()=>external_renderer_profile_js_namespaceObject.validateRendererProfile,
+    validateRendererProfileCompatibility: ()=>external_renderer_profile_js_namespaceObject.validateRendererProfileCompatibility,
+    validateRendererRouterBindings: ()=>external_renderer_router_bindings_js_namespaceObject.validateRendererRouterBindings,
+    validateRendererRouterPackageIdentity: ()=>external_renderer_profile_js_namespaceObject.validateRendererRouterPackageIdentity,
     validateUltramodernBuildArtifact: ()=>external_build_artifact_js_namespaceObject.validateUltramodernBuildArtifact
 });
 const external_build_artifact_js_namespaceObject = require("./build-artifact.js");
 const external_constants_js_namespaceObject = require("./constants.js");
 const external_delivery_unit_js_namespaceObject = require("./delivery-unit.js");
 const external_metadata_js_namespaceObject = require("./metadata.js");
+const external_renderer_profile_js_namespaceObject = require("./renderer-profile.js");
+const external_renderer_router_bindings_js_namespaceObject = require("./renderer-router-bindings.js");
+const external_runtime_build_artifact_js_namespaceObject = require("./runtime-build-artifact.js");
 const external_validation_core_js_namespaceObject = require("./validation-core.js");
 exports.BACKEND_FEDERATION_CONTRACT_VERSION = __webpack_exports__.BACKEND_FEDERATION_CONTRACT_VERSION;
 exports.BACKEND_FEDERATION_EFFECT_EXPOSE = __webpack_exports__.BACKEND_FEDERATION_EFFECT_EXPOSE;
@@ -75,10 +89,14 @@ exports.DELIVERY_UNIT_DEPLOY_PROFILE = __webpack_exports__.DELIVERY_UNIT_DEPLOY_
 exports.DELIVERY_UNIT_IDENTITY_FIELDS = __webpack_exports__.DELIVERY_UNIT_IDENTITY_FIELDS;
 exports.DELIVERY_UNIT_KIND = __webpack_exports__.DELIVERY_UNIT_KIND;
 exports.DELIVERY_UNIT_SCHEMA_VERSION = __webpack_exports__.DELIVERY_UNIT_SCHEMA_VERSION;
+exports.RENDERER_PROTOCOL_VERSION = __webpack_exports__.RENDERER_PROTOCOL_VERSION;
 exports.ULTRAMODERN_BUILD_ARTIFACT_FILE = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_FILE;
 exports.ULTRAMODERN_BUILD_ARTIFACT_PATH = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_PATH;
+exports.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION = __webpack_exports__.ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION;
 exports.ULTRAMODERN_BUILD_MODULE_FILE = __webpack_exports__.ULTRAMODERN_BUILD_MODULE_FILE;
 exports.ULTRAMODERN_BUILD_MODULE_PATH = __webpack_exports__.ULTRAMODERN_BUILD_MODULE_PATH;
+exports.assertRendererProfileCompatibility = __webpack_exports__.assertRendererProfileCompatibility;
+exports.assertUltramodernBuildArtifact = __webpack_exports__.assertUltramodernBuildArtifact;
 exports.backendFederationExposeNames = __webpack_exports__.backendFederationExposeNames;
 exports.backendFederationMetadata = __webpack_exports__.backendFederationMetadata;
 exports.backendFederationVersionBoundary = __webpack_exports__.backendFederationVersionBoundary;
@@ -86,8 +104,10 @@ exports.createUltramodernBuildArtifact = __webpack_exports__.createUltramodernBu
 exports.deliveryUnitContractBlock = __webpack_exports__.deliveryUnitContractBlock;
 exports.deliveryUnitIdentityFieldValue = __webpack_exports__.deliveryUnitIdentityFieldValue;
 exports.formatBackendFederationValidationErrors = __webpack_exports__.formatBackendFederationValidationErrors;
+exports.immutableRendererRouterBindings = __webpack_exports__.immutableRendererRouterBindings;
 exports.isUltramodernBuildArtifact = __webpack_exports__.isUltramodernBuildArtifact;
 exports.nonEmptyString = __webpack_exports__.nonEmptyString;
+exports.resolveUltramodernBuildArtifact = __webpack_exports__.resolveUltramodernBuildArtifact;
 exports.stampUltramodernBuildArtifactIdentity = __webpack_exports__.stampUltramodernBuildArtifactIdentity;
 exports.stampUltramodernBuildArtifactSourceRevision = __webpack_exports__.stampUltramodernBuildArtifactSourceRevision;
 exports.toBackendFederationExposeNames = __webpack_exports__.toBackendFederationExposeNames;
@@ -97,6 +117,11 @@ exports.validateBackendFederationMetadata = __webpack_exports__.validateBackendF
 exports.validateDeliveryUnitContractBlock = __webpack_exports__.validateDeliveryUnitContractBlock;
 exports.validateDeliveryUnitIdentity = __webpack_exports__.validateDeliveryUnitIdentity;
 exports.validateDeliveryUnitRecord = __webpack_exports__.validateDeliveryUnitRecord;
+exports.validateRendererIdentity = __webpack_exports__.validateRendererIdentity;
+exports.validateRendererProfile = __webpack_exports__.validateRendererProfile;
+exports.validateRendererProfileCompatibility = __webpack_exports__.validateRendererProfileCompatibility;
+exports.validateRendererRouterBindings = __webpack_exports__.validateRendererRouterBindings;
+exports.validateRendererRouterPackageIdentity = __webpack_exports__.validateRendererRouterPackageIdentity;
 exports.validateUltramodernBuildArtifact = __webpack_exports__.validateUltramodernBuildArtifact;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "BACKEND_FEDERATION_CONTRACT_VERSION",
@@ -108,10 +133,14 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "DELIVERY_UNIT_IDENTITY_FIELDS",
     "DELIVERY_UNIT_KIND",
     "DELIVERY_UNIT_SCHEMA_VERSION",
+    "RENDERER_PROTOCOL_VERSION",
     "ULTRAMODERN_BUILD_ARTIFACT_FILE",
     "ULTRAMODERN_BUILD_ARTIFACT_PATH",
+    "ULTRAMODERN_BUILD_ARTIFACT_SCHEMA_VERSION",
     "ULTRAMODERN_BUILD_MODULE_FILE",
     "ULTRAMODERN_BUILD_MODULE_PATH",
+    "assertRendererProfileCompatibility",
+    "assertUltramodernBuildArtifact",
     "backendFederationExposeNames",
     "backendFederationMetadata",
     "backendFederationVersionBoundary",
@@ -119,8 +148,10 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "deliveryUnitContractBlock",
     "deliveryUnitIdentityFieldValue",
     "formatBackendFederationValidationErrors",
+    "immutableRendererRouterBindings",
     "isUltramodernBuildArtifact",
     "nonEmptyString",
+    "resolveUltramodernBuildArtifact",
     "stampUltramodernBuildArtifactIdentity",
     "stampUltramodernBuildArtifactSourceRevision",
     "toBackendFederationExposeNames",
@@ -130,6 +161,11 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "validateDeliveryUnitContractBlock",
     "validateDeliveryUnitIdentity",
     "validateDeliveryUnitRecord",
+    "validateRendererIdentity",
+    "validateRendererProfile",
+    "validateRendererProfileCompatibility",
+    "validateRendererRouterBindings",
+    "validateRendererRouterPackageIdentity",
     "validateUltramodernBuildArtifact"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/cjs/backend-federation-contract/renderer-profile.js

@@ -0,0 +1,164 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    RENDERER_PROTOCOL_VERSION: ()=>RENDERER_PROTOCOL_VERSION,
+    assertRendererProfileCompatibility: ()=>assertRendererProfileCompatibility,
+    validateRendererIdentity: ()=>validateRendererIdentity,
+    validateRendererProfile: ()=>validateRendererProfile,
+    validateRendererProfileCompatibility: ()=>validateRendererProfileCompatibility,
+    validateRendererRouterPackageIdentity: ()=>validateRendererRouterPackageIdentity
+});
+const external_validation_core_js_namespaceObject = require("./validation-core.js");
+const RENDERER_PROTOCOL_VERSION = 1;
+const exactFields = (value, fields, path, errors)=>{
+    for (const field of Object.keys(value))if (!fields.includes(field)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.${field}`, 'is not a supported field.');
+};
+const canonicalString = (value)=>'string' == typeof value && value.length > 0 && value.trim() === value;
+const exactPackageVersion = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+const validateRenderer = (value, path, errors)=>{
+    if (!canonicalString(value.renderer) || !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u.test(value.renderer)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.renderer`, 'must be a lowercase renderer token separated by single hyphens.');
+    if (value.protocolVersion !== RENDERER_PROTOCOL_VERSION) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.protocolVersion`, `must be ${RENDERER_PROTOCOL_VERSION}.`);
+};
+const validateRendererIdentity = (value, path = 'rendererIdentity')=>{
+    const errors = [];
+    if (!(0, external_validation_core_js_namespaceObject.isRecord)(value)) {
+        (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'must be an object.');
+        return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+    }
+    exactFields(value, [
+        'renderer',
+        'appId',
+        'entryName',
+        'protocolVersion',
+        'buildId'
+    ], path, errors);
+    validateRenderer(value, path, errors);
+    for (const field of [
+        'appId',
+        'entryName',
+        'buildId'
+    ])if (!canonicalString(value[field])) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.${field}`, 'must be a non-empty trimmed string.');
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const validatePackageIdentity = (value, path, errors, router = false, hydration = false)=>{
+    if (!(0, external_validation_core_js_namespaceObject.isRecord)(value)) return void (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'must be an object.');
+    exactFields(value, router ? [
+        'name',
+        'version',
+        'coreName',
+        'coreVersion'
+    ] : [
+        'name',
+        'version'
+    ], path, errors);
+    if (!canonicalString(value.name)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.name`, 'must be a non-empty trimmed string.');
+    if (router && !canonicalString(value.coreName)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.coreName`, 'must be a non-empty trimmed string.');
+    for (const field of router ? [
+        'version',
+        'coreVersion'
+    ] : [
+        'version'
+    ])if (!canonicalString(value[field]) || !(exactPackageVersion.test(value[field]) || hydration && /^[1-9]\d*$/.test(value[field]))) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.${field}`, 'must be an exact version.');
+};
+const validateRendererRouterPackageIdentity = (value, path = 'routerPackage')=>{
+    const errors = [];
+    validatePackageIdentity(value, path, errors, true);
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const validateRendererProfile = (value, path = 'rendererProfile')=>{
+    const errors = [];
+    if (!(0, external_validation_core_js_namespaceObject.isRecord)(value)) {
+        (0, external_validation_core_js_namespaceObject.addError)(errors, path, 'must be an object.');
+        return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+    }
+    exactFields(value, [
+        'renderer',
+        'protocolVersion',
+        'compiler',
+        'hydration',
+        'router'
+    ], path, errors);
+    validateRenderer(value, path, errors);
+    validatePackageIdentity(value.compiler, `${path}.compiler`, errors);
+    validatePackageIdentity(value.hydration, `${path}.hydration`, errors, false, true);
+    validatePackageIdentity(value.router, `${path}.router`, errors, true);
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const validateRendererProfileCompatibility = (expected, actual, path = 'rendererProfile')=>{
+    const errors = [
+        ...validateRendererProfile(expected, `${path}.expected`).errors,
+        ...validateRendererProfile(actual, `${path}.actual`).errors
+    ];
+    if (errors.length || !(0, external_validation_core_js_namespaceObject.isRecord)(expected) || !(0, external_validation_core_js_namespaceObject.isRecord)(actual)) return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+    if (expected.renderer !== actual.renderer) {
+        (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.renderer`, 'cross-renderer components are unsupported.');
+        return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+    }
+    if (expected.protocolVersion !== actual.protocolVersion) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.protocolVersion`, 'must match the consuming renderer protocol.');
+    for (const field of [
+        'compiler',
+        'hydration',
+        'router'
+    ]){
+        const expectedPackage = expected[field];
+        const actualPackage = actual[field];
+        for (const identityField of 'router' === field ? [
+            'name',
+            'version',
+            'coreName',
+            'coreVersion'
+        ] : [
+            'name',
+            'version'
+        ])if (expectedPackage[identityField] !== actualPackage[identityField]) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.${field}.${identityField}`, 'must match the consuming renderer profile.');
+    }
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const assertRendererProfileCompatibility = (expected, actual)=>{
+    const result = validateRendererProfileCompatibility(expected, actual);
+    if (!result.ok) throw new Error((0, external_validation_core_js_namespaceObject.formatBackendFederationValidationErrors)(result.errors));
+};
+exports.RENDERER_PROTOCOL_VERSION = __webpack_exports__.RENDERER_PROTOCOL_VERSION;
+exports.assertRendererProfileCompatibility = __webpack_exports__.assertRendererProfileCompatibility;
+exports.validateRendererIdentity = __webpack_exports__.validateRendererIdentity;
+exports.validateRendererProfile = __webpack_exports__.validateRendererProfile;
+exports.validateRendererProfileCompatibility = __webpack_exports__.validateRendererProfileCompatibility;
+exports.validateRendererRouterPackageIdentity = __webpack_exports__.validateRendererRouterPackageIdentity;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "RENDERER_PROTOCOL_VERSION",
+    "assertRendererProfileCompatibility",
+    "validateRendererIdentity",
+    "validateRendererProfile",
+    "validateRendererProfileCompatibility",
+    "validateRendererRouterPackageIdentity"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});