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

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 (77) hide show
  1. package/README.md +3 -3
  2. package/dist/cjs/backend-federation/identity.js +23 -22
  3. package/dist/cjs/backend-federation/node-evaluator.js +48 -0
  4. package/dist/cjs/backend-federation/node.js +2 -2
  5. package/dist/cjs/backend-federation-manifest/node.js +2 -2
  6. package/dist/cjs/backend-federation-manifest/validation.js +11 -7
  7. package/dist/cjs/cross-project-policy/node.js +8 -28
  8. package/dist/cjs/{effect-adapter → effect-server}/cross-project-policy.js +5 -5
  9. package/dist/cjs/effect-server/entry.js +63 -0
  10. package/dist/cjs/{effect-adapter → effect-server}/error-response.js +4 -4
  11. package/dist/cjs/effect-server/index.js +199 -0
  12. package/dist/cjs/effect-source-loader/built-entry.js +4 -5
  13. package/dist/cjs/effect-source-loader/loader.js +2 -1
  14. package/dist/cjs/effect-source-loader/operation-contracts.js +8 -31
  15. package/dist/cjs/effect-source-loader/paths.js +38 -10
  16. package/dist/esm/backend-federation/identity.mjs +18 -23
  17. package/dist/esm/backend-federation/node-evaluator.mjs +7 -0
  18. package/dist/esm/backend-federation/node.mjs +2 -2
  19. package/dist/esm/backend-federation-manifest/node.mjs +2 -2
  20. package/dist/esm/backend-federation-manifest/validation.mjs +12 -8
  21. package/dist/esm/cross-project-policy/node.mjs +9 -19
  22. package/dist/esm/{effect-adapter → effect-server}/cross-project-policy.mjs +3 -3
  23. package/dist/esm/effect-server/entry.mjs +15 -0
  24. package/dist/esm/{effect-adapter → effect-server}/error-response.mjs +2 -2
  25. package/dist/esm/effect-server/index.mjs +151 -0
  26. package/dist/esm/effect-source-loader/built-entry.mjs +5 -6
  27. package/dist/esm/effect-source-loader/loader.mjs +2 -1
  28. package/dist/esm/effect-source-loader/operation-contracts.mjs +10 -33
  29. package/dist/esm/effect-source-loader/paths.mjs +30 -11
  30. package/dist/esm-node/backend-federation/identity.mjs +18 -23
  31. package/dist/esm-node/backend-federation/node-evaluator.mjs +8 -0
  32. package/dist/esm-node/backend-federation/node.mjs +2 -2
  33. package/dist/esm-node/backend-federation-manifest/node.mjs +2 -2
  34. package/dist/esm-node/backend-federation-manifest/validation.mjs +12 -8
  35. package/dist/esm-node/cross-project-policy/node.mjs +9 -19
  36. package/dist/esm-node/{effect-adapter → effect-server}/cross-project-policy.mjs +3 -3
  37. package/dist/esm-node/effect-server/entry.mjs +16 -0
  38. package/dist/esm-node/{effect-adapter → effect-server}/error-response.mjs +2 -2
  39. package/dist/esm-node/effect-server/index.mjs +152 -0
  40. package/dist/esm-node/effect-source-loader/built-entry.mjs +5 -6
  41. package/dist/esm-node/effect-source-loader/loader.mjs +2 -1
  42. package/dist/esm-node/effect-source-loader/operation-contracts.mjs +10 -33
  43. package/dist/esm-node/effect-source-loader/paths.mjs +30 -11
  44. package/dist/types/backend-federation/identity.d.ts +3 -6
  45. package/dist/types/backend-federation/node-evaluator.d.ts +2 -0
  46. package/dist/types/cross-project-policy/node.d.ts +2 -2
  47. package/dist/types/effect-server/cross-project-policy.d.ts +5 -0
  48. package/dist/types/{effect-adapter → effect-server}/entry.d.ts +1 -1
  49. package/dist/types/effect-server/error-response.d.ts +2 -0
  50. package/dist/types/effect-server/index.d.ts +4 -0
  51. package/dist/types/effect-source-loader/paths.d.ts +20 -2
  52. package/package.json +27 -27
  53. package/src/backend-federation/identity.ts +39 -47
  54. package/src/backend-federation/node-evaluator.ts +13 -0
  55. package/src/backend-federation/node.ts +2 -3
  56. package/src/backend-federation-manifest/node.ts +2 -3
  57. package/src/backend-federation-manifest/validation.ts +22 -29
  58. package/src/cross-project-policy/node.ts +7 -38
  59. package/src/{effect-adapter → effect-server}/cross-project-policy.ts +8 -2
  60. package/src/effect-server/entry.ts +18 -0
  61. package/src/{effect-adapter → effect-server}/error-response.ts +1 -1
  62. package/src/effect-server/index.ts +242 -0
  63. package/src/effect-source-loader/built-entry.ts +11 -9
  64. package/src/effect-source-loader/loader.ts +10 -5
  65. package/src/effect-source-loader/operation-contracts.ts +7 -41
  66. package/src/effect-source-loader/paths.ts +55 -21
  67. package/dist/cjs/effect-adapter/entry.js +0 -99
  68. package/dist/cjs/effect-adapter/index.js +0 -194
  69. package/dist/esm/effect-adapter/entry.mjs +0 -51
  70. package/dist/esm/effect-adapter/index.mjs +0 -143
  71. package/dist/esm-node/effect-adapter/entry.mjs +0 -52
  72. package/dist/esm-node/effect-adapter/index.mjs +0 -144
  73. package/dist/types/effect-adapter/cross-project-policy.d.ts +0 -4
  74. package/dist/types/effect-adapter/error-response.d.ts +0 -2
  75. package/dist/types/effect-adapter/index.d.ts +0 -21
  76. package/src/effect-adapter/entry.ts +0 -96
  77. 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,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,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 };
