@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.1 → 3.9.0-ultramodern.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/README.md +13 -3
  2. package/dist/cjs/backend-federation/edge-runtime.js +3 -15
  3. package/dist/cjs/backend-federation/edge.js +8 -9
  4. package/dist/cjs/backend-federation/identity.js +17 -23
  5. package/dist/cjs/backend-federation/index.js +5 -5
  6. package/dist/cjs/backend-federation/load.js +3 -13
  7. package/dist/cjs/backend-federation/validate-loaded.js +2 -4
  8. package/dist/cjs/backend-federation-manifest/load.js +37 -12
  9. package/dist/cjs/backend-federation-manifest/metadata.js +3 -3
  10. package/dist/cjs/backend-federation-manifest/remote.js +2 -2
  11. package/dist/cjs/backend-federation-manifest/validation.js +7 -7
  12. package/dist/cjs/cross-project-policy/evaluation.js +3 -3
  13. package/dist/cjs/cross-project-policy/node.js +4 -3
  14. package/dist/cjs/{backend-federation/legacy-warning.js → cross-project-policy/producer-runtime.js} +23 -5
  15. package/dist/cjs/effect-adapter/entry.js +1 -0
  16. package/dist/cjs/effect-adapter/index.js +9 -2
  17. package/dist/cjs/{client-generator → effect-source-loader}/built-entry.js +1 -1
  18. package/dist/cjs/{client-generator/runtime.js → effect-source-loader/http-api-runtime.js} +12 -20
  19. package/dist/cjs/effect-source-loader/index.js +18 -6
  20. package/dist/cjs/effect-source-loader/loader.js +10 -29
  21. package/dist/cjs/effect-source-loader/operation-contracts.js +83 -0
  22. package/dist/cjs/effect-source-loader/rspack-loader.js +73 -0
  23. package/dist/cjs/effect-source-loader/worker-runtime-source.js +71 -0
  24. package/dist/cjs/effect-source-loader/worker-runtime-wrapper.js +7 -50
  25. package/dist/cjs/hono/cross-project-policy.js +2 -1
  26. package/dist/cjs/hono/node.js +51 -0
  27. package/dist/esm/backend-federation/edge-runtime.mjs +2 -11
  28. package/dist/esm/backend-federation/edge.mjs +4 -5
  29. package/dist/esm/backend-federation/identity.mjs +17 -23
  30. package/dist/esm/backend-federation/index.mjs +1 -1
  31. package/dist/esm/backend-federation/load.mjs +2 -12
  32. package/dist/esm/backend-federation/validate-loaded.mjs +2 -4
  33. package/dist/esm/backend-federation-manifest/load.mjs +37 -12
  34. package/dist/esm/backend-federation-manifest/metadata.mjs +1 -1
  35. package/dist/esm/backend-federation-manifest/remote.mjs +1 -1
  36. package/dist/esm/backend-federation-manifest/validation.mjs +5 -5
  37. package/dist/esm/cross-project-policy/evaluation.mjs +1 -1
  38. package/dist/esm/cross-project-policy/node.mjs +2 -1
  39. package/dist/esm/cross-project-policy/producer-runtime.mjs +20 -0
  40. package/dist/esm/effect-adapter/entry.mjs +1 -0
  41. package/dist/esm/effect-adapter/index.mjs +5 -1
  42. package/dist/esm/{client-generator → effect-source-loader}/built-entry.mjs +1 -1
  43. package/dist/esm/effect-source-loader/http-api-runtime.mjs +19 -0
  44. package/dist/esm/effect-source-loader/index.mjs +5 -2
  45. package/dist/esm/effect-source-loader/loader.mjs +10 -29
  46. package/dist/esm/effect-source-loader/operation-contracts.mjs +45 -0
  47. package/dist/esm/effect-source-loader/rspack-loader.mjs +35 -0
  48. package/dist/esm/effect-source-loader/worker-runtime-source.mjs +23 -0
  49. package/dist/esm/effect-source-loader/worker-runtime-wrapper.mjs +5 -45
  50. package/dist/esm/hono/cross-project-policy.mjs +2 -1
  51. package/dist/esm-node/backend-federation/edge-runtime.mjs +2 -11
  52. package/dist/esm-node/backend-federation/edge.mjs +4 -5
  53. package/dist/esm-node/backend-federation/identity.mjs +17 -23
  54. package/dist/esm-node/backend-federation/index.mjs +1 -1
  55. package/dist/esm-node/backend-federation/load.mjs +2 -12
  56. package/dist/esm-node/backend-federation/validate-loaded.mjs +2 -4
  57. package/dist/esm-node/backend-federation-manifest/load.mjs +37 -12
  58. package/dist/esm-node/backend-federation-manifest/metadata.mjs +1 -1
  59. package/dist/esm-node/backend-federation-manifest/remote.mjs +1 -1
  60. package/dist/esm-node/backend-federation-manifest/validation.mjs +5 -5
  61. package/dist/esm-node/cross-project-policy/evaluation.mjs +1 -1
  62. package/dist/esm-node/cross-project-policy/node.mjs +2 -1
  63. package/dist/esm-node/cross-project-policy/producer-runtime.mjs +21 -0
  64. package/dist/esm-node/effect-adapter/entry.mjs +1 -0
  65. package/dist/esm-node/effect-adapter/index.mjs +5 -1
  66. package/dist/esm-node/{client-generator → effect-source-loader}/built-entry.mjs +1 -1
  67. package/dist/esm-node/effect-source-loader/http-api-runtime.mjs +20 -0
  68. package/dist/esm-node/effect-source-loader/index.mjs +5 -2
  69. package/dist/esm-node/effect-source-loader/loader.mjs +10 -29
  70. package/dist/esm-node/effect-source-loader/operation-contracts.mjs +46 -0
  71. package/dist/esm-node/effect-source-loader/rspack-loader.mjs +37 -0
  72. package/dist/esm-node/effect-source-loader/worker-runtime-source.mjs +24 -0
  73. package/dist/esm-node/effect-source-loader/worker-runtime-wrapper.mjs +5 -45
  74. package/dist/esm-node/hono/cross-project-policy.mjs +2 -1
  75. package/dist/esm-node/hono/node.mjs +14 -0
  76. package/dist/types/backend-federation/edge-runtime.d.ts +0 -5
  77. package/dist/types/backend-federation/edge.d.ts +1 -3
  78. package/dist/types/backend-federation/identity.d.ts +2 -11
  79. package/dist/types/backend-federation/index.d.ts +1 -1
  80. package/dist/types/backend-federation/load.d.ts +1 -7
  81. package/dist/types/backend-federation/node.d.ts +1 -3
  82. package/dist/types/backend-federation/types.d.ts +1 -7
  83. package/dist/types/backend-federation/validate-loaded.d.ts +1 -2
  84. package/dist/types/backend-federation-manifest/metadata.d.ts +0 -6
  85. package/dist/types/cross-project-policy/evaluation.d.ts +1 -1
  86. package/dist/types/cross-project-policy/node.d.ts +2 -1
  87. package/dist/types/cross-project-policy/producer-runtime.d.ts +20 -0
  88. package/dist/types/effect-adapter/entry.d.ts +1 -0
  89. package/dist/types/effect-adapter/index.d.ts +2 -0
  90. package/dist/types/effect-source-loader/index.d.ts +5 -2
  91. package/dist/types/effect-source-loader/operation-contracts.d.ts +8 -0
  92. package/dist/types/effect-source-loader/rspack-loader.d.ts +9 -0
  93. package/dist/types/effect-source-loader/worker-runtime-source.d.ts +4 -0
  94. package/dist/types/effect-source-loader/worker-runtime-wrapper.d.ts +4 -22
  95. package/dist/types/hono/node.d.ts +4 -0
  96. package/package.json +50 -22
  97. package/src/backend-federation/edge-runtime.ts +2 -13
  98. package/src/backend-federation/edge.ts +9 -17
  99. package/src/backend-federation/identity.ts +9 -27
  100. package/src/backend-federation/index.ts +1 -1
  101. package/src/backend-federation/load.ts +7 -34
  102. package/src/backend-federation/node.ts +0 -11
  103. package/src/backend-federation/types.ts +1 -7
  104. package/src/backend-federation/validate-loaded.ts +2 -7
  105. package/src/backend-federation-manifest/load.ts +92 -38
  106. package/src/backend-federation-manifest/metadata.ts +1 -7
  107. package/src/backend-federation-manifest/remote.ts +1 -1
  108. package/src/backend-federation-manifest/validation.ts +10 -13
  109. package/src/cross-project-policy/evaluation.ts +1 -1
  110. package/src/cross-project-policy/node.ts +3 -3
  111. package/src/cross-project-policy/producer-runtime.ts +43 -0
  112. package/src/effect-adapter/entry.ts +1 -0
  113. package/src/effect-adapter/index.ts +5 -0
  114. package/src/{client-generator → effect-source-loader}/built-entry.ts +1 -3
  115. package/src/effect-source-loader/http-api-runtime.ts +39 -0
  116. package/src/effect-source-loader/index.ts +8 -5
  117. package/src/effect-source-loader/loader.ts +31 -47
  118. package/src/effect-source-loader/operation-contracts.ts +72 -0
  119. package/src/effect-source-loader/rspack-loader.ts +72 -0
  120. package/src/effect-source-loader/worker-runtime-source.ts +34 -0
  121. package/src/effect-source-loader/worker-runtime-wrapper.ts +5 -75
  122. package/src/hono/cross-project-policy.ts +2 -1
  123. package/src/hono/node.ts +24 -0
  124. package/dist/cjs/client-generator/generator.js +0 -73
  125. package/dist/cjs/client-generator/index.js +0 -54
  126. package/dist/cjs/client-generator/rendering.js +0 -253
  127. package/dist/cjs/client-generator/types.js +0 -18
  128. package/dist/esm/backend-federation/legacy-warning.mjs +0 -2
  129. package/dist/esm/client-generator/generator.mjs +0 -32
  130. package/dist/esm/client-generator/index.mjs +0 -3
  131. package/dist/esm/client-generator/rendering.mjs +0 -209
  132. package/dist/esm/client-generator/runtime.mjs +0 -27
  133. package/dist/esm/client-generator/types.mjs +0 -0
  134. package/dist/esm-node/backend-federation/legacy-warning.mjs +0 -3
  135. package/dist/esm-node/client-generator/generator.mjs +0 -33
  136. package/dist/esm-node/client-generator/index.mjs +0 -4
  137. package/dist/esm-node/client-generator/rendering.mjs +0 -210
  138. package/dist/esm-node/client-generator/runtime.mjs +0 -29
  139. package/dist/esm-node/client-generator/types.mjs +0 -1
  140. package/dist/types/backend-federation/legacy-warning.d.ts +0 -1
  141. package/dist/types/client-generator/generator.d.ts +0 -3
  142. package/dist/types/client-generator/index.d.ts +0 -4
  143. package/dist/types/client-generator/rendering.d.ts +0 -24
  144. package/dist/types/client-generator/types.d.ts +0 -33
  145. package/src/backend-federation/legacy-warning.ts +0 -2
  146. package/src/client-generator/generator.ts +0 -52
  147. package/src/client-generator/index.ts +0 -10
  148. package/src/client-generator/rendering.ts +0 -307
  149. package/src/client-generator/runtime.ts +0 -69
  150. package/src/client-generator/types.ts +0 -35
  151. /package/dist/cjs/{client-generator → effect-source-loader}/paths.js +0 -0
  152. /package/dist/esm/{client-generator → effect-source-loader}/paths.mjs +0 -0
  153. /package/dist/esm-node/{client-generator → effect-source-loader}/paths.mjs +0 -0
  154. /package/dist/types/{client-generator → effect-source-loader}/built-entry.d.ts +0 -0
  155. /package/dist/types/{client-generator/runtime.d.ts → effect-source-loader/http-api-runtime.d.ts} +0 -0
  156. /package/dist/types/{client-generator → effect-source-loader}/paths.d.ts +0 -0
  157. /package/src/{client-generator → effect-source-loader}/paths.ts +0 -0
