@bleedingdev/modern-js-app-tools-extensions 3.9.0-ultramodern.9 → 3.9.3-ultramodern.10

package/dist/types/release-envelope/renderer-output-stamp.d.ts

@@ -0,0 +1,34 @@
+import { type UltramodernBuildArtifact, type UltramodernBuildUiSurface } from '@modern-js/backend-federation-contracts';
+export type RendererBuildOutputContext = {
+    appDirectory: string;
+    distDirectory: string;
+    entrypoints: readonly {
+        entryName: string;
+        isMainEntry?: boolean;
+    }[];
+};
+export type FinalizedRendererBuildOutput = {
+    buildMarker: string;
+    sourceRevision: string;
+    ui: Pick<UltramodernBuildUiSurface, 'rendererIdentity' | 'rendererProfile' | 'routerBindings'>;
+};
+export type RendererBuildOutputOptions = {
+    resolveRendererBuild: (context: RendererBuildOutputContext) => Promise<FinalizedRendererBuildOutput>;
+    /** Exact metadata producer selected by the owning renderer composition. */
+    rendererBuildPlugin: string;
+};
+export declare const validateFinalizedRendererBuild: (output: FinalizedRendererBuildOutput, context: RendererBuildOutputContext, appId: string) => void;
+export declare const stampFinalizedRendererBuildArtifact: (artifact: UltramodernBuildArtifact, output: FinalizedRendererBuildOutput, context: RendererBuildOutputContext) => UltramodernBuildArtifact;
+export declare function emitRendererBuildArtifact(context: RendererBuildOutputContext, options: RendererBuildOutputOptions): Promise<UltramodernBuildArtifact | undefined>;
+/** Stamp generated UI carriers after their actual compiler manifest is committed. */
+export declare function rendererBuildArtifactStampPlugin(options: RendererBuildOutputOptions): {
+    name: string;
+    pre: string[];
+    required: string[];
+    setup(api: {
+        getAppContext(): RendererBuildOutputContext & {
+            apiOnly?: boolean;
+        };
+        onAfterBuild(handler: () => Promise<void>): void;
+    }): void;
+};

package/dist/types/release-envelope/types.d.ts

