@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.2 → 3.9.0-ultramodern.20

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 (216) hide show
  1. package/README.md +25 -5
  2. package/dist/cjs/backend-federation/edge-runtime.js +3 -15
  3. package/dist/cjs/backend-federation/edge.js +9 -10
  4. package/dist/cjs/backend-federation/identity.js +26 -31
  5. package/dist/cjs/backend-federation/index.js +5 -5
  6. package/dist/cjs/backend-federation/integrity-plugin.js +112 -0
  7. package/dist/cjs/backend-federation/load.js +3 -13
  8. package/dist/cjs/backend-federation/node-shared.js +85 -0
  9. package/dist/cjs/backend-federation/node.js +6 -1
  10. package/dist/cjs/backend-federation/plugin.js +40 -21
  11. package/dist/cjs/backend-federation/runtime.js +16 -84
  12. package/dist/cjs/backend-federation/validate-loaded.js +2 -4
  13. package/dist/cjs/backend-federation-manifest/load.js +40 -12
  14. package/dist/cjs/backend-federation-manifest/metadata.js +3 -3
  15. package/dist/cjs/backend-federation-manifest/node.js +3 -1
  16. package/dist/cjs/backend-federation-manifest/remote.js +3 -9
  17. package/dist/cjs/backend-federation-manifest/validation.js +16 -12
  18. package/dist/cjs/cross-project-policy/evaluation.js +3 -3
  19. package/dist/cjs/cross-project-policy/node.js +11 -30
  20. package/dist/cjs/{backend-federation/legacy-warning.js → cross-project-policy/producer-runtime.js} +23 -5
  21. package/dist/cjs/{effect-adapter → effect-server}/cross-project-policy.js +5 -5
  22. package/dist/cjs/effect-server/entry.js +63 -0
  23. package/dist/cjs/{effect-adapter → effect-server}/error-response.js +4 -4
  24. package/dist/cjs/effect-server/index.js +199 -0
  25. package/dist/cjs/{client-generator → effect-source-loader}/built-entry.js +5 -6
  26. package/dist/cjs/{client-generator/runtime.js → effect-source-loader/http-api-runtime.js} +12 -20
  27. package/dist/cjs/effect-source-loader/index.js +18 -6
  28. package/dist/cjs/effect-source-loader/loader.js +17 -30
  29. package/dist/cjs/effect-source-loader/operation-contracts.js +60 -0
  30. package/dist/cjs/effect-source-loader/paths.js +90 -0
  31. package/dist/cjs/effect-source-loader/rspack-loader.js +73 -0
  32. package/dist/cjs/effect-source-loader/worker-runtime-source.js +71 -0
  33. package/dist/cjs/effect-source-loader/worker-runtime-wrapper.js +7 -50
  34. package/dist/cjs/hono/cross-project-policy.js +2 -1
  35. package/dist/cjs/{client-generator/paths.js → hono/node.js} +14 -25
  36. package/dist/esm/backend-federation/edge-runtime.mjs +2 -11
  37. package/dist/esm/backend-federation/edge.mjs +5 -6
  38. package/dist/esm/backend-federation/identity.mjs +21 -32
  39. package/dist/esm/backend-federation/index.mjs +1 -1
  40. package/dist/esm/backend-federation/integrity-plugin.mjs +68 -0
  41. package/dist/esm/backend-federation/load.mjs +2 -12
  42. package/dist/esm/backend-federation/node-shared.mjs +41 -0
  43. package/dist/esm/backend-federation/node.mjs +4 -2
  44. package/dist/esm/backend-federation/plugin.mjs +37 -18
  45. package/dist/esm/backend-federation/runtime.mjs +16 -84
  46. package/dist/esm/backend-federation/validate-loaded.mjs +2 -4
  47. package/dist/esm/backend-federation-manifest/load.mjs +40 -12
  48. package/dist/esm/backend-federation-manifest/metadata.mjs +1 -1
  49. package/dist/esm/backend-federation-manifest/node.mjs +3 -1
  50. package/dist/esm/backend-federation-manifest/remote.mjs +2 -8
  51. package/dist/esm/backend-federation-manifest/validation.mjs +15 -11
  52. package/dist/esm/cross-project-policy/evaluation.mjs +1 -1
  53. package/dist/esm/cross-project-policy/node.mjs +10 -19
  54. package/dist/esm/cross-project-policy/producer-runtime.mjs +20 -0
  55. package/dist/esm/{effect-adapter → effect-server}/cross-project-policy.mjs +3 -3
  56. package/dist/esm/effect-server/entry.mjs +15 -0
  57. package/dist/esm/{effect-adapter → effect-server}/error-response.mjs +2 -2
  58. package/dist/esm/effect-server/index.mjs +151 -0
  59. package/dist/esm/{client-generator → effect-source-loader}/built-entry.mjs +6 -7
  60. package/dist/esm/effect-source-loader/http-api-runtime.mjs +19 -0
  61. package/dist/esm/effect-source-loader/index.mjs +5 -2
  62. package/dist/esm/effect-source-loader/loader.mjs +17 -30
  63. package/dist/esm/effect-source-loader/operation-contracts.mjs +22 -0
  64. package/dist/esm/effect-source-loader/paths.mjs +43 -0
  65. package/dist/esm/effect-source-loader/rspack-loader.mjs +35 -0
  66. package/dist/esm/effect-source-loader/worker-runtime-source.mjs +23 -0
  67. package/dist/esm/effect-source-loader/worker-runtime-wrapper.mjs +5 -45
  68. package/dist/esm/hono/cross-project-policy.mjs +2 -1
  69. package/dist/esm-node/backend-federation/edge-runtime.mjs +2 -11
  70. package/dist/esm-node/backend-federation/edge.mjs +5 -6
  71. package/dist/esm-node/backend-federation/identity.mjs +21 -32
  72. package/dist/esm-node/backend-federation/index.mjs +1 -1
  73. package/dist/esm-node/backend-federation/integrity-plugin.mjs +69 -0
  74. package/dist/esm-node/backend-federation/load.mjs +2 -12
  75. package/dist/esm-node/backend-federation/node-shared.mjs +42 -0
  76. package/dist/esm-node/backend-federation/node.mjs +4 -2
  77. package/dist/esm-node/backend-federation/plugin.mjs +37 -18
  78. package/dist/esm-node/backend-federation/runtime.mjs +16 -84
  79. package/dist/esm-node/backend-federation/validate-loaded.mjs +2 -4
  80. package/dist/esm-node/backend-federation-manifest/load.mjs +40 -12
  81. package/dist/esm-node/backend-federation-manifest/metadata.mjs +1 -1
  82. package/dist/esm-node/backend-federation-manifest/node.mjs +3 -1
  83. package/dist/esm-node/backend-federation-manifest/remote.mjs +2 -8
  84. package/dist/esm-node/backend-federation-manifest/validation.mjs +15 -11
  85. package/dist/esm-node/cross-project-policy/evaluation.mjs +1 -1
  86. package/dist/esm-node/cross-project-policy/node.mjs +10 -19
  87. package/dist/esm-node/cross-project-policy/producer-runtime.mjs +21 -0
  88. package/dist/esm-node/{effect-adapter → effect-server}/cross-project-policy.mjs +3 -3
  89. package/dist/esm-node/effect-server/entry.mjs +16 -0
  90. package/dist/esm-node/{effect-adapter → effect-server}/error-response.mjs +2 -2
  91. package/dist/esm-node/effect-server/index.mjs +152 -0
  92. package/dist/esm-node/{client-generator → effect-source-loader}/built-entry.mjs +6 -7
  93. package/dist/esm-node/effect-source-loader/http-api-runtime.mjs +20 -0
  94. package/dist/esm-node/effect-source-loader/index.mjs +5 -2
  95. package/dist/esm-node/effect-source-loader/loader.mjs +17 -30
  96. package/dist/esm-node/effect-source-loader/operation-contracts.mjs +23 -0
  97. package/dist/esm-node/effect-source-loader/paths.mjs +44 -0
  98. package/dist/esm-node/effect-source-loader/rspack-loader.mjs +37 -0
  99. package/dist/esm-node/effect-source-loader/worker-runtime-source.mjs +24 -0
  100. package/dist/esm-node/effect-source-loader/worker-runtime-wrapper.mjs +5 -45
  101. package/dist/esm-node/hono/cross-project-policy.mjs +2 -1
  102. package/dist/esm-node/hono/node.mjs +14 -0
  103. package/dist/types/backend-federation/edge-runtime.d.ts +0 -5
  104. package/dist/types/backend-federation/edge.d.ts +5 -5
  105. package/dist/types/backend-federation/identity.d.ts +4 -16
  106. package/dist/types/backend-federation/index.d.ts +1 -1
  107. package/dist/types/backend-federation/integrity-plugin.d.ts +13 -0
  108. package/dist/types/backend-federation/load.d.ts +1 -7
  109. package/dist/types/backend-federation/node-shared.d.ts +20 -0
  110. package/dist/types/backend-federation/node.d.ts +4 -3
  111. package/dist/types/backend-federation/plugin.d.ts +4 -0
  112. package/dist/types/backend-federation/types.d.ts +3 -14
  113. package/dist/types/backend-federation/validate-loaded.d.ts +1 -2
  114. package/dist/types/backend-federation-manifest/metadata.d.ts +0 -6
  115. package/dist/types/backend-federation-manifest/types.d.ts +2 -1
  116. package/dist/types/cross-project-policy/evaluation.d.ts +1 -1
  117. package/dist/types/cross-project-policy/node.d.ts +3 -2
  118. package/dist/types/cross-project-policy/producer-runtime.d.ts +20 -0
  119. package/dist/types/effect-server/cross-project-policy.d.ts +5 -0
  120. package/dist/types/effect-server/entry.d.ts +3 -0
  121. package/dist/types/effect-server/error-response.d.ts +2 -0
  122. package/dist/types/effect-server/index.d.ts +4 -0
  123. package/dist/types/effect-source-loader/index.d.ts +5 -2
  124. package/dist/types/effect-source-loader/operation-contracts.d.ts +8 -0
  125. package/dist/types/effect-source-loader/paths.d.ts +23 -0
  126. package/dist/types/effect-source-loader/rspack-loader.d.ts +9 -0
  127. package/dist/types/effect-source-loader/worker-runtime-source.d.ts +4 -0
  128. package/dist/types/effect-source-loader/worker-runtime-wrapper.d.ts +4 -22
  129. package/dist/types/hono/node.d.ts +4 -0
  130. package/package.json +64 -36
  131. package/src/backend-federation/edge-runtime.ts +2 -13
  132. package/src/backend-federation/edge.ts +16 -21
  133. package/src/backend-federation/identity.ts +39 -65
  134. package/src/backend-federation/index.ts +1 -1
  135. package/src/backend-federation/integrity-plugin.ts +157 -0
  136. package/src/backend-federation/load.ts +7 -35
  137. package/src/backend-federation/node-shared.ts +76 -0
  138. package/src/backend-federation/node.ts +7 -14
  139. package/src/backend-federation/plugin.ts +73 -25
  140. package/src/backend-federation/runtime.ts +16 -90
  141. package/src/backend-federation/types.ts +3 -18
  142. package/src/backend-federation/validate-loaded.ts +2 -7
  143. package/src/backend-federation-manifest/load.ts +93 -38
  144. package/src/backend-federation-manifest/metadata.ts +1 -7
  145. package/src/backend-federation-manifest/node.ts +3 -2
  146. package/src/backend-federation-manifest/remote.ts +1 -7
  147. package/src/backend-federation-manifest/types.ts +2 -0
  148. package/src/backend-federation-manifest/validation.ts +29 -39
  149. package/src/cross-project-policy/evaluation.ts +1 -1
  150. package/src/cross-project-policy/node.ts +10 -41
  151. package/src/cross-project-policy/producer-runtime.ts +43 -0
  152. package/src/{effect-adapter → effect-server}/cross-project-policy.ts +8 -2
  153. package/src/effect-server/entry.ts +18 -0
  154. package/src/{effect-adapter → effect-server}/error-response.ts +1 -1
  155. package/src/effect-server/index.ts +242 -0
  156. package/src/{client-generator → effect-source-loader}/built-entry.ts +12 -12
  157. package/src/effect-source-loader/http-api-runtime.ts +39 -0
  158. package/src/effect-source-loader/index.ts +8 -5
  159. package/src/effect-source-loader/loader.ts +47 -52
  160. package/src/effect-source-loader/operation-contracts.ts +38 -0
  161. package/src/effect-source-loader/paths.ts +74 -0
  162. package/src/effect-source-loader/rspack-loader.ts +71 -0
  163. package/src/effect-source-loader/worker-runtime-source.ts +34 -0
  164. package/src/effect-source-loader/worker-runtime-wrapper.ts +5 -75
  165. package/src/hono/cross-project-policy.ts +2 -1
  166. package/src/hono/node.ts +24 -0
  167. package/dist/cjs/backend-federation/entry.js +0 -94
  168. package/dist/cjs/client-generator/generator.js +0 -73
  169. package/dist/cjs/client-generator/index.js +0 -54
  170. package/dist/cjs/client-generator/rendering.js +0 -253
  171. package/dist/cjs/client-generator/types.js +0 -18
  172. package/dist/cjs/effect-adapter/entry.js +0 -98
  173. package/dist/cjs/effect-adapter/index.js +0 -187
  174. package/dist/esm/backend-federation/entry.mjs +0 -56
  175. package/dist/esm/backend-federation/legacy-warning.mjs +0 -2
  176. package/dist/esm/client-generator/generator.mjs +0 -32
  177. package/dist/esm/client-generator/index.mjs +0 -3
  178. package/dist/esm/client-generator/paths.mjs +0 -24
  179. package/dist/esm/client-generator/rendering.mjs +0 -209
  180. package/dist/esm/client-generator/runtime.mjs +0 -27
  181. package/dist/esm/client-generator/types.mjs +0 -0
  182. package/dist/esm/effect-adapter/entry.mjs +0 -50
  183. package/dist/esm/effect-adapter/index.mjs +0 -139
  184. package/dist/esm-node/backend-federation/entry.mjs +0 -57
  185. package/dist/esm-node/backend-federation/legacy-warning.mjs +0 -3
  186. package/dist/esm-node/client-generator/generator.mjs +0 -33
  187. package/dist/esm-node/client-generator/index.mjs +0 -4
  188. package/dist/esm-node/client-generator/paths.mjs +0 -25
  189. package/dist/esm-node/client-generator/rendering.mjs +0 -210
  190. package/dist/esm-node/client-generator/runtime.mjs +0 -29
  191. package/dist/esm-node/client-generator/types.mjs +0 -1
  192. package/dist/esm-node/effect-adapter/entry.mjs +0 -51
  193. package/dist/esm-node/effect-adapter/index.mjs +0 -140
  194. package/dist/types/backend-federation/entry.d.ts +0 -2
  195. package/dist/types/backend-federation/legacy-warning.d.ts +0 -1
  196. package/dist/types/client-generator/generator.d.ts +0 -3
  197. package/dist/types/client-generator/index.d.ts +0 -4
  198. package/dist/types/client-generator/paths.d.ts +0 -5
  199. package/dist/types/client-generator/rendering.d.ts +0 -24
  200. package/dist/types/client-generator/types.d.ts +0 -33
  201. package/dist/types/effect-adapter/cross-project-policy.d.ts +0 -4
  202. package/dist/types/effect-adapter/entry.d.ts +0 -2
  203. package/dist/types/effect-adapter/error-response.d.ts +0 -2
  204. package/dist/types/effect-adapter/index.d.ts +0 -19
  205. package/src/backend-federation/entry.ts +0 -125
  206. package/src/backend-federation/legacy-warning.ts +0 -2
  207. package/src/client-generator/generator.ts +0 -52
  208. package/src/client-generator/index.ts +0 -10
  209. package/src/client-generator/paths.ts +0 -40
  210. package/src/client-generator/rendering.ts +0 -307
  211. package/src/client-generator/runtime.ts +0 -69
  212. package/src/client-generator/types.ts +0 -35
  213. package/src/effect-adapter/entry.ts +0 -95
  214. package/src/effect-adapter/index.ts +0 -246
  215. /package/dist/types/{client-generator → effect-source-loader}/built-entry.d.ts +0 -0
  216. /package/dist/types/{client-generator/runtime.d.ts → effect-source-loader/http-api-runtime.d.ts} +0 -0
