frontmcp 1.1.0 → 1.1.2-beta.1

package/src/config/frontmcp-config.loader.js

@@ -7,12 +7,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadFrontMcpConfig = loadFrontMcpConfig;
+exports.tryLoadFrontMcpConfig = tryLoadFrontMcpConfig;
 exports.validateConfig = validateConfig;
 exports.findDeployment = findDeployment;
 exports.getDeploymentTargets = getDeploymentTargets;
 const tslib_1 = require("tslib");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("@frontmcp/utils");
 const frontmcp_config_schema_1 = require("./frontmcp-config.schema");
 const CONFIG_FILENAMES = [
     'frontmcp.config.ts',
@@ -36,6 +38,57 @@ async function loadFrontMcpConfig(cwd) {
     const raw = await loadRawConfig(cwd);
     return validateConfig(raw);
 }
+/**
+ * Variant that load-errors propagate (parse failures in `frontmcp.config.ts`,
+ * missing dependencies, etc.) but schema-validation errors return `undefined`.
+ *
+ * Used by `runBuild` to support both shapes: the new top-level
+ * `frontmcpConfigSchema` (with `deployments`) and the older exec-only shape
+ * (top-level `cli`, `sea`, `esbuild`) that `loadExecConfig` consumes
+ * directly. A user with the old shape should still get a successful build
+ * — the exec-loader picks the file up from disk by itself.
+ *
+ * Returns `undefined` when:
+ *  - no config file is present (caller falls back to CLI flags), or
+ *  - the file loads but doesn't match the new schema (legacy shape).
+ *
+ * Throws when:
+ *  - the file exists but can't be parsed (TS syntax error, ESM/CJS mismatch
+ *    that even esbuild can't recover from, etc.) — i.e., #365 silent-default
+ *    regressions.
+ */
+async function tryLoadFrontMcpConfig(cwd) {
+    let raw;
+    try {
+        raw = await loadRawConfig(cwd);
+    }
+    catch (err) {
+        // Distinguish "no config and no package.json" from real load failures.
+        // `deriveFromPackageJson` throws this exact message — treat it as "no config".
+        if (err.message?.startsWith('No frontmcp.config found')) {
+            return undefined;
+        }
+        throw err;
+    }
+    const result = frontmcp_config_schema_1.frontmcpConfigSchema.safeParse(raw);
+    if (!result.success) {
+        // Distinguish two failure shapes:
+        //   1. Legacy exec-only config — top-level `cli` / `sea` / `esbuild`,
+        //      no `deployments` key. Return undefined so `loadExecConfig` picks
+        //      it up directly. Pre-v1.1 fixtures live in this branch.
+        //   2. Anything else — looks like the user attempted a v1.1 config and
+        //      got it wrong (typo'd `deployments`, invalid `target`, etc.).
+        //      Throw so we don't silently fall back to defaults — that was the
+        //      silent-corruption mode #365 was trying to eliminate.
+        const obj = typeof raw === 'object' && raw !== null ? raw : undefined;
+        const isLegacyExecOnlyShape = !!obj && !('deployments' in obj) && ('cli' in obj || 'sea' in obj || 'esbuild' in obj);
+        if (isLegacyExecOnlyShape)
+            return undefined;
+        const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
+        throw new Error(`Invalid frontmcp.config:\n${issues}`);
+    }
+    return result.data;
+}
 /**
  * Load raw config without validation.
  */
@@ -49,15 +102,43 @@ async function loadRawConfig(cwd) {
             return JSON.parse(content);
         }
         if (filename.endsWith('.ts')) {
-            // TypeScript config — try tsx or ts-node for runtime loading
+            // #365 — When the project is `"type": "commonjs"` (the default),
+            // `require()` can't load .ts without a hook and `await import()` emits
+            // Node's `Failed to load the ES module … Make sure to set "type": "module"`
+            // warning to stderr regardless of whether type-stripping eventually
+            // succeeds — that warning by itself looked to retesters like a hard
+            // load failure even when the build proceeded. Round 2: when the host
+            // project is CJS, skip Node's `await import()` entirely and go
+            // straight to esbuild. For ESM projects we still try the runtime
+            // paths first (faster, no transpile cost). Either way, a failure on
+            // every path throws the combined error — never silent defaults.
+            const isCjsProject = await isCommonJsProject(cwd);
+            let requireErr;
             try {
                 const mod = require(configPath);
                 return mod.default ?? mod;
             }
-            catch {
-                // If require fails (no ts-node), try dynamic import
-                const mod = await import(configPath);
-                return mod.default ?? mod;
+            catch (e) {
+                requireErr = e;
+            }
+            if (!isCjsProject) {
+                try {
+                    const mod = await import(configPath);
+                    return mod.default ?? mod;
+                }
+                catch {
+                    // Fall through to esbuild.
+                }
+            }
+            try {
+                return await loadTsConfigViaEsbuild(configPath);
+            }
+            catch (esbuildErr) {
+                throw new Error(`Failed to load ${filename}.\n` +
+                    `  require() error: ${requireErr?.message ?? '(skipped)'}\n` +
+                    `  esbuild error:   ${esbuildErr.message}\n` +
+                    `Hint: ensure the file exports a default config (e.g., ` +
+                    `\`export default defineConfig({...})\`) and that all imports resolve.`);
             }
         }
         // JS/MJS/CJS
@@ -71,6 +152,72 @@ async function loadRawConfig(cwd) {
     // Fallback: derive from package.json
     return deriveFromPackageJson(cwd);
 }
+/**
+ * Read the host project's `package.json.type` to decide whether `await import()`
+ * of a `.ts` file is worth attempting. Returns true when the project is
+ * declared `"type": "commonjs"` or omits the field entirely (Node's default).
+ *
+ * Read errors (no package.json, malformed JSON) are treated as "CJS" — that's
+ * the safer default for the loader because it routes us through esbuild
+ * transpilation rather than relying on Node's experimental TS handling.
+ *
+ * Routed through `@frontmcp/utils` per repo convention so this module
+ * doesn't reach into `node:fs` for an ad-hoc package.json read.
+ */
+async function isCommonJsProject(cwd) {
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        const contents = await (0, utils_1.readFile)(pkgPath);
+        const pkg = JSON.parse(contents);
+        return pkg.type !== 'module';
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Transpile a TypeScript config file with esbuild (CJS target) and eval the
+ * result via Module-via-vm. Used as a last-resort path when neither `require()`
+ * (no ts-node hook) nor `await import()` (project is `"type": "commonjs"`)
+ * can load the file directly.
+ *
+ * Uses `esbuild.build({ bundle: true, packages: 'external' })` rather than
+ * `transformSync` so a config that imports a sibling helper TS file
+ * (`import { foo } from './helpers'`) gets the helper inlined into the
+ * compiled output. Without bundling, the resulting CJS would emit
+ * `require('./helpers')` which Node can't resolve under `"type": "commonjs"`.
+ *
+ * `packages: 'external'` keeps node_modules dependencies as runtime
+ * `require()` calls so `import { defineConfig } from 'frontmcp'` still
+ * resolves against the project's installed copy of the SDK.
+ */
+async function loadTsConfigViaEsbuild(configPath) {
+    const esbuild = require('esbuild');
+    const built = await esbuild.build({
+        entryPoints: [configPath],
+        bundle: true,
+        write: false,
+        platform: 'node',
+        format: 'cjs',
+        target: 'es2022',
+        packages: 'external',
+        sourcemap: 'inline',
+        logLevel: 'silent',
+    });
+    if (!built.outputFiles || built.outputFiles.length === 0) {
+        throw new Error('esbuild produced no output for ' + configPath);
+    }
+    const code = built.outputFiles[0].text;
+    const Module = require('module');
+    const m = new Module(configPath, module);
+    // Make the loaded module's `require` resolve relative to the config dir
+    // so user `import { defineConfig } from 'frontmcp'` keeps working.
+    m.filename = configPath;
+    m.paths = Module._nodeModulePaths(path.dirname(configPath));
+    m._compile(code, configPath);
+    const exported = m.exports;
+    return exported?.default ?? exported;
+}
 /**
  * Derive minimal config from package.json.
  */

package/src/config/frontmcp-config.loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmcp-config.loader.js","sourceRoot":"","sources":["../../../src/config/frontmcp-config.loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FrontMCP Config Loader\n *\n * Loads `frontmcp.config.(json|js|ts|mjs|cjs)` from a directory.\n * Falls back to deriving minimal config from package.json.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nimport { frontmcpConfigSchema, type FrontMcpConfigParsed } from './frontmcp-config.schema';\nimport type { DeploymentTarget, FrontMcpConfig } from './frontmcp-config.types';\n\nconst CONFIG_FILENAMES = [\n  'frontmcp.config.ts',\n  'frontmcp.config.js',\n  'frontmcp.config.json',\n  'frontmcp.config.mjs',\n  'frontmcp.config.cjs',\n];\n\n/**\n * Load and validate a frontmcp.config file from the given directory.\n *\n * Resolution order:\n * 1. frontmcp.config.ts\n * 2. frontmcp.config.js\n * 3. frontmcp.config.json\n * 4. frontmcp.config.mjs\n * 5. frontmcp.config.cjs\n * 6. Derive from package.json (minimal config with 'node' target)\n */\nexport async function loadFrontMcpConfig(cwd: string): Promise<FrontMcpConfigParsed> {\n  const raw = await loadRawConfig(cwd);\n  return validateConfig(raw);\n}\n\n/**\n * Load raw config without validation.\n */\nasync function loadRawConfig(cwd: string): Promise<unknown> {\n  for (const filename of CONFIG_FILENAMES) {\n    const configPath = path.join(cwd, filename);\n    if (!fs.existsSync(configPath)) continue;\n\n    if (filename.endsWith('.json')) {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      return JSON.parse(content);\n    }\n\n    if (filename.endsWith('.ts')) {\n      // TypeScript config — try tsx or ts-node for runtime loading\n      try {\n        const mod = require(configPath);\n        return mod.default ?? mod;\n      } catch {\n        // If require fails (no ts-node), try dynamic import\n        const mod = await import(configPath);\n        return mod.default ?? mod;\n      }\n    }\n\n    // JS/MJS/CJS\n    if (filename.endsWith('.mjs')) {\n      const mod = await import(configPath);\n      return mod.default ?? mod;\n    }\n\n    const mod = require(configPath);\n    return mod.default ?? mod;\n  }\n\n  // Fallback: derive from package.json\n  return deriveFromPackageJson(cwd);\n}\n\n/**\n * Derive minimal config from package.json.\n */\nfunction deriveFromPackageJson(cwd: string): FrontMcpConfig {\n  const pkgPath = path.join(cwd, 'package.json');\n  if (!fs.existsSync(pkgPath)) {\n    throw new Error(\n      'No frontmcp.config found and no package.json. Create a frontmcp.config.ts to configure build targets.',\n    );\n  }\n\n  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n  return {\n    name: pkg.name?.replace(/^@[^/]+\\//, '') || path.basename(cwd),\n    version: pkg.version || '1.0.0',\n    entry: pkg.main,\n    deployments: [{ target: 'node' }],\n  };\n}\n\n/**\n * Validate raw config against the Zod schema.\n */\nexport function validateConfig(raw: unknown): FrontMcpConfigParsed {\n  const result = frontmcpConfigSchema.safeParse(raw);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n');\n    throw new Error(`Invalid frontmcp.config:\\n${issues}`);\n  }\n  return result.data;\n}\n\n/**\n * Find a deployment target by type.\n */\nexport function findDeployment(config: FrontMcpConfigParsed, target: string): DeploymentTarget | undefined {\n  return config.deployments.find((d) => d.target === target);\n}\n\n/**\n * Get all deployment target types from the config.\n */\nexport function getDeploymentTargets(config: FrontMcpConfigParsed): string[] {\n  return config.deployments.map((d) => d.target);\n}\n"]}
+{"version":3,"file":"frontmcp-config.loader.js","sourceRoot":"","sources":["../../../src/config/frontmcp-config.loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FrontMCP Config Loader\n *\n * Loads `frontmcp.config.(json|js|ts|mjs|cjs)` from a directory.\n * Falls back to deriving minimal config from package.json.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nimport { readFile } from '@frontmcp/utils';\n\nimport { frontmcpConfigSchema, type FrontMcpConfigParsed } from './frontmcp-config.schema';\nimport type { DeploymentTarget, FrontMcpConfig } from './frontmcp-config.types';\n\nconst CONFIG_FILENAMES = [\n  'frontmcp.config.ts',\n  'frontmcp.config.js',\n  'frontmcp.config.json',\n  'frontmcp.config.mjs',\n  'frontmcp.config.cjs',\n];\n\n/**\n * Load and validate a frontmcp.config file from the given directory.\n *\n * Resolution order:\n * 1. frontmcp.config.ts\n * 2. frontmcp.config.js\n * 3. frontmcp.config.json\n * 4. frontmcp.config.mjs\n * 5. frontmcp.config.cjs\n * 6. Derive from package.json (minimal config with 'node' target)\n */\nexport async function loadFrontMcpConfig(cwd: string): Promise<FrontMcpConfigParsed> {\n  const raw = await loadRawConfig(cwd);\n  return validateConfig(raw);\n}\n\n/**\n * Variant that load-errors propagate (parse failures in `frontmcp.config.ts`,\n * missing dependencies, etc.) but schema-validation errors return `undefined`.\n *\n * Used by `runBuild` to support both shapes: the new top-level\n * `frontmcpConfigSchema` (with `deployments`) and the older exec-only shape\n * (top-level `cli`, `sea`, `esbuild`) that `loadExecConfig` consumes\n * directly. A user with the old shape should still get a successful build\n * — the exec-loader picks the file up from disk by itself.\n *\n * Returns `undefined` when:\n *  - no config file is present (caller falls back to CLI flags), or\n *  - the file loads but doesn't match the new schema (legacy shape).\n *\n * Throws when:\n *  - the file exists but can't be parsed (TS syntax error, ESM/CJS mismatch\n *    that even esbuild can't recover from, etc.) — i.e., #365 silent-default\n *    regressions.\n */\nexport async function tryLoadFrontMcpConfig(cwd: string): Promise<FrontMcpConfigParsed | undefined> {\n  let raw: unknown;\n  try {\n    raw = await loadRawConfig(cwd);\n  } catch (err) {\n    // Distinguish \"no config and no package.json\" from real load failures.\n    // `deriveFromPackageJson` throws this exact message — treat it as \"no config\".\n    if ((err as Error).message?.startsWith('No frontmcp.config found')) {\n      return undefined;\n    }\n    throw err;\n  }\n  const result = frontmcpConfigSchema.safeParse(raw);\n  if (!result.success) {\n    // Distinguish two failure shapes:\n    //   1. Legacy exec-only config — top-level `cli` / `sea` / `esbuild`,\n    //      no `deployments` key. Return undefined so `loadExecConfig` picks\n    //      it up directly. Pre-v1.1 fixtures live in this branch.\n    //   2. Anything else — looks like the user attempted a v1.1 config and\n    //      got it wrong (typo'd `deployments`, invalid `target`, etc.).\n    //      Throw so we don't silently fall back to defaults — that was the\n    //      silent-corruption mode #365 was trying to eliminate.\n    const obj = typeof raw === 'object' && raw !== null ? (raw as Record<string, unknown>) : undefined;\n    const isLegacyExecOnlyShape =\n      !!obj && !('deployments' in obj) && ('cli' in obj || 'sea' in obj || 'esbuild' in obj);\n    if (isLegacyExecOnlyShape) return undefined;\n    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n');\n    throw new Error(`Invalid frontmcp.config:\\n${issues}`);\n  }\n  return result.data;\n}\n\n/**\n * Load raw config without validation.\n */\nasync function loadRawConfig(cwd: string): Promise<unknown> {\n  for (const filename of CONFIG_FILENAMES) {\n    const configPath = path.join(cwd, filename);\n    if (!fs.existsSync(configPath)) continue;\n\n    if (filename.endsWith('.json')) {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      return JSON.parse(content);\n    }\n\n    if (filename.endsWith('.ts')) {\n      // #365 — When the project is `\"type\": \"commonjs\"` (the default),\n      // `require()` can't load .ts without a hook and `await import()` emits\n      // Node's `Failed to load the ES module … Make sure to set \"type\": \"module\"`\n      // warning to stderr regardless of whether type-stripping eventually\n      // succeeds — that warning by itself looked to retesters like a hard\n      // load failure even when the build proceeded. Round 2: when the host\n      // project is CJS, skip Node's `await import()` entirely and go\n      // straight to esbuild. For ESM projects we still try the runtime\n      // paths first (faster, no transpile cost). Either way, a failure on\n      // every path throws the combined error — never silent defaults.\n      const isCjsProject = await isCommonJsProject(cwd);\n      let requireErr: Error | undefined;\n      try {\n        const mod = require(configPath);\n        return mod.default ?? mod;\n      } catch (e) {\n        requireErr = e as Error;\n      }\n      if (!isCjsProject) {\n        try {\n          const mod = await import(configPath);\n          return mod.default ?? mod;\n        } catch {\n          // Fall through to esbuild.\n        }\n      }\n      try {\n        return await loadTsConfigViaEsbuild(configPath);\n      } catch (esbuildErr) {\n        throw new Error(\n          `Failed to load ${filename}.\\n` +\n            `  require() error: ${requireErr?.message ?? '(skipped)'}\\n` +\n            `  esbuild error:   ${(esbuildErr as Error).message}\\n` +\n            `Hint: ensure the file exports a default config (e.g., ` +\n            `\\`export default defineConfig({...})\\`) and that all imports resolve.`,\n        );\n      }\n    }\n\n    // JS/MJS/CJS\n    if (filename.endsWith('.mjs')) {\n      const mod = await import(configPath);\n      return mod.default ?? mod;\n    }\n\n    const mod = require(configPath);\n    return mod.default ?? mod;\n  }\n\n  // Fallback: derive from package.json\n  return deriveFromPackageJson(cwd);\n}\n\n/**\n * Read the host project's `package.json.type` to decide whether `await import()`\n * of a `.ts` file is worth attempting. Returns true when the project is\n * declared `\"type\": \"commonjs\"` or omits the field entirely (Node's default).\n *\n * Read errors (no package.json, malformed JSON) are treated as \"CJS\" — that's\n * the safer default for the loader because it routes us through esbuild\n * transpilation rather than relying on Node's experimental TS handling.\n *\n * Routed through `@frontmcp/utils` per repo convention so this module\n * doesn't reach into `node:fs` for an ad-hoc package.json read.\n */\nasync function isCommonJsProject(cwd: string): Promise<boolean> {\n  try {\n    const pkgPath = path.join(cwd, 'package.json');\n    const contents = await readFile(pkgPath);\n    const pkg = JSON.parse(contents) as { type?: string };\n    return pkg.type !== 'module';\n  } catch {\n    return true;\n  }\n}\n\n/**\n * Transpile a TypeScript config file with esbuild (CJS target) and eval the\n * result via Module-via-vm. Used as a last-resort path when neither `require()`\n * (no ts-node hook) nor `await import()` (project is `\"type\": \"commonjs\"`)\n * can load the file directly.\n *\n * Uses `esbuild.build({ bundle: true, packages: 'external' })` rather than\n * `transformSync` so a config that imports a sibling helper TS file\n * (`import { foo } from './helpers'`) gets the helper inlined into the\n * compiled output. Without bundling, the resulting CJS would emit\n * `require('./helpers')` which Node can't resolve under `\"type\": \"commonjs\"`.\n *\n * `packages: 'external'` keeps node_modules dependencies as runtime\n * `require()` calls so `import { defineConfig } from 'frontmcp'` still\n * resolves against the project's installed copy of the SDK.\n */\nasync function loadTsConfigViaEsbuild(configPath: string): Promise<unknown> {\n  const esbuild = require('esbuild') as typeof import('esbuild');\n  const built = await esbuild.build({\n    entryPoints: [configPath],\n    bundle: true,\n    write: false,\n    platform: 'node',\n    format: 'cjs',\n    target: 'es2022',\n    packages: 'external',\n    sourcemap: 'inline',\n    logLevel: 'silent',\n  });\n  if (!built.outputFiles || built.outputFiles.length === 0) {\n    throw new Error('esbuild produced no output for ' + configPath);\n  }\n  const code = built.outputFiles[0].text;\n\n  const Module = require('module') as typeof import('module');\n  const m = new Module(configPath, module);\n  // Make the loaded module's `require` resolve relative to the config dir\n  // so user `import { defineConfig } from 'frontmcp'` keeps working.\n  m.filename = configPath;\n  m.paths = (Module as unknown as { _nodeModulePaths(p: string): string[] })._nodeModulePaths(path.dirname(configPath));\n\n  (m as any)._compile(code, configPath);\n\n  const exported = (m as any).exports as { default?: unknown };\n  return exported?.default ?? exported;\n}\n\n/**\n * Derive minimal config from package.json.\n */\nfunction deriveFromPackageJson(cwd: string): FrontMcpConfig {\n  const pkgPath = path.join(cwd, 'package.json');\n  if (!fs.existsSync(pkgPath)) {\n    throw new Error(\n      'No frontmcp.config found and no package.json. Create a frontmcp.config.ts to configure build targets.',\n    );\n  }\n\n  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n  return {\n    name: pkg.name?.replace(/^@[^/]+\\//, '') || path.basename(cwd),\n    version: pkg.version || '1.0.0',\n    entry: pkg.main,\n    deployments: [{ target: 'node' }],\n  };\n}\n\n/**\n * Validate raw config against the Zod schema.\n */\nexport function validateConfig(raw: unknown): FrontMcpConfigParsed {\n  const result = frontmcpConfigSchema.safeParse(raw);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n');\n    throw new Error(`Invalid frontmcp.config:\\n${issues}`);\n  }\n  return result.data;\n}\n\n/**\n * Find a deployment target by type.\n */\nexport function findDeployment(config: FrontMcpConfigParsed, target: string): DeploymentTarget | undefined {\n  return config.deployments.find((d) => d.target === target);\n}\n\n/**\n * Get all deployment target types from the config.\n */\nexport function getDeploymentTargets(config: FrontMcpConfigParsed): string[] {\n  return config.deployments.map((d) => d.target);\n}\n"]}

package/src/config/index.d.ts

@@ -1,5 +1,5 @@
 export { defineConfig } from './define-config';
-export { loadFrontMcpConfig, validateConfig, findDeployment, getDeploymentTargets } from './frontmcp-config.loader';
+export { loadFrontMcpConfig, tryLoadFrontMcpConfig, validateConfig, findDeployment, getDeploymentTargets, } from './frontmcp-config.loader';
 export { frontmcpConfigSchema } from './frontmcp-config.schema';
 export type { FrontMcpConfigParsed } from './frontmcp-config.schema';
 export type { FrontMcpConfig, ServerDefaults, DeploymentTarget, DeploymentTargetType } from './frontmcp-config.types';

package/src/config/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontmcpConfigSchema = exports.getDeploymentTargets = exports.findDeployment = exports.validateConfig = exports.loadFrontMcpConfig = exports.defineConfig = void 0;
+exports.frontmcpConfigSchema = exports.getDeploymentTargets = exports.findDeployment = exports.validateConfig = exports.tryLoadFrontMcpConfig = exports.loadFrontMcpConfig = exports.defineConfig = void 0;
 var define_config_1 = require("./define-config");
 Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return define_config_1.defineConfig; } });
 var frontmcp_config_loader_1 = require("./frontmcp-config.loader");
 Object.defineProperty(exports, "loadFrontMcpConfig", { enumerable: true, get: function () { return frontmcp_config_loader_1.loadFrontMcpConfig; } });
+Object.defineProperty(exports, "tryLoadFrontMcpConfig", { enumerable: true, get: function () { return frontmcp_config_loader_1.tryLoadFrontMcpConfig; } });
 Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return frontmcp_config_loader_1.validateConfig; } });
 Object.defineProperty(exports, "findDeployment", { enumerable: true, get: function () { return frontmcp_config_loader_1.findDeployment; } });
 Object.defineProperty(exports, "getDeploymentTargets", { enumerable: true, get: function () { return frontmcp_config_loader_1.getDeploymentTargets; } });