@@ -0,0 +1,24 @@
1
+ import "node:module";
2
+ import node_path from "node:path";
3
+ import { build } from "esbuild";
4
+ async function bundleEffectWorkerRuntimeSource(source, resourcePath, loader) {
5
+ const result = await build({
6
+ absWorkingDir: node_path.dirname(resourcePath),
7
+ bundle: true,
8
+ format: 'esm',
9
+ metafile: true,
10
+ packages: 'external',
11
+ platform: 'neutral',
12
+ stdin: {
13
+ contents: source,
14
+ loader: 'js',
15
+ resolveDir: node_path.dirname(resourcePath),
16
+ sourcefile: resourcePath
17
+ },
18
+ target: 'es2024',
19
+ write: false
20
+ });
21
+ for (const dependency of Object.keys(result.metafile.inputs))if ('<stdin>' !== dependency) loader.addDependency(node_path.resolve(node_path.dirname(resourcePath), dependency));
22
+ return result.outputFiles[0].text;
23
+ }
24
+ export { bundleEffectWorkerRuntimeSource };
@@ -1,57 +1,17 @@
1
1
  import "node:module";
2
+ import { resolveEffectOperationContracts } from "./operation-contracts.mjs";
2
3
  async function generateEffectWorkerRuntimeWrapper(loader, options, resourcePath) {
3
- const { generateEffectClient } = await import("../client-generator/generator.mjs");
4
- const artifacts = await generateEffectClient({
4
+ const operationContracts = await resolveEffectOperationContracts({
5
5
  appDir: options.appDir,
6
- apiDir: options.apiDir,
7
6
  resourcePath,
8
7
  prefix: options.prefix,
9
- port: Number(options.port),
10
- target: 'bundle',
11
8
  requestId: options.requestId,
12
- requestCreator: options.requestCreator,
13
- httpMethodDecider: options.httpMethodDecider,
14
- dataPlatformBatch: options.effectDataPlatformBatch,
15
9
  onDependency: (dependency)=>loader.addDependency(dependency)
16
10
  });
17
11
  const sourceRequest = `${resourcePath}?modern-bff-runtime-source`;
18
- const operationContracts = artifacts?.operationContracts ?? {};
19
12
  return `import * as effectBffModule from ${JSON.stringify(sourceRequest)};
20
- import { createEffectBffEdgeDispatcher } from '@modern-js/plugin-bff/effect-edge/dispatcher';
21
-
22
- const __generatedOperationContracts = ${JSON.stringify(operationContracts)};
23
-
24
- const __mergeGeneratedOperationContracts = policy => {
25
- if (
26
- !policy ||
27
- !policy.expectedOperationContracts ||
28
- typeof policy.expectedOperationContracts !== 'object' ||
29
- Array.isArray(policy.expectedOperationContracts)
30
- ) {
31
- return policy;
32
- }
33
- return {
34
- ...policy,
35
- expectedOperationContracts: {
36
- ...policy.expectedOperationContracts,
37
- ...__generatedOperationContracts,
38
- },
39
- };
40
- };
41
-
42
- export const __modern_create_effect_bff_dispatcher = options =>
43
- createEffectBffEdgeDispatcher({
44
- ...options,
45
- crossProjectPolicy: __mergeGeneratedOperationContracts(
46
- options?.crossProjectPolicy,
47
- ),
48
- module: effectBffModule,
49
- });
13
+ import { createEffectBffEdgeDispatcherFactory } from '@modern-js/bff-effect/effect-edge';
14
+ export const __modern_create_effect_bff_dispatcher = createEffectBffEdgeDispatcherFactory(effectBffModule, ${JSON.stringify(operationContracts ?? {})});
50
15
  `;
51
16
  }
52
- async function generateEffectClientCode(options) {
53
- const { generateEffectClient } = await import("../client-generator/generator.mjs");
54
- const artifacts = await generateEffectClient(options);
55
- return null === artifacts ? null : artifacts.code;
56
- }
57
- export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper };
17
+ export { generateEffectWorkerRuntimeWrapper };
@@ -6,6 +6,7 @@ const createHonoCrossProjectPolicyMiddleware = (policy, routePath)=>async functi
6
6
  routePath
7
7
  });
