@bleedingdev/modern-js-app-tools 3.9.0-ultramodern.4 → 3.9.0-ultramodern.6

package/dist/esm-node/plugins/deploy/platforms/node.mjs

@@ -5,7 +5,6 @@ import { chalk, fs, removeModuleSyncFromExports } from "@modern-js/utils";
 import { nodeDepEmit } from "ndepe";
 import { readTemplate, resolveESMDependency } from "../utils/index.mjs";
 import { generateHandler } from "../utils/generator.mjs";
-import { preserveNpmAliases, readPackageIdentity } from "../utils/npmAliases.mjs";
 const createNodePreset = ({ appContext, modernConfig })=>{
     const { appDirectory, distDirectory, moduleType } = appContext;
     const isEsmProject = 'module' === moduleType;
@@ -38,7 +37,6 @@ const createNodePreset = ({ appContext, modernConfig })=>{
             const filter = (filePath)=>!filePath.startsWith(staticDirectory) && !filePath.endsWith('.map');
             const entry = isEsmProject ? await resolveESMDependency('@modern-js/prod-server') : require.resolve('@modern-js/prod-server');
             if (!entry) throw new Error('Cannot find @modern-js/prod-server');
-            const prodServerPackage = await readPackageIdentity(entry);
             await nodeDepEmit({
                 appDir: appDirectory,
                 sourceDir: outputDirectory,
@@ -57,17 +55,6 @@ const createNodePreset = ({ appContext, modernConfig })=>{
                     };
                 }
             });
-            await preserveNpmAliases({
-                appDirectory,
-                outputDirectory,
-                implicitAliases: [
-                    {
-                        aliasName: '@modern-js/prod-server',
-                        targetName: prodServerPackage.name,
-                        targetVersion: prodServerPackage.version
-                    }
-                ]
-            });
             console.log('Static directory:', chalk.blue(node_path.relative(appDirectory, staticDirectory).replace(/\\/g, '/')));
             console.log("You can preview this build by", chalk.blue('node .output/index'));
         }

package/dist/esm-node/plugins/serverBuild.mjs

@@ -39,7 +39,8 @@ const serverBuild = ()=>({
                     sourceDirs,
                     distDir,
                     tsconfigPath,
-                    moduleType
+                    moduleType,
+                    excludeFiles: api.getAppContext().serverCompileExcludedFiles
                 });
             });
         }

package/dist/types/builder/shared/builderPlugins/index.d.ts

@@ -1,5 +1,4 @@
 export * from './adapterBasic.js';
 export * from './adapterHtml.js';
-export * from './adapterPrecompress.js';
 export * from './adapterSSR.js';
 export * from './builderHooks.js';

package/dist/types/config/index.d.ts

@@ -1,3 +1,2 @@
-export * from './build-environment.js';
 export * from './default.js';
 export * from './initialize/index.js';

package/dist/types/index.d.ts

@@ -1,7 +1,6 @@
 import type { AppTools, CliPlugin } from './types/index.js';
 import { initAppContext } from './utils/initAppContext.js';
 export * from './defineConfig.js';
-export * from './presetUltramodern.js';
 export declare const appTools: () => CliPlugin<AppTools>;
 export { build } from './commands/build.js';
 export { deploy } from './commands/deploy.js';

package/dist/types/plugins/deploy/utils/generator.d.ts

@@ -6,7 +6,7 @@ export declare const serverAppContextTemplate: (appContext: AppToolsContext) =>
     apiDirectory: string;
     lambdaDirectory: string;
     metaName: string;
-    bffRuntimeFramework: "effect" | "hono";
+    bffRuntimeFramework: "hono";
 };
 export type PluginItem = [string, Record<string, any> | undefined];
 export declare const genPluginImportsCode: (plugins: PluginItem[], isESM?: boolean) => string;

package/dist/types/types/config/output.d.ts

@@ -1,8 +1,6 @@
 import type { BuilderConfig } from '@modern-js/builder';
 import type { SSGConfig, SSGMultiEntryOptions } from '@modern-js/types';
 import type { UnwrapBuilderConfig } from '../utils.js';
