@mainset/cli 0.2.1-rc.2 → 0.3.0-rc.1

package/dist/esm/commands/web-app.mjs

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import { initDotenv } from '../dotenv-config.mjs';
 import { resolveHostPackageBinForCLICommandPath, runtimePathById, } from '../runtime/index.mjs';
 import { consoleColorize, execImmediateCommand, initProcessCatchErrorLogger, runStreamingCommand, runStreamingInSync, } from '../utils/index.mjs';
 import { execImmediatePurgeDist } from './process-runner-chunks/index.mjs';
@@ -16,6 +17,9 @@ function registerWebAppCommand(program) {
         .option('-c, --config <path>', 'Path to config file')
         .option('--serveMode <mode>', 'Serve mode: ssr or csr (default: ssr)', 'ssr')
         .action((options) => {
+        // !IMPORTANT: Load environment variables from .env file ONLY when we are compiling Web Applications
+        // as it logs {missing .env file} console error during {course-code} / {node-package} compilation
+        initDotenv();
         // Step 0: determinate command params
         const customWebpackConfigPath = path.resolve(runtimePathById.root, options.config || './config/webpack.config.mjs');
         // SSR server path
@@ -44,7 +48,7 @@ function registerWebAppCommand(program) {
                     execImmediatePurgeDist();
                     // Step 2: build:ssr-webapp source code
                     console.log('\n📦 Compiling SSR WebApp with Webpack ...');
-                    execImmediateCommand(`${webpackCLICommandPath} --config ${webpackSSRConfigPath}`);
+                    execImmediateCommand(`MS_CLI__WEBPACK_SERVE_MODE=ssr ${webpackCLICommandPath} --config ${webpackSSRConfigPath}`);
                     /*
                     // Step 3: build:ssr-server source code
                     console.log('\n📦 Compiling SSR Server with Rslib ...');
@@ -61,7 +65,7 @@ function registerWebAppCommand(program) {
                     execImmediatePurgeDist();
                     // Step 2: build:csr-webapp source code
                     console.log('\n📦 Compiling CSR WebApp with Webpack ...');
-                    execImmediateCommand(`${webpackCLICommandPath} --config ${webpackCSRConfigPath}`);
+                    execImmediateCommand(`MS_CLI__WEBPACK_SERVE_MODE=csr ${webpackCLICommandPath} --config ${webpackCSRConfigPath}`);
                     console.log('\n✅ CSR Build completed successfully\n');
                 }
             }
@@ -88,11 +92,9 @@ function registerWebAppCommand(program) {
                     runStreamingInSync([
                         // Step 2: watch:ssr-webapp source code of web app
                         {
-                            runCommand: () => runStreamingCommand(webpackCLICommandPath, [
-                                '--config',
-                                webpackSSRConfigPath,
-                                '--watch',
-                            ]),
+                            runCommand: () => runStreamingCommand(webpackCLICommandPath, ['--config', webpackSSRConfigPath, '--watch'], {
+                                env: Object.assign(Object.assign({}, process.env), { MS_CLI__WEBPACK_SERVE_MODE: 'ssr' }),
+                            }),
                             waitForOutput: 'compiled successfully',
                         },
                         // Step 3: start:ssr-server which is compiled web app and ssr-server code
@@ -112,12 +114,9 @@ function registerWebAppCommand(program) {
                         ? customWebpackConfigPath
                         : path.resolve(runtimePathById.root, 'node_modules', '@mainset/bundler-webpack/dist/esm/webpack-config/dev-server.csr.config.mjs');
                     // Step 1: watch:csr-server / start:csr-server source code
-                    runStreamingCommand(webpackCLICommandPath, [
-                        'serve',
-                        '--config',
-                        webpackDevServerConfigPath,
-                        '--open',
-                    ]);
+                    runStreamingCommand(webpackCLICommandPath, ['serve', '--config', webpackDevServerConfigPath, '--open'], {
+                        env: Object.assign(Object.assign({}, process.env), { MS_CLI__WEBPACK_SERVE_MODE: 'csr' }),
+                    });
                 }
             }
             catch (error) {
@@ -142,10 +141,13 @@ function registerWebAppCommand(program) {
                     // ========== [Serve Static] CSR mode ==========
                     // Step 1: determinate command params
                     const serverEntryPath = path.resolve(runtimePathById.msCLISrc, '../services/serve-static/serve-static.mjs');
-                    const customServeStaticConfigPath = path.resolve(runtimePathById.root, options.config || './config/serve-static.config.json');
-                    const serveStaticConfigPath = fs.existsSync(customServeStaticConfigPath)
-                        ? customServeStaticConfigPath
-                        : path.resolve(runtimePathById.msCLISrc, '../services/express-base-app/express-base-app.config.json');
+                    const customServeStaticMjsConfigPath = path.resolve(runtimePathById.root, options.config || './config/serve-static.config.mjs');
+                    const customServeStaticJsonConfigPath = path.resolve(runtimePathById.root, './config/serve-static.config.json');
+                    const serveStaticConfigPath = (fs.existsSync(customServeStaticMjsConfigPath) &&
+                        customServeStaticMjsConfigPath) ||
+                        (fs.existsSync(customServeStaticJsonConfigPath) &&
+                            customServeStaticJsonConfigPath) ||
+                        path.resolve(runtimePathById.msCLISrc, '../services/express-base-app/express-base-app.config.json');
                     // Step 2: serve static compiled files
                     runStreamingCommand('node', [
                         serverEntryPath,

package/dist/esm/dotenv-config.mjs

@@ -0,0 +1,9 @@
+import dotenv from '@dotenvx/dotenvx';
+function initDotenv() {
+    // Load environment-specific .env file
+    return dotenv.config();
+}
+// REVIEW: investigate if {.env} file need's to be loaded during {course-code} / {node-package} compilation
+// Auto-execute configuration
+// initDotenv();
+export { initDotenv };

package/dist/esm/runtime/index.mjs

@@ -1,3 +1,4 @@
 export { NODE_ENV } from './constants.mjs';
+export { parseCliOptions } from './parse-cli-options.mjs';
 export { runtimePathById } from './path.mjs';
 export { resolveHostPackageBinForCLICommandPath, resolveHostPackageNodeModulesPath, } from './resolve-host-package.mjs';

package/dist/esm/runtime/parse-cli-options.mjs

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+function parseCliOptions(options) {
+    const program = new Command();
+    options.forEach(({ commanderFlags, description }) => {
+        program.option(commanderFlags, description);
+    });
+    return program
+        .allowUnknownOption() // Bypass {error: unknown option '--config'}
+        .allowExcessArguments() // Bypass {error: too many arguments. Expected 0 arguments but got 2.}
+        .parse(process.argv)
+        .opts();
+}
+export { parseCliOptions };

package/dist/esm/services/express-base-app/express-base-app.mjs

@@ -1,17 +1,20 @@
 import express from 'express';
+import { createProxyMiddleware } from 'http-proxy-middleware';
 import path from 'path';
-// Import type { Options } from 'http-proxy-middleware';
 import { runtimePathById } from '../../runtime/index.mjs';
 import defaultExpressConfig from './express-base-app.config.json' with { type: 'json' };
 class ExpressBaseApp {
     // ========== Constructor ==========
     constructor(customExpressConfig = {}) {
-        const { listenPort = defaultExpressConfig.listenPort, serveStatics } = customExpressConfig;
+        const { listenPort = defaultExpressConfig.listenPort, serveStatics = defaultExpressConfig.serveStatics, proxyConfigByPath, } = customExpressConfig;
         this.listenPort = listenPort;
         this.app = express();
         this.appUseStatic({
             serveStatics,
         });
+        this.appUseProxyMiddleware({
+            proxyConfigByPath,
+        });
         this.startListening = this.startListening.bind(this);
     }
     // ========== Private ==========
@@ -21,11 +24,12 @@ class ExpressBaseApp {
             this.app.use(serveStaticConfig.publicPath, express.static(serveStaticConfig.rootPath));
         });
     }
-    // Private appUseProxy() {
-    //   app.use('/api', createProxyMiddleware(proxyConfig['/api/']));
-    //   app.use('/api-local', createProxyMiddleware(proxyConfig['/api-local/']));
-    //   app.use('/api-boilerplate', createProxyMiddleware(proxyConfig['/api-boilerplate/']));
-    // }
+    appUseProxyMiddleware({ proxyConfigByPath = {}, }) {
+        var _a;
+        (_a = Object.keys(proxyConfigByPath)) === null || _a === void 0 ? void 0 : _a.forEach((proxyPath) => {
+            this.app.use(proxyPath, createProxyMiddleware(proxyConfigByPath[proxyPath]));
+        });
+    }
     // ========== Public ==========
     startListening() {
         this.app.listen(this.listenPort, async () => {

package/dist/esm/services/serve-static/serve-static-config-loader.mjs

@@ -1,14 +1,17 @@
-import { Command } from 'commander';
 import fs from 'fs';
+import { parseCliOptions } from '../../runtime/index.mjs';
 // Step-1: parse CLI arguments
-const options = new Command()
-    .option('--serveStaticConfig <path>', 'Path to ./config/serve-static.config.json config file')
-    .allowUnknownOption() // Bypass {error: unknown option '--config'}
-    .allowExcessArguments() // Bypass {error: too many arguments. Expected 0 arguments but got 2.}
-    .parse(process.argv)
-    .opts();
+const options = parseCliOptions([
+    {
+        commanderFlags: '--serveStaticConfig <path>',
+        description: 'Path to ./config/serve-static.config.{mjs,json} config file',
+    },
+]);
 // Step-2: load Serve Static config from JSON file
-const serveStaticConfig = options.serveStaticConfig
-    ? JSON.parse(fs.readFileSync(options.serveStaticConfig, 'utf-8'))
-    : {};
+const isConfigFileJsonWithoutProcessEnvUsage = /\.json$/.test(options.serveStaticConfig);
+const serveStaticConfig = isConfigFileJsonWithoutProcessEnvUsage
+    ? JSON.parse(fs.readFileSync(options.serveStaticConfig, 'utf-8') ||
+        // NOTE: dot not crash in case if {.json} file is empty
+        '{}')
+    : (await import(options.serveStaticConfig)).default;
 export { serveStaticConfig };

package/dist/esm/services/ssr-server/ssr-server-config-loader.mjs

@@ -1,11 +1,11 @@
-import { Command } from 'commander';
+import { parseCliOptions } from '../../runtime/index.mjs';
 // Step-1: parse CLI arguments
-const options = new Command()
-    .option('--ssrServerConfig <path>', 'Path to ./config/ssr-server.config.mts config file')
-    .allowUnknownOption() // Bypass {error: unknown option '--config'}
-    .allowExcessArguments() // Bypass {error: too many arguments. Expected 0 arguments but got 2.}
-    .parse(process.argv)
-    .opts();
+const options = parseCliOptions([
+    {
+        commanderFlags: '--ssrServerConfig <path>',
+        description: 'Path to ./config/ssr-server.config.mts config file',
+    },
+]);
 // Step-2: load SSR server config from JSON file
 const ssrServerConfig = (await import(options.ssrServerConfig))
     .default;

package/dist/esm/utils/process-runner/process-runner.mjs

@@ -36,12 +36,9 @@ function execImmediateCommand(fullCommandString) {
  *
  * Example: runStreamingCommand('rspack', ['serve', '--config', './config/rspack.config.ts']);
  */
-function runStreamingCommand(command, args) {
+function runStreamingCommand(command, args, options = {}) {
     try {
-        const child = spawn(command, args, {
-            stdio: 'inherit',
-            shell: true,
-        });
+        const child = spawn(command, args, Object.assign({ stdio: 'inherit', shell: true }, options));
         // Track the process using ProcessManager as it could live in the background after crashing
         // Examples: server stacks when files removed while server is running
         // 1. rm -rf ./dist

package/dist/types/dotenv-config.d.mts

@@ -0,0 +1,3 @@
+import dotenv from '@dotenvx/dotenvx';
+declare function initDotenv(): dotenv.DotenvConfigOutput;
+export { initDotenv };

package/dist/types/runtime/index.d.mts

@@ -1,4 +1,5 @@
 export { NODE_ENV } from './constants.mjs';
 export type { NodeEnv } from './constants.mjs';
+export { parseCliOptions } from './parse-cli-options.mjs';
 export { runtimePathById } from './path.mjs';
 export { resolveHostPackageBinForCLICommandPath, resolveHostPackageNodeModulesPath, } from './resolve-host-package.mjs';

package/dist/types/runtime/parse-cli-options.d.mts

@@ -0,0 +1,6 @@
+type ParseCliOptionDescriptor = {
+    commanderFlags: string;
+    description?: string;
+};
+declare function parseCliOptions(options: ParseCliOptionDescriptor[]): import("commander").OptionValues;
+export { parseCliOptions };

package/dist/types/services/express-base-app/express-base-app.d.mts

@@ -1,4 +1,5 @@
 import { Express } from 'express';
+import type { Options } from 'http-proxy-middleware';
 interface ServeStaticConfig {
     rootPath?: string;
     publicPath?: string;
@@ -6,12 +7,14 @@ interface ServeStaticConfig {
 interface ExpressBaseAppConfig {
     listenPort?: number;
     serveStatics?: ServeStaticConfig[];
+    proxyConfigByPath?: Record<string, Options>;
 }
 declare class ExpressBaseApp {
     private readonly listenPort;
     readonly app: Express;
     constructor(customExpressConfig?: Partial<ExpressBaseAppConfig>);
     private appUseStatic;
+    private appUseProxyMiddleware;
     startListening(): void;
 }
 export { ExpressBaseApp };

package/dist/types/utils/process-runner/process-runner.d.mts

@@ -1,3 +1,4 @@
+import type { SpawnOptions } from 'child_process';
 declare function initProcessCatchErrorLogger(commandName: string, error: Error | unknown, commandParam?: string): void;
 /**
  * Executes a short-lived command synchronously.
@@ -12,7 +13,7 @@ declare function execImmediateCommand(fullCommandString: string): void;
  *
  * Example: runStreamingCommand('rspack', ['serve', '--config', './config/rspack.config.ts']);
  */
-declare function runStreamingCommand(command: string, args: string[]): import("child_process").ChildProcess | undefined;
+declare function runStreamingCommand(command: string, args: string[], options?: SpawnOptions): import("child_process").ChildProcess | undefined;
 /**
  * Runs a streaming command in sync mode.
  * This is a placeholder function and does not execute any command.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mainset/cli",
-  "version": "0.2.1-rc.2",
+  "version": "0.3.0-rc.1",
   "description": "A unified CLI tool for accelerating development, based on mainset vision of front-end infrastructure",
   "homepage": "https://github.com/mainset/dev-stack-fe/tree/main/packages/cli",
   "bugs": {
@@ -31,6 +31,7 @@
     "ms-cli": "./dist/esm/mainset-cli.mjs"
   },
   "dependencies": {
+    "@dotenvx/dotenvx": "^1.47.2",
     "@types/node": "^24.0.3",
     "commander": "^14.0.0",
     "cors": "^2.8.5",
@@ -42,10 +43,10 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
     "@types/node": "^24.0.3",
-    "@mainset/dev-stack-fe": "^0.1.1"
+    "@mainset/dev-stack-fe": "^0.2.0-rc.1"
   },
   "peerDependencies": {
-    "@mainset/dev-stack-fe": "^0.1.1"
+    "@mainset/dev-stack-fe": "^0.2.0"
   },
   "scripts": {
     "build:source": "node ./node_modules/@mainset/dev-stack-fe/node_modules/typescript/bin/tsc --project ./tsconfig.json",