@@ -1,144 +0,0 @@
1
- import "node:module";
2
- import node_path from "node:path";
3
- import "@modern-js/server-runtime-extensions/server-config";
4
- import { dispatchEffectBffRequest, resolveEffectBffModuleHandler, useEffectContext } from "@modern-js/bff-effect/effect";
5
- import { createDisposableServerRuntimeHandle, registerServerRuntimeDisposer } from "@modern-js/server-runtime-extensions/runtime-lifecycle";
6
- import { fs, isProd, logger } from "@modern-js/utils";
7
- import { checkCrossProjectPolicyForRequest } from "../cross-project-policy/evaluation.mjs";
8
- import { loadEffectBuiltModule, loadEffectSourceModule } from "../effect-source-loader/loader.mjs";
9
- import { resolveEffectAdapterCrossProjectPolicy } from "./cross-project-policy.mjs";
10
- import { resolveEffectAdapterEntryFile } from "./entry.mjs";
11
- import { createEffectAdapterRuntimeErrorResponse } from "./error-response.mjs";
12
- const EFFECT_MIDDLEWARE_BEFORE = [
13
- 'custom-server-hook',
14
- 'custom-server-middleware',
15
- 'render'
16
- ];
17
- class EffectAdapter {
18
- async loadHandler() {
19
- const entryFile = resolveEffectAdapterEntryFile(this.api);
20
- if (!entryFile || !await fs.pathExists(entryFile)) {
21
- this.handler = null;
22
- return;
23
- }
24
- let mod;
25
- try {
26
- const { appDirectory } = this.api.getServerContext();
27
- mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
28
- resourcePath: entryFile,
29
- appDir: appDirectory || node_path.dirname(entryFile)
30
- }));
31
- } catch (error) {
32
- logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
33
- throw error;
34
- }
35
- const crossProjectPolicies = new Map(await Promise.all(this.prefixes.map(async (prefix)=>[
36
- prefix,
37
- await resolveEffectAdapterCrossProjectPolicy(this.api, prefix, mod)
38
- ])));
39
- const effectConfig = this.api.getServerConfig()?.bff?.effect;
40
- const loaded = await resolveEffectBffModuleHandler(mod, {
41
- openapi: effectConfig?.openapi,
42
- dataPlatform: effectConfig?.dataPlatform,
43
- validateRequest: (request)=>{
44
- const { path: mountedPathname } = useEffectContext();
45
- const prefix = this.matchingPrefixes.find((item)=>'/' === item || mountedPathname === item || mountedPathname.startsWith(`${item}/`));
46
- if (!prefix) return null;
47
- const requestUrl = new URL(request.url);
48
- if ('/' !== prefix) requestUrl.pathname = '/' === requestUrl.pathname ? prefix : `${prefix}${requestUrl.pathname}`;
49
- return checkCrossProjectPolicyForRequest(new Request(requestUrl, request), crossProjectPolicies.get(prefix));
50
- },
51
- onWarning: (message)=>logger.warn(message)
52
- });
53
- if (!loaded) {
54
- const error = new Error(`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`);
55
- logger.warn(error.message);
56
- throw error;
57
- }
58
- const candidateOwner = {};
59
- if (loaded.dispose) registerServerRuntimeDisposer(candidateOwner, loaded.dispose);
60
- const candidate = createDisposableServerRuntimeHandle(candidateOwner, loaded.handler);
61
- if (this.retired) {
62
- await candidate.dispose();
63
- throw new Error('Cannot initialize a retired Effect adapter.');
64
- }
65
- this.handler = candidate;
66
- }
67
- constructor(api){
68
- this.handler = null;
69
- this.prefix = '/api';
70
- this.prefixes = [
71
- '/api'
72
- ];
73
- this.matchingPrefixes = [
74
- '/api'
75
- ];
76
- this.retired = false;
77
- this.registerMiddleware = async (options)=>{
78
- const { enableHandleWeb } = options;
79
- const { bffRuntimeFramework, middlewares: globalMiddlewares } = this.api.getServerContext();
80
- if ('hono' === bffRuntimeFramework) return;
81
- const configuredPrefixes = Array.isArray(options.prefix) ? options.prefix.filter(Boolean) : [
82
- options.prefix || '/api'
83
- ];
84
- this.prefixes = [
85
- ...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : [
86
- '/api'
87
- ])
88
- ];
89
- this.matchingPrefixes = [
90
- ...this.prefixes
91
- ].sort((left, right)=>right.length - left.length);
92
- this.prefix = this.prefixes[0] || '/api';
93
- const { serverBase } = this.api.getServerContext();
94
- if (serverBase) this.unregisterRuntimeDisposer = registerServerRuntimeDisposer(serverBase, this.dispose);
95
- try {
96
- await this.loadHandler();
97
- } catch (error) {
98
- await this.dispose();
99
- throw error;
100
- }
101
- const middlewarePrefixes = enableHandleWeb ? [
102
- this.prefix
103
- ] : this.matchingPrefixes;
104
- const middlewares = middlewarePrefixes.map((middlewarePrefix)=>({
105
- name: 'effect-api-handler',
106
- path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
107
- method: 'all',
108
- order: 'post',
109
- before: EFFECT_MIDDLEWARE_BEFORE,
110
- handler: async (context, next)=>{
111
- const handler = this.handler;
112
- if (!handler) {
113
- if (enableHandleWeb) return void await next();
114
- return createEffectAdapterRuntimeErrorResponse(this.api, new Error('[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.'), context);
115
- }
116
- const prefix = enableHandleWeb ? this.matchingPrefixes.find((item)=>'/' === item || context.req.path === item || context.req.path.startsWith(`${item}/`)) || this.prefix : middlewarePrefix;
117
- const response = await dispatchEffectBffRequest(handler, context.req.raw, {
118
- prefix,
119
- env: context.env,
120
- path: context.req.path,
121
- method: context.req.method,
122
- onError: (error)=>createEffectAdapterRuntimeErrorResponse(this.api, error, context)
123
- });
124
- if (404 === response.status && enableHandleWeb) return void await next();
125
- return new Response(response.body, response);
126
- }
127
- }));
128
- globalMiddlewares.push(...middlewares);
129
- };
130
- this.dispose = async ()=>{
131
- this.retired = true;
132
- this.unregisterRuntimeDisposer?.();
133
- this.unregisterRuntimeDisposer = void 0;
134
- const previous = this.handler;
135
- this.handler = null;
136
- await previous?.dispose();
137
- };
138
- this.api = api;
139
- }
140
- }
141
- const createRuntimeAdapters = (api)=>[
142
- new EffectAdapter(api)
143
- ];
144
- export { EffectAdapter, createRuntimeAdapters };
@@ -1,4 +0,0 @@
1
- import { type EffectApiModule } from '@modern-js/bff-effect/effect';
2
- import type { ServerPluginAPI } from '@modern-js/server-core';
3
- import type { ResolvedCrossProjectPolicy } from '../cross-project-policy/evaluation.js';
4
- export declare function resolveEffectAdapterCrossProjectPolicy(api: ServerPluginAPI, prefix: string, mod: EffectApiModule | null): Promise<ResolvedCrossProjectPolicy | undefined>;
@@ -1,2 +0,0 @@
1
- import type { Context, ServerPluginAPI } from '@modern-js/server-core';
2
- export declare function createEffectAdapterRuntimeErrorResponse(api: ServerPluginAPI, error: unknown, context: Context): Promise<Response>;
@@ -1,21 +0,0 @@
1
- import '@modern-js/server-runtime-extensions/server-config';
2
- import type { ServerPluginAPI } from '@modern-js/server-core';
3
- interface EffectAdapterMiddlewareOptions {
4
- prefix: string | readonly string[];
5
- enableHandleWeb?: boolean;
6
- }
7
- export declare class EffectAdapter {
8
- private api;
9
- private handler;
10
- private unregisterRuntimeDisposer?;
11
- private prefix;
12
- private prefixes;
13
- private matchingPrefixes;
14
- private retired;
15
- constructor(api: ServerPluginAPI);
16
- registerMiddleware: (options: EffectAdapterMiddlewareOptions) => Promise<void>;
17
- dispose: () => Promise<void>;
18
- private loadHandler;
19
- }
20
- export declare const createRuntimeAdapters: (api: ServerPluginAPI) => EffectAdapter[];
21
- export {};