@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.
- package/README.md +21 -4
- package/dist/cjs/backend-federation/edge.js +1 -1
- package/dist/cjs/backend-federation/identity.js +23 -22
- package/dist/cjs/backend-federation/integrity-plugin.js +112 -0
- package/dist/cjs/backend-federation/node-shared.js +85 -0
- package/dist/cjs/backend-federation/node.js +6 -1
- package/dist/cjs/backend-federation/plugin.js +40 -21
- package/dist/cjs/backend-federation/runtime.js +16 -84
- package/dist/cjs/backend-federation-manifest/load.js +31 -5
- package/dist/cjs/backend-federation-manifest/node.js +3 -1
- package/dist/cjs/backend-federation-manifest/remote.js +1 -7
- package/dist/cjs/backend-federation-manifest/validation.js +11 -7
- package/dist/cjs/cross-project-policy/node.js +8 -28
- package/dist/cjs/{effect-adapter → effect-server}/cross-project-policy.js +9 -9
- package/dist/cjs/effect-server/entry.js +63 -0
- package/dist/cjs/{effect-adapter → effect-server}/error-response.js +4 -4
- package/dist/cjs/effect-server/index.js +200 -0
- package/dist/cjs/effect-source-loader/built-entry.js +4 -5
- package/dist/cjs/effect-source-loader/http-api-runtime.js +4 -4
- package/dist/cjs/effect-source-loader/loader.js +10 -2
- package/dist/cjs/effect-source-loader/operation-contracts.js +8 -31
- package/dist/cjs/effect-source-loader/paths.js +38 -10
- package/dist/cjs/server-global-vars/index.js +61 -0
- package/dist/esm/backend-federation/edge.mjs +1 -1
- package/dist/esm/backend-federation/identity.mjs +18 -23
- package/dist/esm/backend-federation/integrity-plugin.mjs +68 -0
- package/dist/esm/backend-federation/node-shared.mjs +41 -0
- package/dist/esm/backend-federation/node.mjs +4 -2
- package/dist/esm/backend-federation/plugin.mjs +37 -18
- package/dist/esm/backend-federation/runtime.mjs +16 -84
- package/dist/esm/backend-federation-manifest/load.mjs +31 -5
- package/dist/esm/backend-federation-manifest/node.mjs +3 -1
- package/dist/esm/backend-federation-manifest/remote.mjs +1 -7
- package/dist/esm/backend-federation-manifest/validation.mjs +12 -8
- package/dist/esm/cross-project-policy/node.mjs +9 -19
- package/dist/esm/{effect-adapter → effect-server}/cross-project-policy.mjs +4 -4
- package/dist/esm/effect-server/entry.mjs +15 -0
- package/dist/esm/{effect-adapter → effect-server}/error-response.mjs +2 -2
- package/dist/esm/effect-server/index.mjs +152 -0
- package/dist/esm/effect-source-loader/built-entry.mjs +5 -6
- package/dist/esm/effect-source-loader/http-api-runtime.mjs +1 -1
- package/dist/esm/effect-source-loader/loader.mjs +10 -2
- package/dist/esm/effect-source-loader/operation-contracts.mjs +10 -33
- package/dist/esm/effect-source-loader/paths.mjs +30 -11
- package/dist/esm/server-global-vars/index.mjs +23 -0
- package/dist/esm-node/backend-federation/edge.mjs +1 -1
- package/dist/esm-node/backend-federation/identity.mjs +18 -23
- package/dist/esm-node/backend-federation/integrity-plugin.mjs +69 -0
- package/dist/esm-node/backend-federation/node-shared.mjs +42 -0
- package/dist/esm-node/backend-federation/node.mjs +4 -2
- package/dist/esm-node/backend-federation/plugin.mjs +37 -18
- package/dist/esm-node/backend-federation/runtime.mjs +16 -84
- package/dist/esm-node/backend-federation-manifest/load.mjs +31 -5
- package/dist/esm-node/backend-federation-manifest/node.mjs +3 -1
- package/dist/esm-node/backend-federation-manifest/remote.mjs +1 -7
- package/dist/esm-node/backend-federation-manifest/validation.mjs +12 -8
- package/dist/esm-node/cross-project-policy/node.mjs +9 -19
- package/dist/esm-node/{effect-adapter → effect-server}/cross-project-policy.mjs +4 -4
- package/dist/esm-node/effect-server/entry.mjs +16 -0
- package/dist/esm-node/{effect-adapter → effect-server}/error-response.mjs +2 -2
- package/dist/esm-node/effect-server/index.mjs +153 -0
- package/dist/esm-node/effect-source-loader/built-entry.mjs +5 -6
- package/dist/esm-node/effect-source-loader/http-api-runtime.mjs +1 -1
- package/dist/esm-node/effect-source-loader/loader.mjs +10 -2
- package/dist/esm-node/effect-source-loader/operation-contracts.mjs +10 -33
- package/dist/esm-node/effect-source-loader/paths.mjs +30 -11
- package/dist/esm-node/server-global-vars/index.mjs +24 -0
- package/dist/types/backend-federation/edge.d.ts +4 -2
- package/dist/types/backend-federation/identity.d.ts +3 -6
- package/dist/types/backend-federation/integrity-plugin.d.ts +13 -0
- package/dist/types/backend-federation/node-shared.d.ts +20 -0
- package/dist/types/backend-federation/node.d.ts +3 -0
- package/dist/types/backend-federation/plugin.d.ts +4 -0
- package/dist/types/backend-federation/types.d.ts +2 -7
- package/dist/types/backend-federation-manifest/types.d.ts +2 -1
- package/dist/types/cross-project-policy/node.d.ts +2 -2
- package/dist/types/effect-server/cross-project-policy.d.ts +5 -0
- package/dist/types/{effect-adapter → effect-server}/entry.d.ts +1 -1
- package/dist/types/effect-server/error-response.d.ts +2 -0
- package/dist/types/effect-server/index.d.ts +4 -0
- package/dist/types/effect-source-loader/http-api-runtime.d.ts +2 -0
- package/dist/types/effect-source-loader/loader.d.ts +3 -0
- package/dist/types/effect-source-loader/operation-contracts.d.ts +2 -0
- package/dist/types/effect-source-loader/paths.d.ts +20 -2
- package/dist/types/hono/node.d.ts +1 -1
- package/dist/types/server-global-vars/index.d.ts +11 -0
- package/package.json +47 -33
- package/src/backend-federation/edge.ts +7 -4
- package/src/backend-federation/identity.ts +39 -47
- package/src/backend-federation/integrity-plugin.ts +157 -0
- package/src/backend-federation/load.ts +0 -1
- package/src/backend-federation/node-shared.ts +76 -0
- package/src/backend-federation/node.ts +7 -3
- package/src/backend-federation/plugin.ts +73 -25
- package/src/backend-federation/runtime.ts +16 -90
- package/src/backend-federation/types.ts +2 -11
- package/src/backend-federation-manifest/load.ts +76 -27
- package/src/backend-federation-manifest/node.ts +3 -2
- package/src/backend-federation-manifest/remote.ts +0 -6
- package/src/backend-federation-manifest/types.ts +2 -0
- package/src/backend-federation-manifest/validation.ts +22 -29
- package/src/cross-project-policy/node.ts +7 -38
- package/src/{effect-adapter → effect-server}/cross-project-policy.ts +9 -3
- package/src/effect-server/entry.ts +18 -0
- package/src/{effect-adapter → effect-server}/error-response.ts +1 -1
- package/src/effect-server/index.ts +243 -0
- package/src/effect-source-loader/built-entry.ts +11 -9
- package/src/effect-source-loader/http-api-runtime.ts +3 -1
- package/src/effect-source-loader/loader.ts +24 -6
- package/src/effect-source-loader/operation-contracts.ts +9 -41
- package/src/effect-source-loader/paths.ts +55 -21
- package/src/effect-source-loader/rspack-loader.ts +0 -1
- package/src/server-global-vars/index.ts +46 -0
- package/dist/cjs/backend-federation/entry.js +0 -94
- package/dist/cjs/effect-adapter/entry.js +0 -99
- package/dist/cjs/effect-adapter/index.js +0 -194
- package/dist/esm/backend-federation/entry.mjs +0 -56
- package/dist/esm/effect-adapter/entry.mjs +0 -51
- package/dist/esm/effect-adapter/index.mjs +0 -143
- package/dist/esm-node/backend-federation/entry.mjs +0 -57
- package/dist/esm-node/effect-adapter/entry.mjs +0 -52
- package/dist/esm-node/effect-adapter/index.mjs +0 -144
- package/dist/types/backend-federation/entry.d.ts +0 -2
- package/dist/types/effect-adapter/cross-project-policy.d.ts +0 -4
- package/dist/types/effect-adapter/error-response.d.ts +0 -2
- package/dist/types/effect-adapter/index.d.ts +0 -21
- package/src/backend-federation/entry.ts +0 -125
- package/src/effect-adapter/entry.ts +0 -96
- package/src/effect-adapter/index.ts +0 -251
|
@@ -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,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 {};
|
|
@@ -1,125 +0,0 @@
|
|
|
1
|
-
// @effect-diagnostics asyncFunction:off globalFetch:off strictBooleanExpressions:off
|
|
2
|
-
|
|
3
|
-
import {
|
|
4
|
-
evaluateBackendFederationCommonJsEntry,
|
|
5
|
-
loadVerifiedBackendFederationEntry,
|
|
6
|
-
} from '@modern-js/server-runtime-extensions/backend-federation-security';
|
|
7
|
-
import type { ModuleFederationRuntimePlugin } from '@module-federation/runtime';
|
|
8
|
-
|
|
9
|
-
import type {
|
|
10
|
-
BackendFederationEntryExports,
|
|
11
|
-
BackendFederationLoadEntryPlugin,
|
|
12
|
-
BackendFederationRemote,
|
|
13
|
-
BackendFederationRuntimeOptions,
|
|
14
|
-
} from './types';
|
|
15
|
-
import { isRecord, normalizeExpose } from './utils';
|
|
16
|
-
|
|
17
|
-
function decodeDataUrl(url: string) {
|
|
18
|
-
const commaIndex = url.indexOf(',');
|
|
19
|
-
if (commaIndex < 0) {
|
|
20
|
-
throw new Error('[BFF][Effect] Invalid backend federation data URL entry.');
|
|
21
|
-
}
|
|
22
|
-
return decodeURIComponent(url.slice(commaIndex + 1));
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
async function readCommonJsEntrySource(remote: BackendFederationRemote) {
|
|
26
|
-
if (remote.entry.startsWith('data:')) {
|
|
27
|
-
return decodeDataUrl(remote.entry);
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
throw new Error(
|
|
31
|
-
`[BFF][Effect] Backend federation remote ${remote.name} cannot load CommonJS entry ${remote.entry}.`,
|
|
32
|
-
);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
async function importModuleEntry(remote: BackendFederationRemote) {
|
|
36
|
-
const entry = await import(/* webpackIgnore: true */ remote.entry);
|
|
37
|
-
return (entry.default ?? entry) as BackendFederationEntryExports;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
async function resolvePluginEntry(
|
|
41
|
-
remote: BackendFederationRemote,
|
|
42
|
-
plugins: ModuleFederationRuntimePlugin[] | undefined,
|
|
43
|
-
) {
|
|
44
|
-
for (const plugin of plugins ?? []) {
|
|
45
|
-
const loadEntry = (plugin as BackendFederationLoadEntryPlugin).loadEntry;
|
|
46
|
-
if (typeof loadEntry !== 'function') {
|
|
47
|
-
continue;
|
|
48
|
-
}
|
|
49
|
-
const entry = await loadEntry({ remoteInfo: remote });
|
|
50
|
-
if (entry) {
|
|
51
|
-
return entry;
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
async function loadBackendFederationEntry(
|
|
57
|
-
remote: BackendFederationRemote,
|
|
58
|
-
options: BackendFederationRuntimeOptions,
|
|
59
|
-
) {
|
|
60
|
-
const requiresVerification = Boolean(
|
|
61
|
-
remote.verification || options.entryPolicy?.expected,
|
|
62
|
-
);
|
|
63
|
-
const isNetworkEntry = /^https?:\/\//iu.test(remote.entry);
|
|
64
|
-
if (isNetworkEntry && !requiresVerification) {
|
|
65
|
-
throw new Error(
|
|
66
|
-
`[BFF][Effect] Backend federation remote ${remote.name} requires verified entry bytes before network execution.`,
|
|
67
|
-
);
|
|
68
|
-
}
|
|
69
|
-
if (requiresVerification) {
|
|
70
|
-
return loadVerifiedBackendFederationEntry({
|
|
71
|
-
...options.entryPolicy,
|
|
72
|
-
remote,
|
|
73
|
-
...(remote.verification ? { verification: remote.verification } : {}),
|
|
74
|
-
});
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
const pluginEntry = await resolvePluginEntry(remote, options.plugins);
|
|
78
|
-
if (pluginEntry) {
|
|
79
|
-
return pluginEntry;
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
if (remote.entryGlobalName) {
|
|
83
|
-
const globalEntry = (globalThis as Record<string, unknown>)[
|
|
84
|
-
remote.entryGlobalName
|
|
85
|
-
];
|
|
86
|
-
if (isRecord(globalEntry)) {
|
|
87
|
-
return globalEntry as unknown as BackendFederationEntryExports;
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
if (remote.type === 'module' || remote.entry.startsWith('file:')) {
|
|
92
|
-
return importModuleEntry(remote);
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
return evaluateBackendFederationCommonJsEntry(
|
|
96
|
-
remote,
|
|
97
|
-
new TextEncoder().encode(await readCommonJsEntrySource(remote)),
|
|
98
|
-
options.entryPolicy?.evaluateCommonJs,
|
|
99
|
-
);
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
export async function loadBackendFederationExpose(
|
|
103
|
-
remote: BackendFederationRemote,
|
|
104
|
-
expose: string,
|
|
105
|
-
options: BackendFederationRuntimeOptions,
|
|
106
|
-
) {
|
|
107
|
-
const entry = await loadBackendFederationEntry(remote, options);
|
|
108
|
-
if (typeof entry.init === 'function') {
|
|
109
|
-
await entry.init({ hostName: options.hostName });
|
|
110
|
-
}
|
|
111
|
-
if (typeof entry.get !== 'function') {
|
|
112
|
-
throw new Error(
|
|
113
|
-
`[BFF][Effect] Backend federation remote ${remote.name} entry must expose get().`,
|
|
114
|
-
);
|
|
115
|
-
}
|
|
116
|
-
const factory = await entry.get(expose);
|
|
117
|
-
if (typeof factory !== 'function') {
|
|
118
|
-
throw new Error(
|
|
119
|
-
`[BFF][Effect] Backend federation expose ${remote.name}/${normalizeExpose(
|
|
120
|
-
expose,
|
|
121
|
-
)} must load factory function.`,
|
|
122
|
-
);
|
|
123
|
-
}
|
|
124
|
-
return factory();
|
|
125
|
-
}
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
// @effect-diagnostics nodeBuiltinImport:off strictBooleanExpressions:off
|
|
2
|
-
|
|
3
|
-
import path from 'node:path';
|
|
4
|
-
import '@modern-js/server-runtime-extensions/server-config';
|
|
5
|
-
import type { ServerPluginAPI } from '@modern-js/server-core';
|
|
6
|
-
import { API_DIR, findExists, fs, isProd } from '@modern-js/utils';
|
|
7
|
-
|
|
8
|
-
const JS_OR_TS_EXTS = [
|
|
9
|
-
'.js',
|
|
10
|
-
'.jsx',
|
|
11
|
-
'.ts',
|
|
12
|
-
'.tsx',
|
|
13
|
-
'.mjs',
|
|
14
|
-
'.mts',
|
|
15
|
-
'.cjs',
|
|
16
|
-
'.cts',
|
|
17
|
-
] as const;
|
|
18
|
-
|
|
19
|
-
type JsOrTsExtension = (typeof JS_OR_TS_EXTS)[number];
|
|
20
|
-
|
|
21
|
-
function resolveJsOrTsEntry(entryWithoutOrWithExt: string) {
|
|
22
|
-
const extension = path.extname(entryWithoutOrWithExt) as JsOrTsExtension;
|
|
23
|
-
if (JS_OR_TS_EXTS.includes(extension)) {
|
|
24
|
-
return fs.existsSync(entryWithoutOrWithExt)
|
|
25
|
-
? entryWithoutOrWithExt
|
|
26
|
-
: undefined;
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
return (
|
|
30
|
-
findExists(JS_OR_TS_EXTS.map(ext => `${entryWithoutOrWithExt}${ext}`)) ||
|
|
31
|
-
undefined
|
|
32
|
-
);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
function builtEntryPath(entryPath: string) {
|
|
36
|
-
return entryPath.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
function relativeAppPath(appDirectory: string, entryPath: string) {
|
|
40
|
-
const relativePath = path.relative(appDirectory, entryPath);
|
|
41
|
-
return relativePath === '..' || relativePath.startsWith(`..${path.sep}`)
|
|
42
|
-
? undefined
|
|
43
|
-
: relativePath;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
function isDependencyPath(relativePath: string | undefined) {
|
|
47
|
-
return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
export function resolveEffectAdapterEntryFile(api: ServerPluginAPI) {
|
|
51
|
-
const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
|
|
52
|
-
const appRoot = path.resolve(appDirectory || process.cwd());
|
|
53
|
-
const productionRoot =
|
|
54
|
-
isProd() && distDirectory ? path.resolve(distDirectory) : undefined;
|
|
55
|
-
const configuredEntry = api.getServerConfig()?.bff?.effect?.entry;
|
|
56
|
-
|
|
57
|
-
if (configuredEntry) {
|
|
58
|
-
const sourceEntry = path.isAbsolute(configuredEntry)
|
|
59
|
-
? configuredEntry
|
|
60
|
-
: path.resolve(appRoot, configuredEntry);
|
|
61
|
-
if (productionRoot) {
|
|
62
|
-
const relativeEntry = relativeAppPath(appRoot, sourceEntry);
|
|
63
|
-
if (relativeEntry === undefined || isDependencyPath(relativeEntry)) {
|
|
64
|
-
return resolveJsOrTsEntry(sourceEntry);
|
|
65
|
-
}
|
|
66
|
-
return relativeEntry
|
|
67
|
-
? resolveJsOrTsEntry(
|
|
68
|
-
builtEntryPath(path.resolve(productionRoot, relativeEntry)),
|
|
69
|
-
)
|
|
70
|
-
: undefined;
|
|
71
|
-
}
|
|
72
|
-
return resolveJsOrTsEntry(sourceEntry);
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
const resolvedApiDirectory = path.resolve(appRoot, apiDirectory || API_DIR);
|
|
76
|
-
const productionApiDirectory = productionRoot
|
|
77
|
-
? relativeAppPath(productionRoot, resolvedApiDirectory) !== undefined
|
|
78
|
-
? resolvedApiDirectory
|
|
79
|
-
: (() => {
|
|
80
|
-
const relativeApiDirectory = relativeAppPath(
|
|
81
|
-
appRoot,
|
|
82
|
-
resolvedApiDirectory,
|
|
83
|
-
);
|
|
84
|
-
if (isDependencyPath(relativeApiDirectory)) {
|
|
85
|
-
return resolvedApiDirectory;
|
|
86
|
-
}
|
|
87
|
-
return relativeApiDirectory
|
|
88
|
-
? path.resolve(productionRoot, relativeApiDirectory)
|
|
89
|
-
: undefined;
|
|
90
|
-
})()
|
|
91
|
-
: resolvedApiDirectory;
|
|
92
|
-
|
|
93
|
-
return productionApiDirectory
|
|
94
|
-
? resolveJsOrTsEntry(path.resolve(productionApiDirectory, 'index'))
|
|
95
|
-
: undefined;
|
|
96
|
-
}
|
|
@@ -1,251 +0,0 @@
|
|
|
1
|
-
// @effect-diagnostics anyUnknownInErrorContext:off asyncFunction:off nodeBuiltinImport:off strictBooleanExpressions:off
|
|
2
|
-
|
|
3
|
-
import path from 'node:path';
|
|
4
|
-
import '@modern-js/server-runtime-extensions/server-config';
|
|
5
|
-
import {
|
|
6
|
-
dispatchEffectBffRequest,
|
|
7
|
-
type EffectApiModule,
|
|
8
|
-
type EffectBffRequestHandler,
|
|
9
|
-
resolveEffectBffModuleHandler,
|
|
10
|
-
useEffectContext,
|
|
11
|
-
} from '@modern-js/bff-effect/effect';
|
|
12
|
-
import type { Context, Next, ServerPluginAPI } from '@modern-js/server-core';
|
|
13
|
-
import {
|
|
14
|
-
createDisposableServerRuntimeHandle,
|
|
15
|
-
type DisposableServerRuntimeHandle,
|
|
16
|
-
registerServerRuntimeDisposer,
|
|
17
|
-
} from '@modern-js/server-runtime-extensions/runtime-lifecycle';
|
|
18
|
-
import { fs, isProd, logger } from '@modern-js/utils';
|
|
19
|
-
|
|
20
|
-
import { checkCrossProjectPolicyForRequest } from '../cross-project-policy/evaluation';
|
|
21
|
-
import {
|
|
22
|
-
loadEffectBuiltModule,
|
|
23
|
-
loadEffectSourceModule,
|
|
24
|
-
} from '../effect-source-loader/loader';
|
|
25
|
-
import { resolveEffectAdapterCrossProjectPolicy } from './cross-project-policy';
|
|
26
|
-
import { resolveEffectAdapterEntryFile } from './entry';
|
|
27
|
-
import { createEffectAdapterRuntimeErrorResponse } from './error-response';
|
|
28
|
-
|
|
29
|
-
const EFFECT_MIDDLEWARE_BEFORE = [
|
|
30
|
-
'custom-server-hook',
|
|
31
|
-
'custom-server-middleware',
|
|
32
|
-
'render',
|
|
33
|
-
];
|
|
34
|
-
|
|
35
|
-
interface EffectAdapterMiddlewareOptions {
|
|
36
|
-
prefix: string | readonly string[];
|
|
37
|
-
enableHandleWeb?: boolean;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
export class EffectAdapter {
|
|
41
|
-
private api: ServerPluginAPI;
|
|
42
|
-
|
|
43
|
-
private handler: DisposableServerRuntimeHandle | null = null;
|
|
44
|
-
private unregisterRuntimeDisposer?: () => void;
|
|
45
|
-
private prefix = '/api';
|
|
46
|
-
private prefixes = ['/api'];
|
|
47
|
-
private matchingPrefixes = ['/api'];
|
|
48
|
-
private retired = false;
|
|
49
|
-
|
|
50
|
-
constructor(api: ServerPluginAPI) {
|
|
51
|
-
this.api = api;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
registerMiddleware = async (options: EffectAdapterMiddlewareOptions) => {
|
|
55
|
-
const { enableHandleWeb } = options;
|
|
56
|
-
const { bffRuntimeFramework, middlewares: globalMiddlewares } =
|
|
57
|
-
this.api.getServerContext();
|
|
58
|
-
|
|
59
|
-
if (bffRuntimeFramework === 'hono') {
|
|
60
|
-
return;
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
const configuredPrefixes = Array.isArray(options.prefix)
|
|
64
|
-
? options.prefix.filter(Boolean)
|
|
65
|
-
: [options.prefix || '/api'];
|
|
66
|
-
this.prefixes = [
|
|
67
|
-
...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : ['/api']),
|
|
68
|
-
];
|
|
69
|
-
this.matchingPrefixes = [...this.prefixes].sort(
|
|
70
|
-
(left, right) => right.length - left.length,
|
|
71
|
-
);
|
|
72
|
-
this.prefix = this.prefixes[0] || '/api';
|
|
73
|
-
const { serverBase } = this.api.getServerContext() as {
|
|
74
|
-
serverBase?: object;
|
|
75
|
-
};
|
|
76
|
-
if (serverBase) {
|
|
77
|
-
this.unregisterRuntimeDisposer = registerServerRuntimeDisposer(
|
|
78
|
-
serverBase,
|
|
79
|
-
this.dispose,
|
|
80
|
-
);
|
|
81
|
-
}
|
|
82
|
-
|
|
83
|
-
try {
|
|
84
|
-
await this.loadHandler();
|
|
85
|
-
} catch (error) {
|
|
86
|
-
await this.dispose();
|
|
87
|
-
throw error;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
const middlewarePrefixes = enableHandleWeb
|
|
91
|
-
? [this.prefix]
|
|
92
|
-
: this.matchingPrefixes;
|
|
93
|
-
const middlewares = middlewarePrefixes.map(middlewarePrefix => ({
|
|
94
|
-
name: 'effect-api-handler',
|
|
95
|
-
path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
|
|
96
|
-
method: 'all' as const,
|
|
97
|
-
order: 'post' as const,
|
|
98
|
-
before: EFFECT_MIDDLEWARE_BEFORE,
|
|
99
|
-
handler: async (context: Context, next: Next) => {
|
|
100
|
-
const handler = this.handler;
|
|
101
|
-
if (!handler) {
|
|
102
|
-
if (enableHandleWeb) {
|
|
103
|
-
await next();
|
|
104
|
-
return;
|
|
105
|
-
}
|
|
106
|
-
return createEffectAdapterRuntimeErrorResponse(
|
|
107
|
-
this.api,
|
|
108
|
-
new Error(
|
|
109
|
-
'[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.',
|
|
110
|
-
),
|
|
111
|
-
context,
|
|
112
|
-
);
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
const prefix = enableHandleWeb
|
|
116
|
-
? this.matchingPrefixes.find(
|
|
117
|
-
item =>
|
|
118
|
-
item === '/' ||
|
|
119
|
-
context.req.path === item ||
|
|
120
|
-
context.req.path.startsWith(`${item}/`),
|
|
121
|
-
) || this.prefix
|
|
122
|
-
: middlewarePrefix;
|
|
123
|
-
const response = await dispatchEffectBffRequest(
|
|
124
|
-
handler as EffectBffRequestHandler,
|
|
125
|
-
context.req.raw,
|
|
126
|
-
{
|
|
127
|
-
prefix,
|
|
128
|
-
env: context.env as Record<string, unknown>,
|
|
129
|
-
path: context.req.path,
|
|
130
|
-
method: context.req.method,
|
|
131
|
-
onError: error =>
|
|
132
|
-
createEffectAdapterRuntimeErrorResponse(this.api, error, context),
|
|
133
|
-
},
|
|
134
|
-
);
|
|
135
|
-
|
|
136
|
-
if (response.status === 404 && enableHandleWeb) {
|
|
137
|
-
await next();
|
|
138
|
-
return;
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
return new Response(response.body, response);
|
|
142
|
-
},
|
|
143
|
-
}));
|
|
144
|
-
|
|
145
|
-
globalMiddlewares.push(...middlewares);
|
|
146
|
-
};
|
|
147
|
-
|
|
148
|
-
dispose = async () => {
|
|
149
|
-
this.retired = true;
|
|
150
|
-
this.unregisterRuntimeDisposer?.();
|
|
151
|
-
this.unregisterRuntimeDisposer = undefined;
|
|
152
|
-
const previous = this.handler;
|
|
153
|
-
this.handler = null;
|
|
154
|
-
await previous?.dispose();
|
|
155
|
-
};
|
|
156
|
-
|
|
157
|
-
private async loadHandler() {
|
|
158
|
-
const entryFile = resolveEffectAdapterEntryFile(this.api);
|
|
159
|
-
if (!entryFile || !(await fs.pathExists(entryFile))) {
|
|
160
|
-
this.handler = null;
|
|
161
|
-
return;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
let mod: EffectApiModule;
|
|
165
|
-
try {
|
|
166
|
-
const { appDirectory } = this.api.getServerContext();
|
|
167
|
-
mod = (await (isProd()
|
|
168
|
-
? loadEffectBuiltModule(entryFile)
|
|
169
|
-
: loadEffectSourceModule({
|
|
170
|
-
resourcePath: entryFile,
|
|
171
|
-
appDir: appDirectory || path.dirname(entryFile),
|
|
172
|
-
}))) as EffectApiModule;
|
|
173
|
-
} catch (error) {
|
|
174
|
-
logger.error(
|
|
175
|
-
`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`,
|
|
176
|
-
);
|
|
177
|
-
throw error;
|
|
178
|
-
}
|
|
179
|
-
|
|
180
|
-
const crossProjectPolicies = new Map(
|
|
181
|
-
await Promise.all(
|
|
182
|
-
this.prefixes.map(
|
|
183
|
-
async prefix =>
|
|
184
|
-
[
|
|
185
|
-
prefix,
|
|
186
|
-
await resolveEffectAdapterCrossProjectPolicy(
|
|
187
|
-
this.api,
|
|
188
|
-
prefix,
|
|
189
|
-
mod,
|
|
190
|
-
),
|
|
191
|
-
] as const,
|
|
192
|
-
),
|
|
193
|
-
),
|
|
194
|
-
);
|
|
195
|
-
const effectConfig = this.api.getServerConfig()?.bff?.effect;
|
|
196
|
-
const loaded = await resolveEffectBffModuleHandler(mod, {
|
|
197
|
-
openapi: effectConfig?.openapi,
|
|
198
|
-
dataPlatform: effectConfig?.dataPlatform,
|
|
199
|
-
validateRequest: request => {
|
|
200
|
-
const { path: mountedPathname } = useEffectContext();
|
|
201
|
-
const prefix = this.matchingPrefixes.find(
|
|
202
|
-
item =>
|
|
203
|
-
item === '/' ||
|
|
204
|
-
mountedPathname === item ||
|
|
205
|
-
mountedPathname.startsWith(`${item}/`),
|
|
206
|
-
);
|
|
207
|
-
if (!prefix) {
|
|
208
|
-
return null;
|
|
209
|
-
}
|
|
210
|
-
const requestUrl = new URL(request.url);
|
|
211
|
-
if (prefix !== '/') {
|
|
212
|
-
requestUrl.pathname =
|
|
213
|
-
requestUrl.pathname === '/'
|
|
214
|
-
? prefix
|
|
215
|
-
: `${prefix}${requestUrl.pathname}`;
|
|
216
|
-
}
|
|
217
|
-
return checkCrossProjectPolicyForRequest(
|
|
218
|
-
new Request(requestUrl, request),
|
|
219
|
-
crossProjectPolicies.get(prefix),
|
|
220
|
-
);
|
|
221
|
-
},
|
|
222
|
-
onWarning: message => logger.warn(message),
|
|
223
|
-
});
|
|
224
|
-
|
|
225
|
-
if (!loaded) {
|
|
226
|
-
const error = new Error(
|
|
227
|
-
`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`,
|
|
228
|
-
);
|
|
229
|
-
logger.warn(error.message);
|
|
230
|
-
throw error;
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
const candidateOwner = {};
|
|
234
|
-
if (loaded.dispose) {
|
|
235
|
-
registerServerRuntimeDisposer(candidateOwner, loaded.dispose);
|
|
236
|
-
}
|
|
237
|
-
const candidate = createDisposableServerRuntimeHandle(
|
|
238
|
-
candidateOwner,
|
|
239
|
-
loaded.handler,
|
|
240
|
-
);
|
|
241
|
-
if (this.retired) {
|
|
242
|
-
await candidate.dispose();
|
|
243
|
-
throw new Error('Cannot initialize a retired Effect adapter.');
|
|
244
|
-
}
|
|
245
|
-
this.handler = candidate;
|
|
246
|
-
}
|
|
247
|
-
}
|
|
248
|
-
|
|
249
|
-
export const createRuntimeAdapters = (api: ServerPluginAPI) => [
|
|
250
|
-
new EffectAdapter(api),
|
|
251
|
-
];
|