8
8
  if (denial) return denial;
9
- return next();
9
+ const result = await next();
10
+ return result instanceof Response ? result : void 0;
10
11
  };
11
12
  export { createHonoCrossProjectPolicyMiddleware };
@@ -0,0 +1,14 @@
1
+ import "node:module";
2
+ import { logger } from "@modern-js/utils";
3
+ import { resolveAdapterCrossProjectPolicy } from "../cross-project-policy/node.mjs";
4
+ import { bindHonoRouteHandlers } from "./bind-route-handlers.mjs";
5
+ const createHonoRouteBinder = (api, handlers)=>{
6
+ const policy = resolveAdapterCrossProjectPolicy(api, handlers);
7
+ return (options)=>bindHonoRouteHandlers({
8
+ ...options,
9
+ policy,
10
+ onError: api.getServerConfig()?.onError,
11
+ reportError: (error)=>logger.error(error)
12
+ });
13
+ };
14
+ export { createHonoRouteBinder };
@@ -33,14 +33,9 @@ type BackendFederationEdgeRuntimeBaseOptions = {
33
33
  export type BackendFederationEdgeRuntimeOptions = BackendFederationEdgeRuntimeBaseOptions & {
34
34
  expected: BackendFederationExpectedIdentity;
35
35
  };
36
- type EdgeRuntimeLoadOptions = BackendFederationEdgeRuntimeBaseOptions & {
37
- allowMissingIdentityMetadata?: boolean;
38
- expected?: BackendFederationExpectedIdentity;
39
- };
40
36
  export type BackendFederationEdgeRuntime = {
41
37
  loadRemote<T>(request: string): Promise<T>;
42
38
  };
43
39
  export declare function createBackendFederationLoadEntryPlugin(options: BackendFederationEdgeLoadEntryPluginOptions): BackendFederationEdgeLoadEntryPlugin;
44
40
  export declare function createBackendFederationRuntime(options: BackendFederationEdgeRuntimeOptions): BackendFederationEdgeRuntime;
45
- export declare function createBackendFederationRuntimeForLoad(options: EdgeRuntimeLoadOptions): BackendFederationEdgeRuntime;
46
41
  export {};
@@ -1,4 +1,4 @@
1
- import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
1
+ import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/backend-federation-contracts';
2
2
  import { type BackendFederationEdgeLoadEntryPlugin, type BackendFederationEdgeLoadEntryPluginOptions, type BackendFederationEdgeRemote, type BackendFederationEdgeRuntimeOptions } from './edge-runtime.js';
3
3
  import type { BackendFederatedEffectApiModule, BackendFederationLoadOptions, BackendFederationIdentityLoadOptions as UniversalBackendFederationIdentityLoadOptions } from './types.js';
4
4
  export { type BackendFederationEdgeLoadEntryPlugin, type BackendFederationEdgeLoadEntryPluginOptions, type BackendFederationEdgeRemote, type BackendFederationEdgeRuntime, type BackendFederationEdgeRuntimeOptions, createBackendFederationLoadEntryPlugin, createBackendFederationRuntime, } from './edge-runtime.js';
@@ -24,5 +24,3 @@ export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFede
24
24
  };
