@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.1 → 3.5.0-ultramodern.100

package/dist/esm/utils/effectClientGenerator.mjs

@@ -1,249 +1 @@
-import { deriveOperationVersion } from "@modern-js/bff-core";
-import { compatibleRequire, findExists, fs, logger } from "@modern-js/utils";
-import path from "path";
-import { collectEffectEndpoints, createEffectEndpointContractHash, ensureLeadingSlash, extractHttpApiFromModule, normalizeEffectPrefix } from "../runtime/effect/endpoint-contracts.mjs";
-const JS_OR_TS_EXTS = [
-    '.js',
-    '.jsx',
-    '.ts',
-    '.tsx',
-    '.mjs',
-    '.mts',
-    '.cjs',
-    '.cts'
-];
-const DEFAULT_REQUEST_CREATOR = '@modern-js/plugin-bff/client';
-const EFFECT_CLIENT_RUNTIME_IMPORT = '@modern-js/plugin-bff/effect-client-runtime';
-let httpApiRuntimePromise;
-function isRecord(value) {
-    return 'object' == typeof value && null !== value;
-}
-function isAbsoluteUrl(value) {
-    try {
-        new URL(value);
-        return true;
-    } catch  {
-        return false;
-    }
-}
-function resolveBatchEndpoint(prefix, endpoint) {
-    const value = endpoint || '/_data/batch';
-    if (isAbsoluteUrl(value)) return value;
-    const normalizedPrefix = normalizeEffectPrefix(prefix);
-    const normalizedEndpoint = ensureLeadingSlash(value);
-    if (!normalizedPrefix) return normalizedEndpoint;
-    if (normalizedEndpoint === normalizedPrefix || normalizedEndpoint.startsWith(`${normalizedPrefix}/`)) return normalizedEndpoint;
-    return `${normalizedPrefix}${'/' === normalizedEndpoint ? '' : normalizedEndpoint}`;
-}
-function getPackageInfo(appDir) {
-    try {
-        const packageJsonPath = path.resolve(appDir, './package.json');
-        const packageJson = fs.readJSONSync(packageJsonPath);
-        return {
-            name: packageJson.name,
-            version: packageJson.version
-        };
-    } catch  {
-        return {};
-    }
-}
-async function getHttpApiRuntime() {
-    if (!httpApiRuntimePromise) httpApiRuntimePromise = (async ()=>{
-        let mod;
-        try {
-            mod = await compatibleRequire('effect/unstable/httpapi', false);
-        } catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            if (!message.includes("Cannot find module 'effect/unstable/httpapi'")) throw error;
-            const effectPackageJson = require.resolve('effect/package.json');
-            const effectHttpApiRuntimePath = path.join(path.dirname(effectPackageJson), 'dist', 'unstable', 'httpapi', 'index.js');
-            mod = await compatibleRequire(effectHttpApiRuntimePath, false);
-        }
-        if (isRecord(mod) && isRecord(mod.HttpApi)) {
-            const maybeHttpApi = mod.HttpApi;
-            if ('function' == typeof maybeHttpApi.isHttpApi && 'function' == typeof maybeHttpApi.reflect) return maybeHttpApi;
-        }
-        throw new Error('[BFF][Effect] Unable to resolve HttpApi runtime from effect/unstable/httpapi.');
-    })();
-    return httpApiRuntimePromise;
-}
-async function loadEffectApi(resourcePath) {
-    const httpApiRuntime = await getHttpApiRuntime();
-    const mod = await compatibleRequire(resourcePath, false);
-    return extractHttpApiFromModule(mod, httpApiRuntime.isHttpApi);
-}
-function renderEffectClientCode(endpoints, options) {
-    const requestCreator = options.requestCreator || DEFAULT_REQUEST_CREATOR;
-    const httpMethodDecider = options.httpMethodDecider || 'functionName';
-    const packageInfo = getPackageInfo(options.appDir);
-    const packageName = packageInfo.name;
-    const dataPlatformAppNamespace = packageName || 'unknown-app';
-    const requestId = 'bundle' === options.target ? packageName || process.env.npm_package_name : void 0;
-    const normalizedRequestId = requestId || 'default';
-    const operationVersion = deriveOperationVersion(packageInfo.version);
-    const batchConfig = options.dataPlatformBatch;
-    const batchEndpoint = resolveBatchEndpoint(options.prefix, batchConfig?.endpoint);
-    const manifest = {
-        endpoints: endpoints.map((endpoint)=>({
-                apiId: endpoint.apiId,
-                group: endpoint.groupName,
-                endpoint: endpoint.endpointName,
-                method: endpoint.method,
-                routePath: endpoint.routePath,
-                schemaHash: createEffectEndpointContractHash(endpoint, normalizedRequestId),
-                operationVersion
-            }))
-    };
-    const config = {
-        appNamespace: dataPlatformAppNamespace,
-        ...requestId ? {
-            requestId
-        } : {},
-        port: options.port,
-        useEnvPort: 'server' === options.target,
-        defaultOrigin: `http://localhost:${String(options.port)}`,
-        httpMethodDecider,
-        batch: {
-            enabled: batchConfig?.enabled ?? true,
-            endpoint: batchEndpoint,
-            flushIntervalMs: batchConfig?.flushIntervalMs ?? 8,
-            maxBatchSize: batchConfig?.maxBatchSize ?? 16,
-            maxBatchBytes: batchConfig?.maxBatchBytes ?? 65536,
-            requestTimeoutMs: batchConfig?.requestTimeoutMs ?? 10000,
-            allowedMethods: batchConfig?.allowedMethods && batchConfig.allowedMethods.length > 0 ? batchConfig.allowedMethods : [
-                'GET'
-            ]
-        }
-    };
-    return `import * as __requestRuntime from ${JSON.stringify(requestCreator)};
-import { createGeneratedEffectClient } from ${JSON.stringify(EFFECT_CLIENT_RUNTIME_IMPORT)};
-
-const __manifest = ${JSON.stringify(manifest, null, 2)};
-
-const __config = ${JSON.stringify(config, null, 2)};
-
-const __generated = createGeneratedEffectClient(__manifest, __config, __requestRuntime);
-
-const client = __generated.client;
-const operationManifest = __generated.operationManifest;
-const createEffectRequestContext = __generated.createEffectRequestContext;
-const apiModule = {
-  client,
-  operationManifest,
-  createEffectRequestContext,
-};
-
-export { client, createEffectRequestContext, operationManifest };
-export default apiModule;
-`;
-}
-function renderClientShape(endpoints, valueType) {
-    if (0 === endpoints.length) return `Record<string, Record<string, ${valueType}>>`;
-    const groups = new Map();
-    for (const endpoint of endpoints){
-        const group = groups.get(endpoint.groupName) || [];
-        group.push(endpoint.endpointName);
-        groups.set(endpoint.groupName, group);
-    }
-    const groupEntries = [
-        ...groups.entries()
-    ].map(([groupName, names])=>{
-        const endpointEntries = names.map((name)=>`    ${JSON.stringify(name)}: ${valueType};`).join('\n');
-        return `  ${JSON.stringify(groupName)}: {\n${endpointEntries}\n  };`;
-    });
-    return `{\n${groupEntries.join('\n')}\n}`;
-}
-function renderEffectClientDeclaration(endpoints = []) {
-    return `export type EffectClientOperation = (
-  request?: unknown,
-) => Promise<unknown>;
-export type EffectClientGroup = Record<string, EffectClientOperation>;
-export type EffectClient = Record<string, EffectClientGroup>;
-export type EffectOperationDescriptor = {
-  appNamespace: string;
-  apiId: string;
-  group: string;
-  endpoint: string;
-  operationId: string;
-  routePath: string;
-  method: string;
-  operationVersion: number;
-  schemaHash: string;
-  version: number;
-};
-export type EffectOperationManifest = Record<
-  string,
-  Record<string, EffectOperationDescriptor>
->;
-export type EffectOperationContext = {
-  requestId?: string;
-  operationId?: string;
-  routePath?: string;
-  method?: string;
-  schemaHash?: string;
-  operationVersion?: number;
-  locale?: string;
-  traceparent?: string;
-  traceId?: string;
-  spanId?: string;
-  source?: string;
-  scope?: Record<string, unknown>;
-  sessionClaims?: Record<string, unknown>;
-  attributes?: Record<string, unknown>;
-};
-export type EffectRequestContext = {
-  headers?: Record<string, string>;
-  locale?: string;
-  operationContext?: EffectOperationContext;
-  traceparent?: string;
-  traceId?: string;
-  spanId?: string;
-};
-export type GeneratedEffectClient = ${renderClientShape(endpoints, 'EffectClientOperation')};
-export type GeneratedEffectOperationManifest = ${renderClientShape(endpoints, "EffectOperationDescriptor")};
-
-export declare const client: GeneratedEffectClient;
-export declare const createEffectRequestContext: (
-  requestContext: Record<string, unknown>,
-) => EffectRequestContext;
-export declare const operationManifest: GeneratedEffectOperationManifest;
-declare const apiModule: {
-  client: GeneratedEffectClient;
-  createEffectRequestContext: typeof createEffectRequestContext;
-  operationManifest: GeneratedEffectOperationManifest;
-};
-
-export default apiModule;
-`;
-}
-async function generateEffectClient(options) {
-    const api = await loadEffectApi(options.resourcePath);
-    if (!api) {
-        logger.warn(`[BFF][Effect] Failed to generate client for ${options.resourcePath}: unable to resolve exported HttpApi.`);
-        return null;
-    }
-    const httpApiRuntime = await getHttpApiRuntime();
-    const endpoints = collectEffectEndpoints(httpApiRuntime.reflect, api, options.prefix);
-    return {
-        code: renderEffectClientCode(endpoints, options),
-        declaration: renderEffectClientDeclaration(endpoints),
-        endpoints
-    };
-}
-async function generateEffectClientCode(options) {
-    const artifacts = await generateEffectClient(options);
-    return artifacts ? artifacts.code : null;
-}
-function resolveEffectEntryFile(options) {
-    const { appDir, apiDir, effectEntry } = options;
-    const resolveEntry = (entryWithoutExt)=>{
-        if (path.extname(entryWithoutExt)) return fs.existsSync(entryWithoutExt) ? entryWithoutExt : void 0;
-        return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutExt}${ext}`));
-    };
-    if (effectEntry) {
-        const entryWithoutExt = path.isAbsolute(effectEntry) ? effectEntry : path.resolve(appDir, effectEntry);
-        return resolveEntry(entryWithoutExt);
-    }
-    return resolveEntry(path.resolve(apiDir, 'index'));
-}
-export { generateEffectClient, generateEffectClientCode, renderEffectClientDeclaration, resolveEffectEntryFile };
+export { generateEffectClient, generateEffectClientCode, renderEffectClientDeclaration, resolveEffectEntryFile } from "./effect-client-generator/index.mjs";

package/dist/esm/utils/effectSourceLoader.mjs

@@ -0,0 +1,199 @@
+import node_crypto from "node:crypto";
+import node_fs from "node:fs";
+import { builtinModules } from "node:module";
+import node_path from "node:path";
+import { pathToFileURL } from "node:url";
+import { build, transform } from "esbuild";
+const dynamicImport = new Function('specifier', 'return import(specifier)');
+const SOURCE_LOADERS = new Map([
+    [
+        '.js',
+        'js'
+    ],
+    [
+        '.jsx',
+        'jsx'
+    ],
+    [
+        '.mjs',
+        'js'
+    ],
+    [
+        '.cjs',
+        'js'
+    ],
+    [
+        '.ts',
+        'ts'
+    ],
+    [
+        '.tsx',
+        'tsx'
+    ],
+    [
+        '.mts',
+        'ts'
+    ],
+    [
+        '.cts',
+        'ts'
+    ]
+]);
+function sourceLoader(args) {
+    return SOURCE_LOADERS.get(node_path.extname(args.path).toLowerCase());
+}
+function preserveSourceModuleSemantics() {
+    return {
+        name: 'modern-js-effect-source-semantics',
+        setup (buildApi) {
+            buildApi.onLoad({
+                filter: /\.[cm]?[jt]sx?$/
+            }, async (args)=>{
+                const loader = sourceLoader(args);
+                if (!loader) return;
+                const source = await node_fs.promises.readFile(args.path, 'utf8');
+                const compiled = await transform(source, {
+                    define: {
+                        'import.meta.url': JSON.stringify(pathToFileURL(args.path).href)
+                    },
+                    jsx: 'automatic',
+                    loader,
+                    sourcefile: args.path,
+                    target: 'node20'
+                });
+                return {
+                    contents: compiled.code,
+                    loader: 'js',
+                    resolveDir: node_path.dirname(args.path)
+                };
+            });
+        }
+    };
+}
+const nodeBuiltins = new Set([
+    ...builtinModules,
+    ...builtinModules.map((name)=>`node:${name}`)
+]);
+const dependencyResolutionMarker = 'modern-js-effect-dependency-resolution';
+function isBareSpecifier(specifier) {
+    return !specifier.startsWith('.') && !specifier.startsWith('/') && !node_path.isAbsolute(specifier);
+}
+function externalizeInstalledDependencies() {
+    return {
+        name: 'modern-js-effect-installed-dependencies',
+        setup (buildApi) {
+            buildApi.onResolve({
+                filter: /.*/
+            }, async (args)=>{
+                if (!isBareSpecifier(args.path) || nodeBuiltins.has(args.path) || args.pluginData?.[dependencyResolutionMarker] === true) return nodeBuiltins.has(args.path) ? {
+                    external: true,
+                    path: args.path
+                } : void 0;
+                const resolution = await buildApi.resolve(args.path, {
+                    importer: args.importer,
+                    kind: args.kind,
+                    namespace: args.namespace,
+                    pluginData: {
+                        ...args.pluginData,
+                        [dependencyResolutionMarker]: true
+                    },
+                    resolveDir: args.resolveDir
+                });
+                if (resolution.errors.length > 0) return {
+                    external: true,
+                    path: args.path
+                };
+                if (resolution.external || !resolution.path) return {
+                    external: true,
+                    path: args.path
+                };
+                const realPath = await node_fs.promises.realpath(resolution.path).catch(()=>resolution.path);
+                if (realPath.includes(`${node_path.sep}node_modules${node_path.sep}`)) return {
+                    external: true,
+                    path: args.path
+                };
+                return {
+                    namespace: resolution.namespace,
+                    path: resolution.path,
+                    pluginData: resolution.pluginData,
+                    sideEffects: resolution.sideEffects,
+                    suffix: resolution.suffix,
+                    warnings: resolution.warnings,
+                    watchDirs: resolution.watchDirs,
+                    watchFiles: resolution.watchFiles
+                };
+            });
+        }
+    };
+}
+async function bundleEffectEntryForNode(options) {
+    await build({
+        absWorkingDir: options.appDir,
+        allowOverwrite: true,
+        bundle: true,
+        entryPoints: [
+            options.entryPath
+        ],
+        format: options.format,
+        logLevel: 'silent',
+        outfile: options.entryPath,
+        platform: 'node',
+        plugins: [
+            externalizeInstalledDependencies(),
+            preserveSourceModuleSemantics()
+        ],
+        target: 'node20'
+    });
+}
+function isWatchableInput(filename) {
+    return !filename.includes(`${node_path.sep}node_modules${node_path.sep}`) && (SOURCE_LOADERS.has(node_path.extname(filename).toLowerCase()) || '.json' === node_path.extname(filename).toLowerCase());
+}
+function normalizeImportedModule(module) {
+    if (!module || 'object' != typeof module) return module;
+    const namespace = module;
+    const commonJsModule = namespace.default;
+    if (1 === Object.keys(namespace).length && null !== commonJsModule && 'object' == typeof commonJsModule && true === commonJsModule.__esModule) return commonJsModule;
+    return module;
+}
+async function loadEffectSourceModule(options) {
+    const resourcePath = node_path.resolve(options.resourcePath);
+    const appDir = node_path.resolve(options.appDir ?? node_path.dirname(resourcePath));
+    const tsconfigPath = node_path.join(appDir, 'tsconfig.json');
+    const cacheDirectory = node_path.join(appDir, 'node_modules', '.cache', 'modern-js', 'effect-source-loader');
+    const outputName = node_crypto.createHash('sha256').update(resourcePath).digest('hex').slice(0, 24);
+    const outputPath = node_path.join(cacheDirectory, `${outputName}.mjs`);
+    await node_fs.promises.mkdir(cacheDirectory, {
+        recursive: true
+    });
+    const result = await build({
+        absWorkingDir: appDir,
+        banner: {
+            js: `import { createRequire as __modernCreateEffectRequire } from 'node:module'; const require = __modernCreateEffectRequire(${JSON.stringify(pathToFileURL(resourcePath).href)});`
+        },
+        bundle: true,
+        entryPoints: [
+            resourcePath
+        ],
+        format: 'esm',
+        jsx: 'automatic',
+        logLevel: 'silent',
+        metafile: true,
+        outfile: outputPath,
+        platform: 'node',
+        plugins: [
+            externalizeInstalledDependencies(),
+            preserveSourceModuleSemantics()
+        ],
+        sourcemap: 'inline',
+        target: 'node20',
+        tsconfig: node_fs.existsSync(tsconfigPath) ? tsconfigPath : void 0
+    });
+    for (const input of Object.keys(result.metafile.inputs)){
+        const dependency = node_path.isAbsolute(input) ? node_path.normalize(input) : node_path.resolve(appDir, input);
+        if (isWatchableInput(dependency)) options.onDependency?.(dependency);
+    }
+    const output = await node_fs.promises.readFile(outputPath);
+    const revision = node_crypto.createHash('sha256').update(output).digest('hex');
+    return normalizeImportedModule(await dynamicImport(`${pathToFileURL(outputPath).href}?v=${revision}`));
+}
+export { bundleEffectEntryForNode, loadEffectSourceModule };

package/dist/esm-node/cli/compress.mjs

@@ -0,0 +1,15 @@
+import "node:module";
+import { normalizePrefixList } from "./prefix.mjs";
+const createCompressConfig = (devServer, prefix)=>{
+    if (!devServer || 'object' != typeof devServer || Array.isArray(devServer)) return;
+    const { compress } = devServer;
+    if (void 0 === compress || true === compress) {
+        const prefixes = normalizePrefixList(prefix);
+        return {
+            filter: (req)=>!prefixes.some((item)=>req.url?.includes(item))
+        };
+    }
+    if (false === compress) return false;
+    return compress;
+};
+export { createCompressConfig };

package/dist/esm-node/cli/generator.mjs

@@ -0,0 +1,134 @@
+import "node:module";
+import { ApiRouter } from "@modern-js/bff-core";
+import { compile } from "@modern-js/server-utils";
+import { API_DIR, SHARED_DIR, fs, resolveServerTsconfig } from "@modern-js/utils";
+import path from "path";
+import clientGenerator from "../utils/clientGenerator.mjs";
+import { bundleEffectEntryForNode } from "../utils/effectSourceLoader.mjs";
+import pluginGenerator from "../utils/pluginGenerator.mjs";
+import runtimeGenerator from "../utils/runtimeGenerator.mjs";
+import { getPrimaryPrefix } from "./prefix.mjs";
+import { serializeServerGlobalVars, transformServerGlobalVars } from "./serverGlobalVars.mjs";
+const RUNTIME_CREATE_REQUEST = '@modern-js/plugin-bff/client';
+const effectEntryExtensions = [
+    '.js',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.mjs',
+    '.mts',
+    '.cjs',
+    '.cts'
+];
+function resolveEffectSourceEntry(appDirectory, apiDirectory, configuredEntry) {
+    const entry = configuredEntry ? path.isAbsolute(configuredEntry) ? configuredEntry : path.resolve(appDirectory, configuredEntry) : path.resolve(apiDirectory, 'index');
+    return path.extname(entry) ? entry : effectEntryExtensions.map((extension)=>`${entry}${extension}`).find((candidate)=>fs.existsSync(candidate));
+}
+function resolveBuiltEffectEntry(appDirectory, distDirectory, sourceEntry) {
+    if (!sourceEntry) return;
+    const relativeEntry = path.relative(appDirectory, sourceEntry);
+    if ('..' === relativeEntry || relativeEntry.startsWith(`..${path.sep}`)) throw new Error(`Effect BFF entry must be inside the application directory: ${sourceEntry}`);
+    const builtEntry = path.resolve(distDirectory, relativeEntry).replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
+    return fs.existsSync(builtEntry) ? builtEntry : void 0;
+}
+const createBffGenerator = (api)=>{
+    const compileApi = async ()=>{
+        const { appDirectory, distDirectory, apiDirectory, bffRuntimeFramework, sharedDirectory, moduleType } = api.getAppContext();
+        const modernConfig = api.getNormalizedConfig();
+        const distDir = path.resolve(distDirectory);
+        const apiDir = apiDirectory || path.resolve(appDirectory, API_DIR);
+        const sharedDir = sharedDirectory || path.resolve(appDirectory, SHARED_DIR);
+        const tsconfigPath = resolveServerTsconfig(appDirectory, modernConfig?.server?.tsconfigPath);
+        const sourceDirs = [];
+        if (await fs.pathExists(apiDir)) sourceDirs.push(apiDir);
+        if (await fs.pathExists(sharedDir)) sourceDirs.push(sharedDir);
+        const { alias, globalVars } = modernConfig.source;
+        const { alias: resolveAlias } = modernConfig.resolve;
+        if (sourceDirs.length > 0) {
+            const combinedAlias = [].concat(alias ?? []).concat(resolveAlias ?? []);
+            const serializedGlobalVars = serializeServerGlobalVars(globalVars);
+            await compile(appDirectory, {
+                alias: combinedAlias
+            }, {
+                sourceDirs,
+                distDir,
+                tsconfigPath,
+                moduleType,
+                throwErrorInsteadOfExit: true
+            });
+            await transformServerGlobalVars(sourceDirs.map((sourceDir)=>path.resolve(distDir, path.relative(appDirectory, sourceDir))), serializedGlobalVars);
+            if ('effect' === bffRuntimeFramework) {
+                const sourceEntry = resolveEffectSourceEntry(appDirectory, apiDir, modernConfig.bff?.effect?.entry);
+                const builtEntry = resolveBuiltEffectEntry(appDirectory, distDir, sourceEntry);
+                if (!builtEntry) throw new Error(`Effect BFF entry was not emitted into ${distDir}: ${sourceEntry ?? path.resolve(apiDir, 'index')}`);
+                await bundleEffectEntryForNode({
+                    appDir: appDirectory,
+                    entryPath: builtEntry,
+                    format: 'module' === moduleType ? 'esm' : 'cjs'
+                });
+            }
+        }
+    };
+    const generate = async ()=>{
+        const { appDirectory, apiDirectory, lambdaDirectory, port, bffRuntimeFramework } = api.getAppContext();
+        const modernConfig = api.getNormalizedConfig();
+        const relativeDistPath = modernConfig?.output?.distPath?.root || 'dist';
+        const { bff } = modernConfig || {};
+        const prefix = getPrimaryPrefix(bff?.prefix);
+        const httpMethodDecider = bff?.httpMethodDecider;
+        const apiRouter = new ApiRouter({
+            apiDir: apiDirectory,
+            appDir: appDirectory,
+            lambdaDir: lambdaDirectory,
+            prefix,
+            httpMethodDecider,
+            isBuild: true
+        });
+        const lambdaDir = apiRouter.getLambdaDir();
+        const existLambda = apiRouter.isExistLambda();
+        const runtime = bff?.runtimeCreateRequest || RUNTIME_CREATE_REQUEST;
+        const relativeApiPath = path.relative(appDirectory, apiDirectory);
+        const relativeLambdaPath = path.relative(appDirectory, lambdaDir);
+        await pluginGenerator({
+            prefix,
+            appDirectory,
+            relativeDistPath,
+            relativeApiPath,
+            relativeLambdaPath,
+            runtimeFramework: 'hono' === bffRuntimeFramework ? 'hono' : 'effect'
+        });
+        await clientGenerator({
+            prefix,
+            appDir: appDirectory,
+            apiDir: apiDirectory,
+            lambdaDir,
+            existLambda,
+            port,
+            requestCreator: bff?.requestCreator,
+            httpMethodDecider,
+            relativeDistPath,
+            relativeApiPath,
+            bffRuntimeFramework,
+            effectEntry: bff?.effect?.entry,
+            effectDataPlatformBatch: bff?.effect?.dataPlatform?.batch
+        });
+        await runtimeGenerator({
+            runtime,
+            appDirectory,
+            relativeDistPath
+        });
+    };
+    const handleCrossProjectInvocation = async (isBuild = false)=>{
+        const { bff } = api.getNormalizedConfig();
+        if (bff?.crossProject) {
+            if (!isBuild) await compileApi();
+            await generate();
+        }
+    };
+    return {
+        compileApi,
+        generate,
+        handleCrossProjectInvocation
+    };
+};
+export { createBffGenerator };

package/dist/esm-node/cli/prefix.mjs

@@ -0,0 +1,10 @@
+import "node:module";
+import { DEFAULT_API_PREFIX } from "@modern-js/utils";
+const normalizePrefixList = (prefix)=>{
+    if (Array.isArray(prefix)) return prefix.filter(Boolean);
+    return [
+        prefix || DEFAULT_API_PREFIX
+    ];
+};
+const getPrimaryPrefix = (prefix)=>normalizePrefixList(prefix)[0] || DEFAULT_API_PREFIX;
+export { getPrimaryPrefix, normalizePrefixList };

package/dist/esm-node/cli/serverGlobalVars.mjs

@@ -0,0 +1,77 @@
+import "node:module";
+import { applyOptionsChain, fs } from "@modern-js/utils";
+import { transform } from "@swc/core";
+import path from "path";
+const RELEASE_IDENTITY_GLOBAL_NAMES = [
+    'ULTRAMODERN_BUILD_MARKER',
+    'ULTRAMODERN_SOURCE_REVISION',
+    'ULTRAMODERN_RELEASE_VERSION'
+];
+const collectJavaScriptFiles = async (directory)=>{
+    const entries = await fs.readdir(directory, {
+        withFileTypes: true
+    });
+    const nested = await Promise.all(entries.map(async (entry)=>{
+        const absolutePath = path.join(directory, entry.name);
+        if (entry.isDirectory()) return collectJavaScriptFiles(absolutePath);
+        return /\.(?:c|m)?js$/u.test(entry.name) ? [
+            absolutePath
+        ] : [];
+    }));
+    return nested.flat();
+};
+const serializeServerGlobalVars = (options)=>{
+    const globalVars = applyOptionsChain({}, options, {
+        env: 'server',
+        target: 'node'
+    });
+    return Object.fromEntries(Object.entries(globalVars).map(([key, value])=>{
+        let serialized;
+        try {
+            serialized = JSON.stringify(value);
+        } catch (error) {
+            throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+const transformServerGlobalVars = async (outputDirectories, globalVars)=>{
+    if (0 === Object.keys(globalVars).length) return;
+    const existingDirectories = (await Promise.all(outputDirectories.map(async (directory)=>await fs.pathExists(directory) ? directory : void 0))).filter((directory)=>Boolean(directory));
+    const files = (await Promise.all(existingDirectories.map(collectJavaScriptFiles))).flat();
+    const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`void ${globalVars[name]};`).join('')}\n` : '';
+    await Promise.all(files.map(async (filename)=>{
+        const source = await fs.readFile(filename, 'utf8');
+        const sourceMapFilename = `${filename}.map`;
+        const sourceMapExists = await fs.pathExists(sourceMapFilename);
+        const inputSourceMap = sourceMapExists ? await fs.readFile(sourceMapFilename, 'utf8') : void 0;
+        const result = await transform(`${releaseIdentityBanner}${source}`, {
+            filename,
+            inputSourceMap,
+            sourceMaps: sourceMapExists,
+            jsc: {
+                parser: {
+                    syntax: "ecmascript"
+                },
+                preserveAllComments: true,
+                target: 'es2022',
+                transform: {
+                    optimizer: {
+                        globals: {
+                            vars: globalVars
+                        }
+                    }
+                }
+            }
+        });
+        await fs.writeFile(filename, result.code);
+        if (sourceMapExists && result.map) await fs.writeFile(sourceMapFilename, result.map);
+    }));
+};
+export { serializeServerGlobalVars, transformServerGlobalVars };