@bleedingdev/modern-js-backend-federation-contracts 0.0.0 → 3.9.0-ultramodern.5

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

@@ -0,0 +1,133 @@
+"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__, {
+    backendFederationExposeNames: ()=>backendFederationExposeNames,
+    backendFederationMetadata: ()=>backendFederationMetadata,
+    backendFederationVersionBoundary: ()=>backendFederationVersionBoundary,
+    toBackendFederationExposeNames: ()=>toBackendFederationExposeNames,
+    validateBackendFederationManifest: ()=>validateBackendFederationManifest,
+    validateBackendFederationMetadata: ()=>validateBackendFederationMetadata
+});
+const external_constants_js_namespaceObject = require("./constants.js");
+const external_delivery_unit_js_namespaceObject = require("./delivery-unit.js");
+const external_validation_core_js_namespaceObject = require("./validation-core.js");
+const toBackendFederationExposeNames = (value)=>{
+    const names = [];
+    if (Array.isArray(value)) for (const expose of value){
+        const name = (0, external_validation_core_js_namespaceObject.nonEmptyString)(expose) ?? ((0, external_validation_core_js_namespaceObject.isRecord)(expose) ? (0, external_validation_core_js_namespaceObject.nonEmptyString)(expose.name) : void 0);
+        if (name) names.push(name);
+    }
+    else if ((0, external_validation_core_js_namespaceObject.isRecord)(value)) names.push(...Object.keys(value).filter((name)=>name.length > 0));
+    return Array.from(new Set(names));
+};
+const backendFederationExposeNames = (value)=>{
+    if (!(0, external_validation_core_js_namespaceObject.isRecord)(value)) return [];
+    const exposes = toBackendFederationExposeNames(value.exposes);
+    const expose = (0, external_validation_core_js_namespaceObject.nonEmptyString)(value.expose);
+    return Array.from(new Set([
+        ...exposes,
+        ...expose ? [
+            expose
+        ] : []
+    ]));
+};
+const backendFederationMetadata = (value)=>(0, external_validation_core_js_namespaceObject.isRecord)(value) ? (0, external_validation_core_js_namespaceObject.recordField)(value, 'backendFederation') : void 0;
+const backendFederationVersionBoundary = (value)=>(0, external_validation_core_js_namespaceObject.recordField)(backendFederationMetadata(value), 'versionBoundary');
+const validateBackendFederationMetadata = (value, options = {})=>{
+    const path = options.path ?? 'backendFederation';
+    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);
+    }
+    if (options.requireEffectRuntime && 'effect' !== value.runtimeFramework) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.runtimeFramework`, 'must be "effect".');
+    if (options.requireEffectRuntime && true !== value.strictEffectApproach) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.strictEffectApproach`, 'must be true.');
+    (0, external_validation_core_js_namespaceObject.validateVersionField)(errors, value, 'contractVersion', options.expectedContractVersion ?? external_constants_js_namespaceObject.BACKEND_FEDERATION_CONTRACT_VERSION, path, options.requireVersionFields ?? false);
+    (0, external_validation_core_js_namespaceObject.validateVersionField)(errors, value, 'nodeAdapterVersion', options.expectedNodeAdapterVersion ?? external_constants_js_namespaceObject.BACKEND_FEDERATION_NODE_ADAPTER_VERSION, path, options.requireVersionFields ?? false);
+    if (options.requireEffectExpose && !backendFederationExposeNames(value).includes(external_constants_js_namespaceObject.BACKEND_FEDERATION_EFFECT_EXPOSE)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.expose`, `must include "${external_constants_js_namespaceObject.BACKEND_FEDERATION_EFFECT_EXPOSE}".`);
+    if (options.validateDeliveryUnit ?? true) {
+        const deliveryUnit = (0, external_validation_core_js_namespaceObject.recordField)(value, 'deliveryUnit');
+        if (deliveryUnit) errors.push(...(0, external_delivery_unit_js_namespaceObject.validateDeliveryUnitContractBlock)(deliveryUnit, {
+            path: `${path}.deliveryUnit`
+        }).errors);
+        const versionBoundary = (0, external_validation_core_js_namespaceObject.recordField)(value, 'versionBoundary');
+        const versionBoundaryDeliveryUnit = (0, external_validation_core_js_namespaceObject.recordField)(versionBoundary, 'deliveryUnit');
+        if (versionBoundaryDeliveryUnit) errors.push(...(0, external_delivery_unit_js_namespaceObject.validateDeliveryUnitBoundaryIdentity)(versionBoundaryDeliveryUnit, `${path}.versionBoundary.deliveryUnit`));
+        if (deliveryUnit && versionBoundaryDeliveryUnit) for (const field of external_constants_js_namespaceObject.DELIVERY_UNIT_IDENTITY_FIELDS){
+            const deliveryUnitValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(deliveryUnit, field);
+            const versionBoundaryDeliveryUnitValue = (0, external_delivery_unit_js_namespaceObject.deliveryUnitIdentityFieldValue)(versionBoundaryDeliveryUnit, field);
+            if (deliveryUnitValue && versionBoundaryDeliveryUnitValue && deliveryUnitValue !== versionBoundaryDeliveryUnitValue) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.versionBoundary.deliveryUnit.${field}`, `must match ${path}.deliveryUnit.${field}.`);
+        }
+    }
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+const validateBackendFederationManifest = (value, options = {})=>{
+    const path = options.path ?? 'manifest';
+    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);
+    }
+    if (void 0 !== value.schemaVersion && 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}.`);
+    const metadata = backendFederationMetadata(value);
+    if (metadata) errors.push(...validateBackendFederationMetadata(metadata, {
+        ...options,
+        path: `${path}.backendFederation`,
+        requireEffectExpose: false
+    }).errors);
+    else if (options.requireBackendFederation ?? true) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.backendFederation`, 'must be an object.');
+    if (options.requireEffectExpose) {
+        const topLevelExposeNames = toBackendFederationExposeNames(value.exposes);
+        const metadataExposeNames = backendFederationExposeNames(metadata);
+        const exposeNames = new Set([
+            ...topLevelExposeNames,
+            ...metadataExposeNames
+        ]);
+        if (!exposeNames.has(external_constants_js_namespaceObject.BACKEND_FEDERATION_EFFECT_EXPOSE)) (0, external_validation_core_js_namespaceObject.addError)(errors, `${path}.exposes`, `must include "${external_constants_js_namespaceObject.BACKEND_FEDERATION_EFFECT_EXPOSE}".`);
+    }
+    return (0, external_validation_core_js_namespaceObject.validationResult)(errors);
+};
+exports.backendFederationExposeNames = __webpack_exports__.backendFederationExposeNames;
+exports.backendFederationMetadata = __webpack_exports__.backendFederationMetadata;
+exports.backendFederationVersionBoundary = __webpack_exports__.backendFederationVersionBoundary;
+exports.toBackendFederationExposeNames = __webpack_exports__.toBackendFederationExposeNames;
+exports.validateBackendFederationManifest = __webpack_exports__.validateBackendFederationManifest;
+exports.validateBackendFederationMetadata = __webpack_exports__.validateBackendFederationMetadata;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "backendFederationExposeNames",
+    "backendFederationMetadata",
+    "backendFederationVersionBoundary",
+    "toBackendFederationExposeNames",
+    "validateBackendFederationManifest",
+    "validateBackendFederationMetadata"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/backend-federation-contract/validation-core.js