@@ -1,13 +1,15 @@
1
1
  import "node:module";
2
2
  import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
3
3
  import { loadBackendFederatedEffectApi } from "./load.mjs";
4
- function node_loadBackendFederatedEffectApi(options) {
4
+ import { effectBffHostShared, withEffectBffHostShared } from "./node-shared.mjs";
5
+ async function node_loadBackendFederatedEffectApi(options) {
5
6
  return loadBackendFederatedEffectApi({
6
7
  ...options,
8
+ shared: withEffectBffHostShared(options.shared),
7
9
  entryPolicy: {
8
10
  ...options.entryPolicy,
9
11
  evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateNodeBackendFederationCommonJs
10
12
  }
11
13
  });
12
14
  }
13
- export { node_loadBackendFederatedEffectApi as loadBackendFederatedEffectApi };
15
+ export { effectBffHostShared, node_loadBackendFederatedEffectApi as loadBackendFederatedEffectApi };
@@ -1,25 +1,44 @@
1
1
  import "node:module";
2
+ import { PROVIDED_ENTRY_SCHEME, registerRemoteContainer } from "./integrity-plugin.mjs";
3
+ function toContainer(entry) {
4
+ return {
5
+ get (id) {
6
+ return ()=>Promise.resolve(entry.get(id)).then((factory)=>factory());
7
+ },
8
+ init (...args) {
9
+ return entry.init?.(...args);
10
+ }
11
+ };
12
+ }
2
13
  function createBackendFederationLoadEntryPlugin(options) {
14
+ const provided = new WeakMap();
3
15
  return {
4
16
  name: 'modernjs-backend-federation-load-entry',
5
- loadEntry ({ remoteInfo }) {
6
- return Promise.resolve(options.resolveEntry({
7
- name: remoteInfo.name,
8
- entry: remoteInfo.entry,
9
- type: remoteInfo.type,
10
- entryGlobalName: remoteInfo.entryGlobalName,
11
- shareScope: remoteInfo.shareScope
12
- })).then((entry)=>{
13
- if (void 0 === entry) return;
14
- return {
15
- get (id) {
16
- return ()=>Promise.resolve(entry.get(id)).then((factory)=>factory());
17
- },
18
- init (...args) {
19
- return entry.init?.(...args);
20
- }
21
- };
22
- });
17
+ afterMatchRemote ({ origin, remoteInfo }) {
18
+ if (void 0 === remoteInfo || !PROVIDED_ENTRY_SCHEME.test(remoteInfo.entry)) return;
19
+ let entries = provided.get(origin);
20
+ if (entries?.has(remoteInfo.name) !== true && origin.moduleCache.get(remoteInfo.name)?.remoteEntryExports !== void 0) return;
21
+ if (void 0 === entries) {
22
+ entries = new Map();
23
+ provided.set(origin, entries);
24
+ }
25
+ const runtimeEntries = entries;
26
+ let pending = runtimeEntries.get(remoteInfo.name);
27
+ if (void 0 === pending) {
28
+ pending = Promise.resolve(options.resolveEntry({
29
+ name: remoteInfo.name,
30
+ entry: remoteInfo.entry,
31
+ type: remoteInfo.type
32
+ })).then((entry)=>{
33
+ if (void 0 !== entry) registerRemoteContainer(origin, remoteInfo, toContainer(entry));
34
+ });
35
+ const settled = pending;
36
+ runtimeEntries.set(remoteInfo.name, settled);
37
+ settled.catch(()=>{
38
+ if (runtimeEntries.get(remoteInfo.name) === settled) runtimeEntries.delete(remoteInfo.name);
39
+ });
40
+ }
41
+ return pending;
23
42
  }
24
43
  };
25
44
  }
@@ -1,91 +1,23 @@
1
1
  import "node:module";
2
2
  import { ModuleFederation } from "@module-federation/runtime";
3
- import { loadBackendFederationExpose } from "./entry.mjs";
4
- import { createBackendFederationLoadEntryPlugin } from "./plugin.mjs";
3
+ import { createBackendFederationIntegrityPlugin } from "./integrity-plugin.mjs";
5
4
  import { collectRemotes } from "./remotes.mjs";
6
- function _check_private_redeclaration(obj, privateCollection) {
7
- if (privateCollection.has(obj)) throw new TypeError("Cannot initialize the same private elements twice on an object");
8
- }
9
- function _class_apply_descriptor_get(receiver, descriptor) {
10
- if (descriptor.get) return descriptor.get.call(receiver);
11
- return descriptor.value;
12
- }
13
- function _class_apply_descriptor_set(receiver, descriptor, value) {
14
- if (descriptor.set) descriptor.set.call(receiver, value);
15
- else {
16
- if (!descriptor.writable) throw new TypeError("attempted to set read only private field");
17
- descriptor.value = value;
18
- }
19
- }
20
- function _class_extract_field_descriptor(receiver, privateMap, action) {
21
- if (!privateMap.has(receiver)) throw new TypeError("attempted to " + action + " private field on non-instance");
22
- return privateMap.get(receiver);
23
- }
24
- function _class_private_field_get(receiver, privateMap) {
25
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
26
- return _class_apply_descriptor_get(receiver, descriptor);
27
- }
28
- function _class_private_field_init(obj, privateMap, value) {
29
- _check_private_redeclaration(obj, privateMap);
30
- privateMap.set(obj, value);
31
- }
32
- function _class_private_field_set(receiver, privateMap, value) {
33
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
34
- _class_apply_descriptor_set(receiver, descriptor, value);
35
- return value;
36
- }
37
- let nextRuntimeId = 0;
38
- function parseRemoteRequest(request) {
39
- const [remoteName, ...exposeParts] = request.split('/');
40
- if (void 0 === remoteName || 0 === remoteName.length || 0 === exposeParts.length) return;
41
- return remoteName;
42
- }
43
- function createLocalEntryPlugin(options, remotes) {
44
- return createBackendFederationLoadEntryPlugin({
45
- resolveEntry (resolvedRemote) {
46
- const remote = remotes.find((candidate)=>candidate.name === resolvedRemote.name);
47
- if (void 0 === remote) return;
48
- return {
49
- get (expose) {
50
- return ()=>loadBackendFederationExpose(remote, expose, options);
51
- }
52
- };
53
- }
54
- });
55
- }
56
- function isolateRegisteredRemoteEntries(remotes) {
57
- const runtimeId = nextRuntimeId;
58
- nextRuntimeId += 1;
59
- return remotes.map((remote)=>({
60
- ...remote,
61
- entry: `${remote.entry}#modernjs-backend-runtime-${runtimeId}`
62
- }));
63
- }
64
- var _remoteNames = /*#__PURE__*/ new WeakMap();
65
- class BackendFederationRuntime extends ModuleFederation {
66
- loadRemote(request, loadOptions) {
67
- const remoteName = parseRemoteRequest(request);
68
- if (void 0 === remoteName) return Promise.reject(new Error(`[BFF][Effect] Invalid backend federation request ${request}.`));
69
- if (!_class_private_field_get(this, _remoteNames).has(remoteName)) return Promise.reject(new Error(`[BFF][Effect] Missing backend federation remote ${remoteName}.`));
70
- return super.loadRemote(request, loadOptions);
71
- }
72
- constructor(options, remotes){
73
- super({
74
- name: options.hostName,
75
- remotes: isolateRegisteredRemoteEntries(remotes),
76
- shared: {},
77
- plugins: [
78
- createLocalEntryPlugin(options, remotes)
79
- ]
80
- }), _class_private_field_init(this, _remoteNames, {
81
- writable: true,
82
- value: void 0
83
- });
84
- _class_private_field_set(this, _remoteNames, new Set(remotes.map((remote)=>remote.name)));
85
- }
86
- }
87
5
  function createBackendFederationRuntime(options) {
88
6
  const remotes = collectRemotes(options);
89
- return new BackendFederationRuntime(options, remotes);
7
+ return new ModuleFederation({
8
+ name: options.hostName,
9
+ remotes: remotes.map(({ name, entry, type })=>({
10
+ name,
11
+ entry,
12
+ ...type ? {
13
+ type
14
+ } : {}
15
+ })),
16
+ shared: options.shared ?? {},
17
+ plugins: [
18
+ ...options.plugins ?? [],
19
+ createBackendFederationIntegrityPlugin(options, remotes)
20
+ ]
21
+ });
90
22
  }
91
23
  export { createBackendFederationRuntime };
@@ -8,10 +8,8 @@ function validateLoadedBackendFederatedEffectApi(loaded, options) {
8
8
  if ('effect' !== backendContract.runtimeFramework) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} must expose strict Effect metadata (runtimeFramework: "effect").`);
9
9
  if ('string' == typeof backendContract.name && backendContract.name !== options.remoteName) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} metadata name mismatch: expected ${options.remoteName}, received ${backendContract.name}.`);
10
10
  if (!('runtime' in loaded)) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} must expose runtime.`);
11
- if (void 0 !== options.expected) {
12
- const issues = validateExpectedBackendFederationIdentity(loaded, options.expected, {
13
- allowMissingIdentityMetadata: true === options.allowMissingIdentityMetadata
14
- });
11
+ {
12
+ const issues = validateExpectedBackendFederationIdentity(loaded, options.expected);
15
13
  if (issues.length > 0) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} delivery-unit identity mismatch: ${formatBackendFederationIdentityIssues(issues)}.`);
