frontmcp 0.6.0 → 0.6.1

package/README.md

@@ -14,6 +14,7 @@ _Made with ❤️ for TypeScript developers_
 [![NPM - @frontmcp/sdk](https://img.shields.io/npm/v/@frontmcp/sdk.svg?v=2)](https://www.npmjs.com/package/@frontmcp/sdk)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white)](https://nodejs.org)
 [![License](https://img.shields.io/github/license/agentfront/frontmcp.svg?v=1)](https://github.com/agentfront/frontmcp/blob/main/LICENSE)
+[![Snyk](https://snyk.io/test/github/agentfront/frontmcp/badge.svg)](https://snyk.io/test/github/agentfront/frontmcp)
 
 </div>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -26,13 +26,14 @@
     "frontmcp": "./src/cli.js"
   },
   "dependencies": {
-    "tslib": "^2.3.0"
+    "tslib": "^2.3.0",
+    "@rspack/core": "^1.3.12"
   },
   "devDependencies": {
     "typescript": "^5.5.3",
     "tsx": "^4.20.6",
     "@types/node": "^24.0.0",
-    "@modelcontextprotocol/inspector": "^0.17.2"
+    "@modelcontextprotocol/inspector": "^0.18.0"
   },
   "types": "./src/index.d.ts",
   "type": "commonjs"

package/src/commands/build/adapters/lambda.d.ts

@@ -1,11 +1,17 @@
 import { AdapterTemplate } from '../types';
 /**
  * AWS Lambda adapter - serverless deployment on AWS Lambda.
- * Compiles to ESM and uses @codegenie/serverless-express to wrap the Express app.
+ * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.
  *
  * Prerequisites:
  *   npm install @codegenie/serverless-express
  *
+ * The build process:
+ * 1. TypeScript compiles to ESM in dist/
+ * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)
+ * 3. index.js imports setup first, then main module
+ * 4. rspack bundles everything into handler.cjs
+ *
  * @see https://github.com/codegenie/serverless-express
  */
 export declare const lambdaAdapter: AdapterTemplate;

package/src/commands/build/adapters/lambda.js

@@ -3,23 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.lambdaAdapter = void 0;
 /**
  * AWS Lambda adapter - serverless deployment on AWS Lambda.
- * Compiles to ESM and uses @codegenie/serverless-express to wrap the Express app.
+ * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.
  *
  * Prerequisites:
  *   npm install @codegenie/serverless-express
  *
+ * The build process:
+ * 1. TypeScript compiles to ESM in dist/
+ * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)
+ * 3. index.js imports setup first, then main module
+ * 4. rspack bundles everything into handler.cjs
+ *
  * @see https://github.com/codegenie/serverless-express
  */
 exports.lambdaAdapter = {
     moduleFormat: 'esnext',
+    shouldBundle: true,
+    bundleOutput: 'handler.cjs',
+    getSetupTemplate: () => `// Serverless environment setup - MUST be imported first
+// This sets FRONTMCP_SERVERLESS before any decorators run
+// Required because ESM hoists imports before other statements
+process.env.FRONTMCP_SERVERLESS = '1';
+`,
     getEntryTemplate: (mainModulePath) => `// Auto-generated AWS Lambda entry point
 // Generated by: frontmcp build --adapter lambda
 //
 // IMPORTANT: This adapter requires @codegenie/serverless-express
 // Install it with: npm install @codegenie/serverless-express
 //
-process.env.FRONTMCP_SERVERLESS = '1';
-
+import './serverless-setup.js';
 import '${mainModulePath}';
 import { getServerlessHandlerAsync } from '@frontmcp/sdk';
 import serverlessExpress from '@codegenie/serverless-express';

package/src/commands/build/adapters/lambda.js.map

@@ -1 +1 @@
-{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/lambda.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IAEtB,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;;;;UAQtC,cAAc;;;;;;;;;;;;;;;;;CAiBvB;IAEC,qEAAqE;CACtE,CAAC","sourcesContent":["import { AdapterTemplate } from '../types';\n\n/**\n * AWS Lambda adapter - serverless deployment on AWS Lambda.\n * Compiles to ESM and uses @codegenie/serverless-express to wrap the Express app.\n *\n * Prerequisites:\n *   npm install @codegenie/serverless-express\n *\n * @see https://github.com/codegenie/serverless-express\n */\nexport const lambdaAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated AWS Lambda entry point\n// Generated by: frontmcp build --adapter lambda\n//\n// IMPORTANT: This adapter requires @codegenie/serverless-express\n// Install it with: npm install @codegenie/serverless-express\n//\nprocess.env.FRONTMCP_SERVERLESS = '1';\n\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\nimport serverlessExpress from '@codegenie/serverless-express';\n\nlet serverlessExpressInstance = null;\n\nasync function setup() {\n  const app = await getServerlessHandlerAsync();\n  serverlessExpressInstance = serverlessExpress({ app });\n}\n\nexport const handler = async (event, context) => {\n  if (!serverlessExpressInstance) {\n    await setup();\n  }\n  return serverlessExpressInstance(event, context);\n};\n`,\n\n  // No config file - user manages serverless.yml, SAM template, or CDK\n};\n"]}
+{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/lambda.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,aAAa;IAE3B,gBAAgB,EAAE,GAAG,EAAE,CAAC;;;;CAIzB;IAEC,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;;;UAOtC,cAAc;;;;;;;;;;;;;;;;;CAiBvB;IAEC,qEAAqE;CACtE,CAAC","sourcesContent":["import { AdapterTemplate } from '../types';\n\n/**\n * AWS Lambda adapter - serverless deployment on AWS Lambda.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * Prerequisites:\n *   npm install @codegenie/serverless-express\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n *\n * @see https://github.com/codegenie/serverless-express\n */\nexport const lambdaAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated AWS Lambda entry point\n// Generated by: frontmcp build --adapter lambda\n//\n// IMPORTANT: This adapter requires @codegenie/serverless-express\n// Install it with: npm install @codegenie/serverless-express\n//\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\nimport serverlessExpress from '@codegenie/serverless-express';\n\nlet serverlessExpressInstance = null;\n\nasync function setup() {\n  const app = await getServerlessHandlerAsync();\n  serverlessExpressInstance = serverlessExpress({ app });\n}\n\nexport const handler = async (event, context) => {\n  if (!serverlessExpressInstance) {\n    await setup();\n  }\n  return serverlessExpressInstance(event, context);\n};\n`,\n\n  // No config file - user manages serverless.yml, SAM template, or CDK\n};\n"]}

package/src/commands/build/adapters/vercel.d.ts

@@ -1,7 +1,13 @@
 import { AdapterTemplate } from '../types';
 /**
  * Vercel adapter - serverless deployment on Vercel.
- * Compiles to ESM and generates a handler that exports the Express app.
+ * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.
+ *
+ * The build process:
+ * 1. TypeScript compiles to ESM in dist/
+ * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)
+ * 3. index.js imports setup first, then main module
+ * 4. rspack bundles everything into handler.cjs
  *
  * @see https://vercel.com/docs/frameworks/express
  */

package/src/commands/build/adapters/vercel.js

@@ -3,16 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.vercelAdapter = void 0;
 /**
  * Vercel adapter - serverless deployment on Vercel.
- * Compiles to ESM and generates a handler that exports the Express app.
+ * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.
+ *
+ * The build process:
+ * 1. TypeScript compiles to ESM in dist/
+ * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)
+ * 3. index.js imports setup first, then main module
+ * 4. rspack bundles everything into handler.cjs
  *
  * @see https://vercel.com/docs/frameworks/express
  */
 exports.vercelAdapter = {
     moduleFormat: 'esnext',
+    shouldBundle: true,
+    bundleOutput: 'handler.cjs',
+    getSetupTemplate: () => `// Serverless environment setup - MUST be imported first
+// This sets FRONTMCP_SERVERLESS before any decorators run
+// Required because ESM hoists imports before other statements
+process.env.FRONTMCP_SERVERLESS = '1';
+`,
     getEntryTemplate: (mainModulePath) => `// Auto-generated Vercel entry point
 // Generated by: frontmcp build --adapter vercel
-process.env.FRONTMCP_SERVERLESS = '1';
-
+import './serverless-setup.js';
 import '${mainModulePath}';
 import { getServerlessHandlerAsync } from '@frontmcp/sdk';
 
@@ -28,8 +40,8 @@ export default async function handler(req, res) {
 `,
     getConfig: () => ({
         version: 2,
-        builds: [{ src: 'dist/index.js', use: '@vercel/node' }],
-        routes: [{ src: '/(.*)', dest: '/dist/index.js' }],
+        builds: [{ src: 'dist/handler.cjs', use: '@vercel/node' }],
+        routes: [{ src: '/(.*)', dest: '/dist/handler.cjs' }],
     }),
     configFileName: 'vercel.json',
 };

package/src/commands/build/adapters/vercel.js.map

@@ -1 +1 @@
-{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/vercel.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IAEtB,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;UAItC,cAAc;;;;;;;;;;;;CAYvB;IAEC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;QACvD,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;KACnD,CAAC;IAEF,cAAc,EAAE,aAAa;CAC9B,CAAC","sourcesContent":["import { AdapterTemplate } from '../types';\n\n/**\n * Vercel adapter - serverless deployment on Vercel.\n * Compiles to ESM and generates a handler that exports the Express app.\n *\n * @see https://vercel.com/docs/frameworks/express\n */\nexport const vercelAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Vercel entry point\n// Generated by: frontmcp build --adapter vercel\nprocess.env.FRONTMCP_SERVERLESS = '1';\n\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\n\nlet handlerPromise = null;\n\nexport default async function handler(req, res) {\n  if (!handlerPromise) {\n    handlerPromise = getServerlessHandlerAsync();\n  }\n  const app = await handlerPromise;\n  return app(req, res);\n}\n`,\n\n  getConfig: () => ({\n    version: 2,\n    builds: [{ src: 'dist/index.js', use: '@vercel/node' }],\n    routes: [{ src: '/(.*)', dest: '/dist/index.js' }],\n  }),\n\n  configFileName: 'vercel.json',\n};\n"]}
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/vercel.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,aAAa;IAE3B,gBAAgB,EAAE,GAAG,EAAE,CAAC;;;;CAIzB;IAEC,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;UAGtC,cAAc;;;;;;;;;;;;CAYvB;IAEC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;QAC1D,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;KACtD,CAAC;IAEF,cAAc,EAAE,aAAa;CAC9B,CAAC","sourcesContent":["import { AdapterTemplate } from '../types';\n\n/**\n * Vercel adapter - serverless deployment on Vercel.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n *\n * @see https://vercel.com/docs/frameworks/express\n */\nexport const vercelAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Vercel entry point\n// Generated by: frontmcp build --adapter vercel\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\n\nlet handlerPromise = null;\n\nexport default async function handler(req, res) {\n  if (!handlerPromise) {\n    handlerPromise = getServerlessHandlerAsync();\n  }\n  const app = await handlerPromise;\n  return app(req, res);\n}\n`,\n\n  getConfig: () => ({\n    version: 2,\n    builds: [{ src: 'dist/handler.cjs', use: '@vercel/node' }],\n    routes: [{ src: '/(.*)', dest: '/dist/handler.cjs' }],\n  }),\n\n  configFileName: 'vercel.json',\n};\n"]}

package/src/commands/build/bundler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Bundle the serverless entry point into a single CJS file using rspack.
+ * This resolves ESM/CJS compatibility issues and dynamic import problems.
+ *
+ * @param entryPath - Absolute path to the entry file (e.g., dist/index.js)
+ * @param outDir - Output directory for the bundled file
+ * @param outputFilename - Name of the output bundle (e.g., 'handler.cjs')
+ */
+export declare function bundleForServerless(entryPath: string, outDir: string, outputFilename: string): Promise<void>;

package/src/commands/build/bundler.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleForServerless = bundleForServerless;
+const core_1 = require("@rspack/core");
+const colors_1 = require("../../colors");
+/**
+ * Bundle the serverless entry point into a single CJS file using rspack.
+ * This resolves ESM/CJS compatibility issues and dynamic import problems.
+ *
+ * @param entryPath - Absolute path to the entry file (e.g., dist/index.js)
+ * @param outDir - Output directory for the bundled file
+ * @param outputFilename - Name of the output bundle (e.g., 'handler.cjs')
+ */
+async function bundleForServerless(entryPath, outDir, outputFilename) {
+    const compiler = (0, core_1.rspack)({
+        mode: 'production',
+        target: 'node',
+        entry: entryPath,
+        output: {
+            path: outDir,
+            filename: outputFilename,
+            library: { type: 'commonjs2' },
+            clean: false,
+        },
+        // Use node externals preset for built-in modules
+        externalsPresets: { node: true },
+        // Exclude problematic optional dependencies
+        externals: {
+            '@swc/core': '@swc/core',
+            fsevents: 'fsevents',
+            esbuild: 'esbuild',
+        },
+        resolve: {
+            extensions: ['.js', '.mjs', '.cjs', '.json'],
+        },
+        // Don't minimize to preserve readability for debugging
+        optimization: {
+            minimize: false,
+        },
+        // Suppress verbose output
+        stats: 'errors-warnings',
+    });
+    return new Promise((resolve, reject) => {
+        compiler.run((err, stats) => {
+            if (err) {
+                return reject(err);
+            }
+            if (stats?.hasErrors()) {
+                const info = stats.toJson();
+                const errorMessages = info.errors?.map((e) => e.message).join('\n') || 'Unknown error';
+                return reject(new Error(`Bundle failed:\n${errorMessages}`));
+            }
+            if (stats?.hasWarnings()) {
+                const info = stats.toJson();
+                info.warnings?.forEach((w) => {
+                    console.log((0, colors_1.c)('yellow', `  Warning: ${w.message}`));
+                });
+            }
+            compiler.close((closeErr) => {
+                if (closeErr) {
+                    console.log((0, colors_1.c)('yellow', `  Warning closing compiler: ${closeErr.message}`));
+                }
+                resolve();
+            });
+        });
+    });
+}
+//# sourceMappingURL=bundler.js.map

package/src/commands/build/bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../../../src/commands/build/bundler.ts"],"names":[],"mappings":";;AAWA,kDA0DC;AArED,uCAAsC;AACtC,yCAAiC;AAEjC;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,MAAc,EACd,cAAsB;IAEtB,MAAM,QAAQ,GAAG,IAAA,aAAM,EAAC;QACtB,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,cAAc;YACxB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;YAC9B,KAAK,EAAE,KAAK;SACb;QACD,iDAAiD;QACjD,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QAChC,4CAA4C;QAC5C,SAAS,EAAE;YACT,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,SAAS;SACnB;QACD,OAAO,EAAE;YACP,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;SAC7C;QACD,uDAAuD;QACvD,YAAY,EAAE;YACZ,QAAQ,EAAE,KAAK;SAChB;QACD,0BAA0B;QAC1B,KAAK,EAAE,iBAAiB;KACzB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,IAAI,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;gBACvF,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC3B,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACtD,CAAC,CAAC,CAAC;YACL,CAAC;YACD,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC1B,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,QAAQ,EAAE,+BAA+B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC9E,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { rspack } from '@rspack/core';\nimport { c } from '../../colors';\n\n/**\n * Bundle the serverless entry point into a single CJS file using rspack.\n * This resolves ESM/CJS compatibility issues and dynamic import problems.\n *\n * @param entryPath - Absolute path to the entry file (e.g., dist/index.js)\n * @param outDir - Output directory for the bundled file\n * @param outputFilename - Name of the output bundle (e.g., 'handler.cjs')\n */\nexport async function bundleForServerless(\n  entryPath: string,\n  outDir: string,\n  outputFilename: string,\n): Promise<void> {\n  const compiler = rspack({\n    mode: 'production',\n    target: 'node',\n    entry: entryPath,\n    output: {\n      path: outDir,\n      filename: outputFilename,\n      library: { type: 'commonjs2' },\n      clean: false,\n    },\n    // Use node externals preset for built-in modules\n    externalsPresets: { node: true },\n    // Exclude problematic optional dependencies\n    externals: {\n      '@swc/core': '@swc/core',\n      fsevents: 'fsevents',\n      esbuild: 'esbuild',\n    },\n    resolve: {\n      extensions: ['.js', '.mjs', '.cjs', '.json'],\n    },\n    // Don't minimize to preserve readability for debugging\n    optimization: {\n      minimize: false,\n    },\n    // Suppress verbose output\n    stats: 'errors-warnings',\n  });\n\n  return new Promise((resolve, reject) => {\n    compiler.run((err, stats) => {\n      if (err) {\n        return reject(err);\n      }\n      if (stats?.hasErrors()) {\n        const info = stats.toJson();\n        const errorMessages = info.errors?.map((e) => e.message).join('\\n') || 'Unknown error';\n        return reject(new Error(`Bundle failed:\\n${errorMessages}`));\n      }\n      if (stats?.hasWarnings()) {\n        const info = stats.toJson();\n        info.warnings?.forEach((w) => {\n          console.log(c('yellow', `  Warning: ${w.message}`));\n        });\n      }\n      compiler.close((closeErr) => {\n        if (closeErr) {\n          console.log(c('yellow', `  Warning closing compiler: ${closeErr.message}`));\n        }\n        resolve();\n      });\n    });\n  });\n}\n"]}

package/src/commands/build/index.js

@@ -7,6 +7,7 @@ const colors_1 = require("../../colors");
 const fs_1 = require("../../utils/fs");
 const tsconfig_1 = require("../../tsconfig");
 const adapters_1 = require("./adapters");
+const bundler_1 = require("./bundler");
 function isTsLike(p) {
     return /\.tsx?$/i.test(p);
 }
@@ -15,6 +16,14 @@ function isTsLike(p) {
  */
 async function generateAdapterFiles(adapter, outDir, entryBasename, cwd) {
     const template = adapters_1.ADAPTERS[adapter];
+    // Generate serverless setup file first (if adapter has one)
+    // This file sets FRONTMCP_SERVERLESS=1 before any imports run
+    if (template.getSetupTemplate) {
+        const setupContent = template.getSetupTemplate();
+        const setupPath = path.join(outDir, 'serverless-setup.js');
+        await fs_1.fsp.writeFile(setupPath, setupContent, 'utf8');
+        console.log((0, colors_1.c)('green', `  Generated serverless setup at ${path.relative(cwd, setupPath)}`));
+    }
     // Generate index.js entry point
     const mainModuleName = entryBasename.replace(/\.tsx?$/, '.js');
     const entryContent = template.getEntryTemplate(`./${mainModuleName}`);
@@ -24,6 +33,13 @@ async function generateAdapterFiles(adapter, outDir, entryBasename, cwd) {
         await fs_1.fsp.writeFile(entryPath, entryContent, 'utf8');
         console.log((0, colors_1.c)('green', `  Generated ${adapter} entry at ${path.relative(cwd, entryPath)}`));
     }
+    // Bundle if adapter requires it (creates single CJS file for serverless)
+    if (template.shouldBundle && template.bundleOutput) {
+        console.log((0, colors_1.c)('cyan', `[build] Bundling for ${adapter}...`));
+        const entryPath = path.join(outDir, 'index.js');
+        await (0, bundler_1.bundleForServerless)(entryPath, outDir, template.bundleOutput);
+        console.log((0, colors_1.c)('green', `  Created bundle: ${template.bundleOutput}`));
+    }
     // Generate config file if adapter has one (skip if already exists)
     if (template.getConfig && template.configFileName) {
         const configPath = path.join(cwd, template.configFileName);

package/src/commands/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/build/index.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { ParsedArgs } from '../../args';\nimport { c } from '../../colors';\nimport { ensureDir, fileExists, fsp, runCmd, resolveEntry, writeJSON } from '../../utils/fs';\nimport { REQUIRED_DECORATOR_FIELDS } from '../../tsconfig';\nimport { ADAPTERS } from './adapters';\nimport { AdapterName } from './types';\n\nfunction isTsLike(p: string): boolean {\n  return /\\.tsx?$/i.test(p);\n}\n\n/**\n * Generate adapter-specific entry point and config files.\n */\nasync function generateAdapterFiles(\n  adapter: AdapterName,\n  outDir: string,\n  entryBasename: string,\n  cwd: string,\n): Promise<void> {\n  const template = ADAPTERS[adapter];\n\n  // Generate index.js entry point\n  const mainModuleName = entryBasename.replace(/\\.tsx?$/, '.js');\n  const entryContent = template.getEntryTemplate(`./${mainModuleName}`);\n\n  // Skip if no entry template (e.g., node adapter)\n  if (entryContent) {\n    const entryPath = path.join(outDir, 'index.js');\n    await fsp.writeFile(entryPath, entryContent, 'utf8');\n    console.log(c('green', `  Generated ${adapter} entry at ${path.relative(cwd, entryPath)}`));\n  }\n\n  // Generate config file if adapter has one (skip if already exists)\n  if (template.getConfig && template.configFileName) {\n    const configPath = path.join(cwd, template.configFileName);\n\n    if (await fileExists(configPath)) {\n      console.log(c('yellow', `  ${template.configFileName} already exists (skipping)`));\n    } else {\n      const configContent = template.getConfig();\n\n      if (typeof configContent === 'string') {\n        // Write as plain text (e.g., TOML for wrangler.toml)\n        await fsp.writeFile(configPath, configContent, 'utf8');\n      } else {\n        // Write as JSON\n        await writeJSON(configPath, configContent);\n      }\n      console.log(c('green', `  Generated ${template.configFileName}`));\n    }\n  }\n}\n\n/**\n * Build the FrontMCP server for a specific deployment target.\n *\n * @param opts - Build options from CLI arguments\n *\n * @example\n * ```bash\n * # Build for Node.js (default)\n * frontmcp build\n *\n * # Build for Vercel\n * frontmcp build --adapter vercel\n *\n * # Build for AWS Lambda\n * frontmcp build --adapter lambda\n *\n * # Build for Cloudflare Workers\n * frontmcp build --adapter cloudflare\n * ```\n */\nexport async function runBuild(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n  const entry = await resolveEntry(cwd, opts.entry);\n  const outDir = path.resolve(cwd, opts.outDir || 'dist');\n  const adapter = (opts.adapter || 'node') as AdapterName;\n  await ensureDir(outDir);\n\n  // Validate adapter\n  const template = ADAPTERS[adapter];\n  if (!template) {\n    const available = Object.keys(ADAPTERS).join(', ');\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${available}`);\n  }\n\n  // Warn about experimental adapters\n  if (adapter === 'cloudflare') {\n    console.log(\n      c('yellow', '⚠️  Cloudflare Workers adapter is experimental. See docs for limitations.'),\n    );\n  }\n\n  const moduleFormat = template.moduleFormat;\n\n  console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);\n  console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);\n  console.log(`${c('cyan', '[build]')} adapter: ${adapter} (${moduleFormat})`);\n\n  // Build TypeScript compiler arguments\n  const tsconfigPath = path.join(cwd, 'tsconfig.json');\n  const hasTsconfig = await fileExists(tsconfigPath);\n  const args: string[] = ['-y', 'tsc'];\n\n  if (hasTsconfig) {\n    console.log(c('gray', `[build] tsconfig.json detected — compiling with project settings`));\n    args.push('--project', tsconfigPath);\n  } else {\n    args.push(entry);\n    args.push('--rootDir', path.dirname(entry));\n    if (!isTsLike(entry)) {\n      args.push('--allowJs');\n      console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));\n    }\n    args.push('--experimentalDecorators', '--emitDecoratorMetadata');\n    args.push('--target', REQUIRED_DECORATOR_FIELDS.target);\n  }\n\n  // Always pass module format to override tsconfig\n  args.push('--module', moduleFormat);\n  args.push('--outDir', outDir);\n  args.push('--skipLibCheck');\n\n  // Run TypeScript compiler\n  await runCmd('npx', args);\n\n  // Generate adapter-specific files\n  if (adapter !== 'node') {\n    console.log(c('cyan', `[build] Generating ${adapter} deployment files...`));\n    const entryBasename = path.basename(entry);\n    await generateAdapterFiles(adapter, outDir, entryBasename, cwd);\n  }\n\n  console.log(c('green', '✅ Build completed.'));\n  console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/build/index.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { ParsedArgs } from '../../args';\nimport { c } from '../../colors';\nimport { ensureDir, fileExists, fsp, runCmd, resolveEntry, writeJSON } from '../../utils/fs';\nimport { REQUIRED_DECORATOR_FIELDS } from '../../tsconfig';\nimport { ADAPTERS } from './adapters';\nimport { AdapterName } from './types';\nimport { bundleForServerless } from './bundler';\n\nfunction isTsLike(p: string): boolean {\n  return /\\.tsx?$/i.test(p);\n}\n\n/**\n * Generate adapter-specific entry point and config files.\n */\nasync function generateAdapterFiles(\n  adapter: AdapterName,\n  outDir: string,\n  entryBasename: string,\n  cwd: string,\n): Promise<void> {\n  const template = ADAPTERS[adapter];\n\n  // Generate serverless setup file first (if adapter has one)\n  // This file sets FRONTMCP_SERVERLESS=1 before any imports run\n  if (template.getSetupTemplate) {\n    const setupContent = template.getSetupTemplate();\n    const setupPath = path.join(outDir, 'serverless-setup.js');\n    await fsp.writeFile(setupPath, setupContent, 'utf8');\n    console.log(c('green', `  Generated serverless setup at ${path.relative(cwd, setupPath)}`));\n  }\n\n  // Generate index.js entry point\n  const mainModuleName = entryBasename.replace(/\\.tsx?$/, '.js');\n  const entryContent = template.getEntryTemplate(`./${mainModuleName}`);\n\n  // Skip if no entry template (e.g., node adapter)\n  if (entryContent) {\n    const entryPath = path.join(outDir, 'index.js');\n    await fsp.writeFile(entryPath, entryContent, 'utf8');\n    console.log(c('green', `  Generated ${adapter} entry at ${path.relative(cwd, entryPath)}`));\n  }\n\n  // Bundle if adapter requires it (creates single CJS file for serverless)\n  if (template.shouldBundle && template.bundleOutput) {\n    console.log(c('cyan', `[build] Bundling for ${adapter}...`));\n    const entryPath = path.join(outDir, 'index.js');\n    await bundleForServerless(entryPath, outDir, template.bundleOutput);\n    console.log(c('green', `  Created bundle: ${template.bundleOutput}`));\n  }\n\n  // Generate config file if adapter has one (skip if already exists)\n  if (template.getConfig && template.configFileName) {\n    const configPath = path.join(cwd, template.configFileName);\n\n    if (await fileExists(configPath)) {\n      console.log(c('yellow', `  ${template.configFileName} already exists (skipping)`));\n    } else {\n      const configContent = template.getConfig();\n\n      if (typeof configContent === 'string') {\n        // Write as plain text (e.g., TOML for wrangler.toml)\n        await fsp.writeFile(configPath, configContent, 'utf8');\n      } else {\n        // Write as JSON\n        await writeJSON(configPath, configContent);\n      }\n      console.log(c('green', `  Generated ${template.configFileName}`));\n    }\n  }\n}\n\n/**\n * Build the FrontMCP server for a specific deployment target.\n *\n * @param opts - Build options from CLI arguments\n *\n * @example\n * ```bash\n * # Build for Node.js (default)\n * frontmcp build\n *\n * # Build for Vercel\n * frontmcp build --adapter vercel\n *\n * # Build for AWS Lambda\n * frontmcp build --adapter lambda\n *\n * # Build for Cloudflare Workers\n * frontmcp build --adapter cloudflare\n * ```\n */\nexport async function runBuild(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n  const entry = await resolveEntry(cwd, opts.entry);\n  const outDir = path.resolve(cwd, opts.outDir || 'dist');\n  const adapter = (opts.adapter || 'node') as AdapterName;\n  await ensureDir(outDir);\n\n  // Validate adapter\n  const template = ADAPTERS[adapter];\n  if (!template) {\n    const available = Object.keys(ADAPTERS).join(', ');\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${available}`);\n  }\n\n  // Warn about experimental adapters\n  if (adapter === 'cloudflare') {\n    console.log(\n      c('yellow', '⚠️  Cloudflare Workers adapter is experimental. See docs for limitations.'),\n    );\n  }\n\n  const moduleFormat = template.moduleFormat;\n\n  console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);\n  console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);\n  console.log(`${c('cyan', '[build]')} adapter: ${adapter} (${moduleFormat})`);\n\n  // Build TypeScript compiler arguments\n  const tsconfigPath = path.join(cwd, 'tsconfig.json');\n  const hasTsconfig = await fileExists(tsconfigPath);\n  const args: string[] = ['-y', 'tsc'];\n\n  if (hasTsconfig) {\n    console.log(c('gray', `[build] tsconfig.json detected — compiling with project settings`));\n    args.push('--project', tsconfigPath);\n  } else {\n    args.push(entry);\n    args.push('--rootDir', path.dirname(entry));\n    if (!isTsLike(entry)) {\n      args.push('--allowJs');\n      console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));\n    }\n    args.push('--experimentalDecorators', '--emitDecoratorMetadata');\n    args.push('--target', REQUIRED_DECORATOR_FIELDS.target);\n  }\n\n  // Always pass module format to override tsconfig\n  args.push('--module', moduleFormat);\n  args.push('--outDir', outDir);\n  args.push('--skipLibCheck');\n\n  // Run TypeScript compiler\n  await runCmd('npx', args);\n\n  // Generate adapter-specific files\n  if (adapter !== 'node') {\n    console.log(c('cyan', `[build] Generating ${adapter} deployment files...`));\n    const entryBasename = path.basename(entry);\n    await generateAdapterFiles(adapter, outDir, entryBasename, cwd);\n  }\n\n  console.log(c('green', '✅ Build completed.'));\n  console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));\n}\n"]}

package/src/commands/build/types.d.ts

@@ -12,6 +12,22 @@ export type AdapterTemplate = {
      * @returns The content for index.js, or empty string if no wrapper needed
      */
     getEntryTemplate: (mainModulePath: string) => string;
+    /**
+     * Generate the serverless setup file content.
+     * This file is imported first to set environment variables before decorators run.
+     * @returns The content for serverless-setup.js, or undefined if not needed
+     */
+    getSetupTemplate?: () => string;
+    /**
+     * Whether to bundle the output with rspack.
+     * Recommended for serverless deployments to avoid ESM/CJS issues.
+     */
+    shouldBundle?: boolean;
+    /**
+     * Output filename for the bundled file (e.g., 'handler.cjs').
+     * Only used when shouldBundle is true.
+     */
+    bundleOutput?: string;
     /**
      * Generate the deployment platform config file content.
      * @returns Object (for JSON) or string (for TOML/YAML)

package/src/commands/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/build/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration for a deployment adapter.\n * Each adapter defines how to compile and package the FrontMCP server\n * for a specific deployment target.\n */\nexport type AdapterTemplate = {\n  /** Module format for TypeScript compilation */\n  moduleFormat: 'commonjs' | 'esnext';\n\n  /**\n   * Generate the entry point file content.\n   * @param mainModulePath - Relative path to the compiled main module (e.g., './main.js')\n   * @returns The content for index.js, or empty string if no wrapper needed\n   */\n  getEntryTemplate: (mainModulePath: string) => string;\n\n  /**\n   * Generate the deployment platform config file content.\n   * @returns Object (for JSON) or string (for TOML/YAML)\n   */\n  getConfig?: () => object | string;\n\n  /** Name of the config file (e.g., 'vercel.json', 'wrangler.toml') */\n  configFileName?: string;\n};\n\nexport type AdapterName = 'node' | 'vercel' | 'lambda' | 'cloudflare';\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/build/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration for a deployment adapter.\n * Each adapter defines how to compile and package the FrontMCP server\n * for a specific deployment target.\n */\nexport type AdapterTemplate = {\n  /** Module format for TypeScript compilation */\n  moduleFormat: 'commonjs' | 'esnext';\n\n  /**\n   * Generate the entry point file content.\n   * @param mainModulePath - Relative path to the compiled main module (e.g., './main.js')\n   * @returns The content for index.js, or empty string if no wrapper needed\n   */\n  getEntryTemplate: (mainModulePath: string) => string;\n\n  /**\n   * Generate the serverless setup file content.\n   * This file is imported first to set environment variables before decorators run.\n   * @returns The content for serverless-setup.js, or undefined if not needed\n   */\n  getSetupTemplate?: () => string;\n\n  /**\n   * Whether to bundle the output with rspack.\n   * Recommended for serverless deployments to avoid ESM/CJS issues.\n   */\n  shouldBundle?: boolean;\n\n  /**\n   * Output filename for the bundled file (e.g., 'handler.cjs').\n   * Only used when shouldBundle is true.\n   */\n  bundleOutput?: string;\n\n  /**\n   * Generate the deployment platform config file content.\n   * @returns Object (for JSON) or string (for TOML/YAML)\n   */\n  getConfig?: () => object | string;\n\n  /** Name of the config file (e.g., 'vercel.json', 'wrangler.toml') */\n  configFileName?: string;\n};\n\nexport type AdapterName = 'node' | 'vercel' | 'lambda' | 'cloudflare';\n"]}