package/src/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAAoH;AAA3G,4HAAA,kBAAkB,OAAA;AAAE,wHAAA,cAAc,OAAA;AAAE,wHAAA,cAAc,OAAA;AAAE,8HAAA,oBAAoB,OAAA;AACjF,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA","sourcesContent":["export { defineConfig } from './define-config';\nexport { loadFrontMcpConfig, validateConfig, findDeployment, getDeploymentTargets } from './frontmcp-config.loader';\nexport { frontmcpConfigSchema } from './frontmcp-config.schema';\nexport type { FrontMcpConfigParsed } from './frontmcp-config.schema';\nexport type { FrontMcpConfig, ServerDefaults, DeploymentTarget, DeploymentTargetType } from './frontmcp-config.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAMkC;AALhC,4HAAA,kBAAkB,OAAA;AAClB,+HAAA,qBAAqB,OAAA;AACrB,wHAAA,cAAc,OAAA;AACd,wHAAA,cAAc,OAAA;AACd,8HAAA,oBAAoB,OAAA;AAEtB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA","sourcesContent":["export { defineConfig } from './define-config';\nexport {\n  loadFrontMcpConfig,\n  tryLoadFrontMcpConfig,\n  validateConfig,\n  findDeployment,\n  getDeploymentTargets,\n} from './frontmcp-config.loader';\nexport { frontmcpConfigSchema } from './frontmcp-config.schema';\nexport type { FrontMcpConfigParsed } from './frontmcp-config.schema';\nexport type { FrontMcpConfig, ServerDefaults, DeploymentTarget, DeploymentTargetType } from './frontmcp-config.types';\n"]}