@@ -0,0 +1,85 @@
+"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__);
+const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const nonEmptyString = (value)=>'string' == typeof value && value.trim().length > 0 ? value : void 0;
+const validationResult = (errors)=>({
+        ok: 0 === errors.length,
+        errors
+    });
+const addError = (errors, path, message)=>{
+    errors.push({
+        path,
+        message
+    });
+};
+const recordField = (value, field)=>{
+    const fieldValue = value?.[field];
+    return isRecord(fieldValue) ? fieldValue : void 0;
+};
+const formatBackendFederationValidationErrors = (errors)=>errors.map((error)=>`${error.path}: ${error.message}`).join('; ');
+const validateVersionField = (errors, record, field, expected, path, required)=>{
+    const compatibility = recordField(record, 'compatibility');
+    const executionSurfaces = recordField(record, 'executionSurfaces');
+    const nodeSurface = recordField(executionSurfaces, 'node');
+    const actual = nonEmptyString(record[field]) ?? nonEmptyString(compatibility?.[field]) ?? ('nodeAdapterVersion' === field ? nonEmptyString(nodeSurface?.adapterVersion) : void 0);
+    if (!actual) {
+        if (required) addError(errors, `${path}.${field}`, 'must be a non-empty string.');
+        return;
+    }
+    if (false !== expected && actual !== expected) addError(errors, `${path}.${field}`, `must be "${expected}".`);
+};
+__webpack_require__.d(__webpack_exports__, {}, {
+    addError: addError,
+    formatBackendFederationValidationErrors: formatBackendFederationValidationErrors,
+    isRecord: isRecord,
+    nonEmptyString: nonEmptyString,
+    recordField: recordField,
+    validateVersionField: validateVersionField,
+    validationResult: validationResult
+});
+exports.addError = __webpack_exports__.addError;
+exports.formatBackendFederationValidationErrors = __webpack_exports__.formatBackendFederationValidationErrors;
+exports.isRecord = __webpack_exports__.isRecord;
+exports.nonEmptyString = __webpack_exports__.nonEmptyString;
+exports.recordField = __webpack_exports__.recordField;
+exports.validateVersionField = __webpack_exports__.validateVersionField;
+exports.validationResult = __webpack_exports__.validationResult;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "addError",
+    "formatBackendFederationValidationErrors",
+    "isRecord",
+    "nonEmptyString",
+    "recordField",
+    "validateVersionField",
+    "validationResult"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/backend-federation-contract/build-artifact.mjs