16
14
  }
17
15
  return loaded;
@@ -2,9 +2,11 @@ import "node:module";
2
2
  import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "../backend-federation/index.mjs";
3
3
  import { loadBackendFederatedEffectApi } from "../backend-federation/load.mjs";
4
4
  import { BackendFederationManifestAdapterError } from "./errors.mjs";
5
+ import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
5
6
  import { loadBackendFederationManifest } from "./reference.mjs";
6
7
  import { resolveBackendFederationRemoteFromManifest } from "./remote.mjs";
7
8
  import { classifyLoadError, validateBackendFederationManifest, validateLoadedBackendFederationContract } from "./validation.mjs";
9
+ const DEFAULT_SHARED_MANIFEST_LOAD_TIMEOUT_MS = 10000;
8
10
  function createManifestLoadScope(options) {
9
11
  const controller = new AbortController();
10
12
  const policyTimeouts = [
@@ -16,7 +18,8 @@ function createManifestLoadScope(options) {
16
18
  ...policyTimeouts
17
19
  ].filter((timeout)=>void 0 !== timeout);
18
20
  for (const timeout of configuredTimeouts)if (!Number.isSafeInteger(timeout) || timeout < 0) throw new BackendFederationManifestAdapterError('manifest_invalid', '[BFF][Effect] Backend federation timeoutMs must be a non-negative safe integer.');
19
- const timeoutMs = options.timeoutMs ?? (policyTimeouts.length > 0 ? Math.min(...policyTimeouts) : 0);
21
+ const positivePolicyTimeouts = policyTimeouts.filter((timeout)=>timeout > 0);
22
+ const timeoutMs = options.timeoutMs ?? (0 === policyTimeouts.length ? DEFAULT_SHARED_MANIFEST_LOAD_TIMEOUT_MS : positivePolicyTimeouts.length > 0 ? Math.min(...positivePolicyTimeouts) : 0);
20
23
  const inputSignals = [
21
24
  options.signal,
22
25
  options.manifestPolicy?.signal,
@@ -70,6 +73,27 @@ function isCallerPinnedStaticRemote(options, remote) {
70
73
  function throwIfManifestLoadAborted(signal) {
71
74
  if (signal.aborted) throw new BackendFederationManifestAdapterError('remote_unavailable', '[BFF][Effect] Backend federation load was aborted before remote execution.', signal.reason);
72
75
  }
76
+ function settleOnSharedAbort(promise, signal) {
77
+ if (signal.aborted) {
78
+ promise.catch(()=>{});
79
+ throwIfManifestLoadAborted(signal);
80
+ }
81
+ let onAbort;
82
+ const aborted = new Promise((_resolve, reject)=>{
83
+ onAbort = ()=>{
84
+ reject(new BackendFederationManifestAdapterError('remote_unavailable', '[BFF][Effect] Backend federation load was aborted before remote execution.', signal.reason));
85
+ };
86
+ signal.addEventListener('abort', onAbort, {
87
+ once: true
88
+ });
89
+ });
90
+ return Promise.race([
91
+ promise,
92
+ aborted
93
+ ]).finally(()=>{
94
+ if (onAbort) signal.removeEventListener('abort', onAbort);
95
+ });
96
+ }
73
97
  async function loadBackendFederatedEffectApiFromManifest(options) {
74
98
  let manifest;
75
99
  let remote;
@@ -77,7 +101,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
77
101
  try {
78
102
  scope = createManifestLoadScope(options);
79
103
  throwIfManifestLoadAborted(scope.signal);
80
- manifest = await loadBackendFederationManifest({
104
+ manifest = await settleOnSharedAbort(loadBackendFederationManifest({
81
105
  ...options,
82
106
  manifestPolicy: {
83
107
  ...options.manifestPolicy,
@@ -86,7 +110,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
86
110
  },
87
111
  signal: scope.signal,
88
112
  timeoutMs: 0
89
- });
113
+ }), scope.signal);
90
114
  validateBackendFederationManifest(manifest, options.expected);
91
115
  remote = resolveBackendFederationRemoteFromManifest(manifest, options.remote);
92
116
  throwIfManifestLoadAborted(scope.signal);
@@ -96,12 +120,19 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
96
120
  if (remoteManifest && /^https?:\/\//iu.test(remote.entry) && !hasPinnedRemoteEntryExpectation(options)) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} from a network manifest requires caller-pinned entryUrl, remoteName, sha256, and byteLength values.`);
97
121
  if (/^https?:\/\//iu.test(remote.entry) && void 0 === remote.verification && options.entryPolicy?.expected === void 0) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} requires entry.sha256 and entry.byteLength before network execution.`);
98
122
  if (/^https?:\/\//iu.test(remote.entry) && void 0 !== options.runtime) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} cannot use a custom runtime for network entry execution.`);
99
- const loaded = await loadBackendFederatedEffectApi({
123
+ const deliveryUnit = manifestDeliveryUnit(backendFederationMetadata(manifest), versionBoundaryMetadata(manifest));
124
+ const unitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
125
+ const buildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
126
+ if (!unitId || !buildMarker) throw new BackendFederationManifestAdapterError('manifest_invalid', 'Backend federation manifest requires delivery-unit identity.');
127
+ const loaded = await settleOnSharedAbort(loadBackendFederatedEffectApi({
100
128
  hostName: options.hostName,
101
129
  remote,
102
130
  ...options.plugins ? {
103
131
  plugins: options.plugins
104
132
  } : {},
133
+ ...options.shared ? {
134
+ shared: options.shared
135
+ } : {},
105
136
  entryPolicy: {
106
137
  ...options.entryPolicy,
107
138
  signal: scope.signal,
@@ -110,16 +141,13 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
110
141
  ...options.runtime ? {
111
142
  runtime: options.runtime
112
143
  } : {},
113
- ...options.expected?.unitId && options.expected.buildMarker ? {
114
- expected: {
115
- unitId: options.expected.unitId,
116
- buildMarker: options.expected.buildMarker
117
- },
118
- allowMissingIdentityMetadata: true
119
- } : {}
144
+ expected: {
145
+ unitId,
146
+ buildMarker
147
+ }
120
148
  }).catch((error)=>{
121
149
  throw new BackendFederationManifestAdapterError(scope?.timedOut() === true ? 'timeout' : classifyLoadError(error), `[BFF][Effect] Backend federation remote ${remote?.name ?? 'unknown'} could not load ${remote?.expose ?? BACKEND_FEDERATION_EFFECT_EXPOSE}.`, error);
122
- });
150
+ }), scope.signal);
123
151
  validateLoadedBackendFederationContract(loaded, manifest, remote);
124
152
  return loaded;
125
153
  } catch (error) {
@@ -1,5 +1,5 @@
1
1
  import "node:module";
2
- import { backendFederationMetadata, backendFederationVersionBoundary } from "@modern-js/utils/universal";
2
+ import { backendFederationMetadata, backendFederationVersionBoundary } from "@modern-js/backend-federation-contracts";
3
3
  function stringValue(value) {
4
4
  return 'string' == typeof value && value.length > 0 ? value : void 0;
5
5
  }
@@ -1,9 +1,11 @@
1
1
  import "node:module";
2
2
  import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
3
+ import { withEffectBffHostShared } from "../backend-federation/node-shared.mjs";
3
4
  import { loadBackendFederatedEffectApiFromManifest } from "./load.mjs";
4
- function node_loadBackendFederatedEffectApiFromManifest(options) {
5
+ async function node_loadBackendFederatedEffectApiFromManifest(options) {
5
6
  return loadBackendFederatedEffectApiFromManifest({
6
7
  ...options,
8
+ shared: withEffectBffHostShared(options.shared),
7
9
  entryPolicy: {
8
10
  ...options.entryPolicy,
9
11
  evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateNodeBackendFederationCommonJs
@@ -1,6 +1,6 @@
1
1
  import "node:module";
2
+ import { backendFederationExposeNames } from "@modern-js/backend-federation-contracts";
2
3
  import { BackendFederationRemoteEntryError, resolveBackendFederationRemoteEntryVerification } from "@modern-js/server-runtime-extensions/backend-federation-security";
3
- import { backendFederationExposeNames } from "@modern-js/utils/universal";
4
4
  import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "../backend-federation/index.mjs";
5
5
  import { BackendFederationManifestAdapterError, assertManifestAdapter } from "./errors.mjs";
6
6
  import { backendFederationMetadata, recordField, resolveRemoteEntryFromMetadata, stringValue } from "./metadata.mjs";
@@ -32,13 +32,7 @@ function resolveBackendFederationRemoteFromManifest(manifest, remoteOverride = {
32
32
  ...verification ? {
33
33
  verification
34
34
  } : {},
35
- ...remoteOverride.entryGlobalName ? {
36
- entryGlobalName: remoteOverride.entryGlobalName
37
- } : {},
38
- expose,
39
- ...remoteOverride.shareScope ? {
40
- shareScope: remoteOverride.shareScope
41
- } : {}
35
+ expose
42
36
  };
43
37
  }
44
38
  export { resolveBackendFederationRemoteFromManifest };
@@ -1,8 +1,9 @@
1
1
  import "node:module";
2
- import { formatBackendFederationValidationErrors, validateBackendFederationManifest } from "@modern-js/utils/universal";
2
+ import { formatBackendFederationValidationErrors, validateBackendFederationManifest } from "@modern-js/backend-federation-contracts";
3
3
  import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "../backend-federation/index.mjs";
4
+ import { backendFederationCompatibility, formatBackendFederationIdentityIssues, validateBackendFederationCompatibility } from "../backend-federation/identity.mjs";
4
5
  import { BackendFederationManifestAdapterError, assertConsistentValue, assertManifestAdapter, assertVersionValue } from "./errors.mjs";
5
- import { backendFederationMetadata, manifestDeliveryUnit, recordField, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
6
+ import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
6
7
  function resolveExpectedBuildMarker(expected) {
7
8
  if (void 0 !== expected.buildVersion && void 0 !== expected.buildMarker && expected.buildVersion !== expected.buildMarker) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation expected buildVersion/buildMarker mismatch: buildVersion ${expected.buildVersion}, buildMarker ${expected.buildMarker}.`, void 0, {
8
9
  label: 'expected.buildVersion/buildMarker',
@@ -17,8 +18,7 @@ function validation_validateBackendFederationManifest(manifest, expected = {}) {
17
18
  assertManifestAdapter(backendFederation, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare backendFederation metadata.');
18
19
  const manifestShape = validateBackendFederationManifest(manifest, {
19
20
  expectedContractVersion: false,
20
- expectedNodeAdapterVersion: false,
21
- validateDeliveryUnit: false
21
+ expectedNodeAdapterVersion: false
22
22
  });
23
23
  assertManifestAdapter(manifestShape.ok, 'manifest_invalid', `[BFF][Effect] Backend federation manifest schema invalid: ${formatBackendFederationValidationErrors(manifestShape.errors)}.`);
24
24
  assertManifestAdapter('effect' === backendFederation.runtimeFramework, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare runtimeFramework: "effect".');
@@ -36,6 +36,7 @@ function validation_validateBackendFederationManifest(manifest, expected = {}) {
36
36
  assertConsistentValue(stringValue(deliveryUnit.boundary?.buildMarker), stringValue(boundary?.buildVersion), 'versionBoundary.deliveryUnit.buildMarker vs versionBoundary.buildVersion');
37
37
  assertConsistentValue(stringValue(deliveryUnit.top?.unitId), stringValue(deliveryUnit.boundary?.unitId), 'backendFederation.deliveryUnit.unitId vs versionBoundary.deliveryUnit.unitId');
38
38
  const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
39
+ assertManifestAdapter(manifestUnitId && stringValue(deliveryUnit.boundary?.buildMarker), 'manifest_invalid', 'Backend federation manifest requires delivery-unit unitId and buildMarker.');
39
40
  assertVersionValue(manifestUnitId, expected.unitId, 'deliveryUnit.unitId');
40
41
  assertVersionValue(stringValue(deliveryUnit.boundary?.buildMarker), expectedBuildMarker, 'deliveryUnit.buildMarker');
41
42
  }
@@ -43,19 +44,22 @@ function validateLoadedBackendFederationContract(loaded, manifest, remote) {
43
44
  const loadedContract = loaded.backendFederationContract;
44
45
  const backendFederation = backendFederationMetadata(manifest);
45
46
  const boundary = versionBoundaryMetadata(manifest);
46
- const compatibility = recordField(loadedContract, 'compatibility');
47
+ const compatibility = backendFederationCompatibility(loaded);
47
48
  assertManifestAdapter(compatibility, 'version_mismatch', `[BFF][Effect] Backend federation expose ${remote.name}/${remote.expose?.replace(/^\.\//u, '')} must declare compatibility metadata.`);
48
49
  assertVersionValue(stringValue(loadedContract?.role), 'microvertical-server', 'expose role');
49
50
  assertVersionValue(stringValue(loadedContract?.name), remote.name, 'expose name');
50
- assertVersionValue(stringValue(compatibility.contractVersion), stringValue(backendFederation?.contractVersion), 'expose contractVersion');
51
- assertVersionValue(stringValue(compatibility.nodeAdapterVersion), stringValue(backendFederation?.nodeAdapterVersion), 'expose nodeAdapterVersion');
52
- assertVersionValue(stringValue(compatibility.packageName), stringValue(boundary?.packageName), 'expose packageName');
53
- assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
54
51
  const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
55
52
  const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
56
53
  const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
57
- assertConsistentValue(manifestUnitId, stringValue(compatibility.unitId), 'deliveryUnit.unitId vs expose compatibility.unitId');
58
- assertConsistentValue(manifestBuildMarker, stringValue(compatibility.build), 'deliveryUnit.buildMarker vs expose compatibility.build');
54
+ const issues = validateBackendFederationCompatibility(compatibility, {
55
+ contractVersion: stringValue(backendFederation?.contractVersion),
56
+ nodeAdapterVersion: stringValue(backendFederation?.nodeAdapterVersion),
57
+ packageName: stringValue(boundary?.packageName),
58
+ unitId: manifestUnitId,
59
+ build: manifestBuildMarker ?? stringValue(boundary?.buildVersion)
60
+ });
61
+ assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
62
+ assertManifestAdapter(0 === issues.length, 'version_mismatch', `[BFF][Effect] ${formatBackendFederationIdentityIssues(issues)}.`);
59
63
  }
60
64
  function classifyLoadError(error) {
61
65
  const message = error instanceof Error ? error.message : String(error);
@@ -1,5 +1,5 @@
1
1
  import "node:module";
2
- import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/bff-core/security/cross-project-policy";
2
+ import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/server-runtime-extensions/bff-policy";
3
3
  const DENIAL_HEADERS = {
4
4
  'content-type': 'application/json; charset=utf-8'
5
5
  };
@@ -1,29 +1,20 @@
1
1
  import "node:module";
2
- import { readFileSync } from "node:fs";
3
- import node_path from "node:path";
4
- import { deriveOperationVersion, resolveCrossProjectPolicy } from "@modern-js/bff-core";
5
- const readNearestPackageVersion = (startDir)=>{
6
- if (!startDir) return;
7
- let current = node_path.resolve(startDir);
8
- for(let depth = 0; depth < 10; depth += 1){
9
- try {
10
- const packageJson = JSON.parse(readFileSync(node_path.join(current, 'package.json'), 'utf8'));
11
- if ('string' == typeof packageJson.version) return packageJson.version;
12
- } catch {}
13
- const parent = node_path.dirname(current);
14
- if (parent === current) break;
15
- current = parent;
16
- }
17
- };
18
- const resolveAdapterCrossProjectPolicy = (api, handlers)=>{
2
+ import "@modern-js/server-runtime-extensions/server-config";
3
+ import { resolveCrossProjectPolicy, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
4
+ const resolveAdapterCrossProjectPolicy = (api, handlers, producer)=>{
19
5
  const bff = api.getServerConfig()?.bff;
20
6
  const { apiDirectory, appDirectory } = api.getServerContext();
21
7
  return resolveCrossProjectPolicy({
22
8
  crossProjectPolicy: bff?.crossProjectPolicy,
23
9
  handlers,
24
- requestId: bff?.requestId,
25
10
  isCrossProjectServer: bff?.isCrossProjectServer,
26
- operationVersion: deriveOperationVersion(readNearestPackageVersion(apiDirectory) ?? readNearestPackageVersion(appDirectory))
11
+ ...producer ?? resolveOperationProducer({
12
+ directories: [
13
+ apiDirectory,
14
+ appDirectory
15
+ ],
16
+ requestId: bff?.requestId || 'default'
17
+ })
27
18
  });
28
19
  };
29
20
  export { resolveAdapterCrossProjectPolicy };
@@ -0,0 +1,21 @@
1
+ import "node:module";
2
+ function createProducerClient(configure, { requestId }) {
3
+ return (options)=>configure({
4
+ requestId,
5
+ requireEnvelope: true,
6
+ ...options,
7
+ identityBinding: {
8
+ enabled: true,
9
+ strict: true,
10
+ ...options?.identityBinding
11
+ },
12
+ operationContract: {
13
+ enabled: true,
14
+ strict: true,
15
+ requireSchemaHash: true,
16
+ requireOperationVersion: true,
17
+ ...options?.operationContract
18
+ }
19
+ });
20
+ }
21
+ export { createProducerClient };
@@ -3,7 +3,7 @@ import { collectEffectEndpoints, extractHttpApiFromModule, toOperationContractSo
3
3
  import { logger } from "@modern-js/utils";
4
4
  import { HttpApi } from "effect/unstable/httpapi";
5
5
  import { resolveAdapterCrossProjectPolicy } from "../cross-project-policy/index.mjs";
6
- function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod) {
6
+ function resolveEffectServerCrossProjectPolicy(api, prefix, mod, producer) {
7
7
  const contractSourcesPromise = null === mod ? Promise.resolve([]) : Promise.resolve().then(()=>extractHttpApiFromModule(mod, HttpApi.isHttpApi)).then((effectApi)=>{
8
8
  if (null === effectApi) return [];
9
9
  const reflect = (apiValue, handlers)=>{
@@ -19,9 +19,9 @@ function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod) {
19
19
  return [];
20
20
  });
21
21
  return contractSourcesPromise.then((contractSources)=>{
22
- const policy = resolveAdapterCrossProjectPolicy(api, contractSources);
22
+ const policy = resolveAdapterCrossProjectPolicy(api, contractSources, producer);
23
23
  if (policy?.enabled === true && 0 === contractSources.length) logger.warn('[BFF][Effect] Cross-project policy enabled but no HttpApi endpoints could be reflected; requests fail operation-contract matching unless allowUnknownOperations is enabled.');
24
24
  return policy;
25
25
  });
26
26
  }
27
- export { resolveEffectAdapterCrossProjectPolicy };
27
+ export { resolveEffectServerCrossProjectPolicy };
@@ -0,0 +1,16 @@
1
+ import "node:module";
2
+ import node_path from "node:path";
3
+ import "@modern-js/server-runtime-extensions/server-config";
4
+ import { API_DIR, isProd } from "@modern-js/utils";
5
+ import { resolveEffectEntry } from "../effect-source-loader/paths.mjs";
6
+ function resolveEffectServerEntryFile(api) {
7
+ const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
8
+ const appDir = node_path.resolve(appDirectory || process.cwd());
9
+ return resolveEffectEntry({
10
+ appDir,
11
+ apiDir: node_path.resolve(appDir, apiDirectory || API_DIR),
12
+ effectEntry: api.getServerConfig()?.bff?.effect?.entry,
13
+ distDir: isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0
14
+ }).path;
15
+ }
16
+ export { resolveEffectServerEntryFile };
@@ -1,7 +1,7 @@
1
1
  import "node:module";
2
2
  import { createSafeFailureResponse } from "@modern-js/runtime-extensions/safe-failure";
3
3
  import { logger } from "@modern-js/utils";
4
- function createEffectAdapterRuntimeErrorResponse(api, error, context) {
4
+ function createEffectServerRuntimeErrorResponse(api, error, context) {
5
5
  try {
6
6
  const onError = api.getServerConfig()?.onError;
7
7
  if (void 0 !== onError) return Promise.resolve(onError(error instanceof Error ? error : new Error(String(error)), ensureJsonContext(context))).then((result)=>result instanceof Response ? result : createSafeFailureResponse(error)).catch((configError)=>{
@@ -35,4 +35,4 @@ function ensureJsonContext(context) {
35
35
  }
36
36
  });
37
37
  }
38
- export { createEffectAdapterRuntimeErrorResponse };
38
+ export { createEffectServerRuntimeErrorResponse };