@bleedingdev/modern-js-app-tools-extensions 3.9.0-ultramodern.12 → 3.9.0-ultramodern.14

package/dist/types/backend-federation-build/codegen.d.ts

@@ -53,6 +53,36 @@ export declare const createBackendManifest: (workspaceRoot: string, distDirector
     }[];
     shared: never[];
     backendFederation: {
+        role: string;
+        appId: string;
+        name: string;
+        runtimeFramework: string;
+        strictEffectApproach: boolean;
+        contractVersion: string;
+        nodeAdapterVersion: string;
+        remoteType: string;
+        expose: string;
+        manifestUrl: string;
+        containerEntry: string;
+        source: {
+            module: string;
+        };
+        rpcPath: string | undefined;
+        rpcSerialization: string;
+        deliveryUnit?: import("@modern-js/backend-federation-contracts").DeliveryUnitContractBlock | undefined;
+        versionBoundary: {
+            invariant: string;
+            packageName: string | undefined;
+            version: string | undefined;
+            buildVersion: string | undefined;
+            uiManifestUrl?: string | undefined;
+            deliveryUnit?: {
+                unitId: string;
+                buildMarker: string;
+                sourceRevision: string;
+            } | undefined;
+        };
+    } | {
         role: string;
         appId: string;
         name: string;

package/dist/types/backend-federation-build/config.d.ts

@@ -1,13 +1,23 @@
 import { type DeliveryUnitContractBlock, type UltramodernBuildArtifact } from '@modern-js/backend-federation-contracts';
-export declare const COMPACT_CONFIG_PATH = ".modernjs/ultramodern.json";
-export type CompactApp = {
+export declare const REFERENCE_TOPOLOGY_PATH = "topology/reference-topology.json";
+export declare const DEVELOPMENT_OVERLAY_PATH = "topology/local-overlays/development.json";
+export type TopologyApp = {
     id?: unknown;
+    domain?: unknown;
     kind?: unknown;
     path?: unknown;
     package?: unknown;
-    port?: unknown;
+    portEnv?: unknown;
+    cloudflare?: {
+        publicUrlEnv?: unknown;
+    };
     api?: {
-        prefix?: unknown;
+        bff?: {
+            prefix?: unknown;
+        };
+        protocol?: unknown;
+        rpcPath?: unknown;
+        rpcSerialization?: unknown;
         stem?: unknown;
     };
     moduleFederation?: {
@@ -37,19 +47,23 @@ export type CompactApp = {
         packageName?: unknown;
         version?: unknown;
     };
-    serverExecution?: {
+};
+export type DevelopmentOverlay = {
+    ports?: Record<string, unknown>;
+    manifests?: Record<string, unknown>;
+    serverExecution?: Record<string, {
         node?: {
             remoteName?: unknown;
             manifestUrl?: unknown;
             containerEntry?: unknown;
             remoteType?: unknown;
         };
-    };
+    }>;
 };
-export type CompactConfig = {
-    topology?: {
-        apps?: CompactApp[];
-    };
+export type ReferenceTopology = {
+    shell?: TopologyApp;
+    shells?: TopologyApp[];
+    verticals?: TopologyApp[];
 };
 export type BackendFederationApp = {
     id: string;
@@ -62,13 +76,15 @@ export type BackendFederationApp = {
     deliveryUnit?: DeliveryUnitContractBlock;
     port: number;
     apiPrefix: string;
+    apiProtocol: 'rest' | 'rpc';
+    rpcPath?: string;
     apiStem: string;
     backendName: string;
     manifestUrl: string;
     containerEntry: string;
     remoteType: string;
     uiManifestUrl?: string;
-    compactDeliveryUnit?: {
+    topologyDeliveryUnit?: {
         unitId?: string;
         buildMarker?: string;
         sourceRevision?: string;
@@ -98,5 +114,8 @@ export declare const createStampedDeliveryUnit: (input: {
     version?: string;
     sourceRevision: string;
 }) => DeliveryUnitContractBlock | undefined;
-export declare const createAppFromCompactMetadata: (workspaceRoot: string, appDirectory: string, compactApp: CompactApp) => BackendFederationApp | undefined;
-export declare const findBackendFederationApp: (workspaceRoot: string, appDirectory: string) => Promise<BackendFederationApp | undefined>;
+export declare const createAppFromTopology: (workspaceRoot: string, appDirectory: string, topologyApp: TopologyApp, overlay: DevelopmentOverlay, packageManifest: {
+    name?: unknown;
+    version?: unknown;
+}) => BackendFederationApp | undefined;
+export declare const findBackendFederationApp: (workspaceRoot: string, appDirectory: string) => Promise<BackendFederationApp>;

package/dist/types/cloudflare/delivery-unit.d.ts

@@ -11,7 +11,7 @@ export type DeliveryUnitStamp = DeliveryUnitIdentity & {
 };
 /**
  * Resolve the delivery-unit record declared for this app by the workspace
- * compact config (`.modernjs/ultramodern.json`). This is the topology source
+ * reference topology. This is the topology source
  * of truth the Cloudflare worker snapshot is verified against.
  */
 export declare const resolveTopologyDeliveryUnit: (appDirectory: string) => Promise<DeliveryUnitStamp | undefined>;

package/dist/types/cloudflare/wrangler-config.d.ts

@@ -34,6 +34,12 @@ export declare const createWranglerConfig: (appDirectory: string, modernConfig:
         binding: string;
         run_worker_first: boolean;
     };
+    env?: {
+        [k: string]: {
+            compatibility_date?: string | undefined;
+            compatibility_flags?: JsonValue[] | undefined;
+        };
+    } | undefined;
     d1_databases?: {
         binding: string;
         database_name: string;

package/dist/types/cloudflare-builder.d.ts

@@ -1,5 +1,5 @@
 import type { BffUserConfig } from '@modern-js/server-core';
-import type { EnvironmentConfig, ModifyBundlerChainFn } from '@rsbuild/core';
+import type { EnvironmentConfig, ModifyBundlerChainFn, Rspack } from '@rsbuild/core';
 export interface CloudflareBuilderNormalizedConfig {
     bff?: BffUserConfig;
     deploy?: {
@@ -7,8 +7,13 @@ export interface CloudflareBuilderNormalizedConfig {
     };
 }
 export interface CloudflareBuilderAppContext {
+    apiOnly?: boolean;
     apiDirectory: string;
     appDirectory: string;
+    entrypoints?: ReadonlyArray<{
+        entryName: string;
+    }>;
+    internalDirectory?: string;
 }
 export interface CloudflareBuilderEnvironmentsOptions {
     appContext: CloudflareBuilderAppContext;
@@ -51,9 +56,48 @@ export interface CloudflareBuilderPlugin {
     name: string;
     setup(api: CloudflareBuilderPluginApi): void;
 }
+type AliasField = string | readonly string[];
+/**
+ * Leaves an absent optional dependency missing at runtime, exactly as Node
+ * does, instead of failing the worker build. It applies only when the
+ * importing package itself declares the request as an optional peer
+ * (`peerDependenciesMeta.<name>.optional`) or an `optionalDependencies`
+ * entry, the package is not found in any `resolve.modules` directory, and
+ * neither the app (`resolve.alias`, `resolve.fallback`, `externals`) nor the
+ * importing package (an enabled `resolve.aliasFields` entry such as
+ * `browser`) redirects the request. The import
+ * then rejects with "Cannot find module" so the library's own fallback
+ * handles it (for example `@redis/client` guards `import('@node-rs/xxhash')`).
+ */
+export declare const createAbsentOptionalDependencyFilter: (isRedirected?: (request: string) => boolean, moduleDirectories?: readonly string[], aliasFields?: readonly AliasField[]) => (request: string, context: string) => boolean;
+type AliasOption = Record<string, unknown> | {
+    name: string;
+    onlyModule?: boolean;
+}[] | false | undefined;
+/**
+ * Reads the final resolved `resolve.alias`, `resolve.fallback` and
+ * `externals` so an app's own
+ * replacement for an optional package still wins over the absent-module
+ * fallback (the fallback runs before resolution).
+ */
+export declare const createRequestRedirectMatcher: (options: {
+    externals?: unknown;
+    resolve?: {
+        alias?: AliasOption;
+        fallback?: AliasOption;
+    };
+}) => (request: string) => boolean;
+type FunctionExternal = (data: Rspack.ExternalItemFunctionData, callback: (error?: Error | null, result?: unknown) => void) => unknown;
+/**
+ * Reports whether any function external claims the request. A function that
+ * throws is treated as claiming it, so the request goes through ordinary
+ * external processing and surfaces that error instead of being ignored.
+ */
+export declare const claimsByFunctionExternal: (externals: readonly FunctionExternal[], data: Rspack.ExternalItemFunctionData) => Promise<boolean>;
 export declare function getCloudflareWorkerRspackConfig(workerEntryNames: Iterable<string>): CloudflareWorkerRspackConfig;
 export declare function applyCloudflareWorkerRspackConfig(chain: Parameters<ModifyBundlerChainFn>[0], workerEntryNames: Iterable<string>): void;
 export declare function applyCloudflareWorkerMfRuntimeBoundary(chain: Parameters<ModifyBundlerChainFn>[0]): void;
 export declare function getCloudflareBuilderEnvironments({ appContext, environments, normalizedConfig, resolveDeployProvider, }: CloudflareBuilderEnvironmentsOptions): Record<string, EnvironmentConfig>;
 export declare function applyCloudflareBuilderEnvironments(options: CloudflareBuilderEnvironmentsOptions): CloudflareBuilderEnvironmentsResult;
 export declare const createCloudflareBuilderPlugin: (resolveDeployProvider?: ResolveCloudflareDeployProvider) => CloudflareBuilderPlugin;
+export {};

package/dist/types/cloudflare-output-contract.d.ts

@@ -10,6 +10,8 @@ export declare const CLOUDFLARE_RUNTIME_TYPE = "cloudflare-module-worker";
 export declare const CLOUDFLARE_OUTPUT_PACKAGE_TYPE = "module";
 export declare const CLOUDFLARE_WORKER_PACKAGE_TYPE = "commonjs";
 export declare const CLOUDFLARE_WORKER_BUNDLE_FORMAT = "commonjs";
-export declare const CLOUDFLARE_WORKER_NODE_BUILTINS: readonly ['assert', 'assert/strict', 'async_hooks', 'buffer', 'child_process', 'crypto', 'dgram', 'dns', 'domain', 'events', 'fs', 'fs/promises', 'http', 'http2', 'inspector', 'module', 'net', 'os', 'path', 'process', 'readline', 'readline/promises', 'repl', 'sqlite', 'stream', 'stream/consumers', 'stream/promises', 'stream/web', 'string_decoder', 'timers', 'timers/promises', 'tls', 'trace_events', 'tty', 'url', 'util', 'util/types', 'v8', 'vm', 'wasi', 'worker_threads', 'zlib'];
+export declare const CLOUDFLARE_ROUTE_DATA_HANDLER_EXPORT = "handleRouteDataRequest";
+export declare const getCloudflareWorkerRouteDataEntryName: (entryName: string) => string;
+export declare const CLOUDFLARE_WORKER_NODE_BUILTINS: readonly ['_http_agent', '_http_client', '_http_common', '_http_incoming', '_http_outgoing', '_http_server', '_tls_common', '_tls_wrap', 'assert', 'assert/strict', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console', 'constants', 'crypto', 'dgram', 'diagnostics_channel', 'dns', 'dns/promises', 'domain', 'events', 'fs', 'fs/promises', 'http', 'http2', 'https', 'inspector', 'inspector/promises', 'module', 'net', 'os', 'path', 'path/posix', 'path/win32', 'perf_hooks', 'process', 'punycode', 'querystring', 'readline', 'readline/promises', 'repl', 'sqlite', 'stream', 'stream/consumers', 'stream/promises', 'stream/web', 'string_decoder', 'sys', 'test', 'timers', 'timers/promises', 'tls', 'trace_events', 'tty', 'url', 'util', 'util/types', 'v8', 'vm', 'wasi', 'worker_threads', 'zlib'];
 export declare const CLOUDFLARE_WORKER_PLATFORM_MODULES: readonly ['cloudflare:sockets'];
 export declare const CLOUDFLARE_REQUIRED_COMPATIBILITY_FLAGS: readonly ['nodejs_compat', 'global_fetch_strictly_public'];

package/dist/types/cloudflare-output-verifier/worker-bundles.d.ts

@@ -1,7 +1,7 @@
 import type { CloudflareOutputVerifierIssue, JsonObject } from './issues.js';
 interface WorkerBundleReference {
     dispatcherExport?: string;
-    kind: 'effect-bff' | 'route';
+    kind: 'effect-bff' | 'route' | 'route-data';
     reference: string;
 }
 interface ResolvedWorkerBundleReference extends WorkerBundleReference {
@@ -10,7 +10,7 @@ interface ResolvedWorkerBundleReference extends WorkerBundleReference {
 export declare const getEffectBffWorker: (manifest: JsonObject) => any;
 export declare const getWorkerBundleReferences: (manifest: JsonObject) => WorkerBundleReference[];
 export declare const resolveWorkerBundleReference: (issues: CloudflareOutputVerifierIssue[], outputDirectory: string, reference: WorkerBundleReference, manifestPath: string) => ResolvedWorkerBundleReference | null;
-export declare const missingWorkerBundleMessage: (reference: WorkerBundleReference) => "Cloudflare Effect BFF manifest points to a missing worker bundle." | "Cloudflare route worker manifest points to a missing worker bundle.";
+export declare const missingWorkerBundleMessage: (reference: WorkerBundleReference) => "Cloudflare Effect BFF manifest points to a missing worker bundle." | "Cloudflare route data worker manifest points to a missing worker bundle." | "Cloudflare route worker manifest points to a missing worker bundle.";
 interface WorkerBundleVerificationContract {
     providedPackages: ReadonlySet<string>;
     workerRoot: string;

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/package.json

@@ -11,7 +11,7 @@
     "directory": "packages/solutions/app-tools-extensions"
   },
   "license": "MIT",
-  "version": "3.9.0-ultramodern.12",
+  "version": "3.9.0-ultramodern.14",
   "files": [
     "dist",
     "src"
@@ -142,39 +142,43 @@
     "node": ">=26.7.0"
   },
   "dependencies": {
-    "@babel/parser": "^8.0.4",
-    "@babel/traverse": "^8.0.4",
+    "@babel/parser": "^8.0.6",
+    "@babel/traverse": "^8.0.6",
     "@loadable/component": "5.16.7",
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.12",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.12",
-    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.9.0-ultramodern.12",
-    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.0-ultramodern.12",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.12",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.12",
-    "@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.0-ultramodern.12",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.12",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.12",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.14",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.14",
+    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.9.0-ultramodern.14",
+    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.0-ultramodern.14",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.14",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.14",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.14",
+    "@modern-js/surface-resolution": "npm:@bleedingdev/modern-js-surface-resolution@3.9.0-ultramodern.14",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.14",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.14",
     "@swc/helpers": "^0.5.23",
     "compression-webpack-plugin": "^12.0.0",
     "esbuild": "^0.28.2",
     "std-env": "4.2.0"
   },
   "peerDependencies": {
-    "@rsbuild/core": "2.2.3"
+    "@rsbuild/core": "2.2.9"
   },
   "devDependencies": {
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.12",
-    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.0-ultramodern.12",
-    "@module-federation/runtime-tools": "2.9.0",
-    "@rsbuild/core": "2.2.3",
-    "@rslib/core": "1.0.0",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.14",
+    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.0-ultramodern.14",
+    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.9.0-ultramodern.14",
+    "@module-federation/runtime-tools": "npm:@bleedingdev/mf-runtime-tools@2.9.1",
+    "@rsbuild/core": "2.2.9",
+    "@rslib/core": "1.0.2",
     "@scripts/rstest-config": "2.66.0",
     "@types/babel__traverse": "7.28.0",
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.6.2",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "core-js": "^3.50.0",
-    "effect": "4.0.0-rc.112",
-    "ndepe": "^0.1.13"
+    "effect": "npm:@bleedingdev/effect@4.0.0-rc.117",
+    "miniflare": "5.20260921.0-alpha",
+    "ndepe": "^0.1.13",
+    "pg": "8.23.0"
   },
   "sideEffects": false,
   "publishConfig": {

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

@@ -204,8 +204,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',