feat: add config server outputPath option

README.md

@@ -156,14 +156,16 @@ All server settings are used only in dev mode:
 
 - `port` (`number | true`) — specify port that server listens. The port will be used to
   pass through requests from the client to the server. If set to `true`, the port will be selected automatically.
-  The server is started with the command `APP_PORT=${port} node dist/server/index.js --port ${port}`.
+  The server is started with the command `APP_PORT=${port} node dist/${outputPath}/index.js --port ${port}`.
 - `watch` (`string[]`) — by default `app-builder` monitors only `src/server` directory.
   If you need to watch other directories, specify them here.
 - `watchThrottle` (`number`) — use to add an extra throttle, or delay restarting.
 - `inspect/inspectBrk` (`number | true`) — listen for a debugging client on specified port.
   If specified `true`, try to listen on `9229`.
 - `compiler` (`'typescript' | 'swc'`) — choose TypeScript compiler for server code compilation.
   Default is `'typescript'`. Set to `'swc'` for faster compilation with SWC.
+- `outputPath` (`string`) — custom output path for compiled server code relative to `dist` directory.
+  Default: `server`. Use this when your `server` entrypoint changed from `dist/server` to a different location (e.g., `package/src/server` for path `dist/package/src/server` in monorepo setups).
 
 ### Client
 

src/commands/dev/index.ts

@@ -1,12 +1,10 @@
-import * as path from 'node:path';
 import * as fs from 'node:fs';
 import nodemon from 'nodemon';
 import {onExit} from 'signal-exit';
 import {rimraf} from 'rimraf';
 
 import {createRunFolder, getAppRunPath, shouldCompileTarget} from '../../common/utils';
 import logger from '../../common/logger';
-import paths from '../../common/paths';
 
 import type WebpackDevServer from 'webpack-dev-server';
 import type {NormalizedServiceConfig} from '../../common/models';
@@ -38,7 +36,7 @@ export default async function (config: NormalizedServiceConfig) {
     let serverCompiled = !shouldCompileServer;
     let needToStartNodemon = shouldCompileServer;
 
-    const serverPath = path.resolve(paths.appDist, 'server');
+    const serverPath = config.server.outputPath;
     const {inspect, inspectBrk} = config.server;
 
     const startNodemon = () => {

src/commands/dev/server.ts

@@ -1,4 +1,3 @@
-import * as path from 'node:path';
 import {rimraf} from 'rimraf';
 
 import {ControllableScript} from '../../common/child-process/controllable-script';
@@ -58,7 +57,7 @@ watch(
 export async function watchServerCompilation(
     config: NormalizedServiceConfig,
 ): Promise<ControllableScript> {
-    const serverPath = path.resolve(paths.appDist, 'server');
+    const serverPath = config.server.outputPath;
     rimraf.sync(serverPath);
 
     const build = new ControllableScript(

src/common/config.ts

@@ -5,6 +5,7 @@
 import {stripIndent} from 'common-tags';
 
 import {isLibraryConfig, isServiceConfig} from './models';
+import paths from './paths';
 
 import type {Loader} from 'cosmiconfig';
 import type {CosmiconfigResult} from 'cosmiconfig/dist/types';
@@ -23,16 +24,16 @@
 import {getPort, hasMFAssetsIsolation} from './utils';
 import logger from './logger';
 
 function splitPaths(paths: string | string[]) {
     return (Array.isArray(paths) ? paths : [paths]).flatMap((p) => p.split(','));
 }
 
 function remapPaths(paths: string | string[]) {
     return splitPaths(paths).map((p) => path.resolve(process.cwd(), p));
 }
 
 function omitUndefined<T extends object>(obj: T) {
     const newObj: Record<string, any> = {};
     for (const [key, value] of Object.entries(obj)) {
         if (value !== undefined) {
             newObj[key] = value;
@@ -177,6 +178,10 @@
             inspect: undefined,
             inspectBrk: undefined,
             compiler: serverConfig.compiler || 'typescript',
+            outputPath: path.resolve(
+                paths.appDist,
+                serverConfig.outputPath ? serverConfig.outputPath : 'server',
+            ),
         };
         if (mode === 'dev') {
             if (serverConfig.port === true) {

src/common/models/index.ts

@@ -402,6 +402,14 @@ export interface ServerConfig {
         additionalPaths?: string[];
         exclude?: string | string[];
     };
+
+    /**
+     * Custom output path for compiled server code.
+     * Can be only relative to dist path.
+     * @default 'server'
+     * @example 'package/src/server'
+     */
+    outputPath?: string;
 }
 export interface ServiceConfig {
     target?: 'client' | 'server';
@@ -476,13 +484,14 @@ export type NormalizedClientConfig = Omit<
 
 export type NormalizedServerConfig = Omit<
     ServerConfig,
-    'port' | 'inspect' | 'inspectBrk' | 'compiler'
+    'port' | 'inspect' | 'inspectBrk' | 'compiler' | 'outputPath'
 > & {
     port?: number;
     verbose?: boolean;
     inspect?: number;
     inspectBrk?: number;
     compiler: ServerCompiler;
+    outputPath: string;
 };
 
 export type NormalizedServiceConfig = Omit<ServiceConfig, 'client' | 'server'> & {