25
25
  export type BackendFederationIdentityLoadOptions = EdgeBackendFederationIdentityLoadOptions;
26
26
  export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
27
- /** @deprecated Pass `expected` delivery-unit identity. */
28
- export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;
@@ -15,16 +15,7 @@ export type BackendFederationIdentityIssue = {
15
15
  * Shared expected-identity validation for loaded backend federation modules.
16
16
  * Compares the expose's `backendFederationContract.compatibility` identity
17
17
  * (`unitId`, `build`) against the consumer's expected delivery-unit identity.
18
- * Missing identity metadata is an error: with an expectation present there is
19
- * no legacy escape hatch.
18
+ * Missing identity metadata is an error.
20
19
  */
21
- export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity, options?: {
22
- /**
23
- * Tolerate exposes that declare no identity metadata (legacy modules).
24
- * Mismatching declared values still fail. Used by the manifest adapter,
25
- * whose manifest-side identity is already validated against `expected`;
26
- * the raw identity-aware loader is strict.
27
- */
28
- allowMissingIdentityMetadata?: boolean;
29
- }): BackendFederationIdentityIssue[];
20
+ export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity): BackendFederationIdentityIssue[];
30
21
  export declare function formatBackendFederationIdentityIssues(issues: BackendFederationIdentityIssue[]): string;
@@ -1,4 +1,4 @@
1
- import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
1
+ import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/backend-federation-contracts';
2
2
  export { type BackendFederationExpectedIdentity, type BackendFederationIdentityIssue, validateExpectedBackendFederationIdentity, } from './identity.js';
3
3
  export { createBackendFederationLoadEntryPlugin } from './plugin.js';
4
4
  export { createBackendFederationRuntime } from './runtime.js';
@@ -1,13 +1,7 @@
1
- import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions, BackendFederationLoadOptions } from './types.js';
1
+ import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions } from './types.js';
2
2
  /**
3
3
  * Load a federated Effect API with mandatory delivery-unit identity
4
4
  * validation (MV-G23): the loaded expose's compatibility metadata must match
5
5
  * `expected.unitId` + `expected.buildMarker`.
6
6
  */