-import type { PrecompressConfig } from './precompress.js';
-export type { PrecompressCodecOptions, PrecompressConfig } from './precompress.js';
 export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'output'> {
     /**
      * Enable SSG for self-controlled routing or conventional routing.
@@ -34,12 +32,5 @@ export interface OutputUserConfig extends UnwrapBuilderConfig<BuilderConfig, 'ou
      * Specify the temporary directory for framework generated files.
      */
     tempDir?: string;
-    /**
-     * Generate precompressed static assets by using compression-webpack-plugin.
-     * `true` means enabling both gzip and brotli with default options.
-     * Disabled unless explicitly configured; `presetUltramodern` enables it.
-     * @default false
-     */
-    precompress?: boolean | PrecompressConfig;
 }
 export type { SSGConfig, SSGMultiEntryOptions, SSGRouteOptions, SSGSingleEntryOptions, } from '@modern-js/types';

package/dist/types/types/index.d.ts

@@ -7,4 +7,4 @@ export type { CLIPluginExtends, RuntimePluginConfig, ServerPluginConfig };
 export type AppUserConfig = AppToolsUserConfig;
 export type AppNormalizedConfig = AppToolsNormalizedConfig;
 export type AppToolsAPI = CLIPluginAPI<AppTools>;
-export type { AppToolsContext, AppToolsExtendAPI, AppToolsExtendContext, AppToolsExtendHooks, AppToolsHooks as AppToolsFeatureHooks, } from './plugin.js';
+export type { AfterBffCompileFn, AppToolsContext, AppToolsExtendAPI, AppToolsExtendContext, AppToolsExtendHooks, AppToolsHooks as AppToolsFeatureHooks, BeforeBffCompileFn, BffClientArtifact, BffClientArtifacts, BffCompilation, BffGeneratedEntries, BffGeneratedModule, BffGeneration, ModifyBffClientArtifactsFn, ModifyBffGeneratedEntriesFn, } from './plugin.js';

package/dist/types/types/plugin.d.ts

@@ -1,11 +1,59 @@
 import type { AppContext, AsyncHook, InternalContext, PluginHook, PluginHookTap, TransformFunction } from '@modern-js/plugin';
 import type { Hooks } from '@modern-js/plugin/cli';
-import type { Entrypoint, HtmlPartials, HtmlTemplates, NestedRouteForCli, PageRoute, RouteLegacy, ServerPlugin, ServerRoute } from '@modern-js/types';
+import type { BffRuntimeFramework } from '@modern-js/plugin/server';
+import type { Entrypoint, HtmlPartials, HtmlTemplates, HttpMethodDecider, NestedRouteForCli, PageRoute, RouteLegacy, ServerPlugin, ServerRoute } from '@modern-js/types';
 import type { EagerRouteComponentFilesByEntry } from '@modern-js/utils';
 import type { EnvironmentConfig } from '@rsbuild/core';
 import type { getHookRunners } from '../compat/hooks.js';
 import type { AppTools } from './index.js';
 import type { AppToolsNormalizedConfig, AppToolsUserConfig } from './config/index.js';
