@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.9 → 3.9.3-ultramodern.10

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 (129) hide show
  1. package/README.md +21 -4
  2. package/dist/cjs/backend-federation/edge.js +1 -1
  3. package/dist/cjs/backend-federation/identity.js +23 -22
  4. package/dist/cjs/backend-federation/integrity-plugin.js +112 -0
  5. package/dist/cjs/backend-federation/node-shared.js +85 -0
  6. package/dist/cjs/backend-federation/node.js +6 -1
  7. package/dist/cjs/backend-federation/plugin.js +40 -21
  8. package/dist/cjs/backend-federation/runtime.js +16 -84
  9. package/dist/cjs/backend-federation-manifest/load.js +31 -5
  10. package/dist/cjs/backend-federation-manifest/node.js +3 -1
  11. package/dist/cjs/backend-federation-manifest/remote.js +1 -7
  12. package/dist/cjs/backend-federation-manifest/validation.js +11 -7
  13. package/dist/cjs/cross-project-policy/node.js +8 -28
  14. package/dist/cjs/{effect-adapter → effect-server}/cross-project-policy.js +9 -9
  15. package/dist/cjs/effect-server/entry.js +63 -0
  16. package/dist/cjs/{effect-adapter → effect-server}/error-response.js +4 -4
  17. package/dist/cjs/effect-server/index.js +200 -0
  18. package/dist/cjs/effect-source-loader/built-entry.js +4 -5
  19. package/dist/cjs/effect-source-loader/http-api-runtime.js +4 -4
  20. package/dist/cjs/effect-source-loader/loader.js +10 -2
  21. package/dist/cjs/effect-source-loader/operation-contracts.js +8 -31
  22. package/dist/cjs/effect-source-loader/paths.js +38 -10
  23. package/dist/cjs/server-global-vars/index.js +61 -0
  24. package/dist/esm/backend-federation/edge.mjs +1 -1
  25. package/dist/esm/backend-federation/identity.mjs +18 -23
  26. package/dist/esm/backend-federation/integrity-plugin.mjs +68 -0
  27. package/dist/esm/backend-federation/node-shared.mjs +41 -0
  28. package/dist/esm/backend-federation/node.mjs +4 -2
  29. package/dist/esm/backend-federation/plugin.mjs +37 -18
  30. package/dist/esm/backend-federation/runtime.mjs +16 -84
  31. package/dist/esm/backend-federation-manifest/load.mjs +31 -5
  32. package/dist/esm/backend-federation-manifest/node.mjs +3 -1
  33. package/dist/esm/backend-federation-manifest/remote.mjs +1 -7
  34. package/dist/esm/backend-federation-manifest/validation.mjs +12 -8
  35. package/dist/esm/cross-project-policy/node.mjs +9 -19
  36. package/dist/esm/{effect-adapter → effect-server}/cross-project-policy.mjs +4 -4
  37. package/dist/esm/effect-server/entry.mjs +15 -0
  38. package/dist/esm/{effect-adapter → effect-server}/error-response.mjs +2 -2
  39. package/dist/esm/effect-server/index.mjs +152 -0
  40. package/dist/esm/effect-source-loader/built-entry.mjs +5 -6
  41. package/dist/esm/effect-source-loader/http-api-runtime.mjs +1 -1
  42. package/dist/esm/effect-source-loader/loader.mjs +10 -2
  43. package/dist/esm/effect-source-loader/operation-contracts.mjs +10 -33
  44. package/dist/esm/effect-source-loader/paths.mjs +30 -11
  45. package/dist/esm/server-global-vars/index.mjs +23 -0
  46. package/dist/esm-node/backend-federation/edge.mjs +1 -1
  47. package/dist/esm-node/backend-federation/identity.mjs +18 -23
  48. package/dist/esm-node/backend-federation/integrity-plugin.mjs +69 -0
  49. package/dist/esm-node/backend-federation/node-shared.mjs +42 -0
  50. package/dist/esm-node/backend-federation/node.mjs +4 -2
  51. package/dist/esm-node/backend-federation/plugin.mjs +37 -18
  52. package/dist/esm-node/backend-federation/runtime.mjs +16 -84
  53. package/dist/esm-node/backend-federation-manifest/load.mjs +31 -5
  54. package/dist/esm-node/backend-federation-manifest/node.mjs +3 -1
  55. package/dist/esm-node/backend-federation-manifest/remote.mjs +1 -7
  56. package/dist/esm-node/backend-federation-manifest/validation.mjs +12 -8
  57. package/dist/esm-node/cross-project-policy/node.mjs +9 -19
  58. package/dist/esm-node/{effect-adapter → effect-server}/cross-project-policy.mjs +4 -4
  59. package/dist/esm-node/effect-server/entry.mjs +16 -0
  60. package/dist/esm-node/{effect-adapter → effect-server}/error-response.mjs +2 -2
  61. package/dist/esm-node/effect-server/index.mjs +153 -0
  62. package/dist/esm-node/effect-source-loader/built-entry.mjs +5 -6
  63. package/dist/esm-node/effect-source-loader/http-api-runtime.mjs +1 -1
  64. package/dist/esm-node/effect-source-loader/loader.mjs +10 -2
  65. package/dist/esm-node/effect-source-loader/operation-contracts.mjs +10 -33
  66. package/dist/esm-node/effect-source-loader/paths.mjs +30 -11
  67. package/dist/esm-node/server-global-vars/index.mjs +24 -0
  68. package/dist/types/backend-federation/edge.d.ts +4 -2
  69. package/dist/types/backend-federation/identity.d.ts +3 -6
  70. package/dist/types/backend-federation/integrity-plugin.d.ts +13 -0
  71. package/dist/types/backend-federation/node-shared.d.ts +20 -0
  72. package/dist/types/backend-federation/node.d.ts +3 -0
  73. package/dist/types/backend-federation/plugin.d.ts +4 -0
  74. package/dist/types/backend-federation/types.d.ts +2 -7
  75. package/dist/types/backend-federation-manifest/types.d.ts +2 -1
  76. package/dist/types/cross-project-policy/node.d.ts +2 -2
  77. package/dist/types/effect-server/cross-project-policy.d.ts +5 -0
  78. package/dist/types/{effect-adapter → effect-server}/entry.d.ts +1 -1
  79. package/dist/types/effect-server/error-response.d.ts +2 -0
  80. package/dist/types/effect-server/index.d.ts +4 -0
  81. package/dist/types/effect-source-loader/http-api-runtime.d.ts +2 -0
  82. package/dist/types/effect-source-loader/loader.d.ts +3 -0
  83. package/dist/types/effect-source-loader/operation-contracts.d.ts +2 -0
  84. package/dist/types/effect-source-loader/paths.d.ts +20 -2
  85. package/dist/types/hono/node.d.ts +1 -1
  86. package/dist/types/server-global-vars/index.d.ts +11 -0
  87. package/package.json +47 -33
  88. package/src/backend-federation/edge.ts +7 -4
  89. package/src/backend-federation/identity.ts +39 -47
  90. package/src/backend-federation/integrity-plugin.ts +157 -0
  91. package/src/backend-federation/load.ts +0 -1
  92. package/src/backend-federation/node-shared.ts +76 -0
  93. package/src/backend-federation/node.ts +7 -3
  94. package/src/backend-federation/plugin.ts +73 -25
  95. package/src/backend-federation/runtime.ts +16 -90
  96. package/src/backend-federation/types.ts +2 -11
  97. package/src/backend-federation-manifest/load.ts +76 -27
  98. package/src/backend-federation-manifest/node.ts +3 -2
  99. package/src/backend-federation-manifest/remote.ts +0 -6
  100. package/src/backend-federation-manifest/types.ts +2 -0
  101. package/src/backend-federation-manifest/validation.ts +22 -29
  102. package/src/cross-project-policy/node.ts +7 -38
  103. package/src/{effect-adapter → effect-server}/cross-project-policy.ts +9 -3
  104. package/src/effect-server/entry.ts +18 -0
  105. package/src/{effect-adapter → effect-server}/error-response.ts +1 -1
  106. package/src/effect-server/index.ts +243 -0
  107. package/src/effect-source-loader/built-entry.ts +11 -9
  108. package/src/effect-source-loader/http-api-runtime.ts +3 -1
  109. package/src/effect-source-loader/loader.ts +24 -6
  110. package/src/effect-source-loader/operation-contracts.ts +9 -41
  111. package/src/effect-source-loader/paths.ts +55 -21
  112. package/src/effect-source-loader/rspack-loader.ts +0 -1
  113. package/src/server-global-vars/index.ts +46 -0
  114. package/dist/cjs/backend-federation/entry.js +0 -94
  115. package/dist/cjs/effect-adapter/entry.js +0 -99
  116. package/dist/cjs/effect-adapter/index.js +0 -194
  117. package/dist/esm/backend-federation/entry.mjs +0 -56
  118. package/dist/esm/effect-adapter/entry.mjs +0 -51
  119. package/dist/esm/effect-adapter/index.mjs +0 -143
  120. package/dist/esm-node/backend-federation/entry.mjs +0 -57
  121. package/dist/esm-node/effect-adapter/entry.mjs +0 -52
  122. package/dist/esm-node/effect-adapter/index.mjs +0 -144
  123. package/dist/types/backend-federation/entry.d.ts +0 -2
  124. package/dist/types/effect-adapter/cross-project-policy.d.ts +0 -4
  125. package/dist/types/effect-adapter/error-response.d.ts +0 -2
  126. package/dist/types/effect-adapter/index.d.ts +0 -21
  127. package/src/backend-federation/entry.ts +0 -125
  128. package/src/effect-adapter/entry.ts +0 -96
  129. package/src/effect-adapter/index.ts +0 -251