@@ -1,5 +1,7 @@
-export declare const MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION: 3;
-export declare const MICROVERTICAL_RELEASE_ENVELOPE_KIND: 'ultramodern-target-microvertical-release-envelope';
+import type { RendererIdentity, RendererProfile, RendererRouterBindings } from '@modern-js/backend-federation-contracts';
+import { MICROVERTICAL_RELEASE_ENVELOPE_KIND, MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION, SHELL_RELEASE_ENVELOPE_KIND } from './contract.mjs';
+export { MICROVERTICAL_RELEASE_ENVELOPE_KIND, MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION, SHELL_RELEASE_ENVELOPE_KIND, };
+export type ReleaseEnvelopeKind = typeof MICROVERTICAL_RELEASE_ENVELOPE_KIND | typeof SHELL_RELEASE_ENVELOPE_KIND;
 export declare const MICROVERTICAL_RELEASE_TARGETS: readonly ['node', 'cloudflare'];
 export type MicroVerticalReleaseTarget = (typeof MICROVERTICAL_RELEASE_TARGETS)[number];
 export type MicroVerticalReleaseIdentity = {
@@ -32,31 +34,67 @@ export type MicroVerticalReleaseSurfaces = {
     uiClient: string[];
     ssr: string[];
     apiBackend: string[];
-    backendFederation: {
+    backendFederation?: {
         manifest: string;
         container: string;
     };
 };
+export type MicroVerticalReleaseUi = {
+    rendererIdentity: RendererIdentity;
+    rendererProfile: RendererProfile;
+    routerBindings: RendererRouterBindings;
+};
+/** A Shell consumes remotes; it never publishes a backend federation pair. */
+export type ShellReleaseSurfaces = {
+    uiClient: string[];
+    ssr: string[];
+    apiBackend: string[];
+};
+export type ReleaseSurfaces = MicroVerticalReleaseSurfaces | ShellReleaseSurfaces;
 export type MicroVerticalReleaseEnvelopePayload = {
     schemaVersion: typeof MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION;
     kind: typeof MICROVERTICAL_RELEASE_ENVELOPE_KIND;
     target: MicroVerticalReleaseTarget;
     identity: MicroVerticalReleaseIdentity;
+    ui?: MicroVerticalReleaseUi;
     artifacts: MicroVerticalReleaseArtifact[];
     surfaces: MicroVerticalReleaseSurfaces;
 };
 export type MicroVerticalReleaseEnvelope = MicroVerticalReleaseEnvelopePayload & {
     envelopeDigest: string;
 };
+export type ShellReleaseEnvelopePayload = {
+    schemaVersion: typeof MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION;
+    kind: typeof SHELL_RELEASE_ENVELOPE_KIND;
+    target: MicroVerticalReleaseTarget;
+    identity: MicroVerticalReleaseIdentity;
+    ui?: MicroVerticalReleaseUi;
+    artifacts: MicroVerticalReleaseArtifact[];
+    surfaces: ShellReleaseSurfaces;
+};
+export type ShellReleaseEnvelope = ShellReleaseEnvelopePayload & {
+    envelopeDigest: string;
+};
+export type ReleaseEnvelopePayload = MicroVerticalReleaseEnvelopePayload | ShellReleaseEnvelopePayload;
+export type ReleaseEnvelope = MicroVerticalReleaseEnvelope | ShellReleaseEnvelope;
 export type CreateMicroVerticalReleaseEnvelopeInput = {
     artifactRoot: string;
     target: MicroVerticalReleaseTarget;
     identity: MicroVerticalReleaseIdentity;
+    ui?: MicroVerticalReleaseUi;
     artifacts: MicroVerticalReleaseArtifactInput[];
+} & ({
+    kind?: typeof MICROVERTICAL_RELEASE_ENVELOPE_KIND;
     surfaces: MicroVerticalReleaseSurfaces;
-};
+} | {
+    kind: typeof SHELL_RELEASE_ENVELOPE_KIND;
+    surfaces: ShellReleaseSurfaces;
+});
 export type VerifyMicroVerticalReleaseEnvelopeOptions = {
     artifactRoot: string;
     logicalPathForArtifact?: (artifact: MicroVerticalReleaseArtifact) => string;
     expectedTarget?: MicroVerticalReleaseTarget;
+    expectedKind?: ReleaseEnvelopeKind;
+    expectedRendererIdentity?: RendererIdentity;
+    expectedRendererProfile?: RendererProfile;
 };

package/dist/types/release-identity.d.ts

@@ -7,10 +7,21 @@ export declare const createUltramodernReleaseBuildMarker: ({ generationBuildMark
     sourceRevision: string;
     unitId: string;
 }) => string;
-export declare const resolveUltramodernSourceRevision: (workspaceRoot?: string, configuredSourceRevision?: string) => string;
-export declare const resolveUltramodernReleaseIdentity: ({ generationBuildMarker, sourceRevision: configuredSourceRevision, unitId, workspaceRoot, }: {
+export declare const resolveUltramodernSourceRevision: (workspaceRoot?: string, configuredSourceRevision?: string, environment?: Readonly<NodeJS.ProcessEnv>) => string;
+/**
+ * The one release identity of a delivery unit, resolvable before its build.
+ *
+ * For a clean source revision the build marker is a 64-hex digest of the unit
+ * id, its generation marker and the revision. API bundles carry it, and a UI
+ * unit's renderer adopts it as its `buildId`, so contracts, release plans and
+ * Worker names derived from it before the build match the built
+ * `ultramodern-build.json`, `renderer-build.json`, chunk banners and envelope.
+ * A dirty or non-Git checkout yields the non-promotable `workspace` identity.
+ */
+export declare const resolveUltramodernReleaseIdentity: ({ generationBuildMarker, sourceRevision: configuredSourceRevision, unitId, workspaceRoot, environment, }: {
     generationBuildMarker: string;
     sourceRevision?: string;
     unitId: string;
     workspaceRoot?: string;
+    environment?: Readonly<NodeJS.ProcessEnv>;
 }) => UltramodernReleaseIdentity;

package/dist/types/renderer-build-identity.d.ts

@@ -0,0 +1,41 @@
+import { type RendererIdentity, type RendererName, type RendererProfile, type RendererRouterBindings, type RouterFramework } from '@modern-js/backend-federation-contracts';
+export type RendererProfileKeyInput = RendererProfile & {
+    readonly dependencies?: Readonly<Record<string, string>>;
+};
+export interface RendererBuildIdentityOptions {
+    projectRoot: string;
+    renderer: RendererName;
+    profile: RendererProfileKeyInput;
+    entryNames: readonly string[];
+    mode: 'development' | 'production';
+    /** Delivery-unit app id; defaults to the application package name. */
+    appId?: string;
+    /**
+     * The declared delivery unit's release identity, resolved before the build
+     * by `resolveUltramodernReleaseIdentity`. A promotable production build
+     * adopts its buildMarker as the buildId, so consumers that resolve the unit
+     * identity before compiling see the marker the built artifacts carry.
+     */
+    deliveryUnit?: {
+        readonly unitId: string;
+        readonly buildMarker: string;
+        readonly sourceRevision: string;
+    };
+    /** Externally authenticated source revision (CI) for an undeclared app. */
+    sourceRevision?: string;
+    /** Actual final entry ownership, supplied by the selected renderer composition. */
+    routerBindings: RendererRouterBindings;
+    /** Admitted router frameworks, supplied by the selected renderer owner. */
+    routerFrameworks?: readonly RouterFramework[];
+}
+export interface RendererBuildIdentities {
+    readonly identities: Readonly<Record<string, RendererIdentity>>;
+    readonly buildId: string;
+    readonly profileKey: string;
+    readonly sourceRevision: string;
+    readonly routerBindings: RendererRouterBindings;
+}
+/** Renderer, protocol and installed renderer/framework/compiler versions. */
+export declare function rendererProfileKey(profile: RendererProfileKeyInput): string;
+/** Resolve once per build before emitting entries; never rehashes sources. */
+export declare function resolveRendererBuildIdentities(options: RendererBuildIdentityOptions): RendererBuildIdentities;

package/dist/types/templates/cloudflare-worker-route-data.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Create the worker route data request handler for an entry's route loaders
+ * (the `routes` export of its generated `route-server-loaders.js`).
+ *
+ * The handler takes the Node data handler's options and resolves to
+ * `undefined` for requests that are not route data requests of a known entry,
+ * so the caller renders the page instead.
+ */
+export declare function createRouteDataRequestHandler(routes: any): ({ request, serverRoutes, context, onTiming }: {
+    context?: {} | undefined;
+    onTiming: any;
+    request: any;
+    serverRoutes: any;
+}) => Promise<any>;

package/dist/types/workspace-topology.d.ts

@@ -0,0 +1,91 @@
+import type { CloudflareWorkerSecurityConfig } from './config.js';
+export declare const REFERENCE_TOPOLOGY_PATH = "topology/reference-topology.json";
+export declare const DEVELOPMENT_OVERLAY_PATH = "topology/local-overlays/development.json";
+/** Fields consumed from the existing workspace topology by native plugins. */
+export type TopologyApp = {
+    id?: unknown;
+    domain?: unknown;
+    kind?: unknown;
+    path?: unknown;
+    package?: unknown;
+    portEnv?: unknown;
+    surfaceProfile?: unknown;
+    verticalRefs?: unknown;
+    cloudflare?: {
+        workerName?: unknown;
+        publicUrlEnv?: unknown;
+        compatibilityDate?: unknown;
+        security?: CloudflareWorkerSecurityConfig;
+    };
+    api?: {
+        bff?: {
+            prefix?: unknown;
+        };
+        protocol?: unknown;
+        rpcPath?: unknown;
+        rpcSerialization?: unknown;
+        stem?: unknown;
+    };
+    moduleFederation?: {
+        name?: unknown;
+        manifestUrl?: unknown;
+        exposes?: unknown;
+        verticalRefs?: unknown;
+        remotes?: unknown;
+    };
+    backendFederation?: {
+        name?: unknown;
+        versionBoundary?: {
+            ui?: {
+                manifestUrl?: unknown;
+            };
+        };
+        executionSurfaces?: {
+            node?: {
+                remoteName?: unknown;
+                manifestUrl?: unknown;
+                containerEntry?: unknown;
+                remoteType?: unknown;
+            };
+            cloudflare?: {
+                workerName?: unknown;
+                workerDispatch?: {
+                    serviceBinding?: unknown;
+                    serviceBindingEnv?: unknown;
+                    dispatchWorkerNameEnv?: unknown;
+                };
+            };
+        };
+    };
+    deliveryUnit?: {
+        unitId?: unknown;
+        buildMarker?: unknown;
+        sourceRevision?: unknown;
+        packageName?: unknown;
+        version?: unknown;
+    };
+};
+export type DevelopmentOverlay = {
+    schemaVersion?: unknown;
+    ports?: Record<string, unknown>;
+    manifests?: Record<string, unknown>;
+    serverExecution?: Record<string, {
+        node?: {
+            remoteName?: unknown;
+            manifestUrl?: unknown;
+            containerEntry?: unknown;
+            remoteType?: unknown;
+        };
+    }>;
+};
+export type ReferenceTopology = {
+    schemaVersion?: unknown;
+    shell?: TopologyApp;
+    shells?: TopologyApp[];
+    verticals?: TopologyApp[];
+};
+export declare const normalizeRelativePath: (value: string) => string;
+/** Shared by the generated route and the native Worker service binding. */
+export declare const distributedSsrFragmentSlug: (expose: string) => string;
+export declare const distributedSsrFragmentRoute: (expose: string) => string;
+export declare const findWorkspaceRoot: (appDirectory: string) => string | undefined;

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@bleedingdev/modern-js-app-tools-extensions",
   "description": "Fork-owned UltraModern.js app-tools extensions for Cloudflare delivery and release envelopes.",
-  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
   "bugs": {
-    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
     "directory": "packages/solutions/app-tools-extensions"
   },
   "license": "MIT",
-  "version": "3.9.0-ultramodern.9",
+  "version": "3.9.3-ultramodern.10",
   "files": [
     "dist",
     "src"
@@ -62,6 +62,11 @@
       "import": "./dist/esm-node/cloudflare-output-verifier/*.mjs",
       "require": "./dist/cjs/cloudflare-output-verifier/*.js"
     },
+    "./internal-effect-discovery": {
+      "types": "./dist/types/build-config/internal-effect-discovery.d.ts",
+      "import": "./dist/cjs/build-config/internal-effect-discovery.js",
+      "require": "./dist/cjs/build-config/internal-effect-discovery.js"
+    },
     "./config": {
       "types": "./dist/types/config.d.ts",
       "import": "./dist/esm-node/config.mjs",
@@ -77,6 +82,16 @@
       "import": "./dist/esm-node/release-envelope/*.mjs",
       "require": "./dist/cjs/release-envelope/*.js"
     },
+    "./release-envelope/contract": {
+      "types": "./dist/types/release-envelope/contract.d.mts",
+      "import": "./dist/esm-node/release-envelope/contract.mjs",
+      "require": "./dist/cjs/release-envelope/contract.js"
+    },
+    "./renderer-build-identity": {
+      "types": "./dist/types/renderer-build-identity.d.ts",
+      "import": "./dist/esm-node/renderer-build-identity.mjs",
+      "require": "./dist/cjs/renderer-build-identity.js"
+    },
     "./release-identity": {
       "types": "./dist/types/release-identity.d.ts",
       "import": "./dist/esm-node/release-identity.mjs",
@@ -116,6 +131,21 @@
       "types": "./dist/types/deploy-output/target.d.ts",
       "import": "./dist/esm-node/deploy-output/target.mjs",
       "require": "./dist/cjs/deploy-output/target.js"
+    },
+    "./deploy-output/trace-files": {
+      "types": "./dist/types/deploy-output/trace-files.d.ts",
+      "import": "./dist/esm-node/deploy-output/trace-files.mjs",
+      "require": "./dist/cjs/deploy-output/trace-files.js"
+    },
+    "./workspace-topology": {
+      "types": "./dist/types/workspace-topology.d.ts",
+      "import": "./dist/esm-node/workspace-topology.mjs",
+      "require": "./dist/cjs/workspace-topology.js"
+    },
+    "./module-federation-config": {
+      "types": "./dist/types/module-federation-config/index.d.ts",
+      "import": "./dist/esm-node/module-federation-config/index.mjs",
+      "require": "./dist/cjs/module-federation-config/index.js"
     }
   },
   "typesVersions": {
@@ -135,45 +165,72 @@
       ],
       "deploy-output/target": [
         "./dist/types/deploy-output/target.d.ts"
+      ],
+      "deploy-output/trace-files": [
+        "./dist/types/deploy-output/trace-files.d.ts"
       ]
     }
   },
   "engines": {
-    "node": ">=26.7.0"
+    "node": ">=26.12.0"
   },
   "dependencies": {
-    "@babel/parser": "^8.0.4",
-    "@babel/traverse": "^8.0.4",
-    "@loadable/component": "5.16.7",
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.9",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.9",
-    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.9.0-ultramodern.9",
-    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.0-ultramodern.9",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.9",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.9",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.9",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.9",
+    "@babel/parser": "^8.0.7",
+    "@babel/traverse": "^8.0.7",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.10",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.3-ultramodern.10",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.3-ultramodern.10",
+    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.9.3-ultramodern.10",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.3-ultramodern.10",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.3-ultramodern.10",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.3-ultramodern.10",
+    "@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.3-ultramodern.10",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.3-ultramodern.10",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.10",
     "@swc/helpers": "^0.5.23",
+    "@vercel/nft": "^1.11.0",
     "compression-webpack-plugin": "^12.0.0",
     "esbuild": "^0.28.2",
-    "std-env": "4.2.0"
+    "jsonc-parser": "3.3.1",
+    "std-env": "4.3.0"
   },
   "peerDependencies": {
-    "@rsbuild/core": "2.2.3"
+    "@loadable/component": "5.16.7",
+    "@modern-js/runtime-renderer-extensions": "3.9.3-ultramodern.10",
+    "@rsbuild/core": "2.2.13",
+    "react": "^19.3.1"
+  },
+  "peerDependenciesMeta": {
+    "@loadable/component": {
+      "optional": true
+    },
+    "@modern-js/runtime-renderer-extensions": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.9",
-    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.0-ultramodern.9",
-    "@module-federation/runtime-tools": "2.9.0",
-    "@rsbuild/core": "2.2.3",
-    "@rslib/core": "1.0.0",
+    "@loadable/component": "5.16.7",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.3-ultramodern.10",
+    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.3-ultramodern.10",
+    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.9.3-ultramodern.10",
+    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.3-ultramodern.10",
+    "@module-federation/modern-js-v3": "2.9.2",
+    "@module-federation/runtime-tools": "2.9.2",
+    "@rsbuild/core": "2.2.13",
+    "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",
     "@types/babel__traverse": "7.28.0",
-    "@types/node": "^26.4.1",
-    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "@types/node": "^26.6.5",
     "core-js": "^3.50.0",
-    "effect": "4.0.0-rc.112",
-    "ndepe": "^0.1.13"
+    "effect": "4.0.5",
+    "miniflare": "5.20261012.0-beta",
+    "ndepe": "^0.1.13",
+    "pg": "8.23.1",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -185,5 +242,8 @@
     "build": "rslib build && pnpm run verify:public-surface",
     "test": "rstest",
     "verify:public-surface": "node ./tests/build-config/verify-public-surface.mjs"
+  },
+  "ultramodern": {
+    "sourceName": "@modern-js/app-tools-extensions"
   }
 }