@@ -0,0 +1,135 @@
+import { DELIVERY_UNIT_IDENTITY_FIELDS, DELIVERY_UNIT_SCHEMA_VERSION } from "./constants.mjs";
+import { deliveryUnitIdentityFieldValue, validateDeliveryUnitRecord } from "./delivery-unit.mjs";
+import { addError, isRecord, nonEmptyString, recordField, validationResult } from "./validation-core.mjs";
+const createUltramodernBuildArtifact = (record)=>{
+    const deliveryUnit = {
+        appId: record.appId,
+        build: record.buildMarker,
+        buildMarker: record.buildMarker,
+        deployProfile: record.deployProfile,
+        kind: record.kind,
+        packageName: record.packageName,
+        schemaVersion: record.schemaVersion,
+        sourceRevision: record.sourceRevision,
+        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 {
+        deliveryUnit,
+        kind: 'ultramodern-build-artifact',
+        schemaVersion: DELIVERY_UNIT_SCHEMA_VERSION,
+        surfaces: {
+            api,
+            ui
+        }
+    };
+};
+const validateUltramodernBuildArtifact = (value, path = 'artifact')=>{
+    const errors = [];
+    if (!isRecord(value)) {
+        addError(errors, path, 'must be an object.');
+        return validationResult(errors);
+    }
+    if (value.schemaVersion !== DELIVERY_UNIT_SCHEMA_VERSION) addError(errors, `${path}.schemaVersion`, `must be ${DELIVERY_UNIT_SCHEMA_VERSION}.`);
+    if ('ultramodern-build-artifact' !== value.kind) addError(errors, `${path}.kind`, 'must be "ultramodern-build-artifact".');
+    const deliveryUnit = value.deliveryUnit;
+    errors.push(...validateDeliveryUnitRecord(deliveryUnit, {
+        path: `${path}.deliveryUnit`,
+        allowBuildAlias: true
+    }).errors);
+    if (isRecord(deliveryUnit)) {
+        const build = nonEmptyString(deliveryUnit.build);
+        const buildMarker = nonEmptyString(deliveryUnit.buildMarker);
+        if (build) {
+            if (buildMarker && build !== buildMarker) addError(errors, `${path}.deliveryUnit.build`, 'must match deliveryUnit.buildMarker.');
+        } else addError(errors, `${path}.deliveryUnit.build`, 'must be a non-empty string.');
+    }
+    const surfaces = recordField(value, 'surfaces');
+    if (!surfaces) {
+        addError(errors, `${path}.surfaces`, 'must be an object.');
+        return validationResult(errors);
+    }
+    for (const surface of [
+        'ui',
+        'api'
+    ]){
+        const marker = surfaces[surface];
+        const markerPath = `${path}.surfaces.${surface}`;
+        errors.push(...validateDeliveryUnitRecord(marker, {
+            path: markerPath,
+            allowBuildAlias: true
+        }).errors);
+        if (!isRecord(marker)) continue;
+        const markerBuild = nonEmptyString(marker.build);
+        const markerBuildMarker = nonEmptyString(marker.buildMarker);
+        if (markerBuild) {
+            if (markerBuildMarker && markerBuild !== markerBuildMarker) addError(errors, `${markerPath}.build`, 'must match buildMarker.');
+        } else addError(errors, `${markerPath}.build`, 'must be non-empty string.');
+        if (marker.surface !== surface) addError(errors, `${markerPath}.surface`, `must be "${surface}".`);
+        for (const field of DELIVERY_UNIT_IDENTITY_FIELDS){
+            const deliveryUnitValue = deliveryUnitIdentityFieldValue(deliveryUnit, field, {
+                allowBuildAlias: true
+            });
+            const markerValue = deliveryUnitIdentityFieldValue(marker, field, {
+                allowBuildAlias: true
+            });
+            if (void 0 !== deliveryUnitValue && void 0 !== markerValue && deliveryUnitValue !== markerValue) addError(errors, `${markerPath}.${field}`, `must match ${path}.deliveryUnit.${field}.`);
+        }
+    }
+    return validationResult(errors);
+};
+const isUltramodernBuildArtifact = (value)=>validateUltramodernBuildArtifact(value).ok;
+const stampUltramodernBuildArtifactIdentity = (artifact, identity)=>({
+        ...artifact,
+        deliveryUnit: {
+            ...artifact.deliveryUnit,
+            build: identity.buildMarker,
+            buildMarker: identity.buildMarker,
+            sourceRevision: identity.sourceRevision
+        },
+        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
+            }
+        }
+    });
+const stampUltramodernBuildArtifactSourceRevision = (artifact, sourceRevision)=>stampUltramodernBuildArtifactIdentity(artifact, {
+        buildMarker: artifact.deliveryUnit.buildMarker,
+        sourceRevision
+    });
+export { createUltramodernBuildArtifact, isUltramodernBuildArtifact, stampUltramodernBuildArtifactIdentity, stampUltramodernBuildArtifactSourceRevision, validateUltramodernBuildArtifact };