@@ -1,194 +0,0 @@
1
- "use strict";
2
- var __webpack_require__ = {};
3
- (()=>{
4
- __webpack_require__.n = (module)=>{
5
- var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
6
- __webpack_require__.d(getter, {
7
- a: getter
8
- });
9
- return getter;
10
- };
11
- })();
12
- (()=>{
13
- __webpack_require__.d = (exports1, getters, values)=>{
14
- var define = (defs, kind)=>{
15
- for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
16
- enumerable: true,
17
- [kind]: defs[key]
18
- });
19
- };
20
- define(getters, "get");
21
- define(values, "value");
22
- };
23
- })();
24
- (()=>{
25
- __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
26
- })();
27
- (()=>{
28
- __webpack_require__.r = (exports1)=>{
29
- if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
30
- value: 'Module'
31
- });
32
- Object.defineProperty(exports1, '__esModule', {
33
- value: true
34
- });
35
- };
36
- })();
37
- var __webpack_exports__ = {};
38
- __webpack_require__.r(__webpack_exports__);
39
- __webpack_require__.d(__webpack_exports__, {
40
- EffectAdapter: ()=>EffectAdapter,
41
- createRuntimeAdapters: ()=>createRuntimeAdapters
42
- });
43
- const external_node_path_namespaceObject = require("node:path");
44
- var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
45
- require("@modern-js/server-runtime-extensions/server-config");
46
- const effect_namespaceObject = require("@modern-js/bff-effect/effect");
47
- const runtime_lifecycle_namespaceObject = require("@modern-js/server-runtime-extensions/runtime-lifecycle");
48
- const utils_namespaceObject = require("@modern-js/utils");
49
- const evaluation_js_namespaceObject = require("../cross-project-policy/evaluation.js");
50
- const loader_js_namespaceObject = require("../effect-source-loader/loader.js");
51
- const external_cross_project_policy_js_namespaceObject = require("./cross-project-policy.js");
52
- const external_entry_js_namespaceObject = require("./entry.js");
53
- const external_error_response_js_namespaceObject = require("./error-response.js");
54
- const EFFECT_MIDDLEWARE_BEFORE = [
55
- 'custom-server-hook',
56
- 'custom-server-middleware',
57
- 'render'
58
- ];
59
- class EffectAdapter {
60
- async loadHandler() {
61
- const entryFile = (0, external_entry_js_namespaceObject.resolveEffectAdapterEntryFile)(this.api);
62
- if (!entryFile || !await utils_namespaceObject.fs.pathExists(entryFile)) {
63
- this.handler = null;
64
- return;
65
- }
66
- let mod;
67
- try {
68
- const { appDirectory } = this.api.getServerContext();
69
- mod = await ((0, utils_namespaceObject.isProd)() ? (0, loader_js_namespaceObject.loadEffectBuiltModule)(entryFile) : (0, loader_js_namespaceObject.loadEffectSourceModule)({
70
- resourcePath: entryFile,
71
- appDir: appDirectory || external_node_path_default().dirname(entryFile)
72
- }));
73
- } catch (error) {
74
- utils_namespaceObject.logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
75
- throw error;
76
- }
77
- const crossProjectPolicies = new Map(await Promise.all(this.prefixes.map(async (prefix)=>[
78
- prefix,
79
- await (0, external_cross_project_policy_js_namespaceObject.resolveEffectAdapterCrossProjectPolicy)(this.api, prefix, mod)
80
- ])));
81
- const effectConfig = this.api.getServerConfig()?.bff?.effect;
82
- const loaded = await (0, effect_namespaceObject.resolveEffectBffModuleHandler)(mod, {
83
- openapi: effectConfig?.openapi,
84
- dataPlatform: effectConfig?.dataPlatform,
85
- validateRequest: (request)=>{
86
- const { path: mountedPathname } = (0, effect_namespaceObject.useEffectContext)();
87
- const prefix = this.matchingPrefixes.find((item)=>'/' === item || mountedPathname === item || mountedPathname.startsWith(`${item}/`));
88
- if (!prefix) return null;
89
- const requestUrl = new URL(request.url);
90
- if ('/' !== prefix) requestUrl.pathname = '/' === requestUrl.pathname ? prefix : `${prefix}${requestUrl.pathname}`;
91
- return (0, evaluation_js_namespaceObject.checkCrossProjectPolicyForRequest)(new Request(requestUrl, request), crossProjectPolicies.get(prefix));
92
- },
93
- onWarning: (message)=>utils_namespaceObject.logger.warn(message)
94
- });
95
- if (!loaded) {
96
- const error = new Error(`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`);
97
- utils_namespaceObject.logger.warn(error.message);
98
- throw error;
99
- }
100
- const candidateOwner = {};
101
- if (loaded.dispose) (0, runtime_lifecycle_namespaceObject.registerServerRuntimeDisposer)(candidateOwner, loaded.dispose);
102
- const candidate = (0, runtime_lifecycle_namespaceObject.createDisposableServerRuntimeHandle)(candidateOwner, loaded.handler);
103
- if (this.retired) {
104
- await candidate.dispose();
105
- throw new Error('Cannot initialize a retired Effect adapter.');
106
- }
107
- this.handler = candidate;
108
- }
109
- constructor(api){
110
- this.handler = null;
111
- this.prefix = '/api';
112
- this.prefixes = [
113
- '/api'
114
- ];
115
- this.matchingPrefixes = [
116
- '/api'
117
- ];
118
- this.retired = false;
119
- this.registerMiddleware = async (options)=>{
120
- const { enableHandleWeb } = options;
121
- const { bffRuntimeFramework, middlewares: globalMiddlewares } = this.api.getServerContext();
122
- if ('hono' === bffRuntimeFramework) return;
123
- const configuredPrefixes = Array.isArray(options.prefix) ? options.prefix.filter(Boolean) : [
124
- options.prefix || '/api'
125
- ];
126
- this.prefixes = [
127
- ...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : [
128
- '/api'
129
- ])
130
- ];
131
- this.matchingPrefixes = [
132
- ...this.prefixes
133
- ].sort((left, right)=>right.length - left.length);
134
- this.prefix = this.prefixes[0] || '/api';
135
- const { serverBase } = this.api.getServerContext();
136
- if (serverBase) this.unregisterRuntimeDisposer = (0, runtime_lifecycle_namespaceObject.registerServerRuntimeDisposer)(serverBase, this.dispose);
137
- try {
138
- await this.loadHandler();
139
- } catch (error) {
140
- await this.dispose();
141
- throw error;
142
- }
143
- const middlewarePrefixes = enableHandleWeb ? [
144
- this.prefix
145
- ] : this.matchingPrefixes;
146
- const middlewares = middlewarePrefixes.map((middlewarePrefix)=>({
147
- name: 'effect-api-handler',
148
- path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
149
- method: 'all',
150
- order: 'post',
151
- before: EFFECT_MIDDLEWARE_BEFORE,
152
- handler: async (context, next)=>{
153
- const handler = this.handler;
154
- if (!handler) {
155
- if (enableHandleWeb) return void await next();
156
- return (0, external_error_response_js_namespaceObject.createEffectAdapterRuntimeErrorResponse)(this.api, new Error('[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.'), context);
157
- }
158
- const prefix = enableHandleWeb ? this.matchingPrefixes.find((item)=>'/' === item || context.req.path === item || context.req.path.startsWith(`${item}/`)) || this.prefix : middlewarePrefix;
159
- const response = await (0, effect_namespaceObject.dispatchEffectBffRequest)(handler, context.req.raw, {
160
- prefix,
161
- env: context.env,
162
- path: context.req.path,
163
- method: context.req.method,
164
- onError: (error)=>(0, external_error_response_js_namespaceObject.createEffectAdapterRuntimeErrorResponse)(this.api, error, context)
165
- });
166
- if (404 === response.status && enableHandleWeb) return void await next();
167
- return new Response(response.body, response);
168
- }
169
- }));
170
- globalMiddlewares.push(...middlewares);
171
- };
172
- this.dispose = async ()=>{
173
- this.retired = true;
174
- this.unregisterRuntimeDisposer?.();
175
- this.unregisterRuntimeDisposer = void 0;
176
- const previous = this.handler;
177
- this.handler = null;
178
- await previous?.dispose();
179
- };
180
- this.api = api;
181
- }
182
- }
183
- const createRuntimeAdapters = (api)=>[
184
- new EffectAdapter(api)
185
- ];
186
- exports.EffectAdapter = __webpack_exports__.EffectAdapter;
187
- exports.createRuntimeAdapters = __webpack_exports__.createRuntimeAdapters;
188
- for(var __rspack_i in __webpack_exports__)if (-1 === [
189
- "EffectAdapter",
190
- "createRuntimeAdapters"
191
- ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
192
- Object.defineProperty(exports, '__esModule', {
193
- value: true
194
- });
@@ -1,56 +0,0 @@
1
- import { evaluateBackendFederationCommonJsEntry, loadVerifiedBackendFederationEntry } from "@modern-js/server-runtime-extensions/backend-federation-security";
2
- import { isRecord, normalizeExpose } from "./utils.mjs";
3
- function decodeDataUrl(url) {
4
- const commaIndex = url.indexOf(',');
5
- if (commaIndex < 0) throw new Error('[BFF][Effect] Invalid backend federation data URL entry.');
6
- return decodeURIComponent(url.slice(commaIndex + 1));
7
- }
8
- async function readCommonJsEntrySource(remote) {
9
- if (remote.entry.startsWith('data:')) return decodeDataUrl(remote.entry);
10
- throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} cannot load CommonJS entry ${remote.entry}.`);
11
- }
12
- async function importModuleEntry(remote) {
13
- const entry = await import(remote.entry);
14
- return entry.default ?? entry;
15
- }
16
- async function resolvePluginEntry(remote, plugins) {
17
- for (const plugin of plugins ?? []){
18
- const loadEntry = plugin.loadEntry;
19
- if ('function' != typeof loadEntry) continue;
20
- const entry = await loadEntry({
21
- remoteInfo: remote
22
- });
23
- if (entry) return entry;
24
- }
25
- }
26
- async function loadBackendFederationEntry(remote, options) {
27
- const requiresVerification = Boolean(remote.verification || options.entryPolicy?.expected);
28
- const isNetworkEntry = /^https?:\/\//iu.test(remote.entry);
29
- if (isNetworkEntry && !requiresVerification) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} requires verified entry bytes before network execution.`);
30
- if (requiresVerification) return loadVerifiedBackendFederationEntry({
31
- ...options.entryPolicy,
32
- remote,
33
- ...remote.verification ? {
34
- verification: remote.verification
35
- } : {}
36
- });
37
- const pluginEntry = await resolvePluginEntry(remote, options.plugins);
38
- if (pluginEntry) return pluginEntry;
39
- if (remote.entryGlobalName) {
40
- const globalEntry = globalThis[remote.entryGlobalName];
41
- if (isRecord(globalEntry)) return globalEntry;
42
- }
43
- if ('module' === remote.type || remote.entry.startsWith('file:')) return importModuleEntry(remote);
44
- return evaluateBackendFederationCommonJsEntry(remote, new TextEncoder().encode(await readCommonJsEntrySource(remote)), options.entryPolicy?.evaluateCommonJs);
45
- }
46
- async function loadBackendFederationExpose(remote, expose, options) {
47
- const entry = await loadBackendFederationEntry(remote, options);
48
- if ('function' == typeof entry.init) await entry.init({
49
- hostName: options.hostName
50
- });
51
- if ('function' != typeof entry.get) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} entry must expose get().`);
52
- const factory = await entry.get(expose);
53
- if ('function' != typeof factory) throw new Error(`[BFF][Effect] Backend federation expose ${remote.name}/${normalizeExpose(expose)} must load factory function.`);
54
- return factory();
55
- }
56
- export { loadBackendFederationExpose };
@@ -1,51 +0,0 @@
1
- import node_path from "node:path";
2
- import "@modern-js/server-runtime-extensions/server-config";
3
- import { API_DIR, findExists, fs, isProd } from "@modern-js/utils";
4
- const JS_OR_TS_EXTS = [
5
- '.js',
6
- '.jsx',
7
- '.ts',
8
- '.tsx',
9
- '.mjs',
10
- '.mts',
11
- '.cjs',
12
- '.cts'
13
- ];
14
- function resolveJsOrTsEntry(entryWithoutOrWithExt) {
15
- const extension = node_path.extname(entryWithoutOrWithExt);
16
- if (JS_OR_TS_EXTS.includes(extension)) return fs.existsSync(entryWithoutOrWithExt) ? entryWithoutOrWithExt : void 0;
17
- return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutOrWithExt}${ext}`)) || void 0;
18
- }
19
- function builtEntryPath(entryPath) {
20
- return entryPath.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
21
- }
22
- function relativeAppPath(appDirectory, entryPath) {
23
- const relativePath = node_path.relative(appDirectory, entryPath);
24
- return '..' === relativePath || relativePath.startsWith(`..${node_path.sep}`) ? void 0 : relativePath;
25
- }
26
- function isDependencyPath(relativePath) {
27
- return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
28
- }
29
- function resolveEffectAdapterEntryFile(api) {
30
- const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
31
- const appRoot = node_path.resolve(appDirectory || process.cwd());
32
- const productionRoot = isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0;
33
- const configuredEntry = api.getServerConfig()?.bff?.effect?.entry;
34
- if (configuredEntry) {
35
- const sourceEntry = node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appRoot, configuredEntry);
36
- if (productionRoot) {
37
- const relativeEntry = relativeAppPath(appRoot, sourceEntry);
38
- if (void 0 === relativeEntry || isDependencyPath(relativeEntry)) return resolveJsOrTsEntry(sourceEntry);
39
- return relativeEntry ? resolveJsOrTsEntry(builtEntryPath(node_path.resolve(productionRoot, relativeEntry))) : void 0;
40
- }
41
- return resolveJsOrTsEntry(sourceEntry);
42
- }
43
- const resolvedApiDirectory = node_path.resolve(appRoot, apiDirectory || API_DIR);
44
- const productionApiDirectory = productionRoot ? void 0 !== relativeAppPath(productionRoot, resolvedApiDirectory) ? resolvedApiDirectory : (()=>{
45
- const relativeApiDirectory = relativeAppPath(appRoot, resolvedApiDirectory);
46
- if (isDependencyPath(relativeApiDirectory)) return resolvedApiDirectory;
47
- return relativeApiDirectory ? node_path.resolve(productionRoot, relativeApiDirectory) : void 0;
48
- })() : resolvedApiDirectory;
49
- return productionApiDirectory ? resolveJsOrTsEntry(node_path.resolve(productionApiDirectory, 'index')) : void 0;
50
- }
51
- export { resolveEffectAdapterEntryFile };
@@ -1,143 +0,0 @@
1
- import node_path from "node:path";
2
- import "@modern-js/server-runtime-extensions/server-config";
3
- import { dispatchEffectBffRequest, resolveEffectBffModuleHandler, useEffectContext } from "@modern-js/bff-effect/effect";
4
- import { createDisposableServerRuntimeHandle, registerServerRuntimeDisposer } from "@modern-js/server-runtime-extensions/runtime-lifecycle";
5
- import { fs, isProd, logger } from "@modern-js/utils";
6
- import { checkCrossProjectPolicyForRequest } from "../cross-project-policy/evaluation.mjs";
7
- import { loadEffectBuiltModule, loadEffectSourceModule } from "../effect-source-loader/loader.mjs";
8
- import { resolveEffectAdapterCrossProjectPolicy } from "./cross-project-policy.mjs";
9
- import { resolveEffectAdapterEntryFile } from "./entry.mjs";
10
- import { createEffectAdapterRuntimeErrorResponse } from "./error-response.mjs";
11
- const EFFECT_MIDDLEWARE_BEFORE = [
12
- 'custom-server-hook',
13
- 'custom-server-middleware',
14
- 'render'
15
- ];
16
- class EffectAdapter {
17
- async loadHandler() {
18
- const entryFile = resolveEffectAdapterEntryFile(this.api);
19
- if (!entryFile || !await fs.pathExists(entryFile)) {
20
- this.handler = null;
21
- return;
22
- }
23
- let mod;
24
- try {
25
- const { appDirectory } = this.api.getServerContext();
26
- mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
27
- resourcePath: entryFile,
28
- appDir: appDirectory || node_path.dirname(entryFile)
29
- }));
30
- } catch (error) {
31
- logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
32
- throw error;
33
- }
34
- const crossProjectPolicies = new Map(await Promise.all(this.prefixes.map(async (prefix)=>[
35
- prefix,
36
- await resolveEffectAdapterCrossProjectPolicy(this.api, prefix, mod)
37
- ])));
38
- const effectConfig = this.api.getServerConfig()?.bff?.effect;
39
- const loaded = await resolveEffectBffModuleHandler(mod, {
40
- openapi: effectConfig?.openapi,
41
- dataPlatform: effectConfig?.dataPlatform,
42
- validateRequest: (request)=>{
43
- const { path: mountedPathname } = useEffectContext();
44
- const prefix = this.matchingPrefixes.find((item)=>'/' === item || mountedPathname === item || mountedPathname.startsWith(`${item}/`));
45
- if (!prefix) return null;
46
- const requestUrl = new URL(request.url);
47
- if ('/' !== prefix) requestUrl.pathname = '/' === requestUrl.pathname ? prefix : `${prefix}${requestUrl.pathname}`;
48
- return checkCrossProjectPolicyForRequest(new Request(requestUrl, request), crossProjectPolicies.get(prefix));
49
- },
50
- onWarning: (message)=>logger.warn(message)
51
- });
52
- if (!loaded) {
53
- const error = new Error(`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`);
54
- logger.warn(error.message);
55
- throw error;
56
- }
57
- const candidateOwner = {};
58
- if (loaded.dispose) registerServerRuntimeDisposer(candidateOwner, loaded.dispose);
59
- const candidate = createDisposableServerRuntimeHandle(candidateOwner, loaded.handler);
60
- if (this.retired) {
61
- await candidate.dispose();
62
- throw new Error('Cannot initialize a retired Effect adapter.');
63
- }
64
- this.handler = candidate;
65
- }
66
- constructor(api){
67
- this.handler = null;
68
- this.prefix = '/api';
69
- this.prefixes = [
70
- '/api'
71
- ];
72
- this.matchingPrefixes = [
73
- '/api'
74
- ];
75
- this.retired = false;
76
- this.registerMiddleware = async (options)=>{
77
- const { enableHandleWeb } = options;
78
- const { bffRuntimeFramework, middlewares: globalMiddlewares } = this.api.getServerContext();
79
- if ('hono' === bffRuntimeFramework) return;
80
- const configuredPrefixes = Array.isArray(options.prefix) ? options.prefix.filter(Boolean) : [
81
- options.prefix || '/api'
82
- ];
83
- this.prefixes = [
84
- ...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : [
85
- '/api'
86
- ])
87
- ];
88
- this.matchingPrefixes = [
89
- ...this.prefixes
90
- ].sort((left, right)=>right.length - left.length);
91
- this.prefix = this.prefixes[0] || '/api';
92
- const { serverBase } = this.api.getServerContext();
93
- if (serverBase) this.unregisterRuntimeDisposer = registerServerRuntimeDisposer(serverBase, this.dispose);
94
- try {
95
- await this.loadHandler();
96
- } catch (error) {
97
- await this.dispose();
98
- throw error;
99
- }
100
- const middlewarePrefixes = enableHandleWeb ? [
101
- this.prefix
102
- ] : this.matchingPrefixes;
103
- const middlewares = middlewarePrefixes.map((middlewarePrefix)=>({
104
- name: 'effect-api-handler',
105
- path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
106
- method: 'all',
107
- order: 'post',
108
- before: EFFECT_MIDDLEWARE_BEFORE,
109
- handler: async (context, next)=>{
110
- const handler = this.handler;
111
- if (!handler) {
112
- if (enableHandleWeb) return void await next();
113
- return createEffectAdapterRuntimeErrorResponse(this.api, new Error('[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.'), context);
114
- }
115
- const prefix = enableHandleWeb ? this.matchingPrefixes.find((item)=>'/' === item || context.req.path === item || context.req.path.startsWith(`${item}/`)) || this.prefix : middlewarePrefix;
116
- const response = await dispatchEffectBffRequest(handler, context.req.raw, {
117
- prefix,
118
- env: context.env,
119
- path: context.req.path,
120
- method: context.req.method,
121
- onError: (error)=>createEffectAdapterRuntimeErrorResponse(this.api, error, context)
122
- });
123
- if (404 === response.status && enableHandleWeb) return void await next();
124
- return new Response(response.body, response);
125
- }
126
- }));
127
- globalMiddlewares.push(...middlewares);
128
- };
129
- this.dispose = async ()=>{
130
- this.retired = true;
131
- this.unregisterRuntimeDisposer?.();
132
- this.unregisterRuntimeDisposer = void 0;
133
- const previous = this.handler;
134
- this.handler = null;
135
- await previous?.dispose();
136
- };
137
- this.api = api;
138
- }
139
- }
140
- const createRuntimeAdapters = (api)=>[
141
- new EffectAdapter(api)
142
- ];
143
- export { EffectAdapter, createRuntimeAdapters };
@@ -1,57 +0,0 @@
1
- import "node:module";
2
- import { evaluateBackendFederationCommonJsEntry, loadVerifiedBackendFederationEntry } from "@modern-js/server-runtime-extensions/backend-federation-security";
3
- import { isRecord, normalizeExpose } from "./utils.mjs";
4
- function decodeDataUrl(url) {
5
- const commaIndex = url.indexOf(',');
6
- if (commaIndex < 0) throw new Error('[BFF][Effect] Invalid backend federation data URL entry.');
7
- return decodeURIComponent(url.slice(commaIndex + 1));
8
- }
9
- async function readCommonJsEntrySource(remote) {
10
- if (remote.entry.startsWith('data:')) return decodeDataUrl(remote.entry);
11
- throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} cannot load CommonJS entry ${remote.entry}.`);
12
- }
13
- async function importModuleEntry(remote) {
14
- const entry = await import(remote.entry);
15
- return entry.default ?? entry;
16
- }
17
- async function resolvePluginEntry(remote, plugins) {
18
- for (const plugin of plugins ?? []){
19
- const loadEntry = plugin.loadEntry;
20
- if ('function' != typeof loadEntry) continue;
21
- const entry = await loadEntry({
22
- remoteInfo: remote
23
- });
24
- if (entry) return entry;
25
- }
26
- }
27
- async function loadBackendFederationEntry(remote, options) {
28
- const requiresVerification = Boolean(remote.verification || options.entryPolicy?.expected);
29
- const isNetworkEntry = /^https?:\/\//iu.test(remote.entry);
30
- if (isNetworkEntry && !requiresVerification) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} requires verified entry bytes before network execution.`);
31
- if (requiresVerification) return loadVerifiedBackendFederationEntry({
32
- ...options.entryPolicy,
33
- remote,
34
- ...remote.verification ? {
35
- verification: remote.verification
36
- } : {}
37
- });
38
- const pluginEntry = await resolvePluginEntry(remote, options.plugins);
39
- if (pluginEntry) return pluginEntry;
40
- if (remote.entryGlobalName) {
41
- const globalEntry = globalThis[remote.entryGlobalName];
42
- if (isRecord(globalEntry)) return globalEntry;
43
- }
44
- if ('module' === remote.type || remote.entry.startsWith('file:')) return importModuleEntry(remote);
45
- return evaluateBackendFederationCommonJsEntry(remote, new TextEncoder().encode(await readCommonJsEntrySource(remote)), options.entryPolicy?.evaluateCommonJs);
46
- }
47
- async function loadBackendFederationExpose(remote, expose, options) {
48
- const entry = await loadBackendFederationEntry(remote, options);
49
- if ('function' == typeof entry.init) await entry.init({
50
- hostName: options.hostName
51
- });
52
- if ('function' != typeof entry.get) throw new Error(`[BFF][Effect] Backend federation remote ${remote.name} entry must expose get().`);
53
- const factory = await entry.get(expose);
54
- if ('function' != typeof factory) throw new Error(`[BFF][Effect] Backend federation expose ${remote.name}/${normalizeExpose(expose)} must load factory function.`);
55
- return factory();
56
- }
57
- export { loadBackendFederationExpose };
@@ -1,52 +0,0 @@
1
- import "node:module";
2
- import node_path from "node:path";
3
- import "@modern-js/server-runtime-extensions/server-config";
4
- import { API_DIR, findExists, fs, isProd } from "@modern-js/utils";
5
- const JS_OR_TS_EXTS = [
6
- '.js',
7
- '.jsx',
8
- '.ts',
9
- '.tsx',
10
- '.mjs',
11
- '.mts',
12
- '.cjs',
13
- '.cts'
14
- ];
15
- function resolveJsOrTsEntry(entryWithoutOrWithExt) {
16
- const extension = node_path.extname(entryWithoutOrWithExt);
17
- if (JS_OR_TS_EXTS.includes(extension)) return fs.existsSync(entryWithoutOrWithExt) ? entryWithoutOrWithExt : void 0;
18
- return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutOrWithExt}${ext}`)) || void 0;
19
- }
20
- function builtEntryPath(entryPath) {
21
- return entryPath.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
22
- }
23
- function relativeAppPath(appDirectory, entryPath) {
24
- const relativePath = node_path.relative(appDirectory, entryPath);
25
- return '..' === relativePath || relativePath.startsWith(`..${node_path.sep}`) ? void 0 : relativePath;
26
- }
27
- function isDependencyPath(relativePath) {
28
- return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
29
- }
30
- function resolveEffectAdapterEntryFile(api) {
31
- const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
32
- const appRoot = node_path.resolve(appDirectory || process.cwd());
33
- const productionRoot = isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0;
34
- const configuredEntry = api.getServerConfig()?.bff?.effect?.entry;
35
- if (configuredEntry) {
36
- const sourceEntry = node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appRoot, configuredEntry);
37
- if (productionRoot) {
38
- const relativeEntry = relativeAppPath(appRoot, sourceEntry);
39
- if (void 0 === relativeEntry || isDependencyPath(relativeEntry)) return resolveJsOrTsEntry(sourceEntry);
40
- return relativeEntry ? resolveJsOrTsEntry(builtEntryPath(node_path.resolve(productionRoot, relativeEntry))) : void 0;
41
- }
42
- return resolveJsOrTsEntry(sourceEntry);
43
- }
44
- const resolvedApiDirectory = node_path.resolve(appRoot, apiDirectory || API_DIR);
45
- const productionApiDirectory = productionRoot ? void 0 !== relativeAppPath(productionRoot, resolvedApiDirectory) ? resolvedApiDirectory : (()=>{
46
- const relativeApiDirectory = relativeAppPath(appRoot, resolvedApiDirectory);
47
- if (isDependencyPath(relativeApiDirectory)) return resolvedApiDirectory;
48
- return relativeApiDirectory ? node_path.resolve(productionRoot, relativeApiDirectory) : void 0;
49
- })() : resolvedApiDirectory;
50
- return productionApiDirectory ? resolveJsOrTsEntry(node_path.resolve(productionApiDirectory, 'index')) : void 0;
51
- }
52
- export { resolveEffectAdapterEntryFile };