package/src/backend-federation-build/codegen.ts

@@ -1,7 +1,6 @@
 import path from 'node:path';
 import {
   BACKEND_FEDERATION_EFFECT_EXPOSE as BACKEND_EXPOSE,
-  BACKEND_FEDERATION_MANIFEST_FILE as BACKEND_MANIFEST_FILE,
   BACKEND_FEDERATION_REMOTE_ENTRY_FILE as BACKEND_REMOTE_ENTRY_FILE,
   BACKEND_FEDERATION_CONTRACT_VERSION as CONTRACT_VERSION,
   formatBackendFederationValidationErrors,
@@ -65,28 +64,34 @@ export const createBackendRemoteEntrySource = async (
     ...(app.sourceRevision ? { sourceRevision: app.sourceRevision } : {}),
   };
   const source = `// Generated by Modern.js backend federation build.
-import * as exposedNamespace from ${JSON.stringify(effectApiSpecifier)};
+import { adoptEffectBffShareScope } from '@modern-js/bff-effect/effect-edge';
 
-const exposedModule = {
-  ...exposedNamespace,
-  backendFederationContract: {
-    ...(exposedNamespace.backendFederationContract ?? {}),
-    compatibility: {
-      ...(exposedNamespace.backendFederationContract?.compatibility ?? {}),
-      ...${JSON.stringify(compatibility)},
+// The expose evaluates lazily so defineEffectBff registers its handler
+// factories with the registry the host shares through init().
+let exposedModule;
+const loadExposedModule = () =>
+  (exposedModule ??= import(${JSON.stringify(effectApiSpecifier)}).then(exposedNamespace => ({
+    ...exposedNamespace,
+    backendFederationContract: {
+      ...(exposedNamespace.backendFederationContract ?? {}),
+      compatibility: {
+        ...(exposedNamespace.backendFederationContract?.compatibility ?? {}),
+        ...${JSON.stringify(compatibility)},
+      },
+      name: ${JSON.stringify(app.backendName)},
+      role: 'microvertical-server',
+      runtimeFramework: 'effect',
+      strictEffectApproach: true,
     },
-    name: ${JSON.stringify(app.backendName)},
-    role: 'microvertical-server',
-    runtimeFramework: 'effect',
-    strictEffectApproach: true,
-  },
-};
+  })));
 const exposedModules = {
-  ${JSON.stringify(BACKEND_EXPOSE)}: () => Promise.resolve(exposedModule),
+  ${JSON.stringify(BACKEND_EXPOSE)}: loadExposedModule,
 };
 const __modernjsBackendFederation = ${JSON.stringify(containerMetadata)};
 
-function init() {}
+function init(shareScope) {
+  return adoptEffectBffShareScope(shareScope);
+}
 
 function get(id) {
   const load = exposedModules[id];
@@ -204,8 +209,12 @@ export const createBackendManifest = (
       source: {
         module: sourceModule,
       },
-      readinessPath: `${app.apiPrefix}/${app.apiStem}/readiness`,
-      openapiPath: `${app.apiPrefix}/openapi.json`,
+      ...(app.apiProtocol === 'rpc'
+        ? { rpcPath: app.rpcPath, rpcSerialization: 'json' }
+        : {
+            readinessPath: `${app.apiPrefix}/${app.apiStem}/readiness`,
+            openapiPath: `${app.apiPrefix}/openapi.json`,
+          }),
       ...(app.deliveryUnit ? { deliveryUnit: app.deliveryUnit } : {}),
       versionBoundary: {
         invariant: 'web-and-api-same-build',