package/dist/esm/backend-federation-contract/constants.mjs

@@ -0,0 +1,18 @@
+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 DELIVERY_UNIT_SCHEMA_VERSION = 1;
+const DELIVERY_UNIT_KIND = 'microvertical-delivery-unit';
+const DELIVERY_UNIT_DEPLOY_PROFILE = 'cloudflare-ssr-mf-effect-v1';
+const DELIVERY_UNIT_IDENTITY_FIELDS = [
+    'unitId',
+    'buildMarker',
+    'sourceRevision'
+];
+const ULTRAMODERN_BUILD_ARTIFACT_FILE = 'ultramodern-build.json';
+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}`;
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, BACKEND_FEDERATION_REMOTE_ENTRY_FILE, DELIVERY_UNIT_DEPLOY_PROFILE, DELIVERY_UNIT_IDENTITY_FIELDS, DELIVERY_UNIT_KIND, DELIVERY_UNIT_SCHEMA_VERSION, ULTRAMODERN_BUILD_ARTIFACT_FILE, ULTRAMODERN_BUILD_ARTIFACT_PATH, ULTRAMODERN_BUILD_MODULE_FILE, ULTRAMODERN_BUILD_MODULE_PATH };

package/dist/esm/backend-federation-contract/delivery-unit.mjs

@@ -0,0 +1,74 @@
+import { DELIVERY_UNIT_DEPLOY_PROFILE, DELIVERY_UNIT_IDENTITY_FIELDS, DELIVERY_UNIT_KIND, DELIVERY_UNIT_SCHEMA_VERSION } from "./constants.mjs";
+import { addError, isRecord, nonEmptyString, validationResult } from "./validation-core.mjs";
+const deliveryUnitIdentityFieldValue = (value, field, options = {})=>{
+    if (!isRecord(value)) return;
+    if ('buildMarker' === field && options.allowBuildAlias) return nonEmptyString(value.buildMarker) ?? nonEmptyString(value.build);
+    return nonEmptyString(value[field]);
+};
+const validateDeliveryUnitIdentity = (value, options = {})=>{
+    const path = options.path ?? 'deliveryUnit';
+    const errors = [];
+    if (!isRecord(value)) {
+        addError(errors, path, 'must be an object.');
+        return validationResult(errors);
+    }
+    for (const field of DELIVERY_UNIT_IDENTITY_FIELDS)if (!deliveryUnitIdentityFieldValue(value, field, options)) addError(errors, `${path}.${field}`, 'must be a non-empty string.');
+    return validationResult(errors);
+};
+const validateDeliveryUnitContractBlock = (value, options = {})=>{
+    const path = options.path ?? 'deliveryUnit';
+    const errors = [
+        ...validateDeliveryUnitIdentity(value, options).errors
+    ];
+    if (!isRecord(value)) return validationResult(errors);
+    if (value.schemaVersion !== DELIVERY_UNIT_SCHEMA_VERSION) addError(errors, `${path}.schemaVersion`, `must be ${DELIVERY_UNIT_SCHEMA_VERSION}.`);
+    if (value.kind !== DELIVERY_UNIT_KIND) addError(errors, `${path}.kind`, `must be "${DELIVERY_UNIT_KIND}".`);
+    if (!nonEmptyString(value.packageName)) addError(errors, `${path}.packageName`, 'must be a non-empty string.');
+    if (!nonEmptyString(value.version)) addError(errors, `${path}.version`, 'must be a non-empty string.');
+    return validationResult(errors);
+};
+const validateDeliveryUnitRecord = (value, options = {})=>{
+    const path = options.path ?? 'deliveryUnit';
+    const errors = [
+        ...validateDeliveryUnitContractBlock(value, {
+            ...options,
+            path
+        }).errors
+    ];
+    if (!isRecord(value)) return validationResult(errors);
+    if (!nonEmptyString(value.appId)) addError(errors, `${path}.appId`, 'must be a non-empty string.');
+    if (value.deployProfile !== DELIVERY_UNIT_DEPLOY_PROFILE) addError(errors, `${path}.deployProfile`, `must be "${DELIVERY_UNIT_DEPLOY_PROFILE}".`);
+    return validationResult(errors);
+};
+const validateDeliveryUnitBoundaryIdentity = (value, path)=>{
+    const errors = [];
+    if (!isRecord(value)) {
+        addError(errors, path, 'must be an object.');
+        return errors;
+    }
+    for (const field of DELIVERY_UNIT_IDENTITY_FIELDS)if (!deliveryUnitIdentityFieldValue(value, field)) addError(errors, `${path}.${field}`, 'must be a non-empty string.');
+    return errors;
+};
+const deliveryUnitContractBlock = (record)=>({
+        schemaVersion: record.schemaVersion,
+        kind: record.kind,
+        unitId: record.unitId,
+        packageName: record.packageName,
+        version: record.version,
+        buildMarker: record.buildMarker,
+        sourceRevision: record.sourceRevision
+    });
+const toDeliveryUnitIdentity = (value)=>{
+    const unitId = deliveryUnitIdentityFieldValue(value, 'unitId');
+    const buildMarker = deliveryUnitIdentityFieldValue(value, 'buildMarker', {
+        allowBuildAlias: true
+    });
+    const sourceRevision = deliveryUnitIdentityFieldValue(value, 'sourceRevision');
+    if (!unitId || !buildMarker || !sourceRevision) return;
+    return {
+        unitId,
+        buildMarker,
+        sourceRevision
+    };
+};
+export { deliveryUnitContractBlock, deliveryUnitIdentityFieldValue, toDeliveryUnitIdentity, validateDeliveryUnitBoundaryIdentity, validateDeliveryUnitContractBlock, validateDeliveryUnitIdentity, validateDeliveryUnitRecord };

package/dist/esm/backend-federation-contract/index.mjs

@@ -0,0 +1,5 @@
+export { createUltramodernBuildArtifact, isUltramodernBuildArtifact, stampUltramodernBuildArtifactIdentity, stampUltramodernBuildArtifactSourceRevision, validateUltramodernBuildArtifact } from "./build-artifact.mjs";
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, BACKEND_FEDERATION_REMOTE_ENTRY_FILE, DELIVERY_UNIT_DEPLOY_PROFILE, DELIVERY_UNIT_IDENTITY_FIELDS, DELIVERY_UNIT_KIND, DELIVERY_UNIT_SCHEMA_VERSION, ULTRAMODERN_BUILD_ARTIFACT_FILE, ULTRAMODERN_BUILD_ARTIFACT_PATH, ULTRAMODERN_BUILD_MODULE_FILE, ULTRAMODERN_BUILD_MODULE_PATH } from "./constants.mjs";
+export { deliveryUnitContractBlock, deliveryUnitIdentityFieldValue, toDeliveryUnitIdentity, validateDeliveryUnitContractBlock, validateDeliveryUnitIdentity, validateDeliveryUnitRecord } from "./delivery-unit.mjs";
+export { backendFederationExposeNames, backendFederationMetadata, backendFederationVersionBoundary, toBackendFederationExposeNames, validateBackendFederationManifest, validateBackendFederationMetadata } from "./metadata.mjs";
+export { formatBackendFederationValidationErrors, nonEmptyString } from "./validation-core.mjs";

package/dist/esm/backend-federation-contract/metadata.mjs

@@ -0,0 +1,80 @@
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, DELIVERY_UNIT_IDENTITY_FIELDS, DELIVERY_UNIT_SCHEMA_VERSION } from "./constants.mjs";
+import { deliveryUnitIdentityFieldValue, validateDeliveryUnitBoundaryIdentity, validateDeliveryUnitContractBlock } from "./delivery-unit.mjs";
+import { addError, isRecord, nonEmptyString, recordField, validateVersionField, validationResult } from "./validation-core.mjs";
+const toBackendFederationExposeNames = (value)=>{
+    const names = [];
+    if (Array.isArray(value)) for (const expose of value){
+        const name = nonEmptyString(expose) ?? (isRecord(expose) ? nonEmptyString(expose.name) : void 0);
+        if (name) names.push(name);
+    }
+    else if (isRecord(value)) names.push(...Object.keys(value).filter((name)=>name.length > 0));
+    return Array.from(new Set(names));
+};
+const backendFederationExposeNames = (value)=>{
+    if (!isRecord(value)) return [];
+    const exposes = toBackendFederationExposeNames(value.exposes);
+    const expose = nonEmptyString(value.expose);
+    return Array.from(new Set([
+        ...exposes,
+        ...expose ? [
+            expose
+        ] : []
+    ]));
+};
+const backendFederationMetadata = (value)=>isRecord(value) ? recordField(value, 'backendFederation') : void 0;
+const backendFederationVersionBoundary = (value)=>recordField(backendFederationMetadata(value), 'versionBoundary');
+const validateBackendFederationMetadata = (value, options = {})=>{
+    const path = options.path ?? 'backendFederation';
+    const errors = [];
+    if (!isRecord(value)) {
+        addError(errors, path, 'must be an object.');
+        return validationResult(errors);
+    }
+    if (options.requireEffectRuntime && 'effect' !== value.runtimeFramework) addError(errors, `${path}.runtimeFramework`, 'must be "effect".');
+    if (options.requireEffectRuntime && true !== value.strictEffectApproach) addError(errors, `${path}.strictEffectApproach`, 'must be true.');
+    validateVersionField(errors, value, 'contractVersion', options.expectedContractVersion ?? BACKEND_FEDERATION_CONTRACT_VERSION, path, options.requireVersionFields ?? false);
+    validateVersionField(errors, value, 'nodeAdapterVersion', options.expectedNodeAdapterVersion ?? BACKEND_FEDERATION_NODE_ADAPTER_VERSION, path, options.requireVersionFields ?? false);
+    if (options.requireEffectExpose && !backendFederationExposeNames(value).includes(BACKEND_FEDERATION_EFFECT_EXPOSE)) addError(errors, `${path}.expose`, `must include "${BACKEND_FEDERATION_EFFECT_EXPOSE}".`);
+    if (options.validateDeliveryUnit ?? true) {
+        const deliveryUnit = recordField(value, 'deliveryUnit');
+        if (deliveryUnit) errors.push(...validateDeliveryUnitContractBlock(deliveryUnit, {
+            path: `${path}.deliveryUnit`
+        }).errors);
+        const versionBoundary = recordField(value, 'versionBoundary');
+        const versionBoundaryDeliveryUnit = recordField(versionBoundary, 'deliveryUnit');
+        if (versionBoundaryDeliveryUnit) errors.push(...validateDeliveryUnitBoundaryIdentity(versionBoundaryDeliveryUnit, `${path}.versionBoundary.deliveryUnit`));
+        if (deliveryUnit && versionBoundaryDeliveryUnit) for (const field of DELIVERY_UNIT_IDENTITY_FIELDS){
+            const deliveryUnitValue = deliveryUnitIdentityFieldValue(deliveryUnit, field);
+            const versionBoundaryDeliveryUnitValue = deliveryUnitIdentityFieldValue(versionBoundaryDeliveryUnit, field);
+            if (deliveryUnitValue && versionBoundaryDeliveryUnitValue && deliveryUnitValue !== versionBoundaryDeliveryUnitValue) addError(errors, `${path}.versionBoundary.deliveryUnit.${field}`, `must match ${path}.deliveryUnit.${field}.`);
+        }
+    }
+    return validationResult(errors);
+};
+const validateBackendFederationManifest = (value, options = {})=>{
+    const path = options.path ?? 'manifest';
+    const errors = [];
+    if (!isRecord(value)) {
+        addError(errors, path, 'must be an object.');
+        return validationResult(errors);
+    }
+    if (void 0 !== value.schemaVersion && value.schemaVersion !== DELIVERY_UNIT_SCHEMA_VERSION) addError(errors, `${path}.schemaVersion`, `must be ${DELIVERY_UNIT_SCHEMA_VERSION}.`);
+    const metadata = backendFederationMetadata(value);
+    if (metadata) errors.push(...validateBackendFederationMetadata(metadata, {
+        ...options,
+        path: `${path}.backendFederation`,
+        requireEffectExpose: false
+    }).errors);
+    else if (options.requireBackendFederation ?? true) addError(errors, `${path}.backendFederation`, 'must be an object.');
+    if (options.requireEffectExpose) {
+        const topLevelExposeNames = toBackendFederationExposeNames(value.exposes);
+        const metadataExposeNames = backendFederationExposeNames(metadata);
+        const exposeNames = new Set([
+            ...topLevelExposeNames,
+            ...metadataExposeNames
+        ]);
+        if (!exposeNames.has(BACKEND_FEDERATION_EFFECT_EXPOSE)) addError(errors, `${path}.exposes`, `must include "${BACKEND_FEDERATION_EFFECT_EXPOSE}".`);
+    }
+    return validationResult(errors);
+};
+export { backendFederationExposeNames, backendFederationMetadata, backendFederationVersionBoundary, toBackendFederationExposeNames, validateBackendFederationManifest, validateBackendFederationMetadata };

package/dist/esm/backend-federation-contract/validation-core.mjs

@@ -0,0 +1,29 @@
+const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const nonEmptyString = (value)=>'string' == typeof value && value.trim().length > 0 ? value : void 0;
+const validationResult = (errors)=>({
+        ok: 0 === errors.length,
+        errors
+    });
+const addError = (errors, path, message)=>{
+    errors.push({
+        path,
+        message
+    });
+};
+const recordField = (value, field)=>{
+    const fieldValue = value?.[field];
+    return isRecord(fieldValue) ? fieldValue : void 0;
+};
+const formatBackendFederationValidationErrors = (errors)=>errors.map((error)=>`${error.path}: ${error.message}`).join('; ');
+const validateVersionField = (errors, record, field, expected, path, required)=>{
+    const compatibility = recordField(record, 'compatibility');
+    const executionSurfaces = recordField(record, 'executionSurfaces');
+    const nodeSurface = recordField(executionSurfaces, 'node');
+    const actual = nonEmptyString(record[field]) ?? nonEmptyString(compatibility?.[field]) ?? ('nodeAdapterVersion' === field ? nonEmptyString(nodeSurface?.adapterVersion) : void 0);
+    if (!actual) {
+        if (required) addError(errors, `${path}.${field}`, 'must be a non-empty string.');
+        return;
+    }
+    if (false !== expected && actual !== expected) addError(errors, `${path}.${field}`, `must be "${expected}".`);
+};
+export { addError, formatBackendFederationValidationErrors, isRecord, nonEmptyString, recordField, validateVersionField, validationResult };