+export interface BffCompilation {
+    readonly appDirectory: string;
+    readonly apiDirectory: string;
+    readonly sourceDirectories: readonly string[];
+    readonly outputDirectories: readonly string[];
+    readonly distDirectory: string;
+    readonly tsconfigPath?: string;
+    readonly moduleType: AppToolsContext['moduleType'];
+}
+export interface BffGeneration {
+    readonly appDirectory: string;
+    readonly apiDirectory: string;
+    readonly lambdaDirectory: string;
+    readonly existLambda: boolean;
+    readonly apiFiles: readonly string[];
+    readonly relativeDistPath: string;
+    readonly prefix: string;
+    readonly port?: number;
+    readonly requestId: string;
+    readonly requestCreator?: string;
+    readonly httpMethodDecider?: HttpMethodDecider;
+}
+export interface BffClientArtifact {
+    /** Canonical relative source path under generation.apiDirectory. */
+    readonly sourcePath: string;
+    readonly code: string;
+    readonly declaration: string;
+}
+export interface BffClientArtifacts {
+    readonly generation: BffGeneration;
+    additionalArtifacts: BffClientArtifact[];
+}
+export interface BffGeneratedModule {
+    readonly code: string;
+    readonly declaration: string;
+}
+export interface BffGeneratedEntries {
+    readonly generation: BffGeneration;
+    plugin: BffGeneratedModule;
+    runtime: BffGeneratedModule | null;
+    /** Direct dependencies required by the emitted SDK modules. */
+    packageDependencies: Record<string, string>;
+}
+export type BeforeBffCompileFn = (context: BffCompilation) => void | Promise<void>;
+export type AfterBffCompileFn = (context: BffCompilation) => void | Promise<void>;
+export type ModifyBffClientArtifactsFn = TransformFunction<BffClientArtifacts>;
+export type ModifyBffGeneratedEntriesFn = TransformFunction<BffGeneratedEntries>;
 export type AfterPrepareFn = () => Promise<void> | void;
 export type CheckEntryPointFn = TransformFunction<{
     path: string;
@@ -64,6 +112,10 @@ export interface AppToolsExtendAPI {
     useHookRunners: () => ReturnType<typeof getHookRunners>;
 }
 export interface AppToolsExtendHooks extends Record<string, PluginHook<(...args: any[]) => any>> {
+    onBeforeBffCompile: AsyncHook<BeforeBffCompileFn>;
+    onAfterBffCompile: AsyncHook<AfterBffCompileFn>;
+    modifyBffClientArtifacts: AsyncHook<ModifyBffClientArtifactsFn>;
+    modifyBffGeneratedEntries: AsyncHook<ModifyBffGeneratedEntriesFn>;
     onAfterPrepare: AsyncHook<AfterPrepareFn>;
     deploy: AsyncHook<DeplpoyFn>;
     checkEntryPoint: AsyncHook<CheckEntryPointFn>;
@@ -88,6 +140,8 @@ export interface AppToolsExtendContext {
     runtimeConfigFile: string;
     serverPlugins: ServerPlugin[];
     moduleType: 'module' | 'commonjs';
+    /** Exact generated files excluded from server compilation. */
+    serverCompileExcludedFiles?: string[];
     /** Information for entry points */
     entrypoints: Entrypoint[];
     /** Selected entry points */
@@ -115,7 +169,7 @@ export interface AppToolsExtendContext {
      * Identification for bff runtime framework
      * @private
      */
-    bffRuntimeFramework?: 'hono' | 'effect';
+    bffRuntimeFramework?: BffRuntimeFramework;
     /**
      * Route component files collected from the FINAL file-system routes (after all
      * `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated by

package/dist/types/utils/initAppContext.d.ts

@@ -1,3 +1,4 @@
+import type { BffRuntimeFramework } from '@modern-js/plugin/server';
 export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFile, options, tempDir, }: {
     metaName: string;
     appDirectory: string;
@@ -7,7 +8,7 @@ export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFil
         apiDir?: string;
         distDir?: string;
         sharedDir?: string;
-        bffRuntimeFramework?: 'hono' | 'effect';
+        bffRuntimeFramework?: BffRuntimeFramework;
     };
     tempDir?: string;
 }) => {
@@ -27,5 +28,5 @@ export declare const initAppContext: ({ metaName, appDirectory, runtimeConfigFil
     apiOnly: boolean;
     internalDirAlias: string;
     internalSrcAlias: string;
-    bffRuntimeFramework: "effect" | "hono";
+    bffRuntimeFramework: "hono";
 };

package/docs/configure/app/bff/effect.md

@@ -45,21 +45,33 @@ Please refer to the [Enable BFF](/guides/advanced-features/bff/function.md#enabl
 
 :::caution Install the Effect peers yourself
 `effect` and `@effect/opentelemetry` are **optional exact peer dependencies** of
-`@modern-js/plugin-bff`, not dependencies. The plugin no longer bundles a copy —
-Effect 4 derives `Context` / `Service` keys per module instance, so a bundled copy
-would give your app a second Effect identity. Before setting
-`runtimeFramework: 'effect'` or importing `@modern-js/plugin-bff/effect`,
-`/effect-server`, `/effect-edge` or `/effect-client`, install the exact cohort:
+`@modern-js/bff-effect`. Install them in the application so its API modules and
+the framework use the same Effect instance. Before setting
+`runtimeFramework: 'effect'` or importing `@modern-js/bff-effect/effect`,
+`/effect-edge` or `/effect-client`, install the exact cohort:
 
 ```bash
 pnpm add effect@4.0.0-rc.112 @effect/opentelemetry@4.0.0-rc.112
 ```
 
 The pin is exact because UltraModern ships Effect as one lockstep cohort. Apps
-using only `runtimeFramework: 'hono'` or the `./data-platform` lane need neither
-package.
+using only native `runtimeFramework: 'hono'` or
+`@modern-js/bff-effect/data-platform` need neither package.
 :::
 
+Use `bffPlugin` from `@modern-js/plugin-bff-build-extensions` to register the
+Effect runtime. It composes the native BFF plugin. Install
+`@modern-js/bff-effect` and `@modern-js/plugin-bff-extensions` from the same
+framework cohort as application production dependencies, so the adapter remains
+available after development dependencies are removed. The build plugin can be a
+development dependency. See the [runtime configuration example](/guides/advanced-features/bff/frameworks.md).
+
+Native `@modern-js/plugin-bff/server` exports Hono APIs. For Node Effect APIs,
+import framework helpers such as `defineEffectBff` from
+`@modern-js/bff-effect/effect` and namespaces from the corresponding `effect/*`
+modules. Worker handlers and worker request context use
+`@modern-js/bff-effect/effect-edge`.
+
 Generated UltraModern workspaces use this runtime as the only generated HTTP API
 path. The API contract lives at `shared/api.ts`, the server runtime lives at
 `api/index.ts`, clients live under `src/api/*-client.ts`, and generated checks
@@ -171,7 +183,6 @@ export default defineConfig({
     endpoint: '/_data/batch',
     maxBatchSize: 16,
     maxBatchBytes: 64 * 1024,
-    flushIntervalMs: 8,
     maxConcurrency: 4,
     requestTimeoutMs: 10000,
     allowedMethods: ['GET'],
@@ -205,9 +216,9 @@ export default defineConfig({
 });
 ```
 
-`batch.flushIntervalMs` controls the client-side micro-batch window in the generated Effect client. `maxConcurrency` and `requestTimeoutMs` are applied by the server batch gateway when dispatching items.
+`maxConcurrency` and `requestTimeoutMs` control the server batch gateway. Native `HttpApiClient` calls send individual requests; they do not automatically batch requests.
 
-The generated `api.client.*` API only exists for loader-materialized `@api/index` imports. Directly importing the server entry (`api/index`) exposes the Effect BFF definition; its `client` property is a placeholder that fails on operation access.
+Import a shared `HttpApi` contract and pass it to `HttpApiClient.make` or `makeEffectHttpApiClient`. The client is fully type-inferred; `defineEffectBff` exposes server handlers and does not contain a client.
 
 ## Effect cohort
 
@@ -242,7 +253,7 @@ Strict Effect APIs should test the declared `HttpApi` contract, not a raw
 request handler. Edge-compatible tests can use the framework helper:
 
 ```ts
-import { createEffectBffTestHandler } from '@modern-js/plugin-bff/effect-edge';
+import { createEffectBffTestHandler } from '@modern-js/bff-effect/effect-edge';
 import apiModule from '../api/index';
 
 const testApi = await createEffectBffTestHandler({
@@ -257,12 +268,9 @@ If you manually compose an Effect web handler in a low-level proof, provide the
 platform services explicitly:
 
 ```ts
-import {
-  HttpApiBuilder,
-  HttpRouter,
-  HttpServer,
-  Layer,
-} from '@modern-js/plugin-bff/effect-server';
+import * as Layer from 'effect/Layer';
+import { HttpRouter, HttpServer } from 'effect/unstable/http';
+import { HttpApiBuilder } from 'effect/unstable/httpapi';
 
 const handler = HttpRouter.toWebHandler(
   HttpApiBuilder.layer(api).pipe(
@@ -282,13 +290,10 @@ current Effect v4 beta cohort, `HttpRouter.middleware(...)` returns a `Layer`
 directly:
 
 ```ts
-import {
-  Effect,
-  HttpApiBuilder,
-  HttpMiddleware,
-  HttpRouter,
-  Layer,
-} from '@modern-js/plugin-bff/effect-server';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import { HttpMiddleware, HttpRouter } from 'effect/unstable/http';
+import { HttpApiBuilder } from 'effect/unstable/httpapi';
 
 const corsLayer = HttpRouter.middleware(
   Effect.succeed(

package/docs/guides/advanced-features/bff/data-platform.md

@@ -15,7 +15,7 @@ Modern.js Effect API runtime now supports a request-envelope based data platform
 
 ## Runtime contract helpers
 
-Use `@modern-js/plugin-bff/data-platform` helpers to build and validate contracts:
+Use `@modern-js/bff-effect/data-platform` helpers to build and validate contracts:
 
 ```ts
 import {
@@ -28,7 +28,7 @@ import {
   validateHydrationEnvelope,
   createInvalidationEvent,
   shouldApplyInvalidation,
-} from '@modern-js/plugin-bff/data-platform';
+} from '@modern-js/bff-effect/data-platform';
 ```
 
 ## Effect runtime validation

package/docs/guides/advanced-features/bff/frameworks.md

@@ -2,10 +2,10 @@
 
 # Runtime Framework
 
-Modern.js supports two BFF runtime frameworks:
+Modern.js and the UltraModern BFF extension provide two runtime frameworks:
 
-- `effect` (default): use [Effect HttpApi](https://effect.website/) runtime from `api/index`.
-- `hono`: use file-convention BFF handlers from `api/lambda/**`.
+- `hono` is the native plugin default and uses file-convention handlers from `api/lambda/**`.
+- `effect` is the UltraModern extension default and uses [Effect HttpApi](https://effect.website/) from `api/index`.
 
 `effect` and `hono` are strict runtime modes. There is no automatic fallback between them.
 
@@ -16,12 +16,18 @@ Generated UltraModern workspaces use strict Effect APIs: author HTTP APIs in
 
 ## Switch to Effect runtime
 
+Use the fork build plugin below. It includes the native BFF plugin and registers
+the Effect adapter. The application needs `@modern-js/bff-effect` and
+`@modern-js/plugin-bff-extensions` as production dependencies from the same
+framework cohort. Install the exact Effect peers described in
+[`bff.effect`](/configure/app/bff/effect.md).
+
 ```ts title="modern.config.ts"
-import { bffPlugin } from '@modern-js/plugin-bff';
-import { defineConfig } from '@modern-js/app-tools';
+import { bffPlugin } from '@modern-js/plugin-bff-build-extensions';
+import { appTools, defineConfig } from '@modern-js/app-tools';
 
 export default defineConfig({
-  plugins: [bffPlugin()],
+  plugins: [appTools(), bffPlugin()],
   bff: {
     runtimeFramework: 'effect',
     effect: {
@@ -43,7 +49,7 @@ import {
   HttpApiEndpoint,
   HttpApiGroup,
   Schema,
-} from '@modern-js/plugin-bff/effect-client';
+} from '@modern-js/bff-effect/effect-client';
 
 export const bffApi = HttpApi.make('MyApi').add(
   HttpApiGroup.make('hello').add(
@@ -57,14 +63,12 @@ export const bffApi = HttpApi.make('MyApi').add(
 Implement your Effect API entry at `api/index.ts`:
 
 ```ts title="api/index.ts"
-import {
-  Schema,
-  Effect,
-  HttpApiBuilder,
-  defineEffectBff,
-  Layer,
-  ServiceMap,
-} from '@modern-js/plugin-bff/effect-server';
+import { defineEffectBff } from '@modern-js/bff-effect/effect';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Schema from 'effect/Schema';
+import { HttpApiBuilder } from 'effect/unstable/httpapi';
 import { bffApi } from '../shared/api';
 
 class GreetingUnavailableError extends Schema.TaggedError<GreetingUnavailableError>()(
@@ -74,7 +78,7 @@ class GreetingUnavailableError extends Schema.TaggedError<GreetingUnavailableErr
   },
 ) {}
 
-class GreetingService extends ServiceMap.Service<GreetingService>()('GreetingService', {
+class GreetingService extends Context.Service<GreetingService>()('GreetingService', {
   make: Effect.succeed({
     hello: Effect.fn('GreetingService.hello')(function* () {
       if (Date.now() < 0) {
@@ -109,19 +113,27 @@ const layer = HttpApiBuilder.layer(bffApi).pipe(
 export default defineEffectBff({ api: bffApi, layer });
 ```
 
-Call Effect endpoints from browser code via `@api/index`:
+Create a native, fully inferred client from the shared contract:
 
 ```ts title="src/routes/page.tsx"
-import api from '@api/index';
+import { Effect, makeEffectHttpApiClient } from '@modern-js/bff-effect/effect-client';
+import { bffApi } from '../../shared/api';
 
-const response = await api.client.hello.ping({});
+const response = await Effect.runPromise(
+  makeEffectHttpApiClient(bffApi, { baseUrl: '/api' }).pipe(
+    Effect.flatMap(client => client.hello.ping({})),
+  ),
+);
 ```
 
-The `api.client.*` surface is materialized by the BFF loader for `@api/index` imports. Do not import `api/index` directly and expect `client` to run in server code, scripts, or tests; direct entry imports expose the server runtime definition, and `client` is only a typed placeholder there.
+Requests, responses, and declared errors are inferred from `bffApi`. No client generation or server-entry import is needed.
 
 For UltraModern, Effect `HttpApi` plus Effect BFF is the single blessed authored HTTP path. Use `HttpApi` endpoints with `query`, `params`, `payload`, `success`, and declared errors such as `HttpApiSchema.status(...)`; implement them with `HttpApiBuilder.group(...).handle(...)` and `HttpApiBuilder.layer(...).pipe(Layer.provide(...))`, then default-export the entry as `defineEffectBff({ api, layer })`. See `packages/server/bff-effect/tests/effect-edge-runtime.test.ts` for the live runtime shape.
 
-Hono and `api/lambda/**` are internal compatibility only and feature-frozen.
+Native Hono applications import operators from `@modern-js/plugin-bff/server`.
+UltraModern-generated applications keep their strict Effect API model. Worker
+handlers use `@modern-js/bff-effect/effect-edge`, including its worker request
+context exports; Node handlers use the Effect entry shown above.
 
 ### Getting Request Context
 
@@ -146,7 +158,7 @@ For more details, refer to [useHonoContext](/apis/app/runtime/bff/use-backend-co
 When getting cookies in BFF functions, you need to get the request context through `useHonoContext`, then use `c.req.header('cookie')` to get the Cookie string and parse it manually:
 
 ```ts title="api/lambda/cookies.ts"
-import { Api, Get } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get } from '@modern-js/plugin-bff/server';
 import { useHonoContext } from '@modern-js/server-runtime';
 
 // Helper function to parse Cookie string
@@ -189,7 +201,7 @@ The `c.req.cookie()` method does not exist in the current version. You need to u
 When using Hono as the runtime framework, you can define interfaces through [Api functions](/guides/advanced-features/bff/operators.md):
 
 ```ts title="api/lambda/user.ts"
-import { Api, Get, Query } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Query } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const QuerySchema = z.object({
@@ -218,7 +230,7 @@ For more details about Api functions and operators, refer to [Creating Extensibl
 Hono supports a rich middleware ecosystem, and you can use middleware in BFF functions:
 
 ```ts title="api/lambda/user.ts"
-import { Api, Get, Middleware } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Middleware } from '@modern-js/plugin-bff/server';
 
 export const getUser = Api(
   Get('/user'),

package/docs/guides/advanced-features/bff/function.md

@@ -246,7 +246,7 @@ Parameters following the dynamic path are an object called `RequestOption`, whic
 In a standard function without dynamic routes, `RequestOption` can be obtained from the first parameter, for example:
 
 ```ts title="api/lambda/hello.ts"
-import type { RequestOption } from '@modern-js/plugin-bff/hono-server';
+import type { RequestOption } from '@modern-js/plugin-bff/server';
 
 export async function post({
   query,
@@ -259,7 +259,7 @@ export async function post({
 Custom types can also be used here:
 
 ```ts title="api/lambda/hello.ts"
-import type { RequestOption } from '@modern-js/plugin-bff/hono-server';
+import type { RequestOption } from '@modern-js/plugin-bff/server';
 
 type IQuery = {
   // some types

package/docs/guides/advanced-features/bff/operators.md

@@ -29,7 +29,7 @@ A BFF function created by the `Api` function consists of the following parts:
 The server can define the input parameters and types of the interface. Based on the types, the server will automatically perform type validation at runtime:
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Post, Query, Data } from '@modern-js/plugin-bff/hono-server';
+import { Api, Post, Query, Data } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -78,7 +78,7 @@ addUser({
 As shown in the example below, you can specify the route and HTTP Method through the `Get` function:
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Get, Query, Data } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Query, Data } from '@modern-js/plugin-bff/server';
 
 // Specify the interface route, Modern.js sets `bff.prefix` to `/api` by default,
 // so the interface route is `/api/user`, and the HTTP Method is GET.
@@ -92,7 +92,7 @@ export const getHello = Api(
 When the route is not specified, the interface route is defined according to the file convention. As shown in the example below, with the function writing method, there is a code path `api/lambda/user.ts`, which will register the corresponding interface `/api/user`.
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Get, Query, Data } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Query, Data } from '@modern-js/plugin-bff/server';
 
 // No interface route specified, according to file convention and function name, the interface is api/user, HTTP Method is get.
 export const get = Api(Query(UserSchema), async ({ query }) => query);
@@ -125,7 +125,7 @@ Using the `Query` function, you can define the type of query. After using the `Q
 
 ```typescript title="api/lambda/user.ts"
 // Server-side code
-import { Api, Query } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -153,7 +153,7 @@ get({
 URL query parameters are strings by default. If you need numeric types, you need to use `z.coerce.number()` for type conversion:
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Get, Query } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Query } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const QuerySchema = z.object({
@@ -189,7 +189,7 @@ If you use the Data function, you must follow the HTTP protocol. When the HTTP M
 :::
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Data } from '@modern-js/plugin-bff/hono-server';
+import { Api, Data } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const DataSchema = z.object({
@@ -218,7 +218,7 @@ post({
 Route parameters can implement dynamic routes and get parameters from the path. You can specify path parameters through `Params<T>(schema: z.ZodType<T>)`
 
 ```typescript
-import { Api, Get, Params } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Params } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -239,7 +239,7 @@ export const queryUser = Api(
 You can define the request headers required by the interface through the `Headers<T>(schema: z.ZodType<T>)` function and pass the request headers through integrated calls:
 
 ```typescript
-import { Api, Headers } from '@modern-js/plugin-bff/hono-server';
+import { Api, Headers } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const headerSchema = z.object({
@@ -297,7 +297,7 @@ The `Middleware` operator can be configured multiple times, and the execution or
 :::
 
 ```typescript
-import { Api, Query, Middleware } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query, Middleware } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -333,7 +333,7 @@ The `Pipe` operator can be configured multiple times. The execution order of fun
 :::
 
 ```typescript
-import { Api, Query, Pipe } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query, Pipe } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -361,7 +361,7 @@ export const get = Api(
 Also,
 
 ```typescript
-import { Api, Query, Pipe } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query, Pipe } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -392,7 +392,7 @@ export const get = Api(
 If you need to do more custom operations on the response, you can pass a function to the `end` function. The input parameter of the function is Hono's Context (`c`), and you can operate on `c.req` and `c.res`:
 
 ```typescript
-import { Api, Query, Pipe } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query, Pipe } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -432,7 +432,7 @@ The following are response-related operators. Through response operators, you ca
 You can specify the status code returned by the interface through the `HttpCode(statusCode: number)` function
 
 ```typescript
-import { Api, Query, Data, HttpCode } from '@modern-js/plugin-bff/hono-server';
+import { Api, Query, Data, HttpCode } from '@modern-js/plugin-bff/server';
 import { z } from 'zod';
 
 const UserSchema = z.object({
@@ -464,7 +464,7 @@ export const post = Api(
 Supports setting response headers through the `SetHeaders(headers: Record<string, string>)` function
 
 ```typescript
-import { Api, Get, SetHeaders } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, SetHeaders } from '@modern-js/plugin-bff/server';
 
 export default Api(
   Get('/hello'),
@@ -480,7 +480,7 @@ export default Api(
 Supports redirecting the interface through `Redirect(url: string)`:
 
 ```typescript
-import { Api, Get, Redirect } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Redirect } from '@modern-js/plugin-bff/server';
 
 export default Api(
   Get('/hello'),
@@ -494,7 +494,7 @@ export default Api(
 As mentioned above, through operators, you can get `query`, `data`, `params`, etc. in the input parameters of the interface processing function. But sometimes we need to get more request context information. At this time, we can get it through [`useHonoContext`](/apis/app/runtime/bff/use-backend-context.md):
 
 ```typescript title="api/lambda/user.ts"
-import { Api, Get, Query } from '@modern-js/plugin-bff/hono-server';
+import { Api, Get, Query } from '@modern-js/plugin-bff/server';
 import { useHonoContext } from '@modern-js/server-runtime';
 import { z } from 'zod';
 
@@ -539,7 +539,7 @@ For specific comparisons of different solutions, you can refer to [Why Use Zod](
 In frontend development, some server interfaces (such as some configuration interfaces) have long response times, but actually don't need to be updated for a long time. For such interfaces, we can set HTTP cache to improve page performance:
 
 ```typescript
-import { Api, SetHeaders } from '@modern-js/plugin-bff/hono-server';
+import { Api, SetHeaders } from '@modern-js/plugin-bff/server';
 
 export const get = Api(
   // Cache will only take effect when using integrated calls or fetch for requests