7
7
  export declare function loadBackendFederatedEffectApi(options: BackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
8
- /**
9
- * @deprecated Pass `expected` (delivery-unit `unitId` + `buildMarker`).
10
- * Loads without an expected identity cannot be validated against a resolved
11
- * delivery-unit record and emit a runtime warning.
12
- */
13
- export declare function loadBackendFederatedEffectApi(options: BackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;
@@ -1,4 +1,2 @@
1
- import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions, BackendFederationLoadOptions } from './types.js';
1
+ import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions } from './types.js';
2
2
  export declare function loadBackendFederatedEffectApi(options: BackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
3
- /** @deprecated Pass `expected` delivery-unit identity. */
4
- export declare function loadBackendFederatedEffectApi(options: BackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;
@@ -1,6 +1,6 @@
1
+ import type { BACKEND_FEDERATION_EFFECT_EXPOSE } from '@modern-js/backend-federation-contracts';
1
2
  import type { EffectApiModule } from '@modern-js/bff-effect/effect';
2
3
  import type { BackendFederationRemoteEntryPolicy, BackendFederationRemoteEntryVerification } from '@modern-js/server-runtime-extensions/backend-federation-security';
3
- import type { BACKEND_FEDERATION_EFFECT_EXPOSE } from '@modern-js/utils/universal';
4
4
  import type { ModuleFederation, ModuleFederationRuntimePlugin } from '@module-federation/runtime';
5
5
  import type { BackendFederationExpectedIdentity } from './identity.js';
6
6
  export type BackendFederationRemote = {
@@ -62,12 +62,6 @@ export type BackendFederationLoadOptions = BackendFederationRuntimeOptions & {
62
62
  */
63
63
  export type BackendFederationIdentityLoadOptions = BackendFederationLoadOptions & {
64
64
  expected: BackendFederationExpectedIdentity;
65
- /**
66
- * Tolerate legacy exposes without identity metadata (mismatching declared
67
- * values still fail). Prefer leaving this unset: identity-less exposes
68
- * cannot be validated against a resolved delivery-unit record.
69
- */
70
- allowMissingIdentityMetadata?: boolean;
71
65
  };
72
66
  export type BackendFederationLoadEntryPlugin = ModuleFederationRuntimePlugin & {
73
67
  loadEntry?: (args: {
@@ -1,8 +1,7 @@
1
1
  import type { BackendFederationExpectedIdentity } from './identity.js';
2
2
  import type { BackendFederatedEffectApiModule } from './types.js';
3
3
  export declare function validateLoadedBackendFederatedEffectApi(loaded: unknown, options: {
4
- allowMissingIdentityMetadata?: boolean;
5
- expected?: BackendFederationExpectedIdentity;
4
+ expected: BackendFederationExpectedIdentity;
6
5
  remoteName: string;
7
6
  remoteRequest: string;
8
7
  }): BackendFederatedEffectApiModule;
@@ -6,12 +6,6 @@ export declare function resolveRemoteEntryFromMetadata(manifest: BackendFederati
6
6
  export declare function backendFederationMetadata(manifest: BackendFederationManifest): Record<string, unknown> | undefined;
7
7
  export declare function versionBoundaryMetadata(manifest: BackendFederationManifest): Record<string, unknown> | undefined;
8
8
  export declare function deliveryUnitMetadata(record: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
9
- /**
10
- * Resolves the delivery-unit identity root for a manifest (ADR-0019 §3):
11
- * prefers `versionBoundary.deliveryUnit`, falls back to the top-level
12
- * `backendFederation.deliveryUnit` record. Both are additive/optional so
13
- * legacy manifests without delivery-unit metadata continue to validate.
14
- */
15
9
  export declare function manifestDeliveryUnit(backendFederation: Record<string, unknown> | undefined, boundary: Record<string, unknown> | undefined): {
16
10
  boundary: Record<string, unknown> | undefined;
17
11
  top: Record<string, unknown> | undefined;
@@ -1,4 +1,4 @@
1
- import { type CrossProjectRequestObservation, type NormalizedCrossProjectPolicy } from '@modern-js/bff-core/security/cross-project-policy';
1
+ import { type CrossProjectRequestObservation, type NormalizedCrossProjectPolicy } from '@modern-js/server-runtime-extensions/bff-policy';
2
2
  export type ResolvedCrossProjectPolicy = NormalizedCrossProjectPolicy;
3
3
  export declare const checkCrossProjectPolicyResponse: (headers: Record<string, unknown>, policy: ResolvedCrossProjectPolicy | undefined, observedRequest?: CrossProjectRequestObservation) => Response | null;
4
4
  export declare const checkCrossProjectPolicyForRequest: (request: Request, policy: ResolvedCrossProjectPolicy | undefined) => Response | null;
@@ -1,4 +1,5 @@
1
- import { type OperationContractSource } from '@modern-js/bff-core';
1
+ import '@modern-js/server-runtime-extensions/server-config';
2
2
  import type { ServerPluginAPI } from '@modern-js/server-core';
3
+ import { type OperationContractSource } from '@modern-js/server-runtime-extensions/bff-policy/node';
3
4
  import type { ResolvedCrossProjectPolicy } from './evaluation.js';
4
5
  export declare const resolveAdapterCrossProjectPolicy: (api: ServerPluginAPI, handlers: OperationContractSource[]) => ResolvedCrossProjectPolicy | undefined;
@@ -0,0 +1,20 @@
1
+ interface ProducerClientOptions {
2
+ requestId?: string;
3
+ requireEnvelope?: boolean;
4
+ identityBinding?: {
5
+ enabled?: boolean;
6
+ strict?: boolean;
7
+ protectedHeaders?: string[];
8
+ };
9
+ operationContract?: {
10
+ enabled?: boolean;
11
+ strict?: boolean;
12
+ requireSchemaHash?: boolean;
13
+ requireOperationVersion?: boolean;
14
+ };
15
+ }
16
+ /** Bind producer defaults once while preserving every per-call nested override. */
17
+ export declare function createProducerClient<Options extends ProducerClientOptions, Result>(configure: (options: Options) => Result, { requestId }: {
18
+ requestId: string;
19
+ }): (options?: Options) => Result;
20
+ export {};
@@ -1,2 +1,3 @@
1
+ import '@modern-js/server-runtime-extensions/server-config';
1
2
  import type { ServerPluginAPI } from '@modern-js/server-core';
2
3
  export declare function resolveEffectAdapterEntryFile(api: ServerPluginAPI): string | undefined;
@@ -1,3 +1,4 @@
1
+ import '@modern-js/server-runtime-extensions/server-config';
1
2
  import type { ServerPluginAPI } from '@modern-js/server-core';
2
3
  interface EffectAdapterMiddlewareOptions {
3
4
  prefix: string | readonly string[];
@@ -16,4 +17,5 @@ export declare class EffectAdapter {
16
17
  dispose: () => Promise<void>;
17
18
  private loadHandler;
18
19
  }
20
+ export declare const createRuntimeAdapters: (api: ServerPluginAPI) => EffectAdapter[];
19
21
  export {};
@@ -1,3 +1,6 @@
1
- export { resolveEffectEntryFile } from '../client-generator/paths.js';
1
+ export { bundleBuiltEffectEntryForNode, resolveEffectEntryPaths, } from './built-entry.js';
2
2
  export { bundleEffectEntryForNode } from './loader.js';
3
- export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper, } from './worker-runtime-wrapper.js';
3
+ export { resolveEffectOperationContracts } from './operation-contracts.js';
4
+ export { resolveEffectEntryFile } from './paths.js';
5
+ export { bundleEffectWorkerRuntimeSource } from './worker-runtime-source.js';
6
+ export { generateEffectWorkerRuntimeWrapper } from './worker-runtime-wrapper.js';
@@ -0,0 +1,8 @@
1
+ /** Derives server policy metadata without emitting or typing a client. */
2
+ export declare function resolveEffectOperationContracts(options: {
3
+ appDir: string;
4
+ resourcePath: string;
5
+ prefix: string;
6
+ requestId?: string;
7
+ onDependency?: (dependency: string) => void;
8
+ }): Promise<import("@modern-js/server-runtime-extensions/bff-policy/node").OperationContractMap | null>;
@@ -0,0 +1,9 @@
1
+ import type { Rspack } from '@rsbuild/core';
2
+ export interface EffectBffLoaderOptions {
3
+ prefix: string;
4
+ appDir: string;
5
+ apiDir: string;
6
+ effectEntry: string;
7
+ requestId?: string;
8
+ }
9
+ export default function loader(this: Rspack.LoaderContext<EffectBffLoaderOptions>, source: string): Promise<void>;
@@ -0,0 +1,4 @@
1
+ /** Keep the worker implementation graph out of the API-to-client loader. */
2
+ export declare function bundleEffectWorkerRuntimeSource(source: string, resourcePath: string, loader: {
3
+ addDependency: (dependency: string) => void;
4
+ }): Promise<string>;
@@ -1,25 +1,7 @@
1
- import type { HttpMethodDecider } from '@modern-js/types';
2
- import type { EffectClientCodegenOptions } from '../client-generator/types.js';
3
- type EffectWorkerRuntimeGenerationOptions = {
4
- apiDir: string;
1
+ export declare function generateEffectWorkerRuntimeWrapper(loader: {
2
+ addDependency: (dependency: string) => void;
3
+ }, options: {
5
4
  appDir: string;
6
- effectDataPlatformBatch?: {
7
- allowedMethods?: string[];
8
- enabled?: boolean;
9
- endpoint?: string;
10
- flushIntervalMs?: number;
11
- maxBatchBytes?: number;
12
- maxBatchSize?: number;
13
- requestTimeoutMs?: number;
14
- };
15
- httpMethodDecider?: HttpMethodDecider;
16
- port: number;
17
5
  prefix: string;
18
- requestCreator?: string;
19
6
  requestId?: string;
20
- };
21
- export declare function generateEffectWorkerRuntimeWrapper(loader: {
22
- addDependency: (dependency: string) => void;
23
- }, options: EffectWorkerRuntimeGenerationOptions, resourcePath: string): Promise<string>;
24
- export declare function generateEffectClientCode(options: EffectClientCodegenOptions): Promise<string | null>;
25
- export {};
7
+ }, resourcePath: string): Promise<string>;
@@ -0,0 +1,4 @@
1
+ import type { ServerPluginAPI } from '@modern-js/server-core';
2
+ import type { OperationContractSource } from '@modern-js/server-runtime-extensions/bff-policy/node';
3
+ import { type BindHonoRouteHandlersOptions } from './bind-route-handlers.js';
4
+ export declare const createHonoRouteBinder: (api: ServerPluginAPI, handlers: OperationContractSource[]) => (options: Pick<BindHonoRouteHandlersOptions, 'handler' | 'routePath'>) => import("hono").MiddlewareHandler[] | import("hono").MiddlewareHandler;
package/package.json CHANGED
@@ -18,7 +18,7 @@
18
18
  "modern.js",
19
19
  "ultramodern.js"
20
20
  ],
21
- "version": "3.9.0-ultramodern.1",
21
+ "version": "3.9.0-ultramodern.11",
22
22
  "files": [
23
23
  "dist",
24
24
  "src"
@@ -66,14 +66,6 @@
66
66
  },
67
67
  "default": "./dist/cjs/effect-source-loader/index.js"
68
68
  },
69
- "./client-generator": {
70
- "types": "./dist/types/client-generator/index.d.ts",
71
- "node": {
72
- "import": "./dist/esm-node/client-generator/index.mjs",
73
- "require": "./dist/cjs/client-generator/index.js"
74
- },
75
- "default": "./dist/cjs/client-generator/index.js"
76
- },
77
69
  "./backend-federation": {
78
70
  "types": "./dist/types/backend-federation/index.d.ts",
79
71
  "node": {
@@ -115,6 +107,30 @@
115
107
  "require": "./dist/cjs/backend-federation-manifest/node.js"
116
108
  },
117
109
  "default": "./dist/cjs/backend-federation-manifest/node.js"
110
+ },
111
+ "./effect-source-loader/rspack-loader": {
112
+ "types": "./dist/types/effect-source-loader/rspack-loader.d.ts",
113
+ "node": {
114
+ "import": "./dist/esm-node/effect-source-loader/rspack-loader.mjs",
115
+ "require": "./dist/cjs/effect-source-loader/rspack-loader.js"
116
+ },
117
+ "default": "./dist/cjs/effect-source-loader/rspack-loader.js"
118
+ },
119
+ "./producer-runtime": {
120
+ "types": "./dist/types/cross-project-policy/producer-runtime.d.ts",
121
+ "node": {
122
+ "import": "./dist/esm-node/cross-project-policy/producer-runtime.mjs",
123
+ "require": "./dist/cjs/cross-project-policy/producer-runtime.js"
124
+ },
125
+ "import": "./dist/esm/cross-project-policy/producer-runtime.mjs",
126
+ "default": "./dist/esm/cross-project-policy/producer-runtime.mjs"
127
+ },
128
+ "./hono/node": {
129
+ "types": "./dist/types/hono/node.d.ts",
130
+ "node": {
131
+ "import": "./dist/esm-node/hono/node.mjs",
132
+ "require": "./dist/cjs/hono/node.js"
133
+ }
118
134
  }
119
135
  },
120
136
  "typesVersions": {
@@ -139,10 +155,6 @@
139
155
  "./dist/types/effect-source-loader/index.d.ts",
140
156
  "./src/effect-source-loader/index.ts"
141
157
  ],
142
- "client-generator": [
143
- "./dist/types/client-generator/index.d.ts",
144
- "./src/client-generator/index.ts"
145
- ],
146
158
  "backend-federation": [
147
159
  "./dist/types/backend-federation/index.d.ts",
148
160
  "./src/backend-federation/index.ts"
@@ -162,6 +174,18 @@
162
174
  "backend-federation-manifest/node": [
163
175
  "./dist/types/backend-federation-manifest/node.d.ts",
164
176
  "./src/backend-federation-manifest/node.ts"
177
+ ],
178
+ "effect-source-loader/rspack-loader": [
179
+ "./dist/types/effect-source-loader/rspack-loader.d.ts",
180
+ "./src/effect-source-loader/rspack-loader.ts"
181
+ ],
182
+ "producer-runtime": [
183
+ "./dist/types/cross-project-policy/producer-runtime.d.ts",
184
+ "./src/cross-project-policy/producer-runtime.ts"
185
+ ],
186
+ "hono/node": [
187
+ "./dist/types/hono/node.d.ts",
188
+ "./src/hono/node.ts"
165
189
  ]
166
190
  }
167
191
  },
@@ -169,15 +193,17 @@
169
193
  "node": ">=26.7.0"
170
194
  },
171
195
  "dependencies": {
172
- "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.1",
173
- "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.1",
174
- "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.1",
175
- "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.1",
176
- "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.1",
177
- "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.1",
178
- "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.1",
196
+ "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.11",
197
+ "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.11",
198
+ "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.11",
199
+ "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.11",
200
+ "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.11",
201
+ "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.11",
202
+ "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.11",
203
+ "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.11",
179
204
  "@module-federation/runtime": "2.9.0",
180
- "esbuild": "^0.28.1"
205
+ "@swc/core": "1.16.2",
206
+ "esbuild": "^0.28.2"
181
207
  },
182
208
  "peerDependencies": {
183
209
  "@effect/opentelemetry": "4.0.0-rc.112",
@@ -193,9 +219,11 @@
193
219
  },
194
220
  "devDependencies": {
195
221
  "@effect/opentelemetry": "4.0.0-rc.112",
222
+ "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.11",
223
+ "@rsbuild/core": "2.2.3",
196
224
  "@rslib/core": "1.0.0",
197
225
  "@scripts/rstest-config": "2.66.0",
198
- "@types/node": "^26.2.0",
226
+ "@types/node": "^26.4.1",
199
227
  "@types/react": "^19.2.18",
200
228
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
201
229
  "effect": "4.0.0-rc.112"
@@ -50,8 +50,7 @@ export type BackendFederationEdgeRuntimeOptions =
50
50
  };
51
51
 
52
52
  type EdgeRuntimeLoadOptions = BackendFederationEdgeRuntimeBaseOptions & {
53
- allowMissingIdentityMetadata?: boolean;
54
- expected?: BackendFederationExpectedIdentity;
53
+ expected: BackendFederationExpectedIdentity;
55
54
  };
56
55
 
57
56
  function parseRemoteRequest(request: string) {
@@ -113,9 +112,8 @@ async function resolveEdgeEntry(
113
112
 
114
113
  class EdgeBackendFederationRuntime {
115
114
  readonly #entries = new Map<string, Promise<BackendFederationEntryExports>>();
116
- readonly #expected: BackendFederationExpectedIdentity | undefined;
115
+ readonly #expected: BackendFederationExpectedIdentity;
117
116
  readonly #hostName: string;
118
- readonly #allowMissingIdentityMetadata: boolean;
119
117
  readonly #modules = new Map<string, Promise<unknown>>();
120
118
  readonly #plugins: readonly BackendFederationEdgeLoadEntryPlugin[];
121
119
  readonly #remotes: BackendFederationEdgeRemote[];
@@ -126,8 +124,6 @@ class EdgeBackendFederationRuntime {
126
124
  '[BFF][Effect] Edge backend federation does not execute entry evaluators. Register a static or service-binding entry provider.',
127
125
  );
128
126
  }
129
- this.#allowMissingIdentityMetadata =
130
- options.allowMissingIdentityMetadata === true;
131
127
  this.#expected = options.expected;
132
128
  this.#hostName = options.hostName;
133
129
  this.#plugins = options.plugins ?? [];
@@ -182,7 +178,6 @@ class EdgeBackendFederationRuntime {
182
178
  }
183
179
  const loaded = await factory();
184
180
  return validateLoadedBackendFederatedEffectApi(loaded, {
185
- allowMissingIdentityMetadata: this.#allowMissingIdentityMetadata,
186
181
  expected: this.#expected,
187
182
  remoteName,
188
183
  remoteRequest: request,
@@ -250,9 +245,3 @@ export function createBackendFederationRuntime(
250
245
  }
251
246
  return new EdgeBackendFederationRuntime(options);
252
247
  }
253
-
254
- export function createBackendFederationRuntimeForLoad(
255
- options: EdgeRuntimeLoadOptions,
256
- ): BackendFederationEdgeRuntime {
257
- return new EdgeBackendFederationRuntime(options);
258
- }
@@ -3,16 +3,14 @@ import {
3
3
  BACKEND_FEDERATION_EFFECT_EXPOSE,
4
4
  BACKEND_FEDERATION_MANIFEST_FILE,
5
5
  BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
6
- } from '@modern-js/utils/universal';
6
+ } from '@modern-js/backend-federation-contracts';
7
7
  import {
8
8
  type BackendFederationEdgeLoadEntryPlugin,
9
9
  type BackendFederationEdgeLoadEntryPluginOptions,
10
10
  type BackendFederationEdgeRemote,
11
11
  type BackendFederationEdgeRuntimeOptions,
12
- createBackendFederationRuntimeForLoad,
12
+ createBackendFederationRuntime,
13
13
  } from './edge-runtime';
14
- import type { BackendFederationExpectedIdentity } from './identity';
15
- import { LEGACY_LOAD_WARNING } from './legacy-warning';
16
14
  import type {
17
15
  BackendFederatedEffectApiModule,
18
16
  BackendFederationLoadOptions,
@@ -79,16 +77,6 @@ export type BackendFederationIdentityLoadOptions =
79
77
 
80
78
  export function loadBackendFederatedEffectApi(
81
79
  options: EdgeBackendFederationIdentityLoadOptions,
82
- ): Promise<BackendFederatedEffectApiModule>;
83
- /** @deprecated Pass `expected` delivery-unit identity. */
84
- export function loadBackendFederatedEffectApi(
85
- options: EdgeBackendFederationLoadOptions,
86
- ): Promise<BackendFederatedEffectApiModule>;
87
- export function loadBackendFederatedEffectApi(
88
- options: EdgeBackendFederationLoadOptions & {
89
- expected?: BackendFederationExpectedIdentity;
90
- allowMissingIdentityMetadata?: boolean;
91
- },
92
80
  ): Promise<BackendFederatedEffectApiModule> {
93
81
  if (
94
82
  (options as BackendFederationLoadOptions).runtime !== undefined ||
@@ -108,8 +96,12 @@ export function loadBackendFederatedEffectApi(
108
96
  );
109
97
  }
110
98
 
111
- if (options.expected === undefined) {
112
- console.warn(LEGACY_LOAD_WARNING);
99
+ if (!options.expected?.unitId || !options.expected.buildMarker) {
100
+ return Promise.reject(
101
+ new Error(
102
+ '[BFF][Effect] Backend federation requires expected.unitId and expected.buildMarker.',
103
+ ),
104
+ );
113
105
  }
114
106
 
115
107
  const expose =
@@ -120,7 +112,7 @@ export function loadBackendFederatedEffectApi(
120
112
 
121
113
  let runtime;
122
114
  try {
123
- runtime = createBackendFederationRuntimeForLoad(options);
115
+ runtime = createBackendFederationRuntime(options);
124
116
  } catch (error) {
125
117
  return Promise.reject(error);
126
118
  }