everything-dev 0.3.2 → 1.3.2

package/dist/api.d.cts

@@ -0,0 +1,36 @@
+import { RuntimeConfig } from "./types.cjs";
+
+//#region src/api.d.ts
+interface LoadedPluginResult {
+  key: string;
+  name: string;
+  router: any;
+  createClient: (context?: unknown) => any;
+  metadata: {
+    remoteUrl: string;
+    version?: string;
+  };
+}
+interface LoadedPluginsResult {
+  base: LoadedPluginResult | null;
+  plugins: LoadedPluginResult[];
+  errors: Array<{
+    key: string;
+    error: string;
+  }>;
+}
+declare function loadApiPlugin(opts: {
+  key: string;
+  runtimeId: string;
+  name: string;
+  entry: string;
+  variables?: Record<string, string>;
+  secrets?: Record<string, string>;
+  integrity?: string;
+  plugins?: Record<string, unknown>;
+}): Promise<LoadedPluginResult>;
+declare function loadApiPluginsFromRuntimeConfig(runtimeConfig: RuntimeConfig, envSecrets?: Record<string, string>): Promise<LoadedPluginsResult>;
+declare function createStitchedRouter(baseRouter: any, plugins: LoadedPluginResult[] | null): any;
+//#endregion
+export { LoadedPluginResult, LoadedPluginsResult, createStitchedRouter, loadApiPlugin, loadApiPluginsFromRuntimeConfig };
+//# sourceMappingURL=api.d.cts.map

package/dist/api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.cts","names":[],"sources":["../src/api.ts"],"mappings":";;;UAKiB,kBAAA;EACf,GAAA;EACA,IAAA;EACA,MAAA;EACA,YAAA,GAAe,OAAA;EACf,QAAA;IACE,SAAA;IACA,OAAA;EAAA;AAAA;AAAA,UAIa,mBAAA;EACf,IAAA,EAAM,kBAAA;EACN,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,KAAA;IAAQ,GAAA;IAAa,KAAA;EAAA;AAAA;AAAA,iBAGT,aAAA,CAAc,IAAA;EAClC,GAAA;EACA,SAAA;EACA,IAAA;EACA,KAAA;EACA,SAAA,GAAY,MAAA;EACZ,OAAA,GAAU,MAAA;EACV,SAAA;EACA,OAAA,GAAU,MAAA;AAAA,IACR,OAAA,CAAQ,kBAAA;AAAA,iBAyDU,+BAAA,CACpB,aAAA,EAAe,aAAA,EACf,UAAA,GAAa,MAAA,mBACZ,OAAA,CAAQ,mBAAA;AAAA,iBAmFK,oBAAA,CAAqB,UAAA,OAAiB,OAAA,EAAS,kBAAA"}

package/dist/api.d.mts

@@ -0,0 +1,36 @@
+import { RuntimeConfig } from "./types.mjs";
+
+//#region src/api.d.ts
+interface LoadedPluginResult {
+  key: string;
+  name: string;
+  router: any;
+  createClient: (context?: unknown) => any;
+  metadata: {
+    remoteUrl: string;
+    version?: string;
+  };
+}
+interface LoadedPluginsResult {
+  base: LoadedPluginResult | null;
+  plugins: LoadedPluginResult[];
+  errors: Array<{
+    key: string;
+    error: string;
+  }>;
+}
+declare function loadApiPlugin(opts: {
+  key: string;
+  runtimeId: string;
+  name: string;
+  entry: string;
+  variables?: Record<string, string>;
+  secrets?: Record<string, string>;
+  integrity?: string;
+  plugins?: Record<string, unknown>;
+}): Promise<LoadedPluginResult>;
+declare function loadApiPluginsFromRuntimeConfig(runtimeConfig: RuntimeConfig, envSecrets?: Record<string, string>): Promise<LoadedPluginsResult>;
+declare function createStitchedRouter(baseRouter: any, plugins: LoadedPluginResult[] | null): any;
+//#endregion
+export { LoadedPluginResult, LoadedPluginsResult, createStitchedRouter, loadApiPlugin, loadApiPluginsFromRuntimeConfig };
+//# sourceMappingURL=api.d.mts.map

package/dist/api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.mts","names":[],"sources":["../src/api.ts"],"mappings":";;;UAKiB,kBAAA;EACf,GAAA;EACA,IAAA;EACA,MAAA;EACA,YAAA,GAAe,OAAA;EACf,QAAA;IACE,SAAA;IACA,OAAA;EAAA;AAAA;AAAA,UAIa,mBAAA;EACf,IAAA,EAAM,kBAAA;EACN,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,KAAA;IAAQ,GAAA;IAAa,KAAA;EAAA;AAAA;AAAA,iBAGT,aAAA,CAAc,IAAA;EAClC,GAAA;EACA,SAAA;EACA,IAAA;EACA,KAAA;EACA,SAAA,GAAY,MAAA;EACZ,OAAA,GAAU,MAAA;EACV,SAAA;EACA,OAAA,GAAU,MAAA;AAAA,IACR,OAAA,CAAQ,kBAAA;AAAA,iBAyDU,+BAAA,CACpB,aAAA,EAAe,aAAA,EACf,UAAA,GAAa,MAAA,mBACZ,OAAA,CAAQ,mBAAA;AAAA,iBAmFK,oBAAA,CAAqB,UAAA,OAAiB,OAAA,EAAS,kBAAA"}

package/dist/api.mjs

@@ -0,0 +1,119 @@
+import { createPluginRuntime } from "./sdk.mjs";
+import { ensureNodeRuntimePlugin, registerRemote } from "./mf.mjs";
+import { verifySriForUrl } from "./integrity.mjs";
+
+//#region src/api.ts
+async function loadApiPlugin(opts) {
+	const remoteEntryUrl = (() => {
+		if (opts.entry.endsWith("/remoteEntry.js")) return opts.entry;
+		if (opts.entry.endsWith("/mf-manifest.json")) return `${opts.entry.replace(/\/mf-manifest\.json$/, "")}/remoteEntry.js`;
+		if (opts.entry.endsWith(".js")) return opts.entry;
+		return `${opts.entry.replace(/\/$/, "")}/remoteEntry.js`;
+	})();
+	if (opts.integrity) await verifySriForUrl(remoteEntryUrl, opts.integrity);
+	await ensureNodeRuntimePlugin();
+	await registerRemote({
+		name: opts.runtimeId,
+		entry: remoteEntryUrl
+	});
+	const plugin = await createPluginRuntime({
+		registry: { [opts.runtimeId]: { remote: remoteEntryUrl } },
+		secrets: opts.secrets ?? {}
+	}).usePlugin(opts.runtimeId, {
+		variables: opts.variables ?? {},
+		secrets: opts.secrets ?? {}
+	}, opts.plugins);
+	return {
+		key: opts.key,
+		name: opts.name,
+		router: plugin.router,
+		createClient: plugin.createClient,
+		metadata: {
+			remoteUrl: remoteEntryUrl,
+			version: plugin.metadata.version
+		}
+	};
+}
+function collectSecrets(config, envSecrets) {
+	const secrets = {};
+	for (const key of config.secrets ?? []) {
+		const value = envSecrets?.[key] ?? process.env[key];
+		if (value) secrets[key] = value;
+	}
+	return secrets;
+}
+async function loadApiPluginsFromRuntimeConfig(runtimeConfig, envSecrets) {
+	const entries = [];
+	if (runtimeConfig.api?.url) entries.push(["api", runtimeConfig.api]);
+	for (const [key, plugin] of Object.entries(runtimeConfig.plugins ?? {})) if (plugin.url) entries.push([key, plugin]);
+	if (entries.length === 0) {
+		console.log("[API] No plugins configured");
+		return {
+			base: null,
+			plugins: [],
+			errors: []
+		};
+	}
+	const pluginEntries = entries.filter(([key]) => key !== "api");
+	const apiEntry = entries.find(([key]) => key === "api");
+	const pluginResults = await Promise.allSettled(pluginEntries.map(async ([key, pluginConfig]) => {
+		console.log(`[API] Loading plugin: ${pluginConfig.name} from ${pluginConfig.entry}`);
+		return loadApiPlugin({
+			key,
+			runtimeId: pluginConfig.name,
+			name: pluginConfig.name,
+			entry: pluginConfig.entry,
+			variables: pluginConfig.variables,
+			secrets: collectSecrets(pluginConfig, envSecrets),
+			integrity: pluginConfig.integrity
+		});
+	}));
+	const plugins = [];
+	const errors = [];
+	const pluginsClient = {};
+	pluginResults.forEach((result, index) => {
+		const [key] = pluginEntries[index] ?? ["unknown"];
+		if (result.status === "fulfilled") {
+			plugins.push(result.value);
+			pluginsClient[key] = result.value.createClient;
+		} else errors.push({
+			key,
+			error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+		});
+	});
+	let base = null;
+	if (apiEntry) {
+		const [key, apiConfig] = apiEntry;
+		try {
+			console.log(`[API] Loading API plugin: ${apiConfig.name} from ${apiConfig.entry}`);
+			base = await loadApiPlugin({
+				key,
+				runtimeId: apiConfig.name,
+				name: apiConfig.name,
+				entry: apiConfig.entry,
+				variables: apiConfig.variables,
+				secrets: collectSecrets(apiConfig, envSecrets),
+				integrity: apiConfig.integrity,
+				plugins: pluginsClient
+			});
+		} catch (error) {
+			errors.push({
+				key,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	return {
+		base,
+		plugins,
+		errors
+	};
+}
+function createStitchedRouter(baseRouter, plugins) {
+	if (!plugins || plugins.length === 0) return baseRouter;
+	return plugins.reduce((router, plugin) => Object.assign(router, plugin.router), baseRouter);
+}
+
+//#endregion
+export { createStitchedRouter, loadApiPlugin, loadApiPluginsFromRuntimeConfig };
+//# sourceMappingURL=api.mjs.map

package/dist/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../src/api.ts"],"sourcesContent":["import { verifySriForUrl } from \"./integrity\";\nimport { ensureNodeRuntimePlugin, registerRemote } from \"./mf\";\nimport { createPluginRuntime } from \"./sdk\";\nimport type { RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport interface LoadedPluginResult {\n  key: string;\n  name: string;\n  router: any;\n  createClient: (context?: unknown) => any;\n  metadata: {\n    remoteUrl: string;\n    version?: string;\n  };\n}\n\nexport interface LoadedPluginsResult {\n  base: LoadedPluginResult | null;\n  plugins: LoadedPluginResult[];\n  errors: Array<{ key: string; error: string }>;\n}\n\nexport async function loadApiPlugin(opts: {\n  key: string;\n  runtimeId: string;\n  name: string;\n  entry: string;\n  variables?: Record<string, string>;\n  secrets?: Record<string, string>;\n  integrity?: string;\n  plugins?: Record<string, unknown>;\n}): Promise<LoadedPluginResult> {\n  const remoteEntryUrl = (() => {\n    if (opts.entry.endsWith(\"/remoteEntry.js\")) return opts.entry;\n    if (opts.entry.endsWith(\"/mf-manifest.json\")) {\n      return `${opts.entry.replace(/\\/mf-manifest\\.json$/, \"\")}/remoteEntry.js`;\n    }\n    if (opts.entry.endsWith(\".js\")) return opts.entry;\n    return `${opts.entry.replace(/\\/$/, \"\")}/remoteEntry.js`;\n  })();\n\n  if (opts.integrity) {\n    await verifySriForUrl(remoteEntryUrl, opts.integrity);\n  }\n\n  await ensureNodeRuntimePlugin();\n  await registerRemote({ name: opts.runtimeId, entry: remoteEntryUrl });\n\n  const runtime: any = createPluginRuntime({\n    registry: {\n      [opts.runtimeId]: { remote: remoteEntryUrl },\n    },\n    secrets: opts.secrets ?? {},\n  });\n\n  // biome-ignore lint/correctness/useHookAtTopLevel: usePlugin is not a React hook\n  const plugin = await runtime.usePlugin(\n    opts.runtimeId,\n    {\n      variables: opts.variables ?? {},\n      secrets: opts.secrets ?? {},\n    },\n    opts.plugins,\n  );\n\n  return {\n    key: opts.key,\n    name: opts.name,\n    router: plugin.router,\n    createClient: plugin.createClient as (context?: unknown) => any,\n    metadata: {\n      remoteUrl: remoteEntryUrl,\n      version: plugin.metadata.version,\n    },\n  };\n}\n\nfunction collectSecrets(config: RuntimePluginConfig, envSecrets?: Record<string, string>) {\n  const secrets: Record<string, string> = {};\n  for (const key of config.secrets ?? []) {\n    const value = envSecrets?.[key] ?? process.env[key];\n    if (value) {\n      secrets[key] = value;\n    }\n  }\n  return secrets;\n}\n\nexport async function loadApiPluginsFromRuntimeConfig(\n  runtimeConfig: RuntimeConfig,\n  envSecrets?: Record<string, string>,\n): Promise<LoadedPluginsResult> {\n  const entries: Array<[string, RuntimePluginConfig]> = [];\n\n  if (runtimeConfig.api?.url) {\n    entries.push([\"api\", runtimeConfig.api]);\n  }\n\n  for (const [key, plugin] of Object.entries(runtimeConfig.plugins ?? {})) {\n    if (plugin.url) {\n      entries.push([key, plugin]);\n    }\n  }\n\n  if (entries.length === 0) {\n    console.log(\"[API] No plugins configured\");\n    return { base: null, plugins: [], errors: [] };\n  }\n\n  // Phase 1: Load non-API plugins first\n  const pluginEntries = entries.filter(([key]) => key !== \"api\");\n  const apiEntry = entries.find(([key]) => key === \"api\");\n\n  const pluginResults = await Promise.allSettled(\n    pluginEntries.map(async ([key, pluginConfig]) => {\n      console.log(`[API] Loading plugin: ${pluginConfig.name} from ${pluginConfig.entry}`);\n      return loadApiPlugin({\n        key,\n        runtimeId: pluginConfig.name,\n        name: pluginConfig.name,\n        entry: pluginConfig.entry,\n        variables: pluginConfig.variables,\n        secrets: collectSecrets(pluginConfig, envSecrets),\n        integrity: pluginConfig.integrity,\n      });\n    }),\n  );\n\n  const plugins: LoadedPluginResult[] = [];\n  const errors: Array<{ key: string; error: string }> = [];\n\n  const pluginsClient: Record<string, unknown> = {};\n\n  pluginResults.forEach((result, index) => {\n    const [key] = pluginEntries[index] ?? [\"unknown\"];\n    if (result.status === \"fulfilled\") {\n      plugins.push(result.value);\n      pluginsClient[key] = result.value.createClient;\n    } else {\n      errors.push({\n        key,\n        error: result.reason instanceof Error ? result.reason.message : String(result.reason),\n      });\n    }\n  });\n\n  // Phase 2: Load API plugin with injected plugins client\n  let base: LoadedPluginResult | null = null;\n\n  if (apiEntry) {\n    const [key, apiConfig] = apiEntry;\n    try {\n      console.log(`[API] Loading API plugin: ${apiConfig.name} from ${apiConfig.entry}`);\n      base = await loadApiPlugin({\n        key,\n        runtimeId: apiConfig.name,\n        name: apiConfig.name,\n        entry: apiConfig.entry,\n        variables: apiConfig.variables,\n        secrets: collectSecrets(apiConfig, envSecrets),\n        integrity: apiConfig.integrity,\n        plugins: pluginsClient,\n      });\n    } catch (error) {\n      errors.push({\n        key,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  return { base, plugins, errors };\n}\n\nexport function createStitchedRouter(baseRouter: any, plugins: LoadedPluginResult[] | null): any {\n  if (!plugins || plugins.length === 0) {\n    return baseRouter;\n  }\n\n  return plugins.reduce((router, plugin) => Object.assign(router, plugin.router), baseRouter);\n}\n"],"mappings":"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"}

package/dist/app.cjs

@@ -0,0 +1,156 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_network = require('./network.cjs');
+const require_config = require('./config.cjs');
+require('./orchestrator.cjs');
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let effect = require("effect");
+let node_net = require("node:net");
+
+//#region src/app.ts
+const DEFAULT_HOST_PORT = 3e3;
+const DEFAULT_UI_PORT = 3002;
+const DEFAULT_API_PORT = 3014;
+const DEFAULT_PLUGIN_PORT_START = 3021;
+function detectLocalPackages(bosConfig, runtimeConfig) {
+	const packages = [];
+	const configDir = require_config.getProjectRoot();
+	const uiLocalPath = runtimeConfig?.ui.localPath ?? require_config.resolveLocalDevelopmentPath(bosConfig?.app.ui.development, configDir);
+	if (uiLocalPath && (0, node_fs.existsSync)((0, node_path.join)(uiLocalPath, "package.json"))) packages.push("ui");
+	const apiLocalPath = runtimeConfig?.api.localPath ?? require_config.resolveLocalDevelopmentPath(bosConfig?.app.api.development, configDir);
+	if (apiLocalPath && (0, node_fs.existsSync)((0, node_path.join)(apiLocalPath, "package.json"))) packages.push("api");
+	const hostLocalPath = require_config.resolveLocalDevelopmentPath(bosConfig?.app.host.development, configDir);
+	if (hostLocalPath && (0, node_fs.existsSync)((0, node_path.join)(hostLocalPath, "package.json"))) packages.push("host");
+	else if ((0, node_fs.existsSync)((0, node_path.join)(configDir, "host", "package.json"))) packages.push("host");
+	for (const [pluginId, pluginConfig] of Object.entries(runtimeConfig?.plugins ?? {})) if (pluginConfig.localPath && (0, node_fs.existsSync)((0, node_path.join)(pluginConfig.localPath, "package.json"))) packages.push(`plugin:${pluginId}`);
+	return packages;
+}
+function buildRuntimeConfig(bosConfig, options) {
+	const configDir = require_config.getProjectRoot();
+	const uiConfig = bosConfig.app.ui;
+	const apiConfig = bosConfig.app.api;
+	const uiSource = options.uiSource ?? "local";
+	const apiSource = options.apiSource ?? "local";
+	const uiLocalPath = require_config.resolveLocalDevelopmentPath(uiConfig.development, configDir);
+	const apiLocalPath = require_config.resolveLocalDevelopmentPath(apiConfig.development, configDir);
+	const uiLocalUrl = !uiLocalPath && uiConfig.development && !require_config.isLocalDevelopmentTarget(uiConfig.development) ? uiConfig.development : "";
+	const apiLocalUrl = !apiLocalPath && apiConfig.development && !require_config.isLocalDevelopmentTarget(apiConfig.development) ? apiConfig.development : "";
+	return {
+		env: options.env ?? "development",
+		account: bosConfig.account,
+		domain: bosConfig.domain,
+		networkId: require_network.getNetworkIdForAccount(bosConfig.account),
+		hostUrl: options.hostUrl,
+		shared: bosConfig.shared,
+		ui: uiConfig ? {
+			name: uiConfig.name,
+			url: uiSource === "remote" ? uiConfig.production ?? "" : uiLocalUrl,
+			entry: uiSource === "remote" ? `${uiConfig.production ?? ""}/mf-manifest.json` : uiLocalUrl ? `${uiLocalUrl}/mf-manifest.json` : "/mf-manifest.json",
+			localPath: uiSource === "local" ? uiLocalPath ?? void 0 : void 0,
+			port: uiSource === "local" && uiLocalUrl ? require_config.parsePort(uiLocalUrl) : void 0,
+			ssrUrl: uiSource === "remote" ? uiConfig.ssr : void 0,
+			ssrIntegrity: uiSource === "remote" ? uiConfig.ssrIntegrity : void 0,
+			integrity: uiSource === "remote" ? uiConfig.productionIntegrity : void 0,
+			source: uiSource === "local" ? uiLocalPath ? "local" : "remote" : "remote"
+		} : {
+			name: "ui",
+			url: "",
+			entry: "/mf-manifest.json",
+			source: uiSource
+		},
+		api: apiConfig ? {
+			name: apiConfig.name,
+			url: apiSource === "remote" ? apiConfig.production ?? "" : apiLocalUrl,
+			entry: apiSource === "remote" ? `${apiConfig.production ?? ""}/mf-manifest.json` : apiLocalUrl ? `${apiLocalUrl}/mf-manifest.json` : "/mf-manifest.json",
+			localPath: apiSource === "local" ? apiLocalPath ?? void 0 : void 0,
+			port: apiSource === "local" && apiLocalUrl ? require_config.parsePort(apiLocalUrl) : void 0,
+			source: apiSource === "local" ? apiLocalPath ? "local" : "remote" : "remote",
+			proxy: options.proxy ?? apiConfig.proxy,
+			variables: apiConfig.variables,
+			secrets: apiConfig.secrets,
+			integrity: apiSource === "remote" ? apiConfig.productionIntegrity : void 0
+		} : {
+			name: "api",
+			url: "",
+			entry: "/mf-manifest.json",
+			source: apiSource
+		},
+		plugins: options.plugins
+	};
+}
+function probeTcpOpen(port, timeoutMs = 250) {
+	return new Promise((resolve) => {
+		const socket = (0, node_net.createConnection)({
+			host: "127.0.0.1",
+			port
+		});
+		const timer = setTimeout(() => {
+			socket.destroy();
+			resolve(false);
+		}, timeoutMs);
+		socket.once("connect", () => {
+			clearTimeout(timer);
+			socket.destroy();
+			resolve(true);
+		});
+		socket.once("error", () => {
+			clearTimeout(timer);
+			resolve(false);
+		});
+	});
+}
+async function pickAvailablePort(preferred, usedPorts) {
+	let port = preferred;
+	while (usedPorts.has(port) || await probeTcpOpen(port)) port += 1;
+	usedPorts.add(port);
+	return port;
+}
+function withLocalRuntimeUrl(entry, port) {
+	const url = `http://localhost:${port}`;
+	return {
+		...entry,
+		url,
+		entry: `${url}/mf-manifest.json`,
+		port
+	};
+}
+async function prepareDevelopmentRuntimeConfig(runtimeConfig, options) {
+	const usedPorts = /* @__PURE__ */ new Set();
+	const hostPort = await pickAvailablePort(options?.hostPort ?? (runtimeConfig.hostUrl ? require_config.parsePort(runtimeConfig.hostUrl) : DEFAULT_HOST_PORT), usedPorts);
+	const next = {
+		...runtimeConfig,
+		hostUrl: `http://localhost:${hostPort}`,
+		ui: { ...runtimeConfig.ui },
+		api: { ...runtimeConfig.api },
+		plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : void 0
+	};
+	if (next.ui.source === "local" && next.ui.localPath) {
+		const uiPort = await pickAvailablePort(next.ui.port ?? DEFAULT_UI_PORT, usedPorts);
+		next.ui = withLocalRuntimeUrl(next.ui, uiPort);
+		if (options?.ssr) {
+			const ssrPort = await pickAvailablePort(uiPort + 1, usedPorts);
+			next.ui.ssrUrl = `http://localhost:${ssrPort}`;
+		} else next.ui.ssrUrl = void 0;
+	}
+	if (next.api.source === "local" && next.api.localPath) {
+		const apiPort = await pickAvailablePort(next.api.port ?? DEFAULT_API_PORT, usedPorts);
+		next.api = withLocalRuntimeUrl(next.api, apiPort);
+	}
+	if (next.plugins) {
+		const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));
+		let pluginBasePort = DEFAULT_PLUGIN_PORT_START;
+		for (const [pluginId, plugin] of entries) {
+			if (plugin.source !== "local" || !plugin.localPath) continue;
+			const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);
+			next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);
+			pluginBasePort = pluginPort + 1;
+		}
+	}
+	return next;
+}
+
+//#endregion
+exports.buildRuntimeConfig = buildRuntimeConfig;
+exports.detectLocalPackages = detectLocalPackages;
+exports.prepareDevelopmentRuntimeConfig = prepareDevelopmentRuntimeConfig;
+//# sourceMappingURL=app.cjs.map

package/dist/app.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.cjs","names":["getProjectRoot","resolveLocalDevelopmentPath","isLocalDevelopmentTarget","getNetworkIdForAccount","parsePort"],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createConnection } from \"node:net\";\nimport { join } from \"node:path\";\nimport { Effect } from \"effect\";\nimport {\n  getProjectRoot,\n  isLocalDevelopmentTarget,\n  parsePort,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport { getNetworkIdForAccount } from \"./network\";\nimport { makeDevProcess, type ProcessCallbacks, type ProcessHandle } from \"./orchestrator\";\nimport type { ProcessRegistry } from \"./process-registry\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport interface AppOrchestrator {\n  packages: string[];\n  env: Record<string, string>;\n  description: string;\n  bosConfig: BosConfig;\n  runtimeConfig: RuntimeConfig;\n  port?: number;\n  interactive?: boolean;\n}\n\nconst STARTUP_ORDER = [\"ui-ssr\", \"ui\", \"api\", \"plugin\", \"host-build\", \"host\"];\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_UI_PORT = 3002;\nconst DEFAULT_API_PORT = 3014;\nconst DEFAULT_PLUGIN_PORT_START = 3021;\n\nconst sortByOrder = (packages: string[]): string[] => {\n  return [...packages].sort((a, b) => {\n    const aIdx = a.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(a);\n    const bIdx = b.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(b);\n    if (aIdx === -1 && bIdx === -1) return 0;\n    if (aIdx === -1) return 1;\n    if (bIdx === -1) return -1;\n    return aIdx - bIdx;\n  });\n};\n\n// Note: log filtering and persistence lives at the CLI layer.\n\nexport interface DevServersHandle {\n  handles: ProcessHandle[];\n  shutdown: Effect.Effect<void>;\n}\n\nexport const startDevServers = (\n  orchestrator: AppOrchestrator,\n  callbacks: ProcessCallbacks,\n  registry?: ProcessRegistry,\n) => {\n  const run = Effect.gen(function* () {\n    const orderedPackages = sortByOrder(orchestrator.packages);\n    const handles: ProcessHandle[] = [];\n\n    const startProcess = (pkg: string) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      return makeDevProcess(\n        pkg,\n        orchestrator.env,\n        callbacks,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n        registry,\n      );\n    };\n\n    const startGroup = (packages: string[]) =>\n      Effect.forEach(packages, startProcess, { concurrency: \"unbounded\" });\n\n    const awaitReady = (pkg: string, handle: ProcessHandle) =>\n      Effect.race(\n        handle.waitForReady,\n        Effect.sleep(\"30 seconds\").pipe(\n          Effect.andThen(\n            Effect.sync(() => {\n              callbacks.onLog(pkg, \"Timeout waiting for ready, continuing...\", true);\n            }),\n          ),\n        ),\n      );\n\n    const nonHostPackages = orderedPackages.filter((pkg) => pkg !== \"host\");\n    const hostPackages = orderedPackages.filter((pkg) => pkg === \"host\");\n\n    const nonHostHandles = yield* startGroup(nonHostPackages);\n    handles.push(...nonHostHandles);\n\n    yield* Effect.forEach(\n      nonHostHandles.map((handle, index) => ({\n        handle,\n        pkg: nonHostPackages[index] ?? handle.name,\n      })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const hostHandles = yield* startGroup(hostPackages);\n    handles.push(...hostHandles);\n\n    yield* Effect.forEach(\n      hostHandles.map((handle, index) => ({ handle, pkg: hostPackages[index] ?? handle.name })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const shutdown = Effect.gen(function* () {\n      const reversed = [...handles].reverse();\n      for (const handle of reversed) {\n        yield* Effect.tryPromise({\n          try: () => handle.kill(),\n          catch: () => null,\n        }).pipe(Effect.ignore);\n      }\n    });\n\n    return { handles, shutdown } satisfies DevServersHandle;\n  });\n\n  return run;\n};\n\nexport function detectLocalPackages(\n  bosConfig?: BosConfig,\n  runtimeConfig?: RuntimeConfig,\n): string[] {\n  const packages: string[] = [];\n  const configDir = getProjectRoot();\n\n  const uiLocalPath =\n    runtimeConfig?.ui.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.ui.development, configDir);\n  if (uiLocalPath && existsSync(join(uiLocalPath, \"package.json\"))) {\n    packages.push(\"ui\");\n  }\n\n  const apiLocalPath =\n    runtimeConfig?.api.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.api.development, configDir);\n  if (apiLocalPath && existsSync(join(apiLocalPath, \"package.json\"))) {\n    packages.push(\"api\");\n  }\n\n  const hostLocalPath = resolveLocalDevelopmentPath(bosConfig?.app.host.development, configDir);\n  if (hostLocalPath && existsSync(join(hostLocalPath, \"package.json\"))) {\n    packages.push(\"host\");\n  } else if (existsSync(join(configDir, \"host\", \"package.json\"))) {\n    packages.push(\"host\");\n  }\n\n  for (const [pluginId, pluginConfig] of Object.entries(runtimeConfig?.plugins ?? {})) {\n    if (pluginConfig.localPath && existsSync(join(pluginConfig.localPath, \"package.json\"))) {\n      packages.push(`plugin:${pluginId}`);\n    }\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    hostUrl: string;\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  const configDir = getProjectRoot();\n  const uiConfig = bosConfig.app.ui;\n  const apiConfig = bosConfig.app.api;\n  const uiSource = options.uiSource ?? \"local\";\n  const apiSource = options.apiSource ?? \"local\";\n  const uiLocalPath = resolveLocalDevelopmentPath(uiConfig.development, configDir);\n  const apiLocalPath = resolveLocalDevelopmentPath(apiConfig.development, configDir);\n  const uiLocalUrl =\n    !uiLocalPath && uiConfig.development && !isLocalDevelopmentTarget(uiConfig.development)\n      ? uiConfig.development\n      : \"\";\n  const apiLocalUrl =\n    !apiLocalPath && apiConfig.development && !isLocalDevelopmentTarget(apiConfig.development)\n      ? apiConfig.development\n      : \"\";\n\n  return {\n    env: options.env ?? \"development\",\n    account: bosConfig.account,\n    domain: bosConfig.domain,\n    networkId: getNetworkIdForAccount(bosConfig.account),\n    hostUrl: options.hostUrl,\n    shared: bosConfig.shared,\n    ui: uiConfig\n      ? {\n          name: uiConfig.name,\n          url: uiSource === \"remote\" ? (uiConfig.production ?? \"\") : uiLocalUrl,\n          entry:\n            uiSource === \"remote\"\n              ? `${uiConfig.production ?? \"\"}/mf-manifest.json`\n              : uiLocalUrl\n                ? `${uiLocalUrl}/mf-manifest.json`\n                : \"/mf-manifest.json\",\n          localPath: uiSource === \"local\" ? (uiLocalPath ?? undefined) : undefined,\n          port: uiSource === \"local\" && uiLocalUrl ? parsePort(uiLocalUrl) : undefined,\n          ssrUrl: uiSource === \"remote\" ? uiConfig.ssr : undefined,\n          ssrIntegrity: uiSource === \"remote\" ? uiConfig.ssrIntegrity : undefined,\n          integrity: uiSource === \"remote\" ? uiConfig.productionIntegrity : undefined,\n          source: uiSource === \"local\" ? (uiLocalPath ? \"local\" : \"remote\") : \"remote\",\n        }\n      : {\n          name: \"ui\",\n          url: \"\",\n          entry: \"/mf-manifest.json\",\n          source: uiSource,\n        },\n    api: apiConfig\n      ? {\n          name: apiConfig.name,\n          url: apiSource === \"remote\" ? (apiConfig.production ?? \"\") : apiLocalUrl,\n          entry:\n            apiSource === \"remote\"\n              ? `${apiConfig.production ?? \"\"}/mf-manifest.json`\n              : apiLocalUrl\n                ? `${apiLocalUrl}/mf-manifest.json`\n                : \"/mf-manifest.json\",\n          localPath: apiSource === \"local\" ? (apiLocalPath ?? undefined) : undefined,\n          port: apiSource === \"local\" && apiLocalUrl ? parsePort(apiLocalUrl) : undefined,\n          source: apiSource === \"local\" ? (apiLocalPath ? \"local\" : \"remote\") : \"remote\",\n          proxy: options.proxy ?? apiConfig.proxy,\n          variables: apiConfig.variables,\n          secrets: apiConfig.secrets,\n          integrity: apiSource === \"remote\" ? apiConfig.productionIntegrity : undefined,\n        }\n      : {\n          name: \"api\",\n          url: \"\",\n          entry: \"/mf-manifest.json\",\n          source: apiSource,\n        },\n    plugins: options.plugins,\n  };\n}\n\nfunction probeTcpOpen(port: number, timeoutMs = 250): Promise<boolean> {\n  return new Promise((resolve) => {\n    const socket = createConnection({ host: \"127.0.0.1\", port });\n    const timer = setTimeout(() => {\n      socket.destroy();\n      resolve(false);\n    }, timeoutMs);\n\n    socket.once(\"connect\", () => {\n      clearTimeout(timer);\n      socket.destroy();\n      resolve(true);\n    });\n\n    socket.once(\"error\", () => {\n      clearTimeout(timer);\n      resolve(false);\n    });\n  });\n}\n\nasync function pickAvailablePort(preferred: number, usedPorts: Set<number>): Promise<number> {\n  let port = preferred;\n  while (usedPorts.has(port) || (await probeTcpOpen(port))) {\n    port += 1;\n  }\n  usedPorts.add(port);\n  return port;\n}\n\nfunction withLocalRuntimeUrl<\n  T extends { url: string; entry: string; port?: number; localPath?: string },\n>(entry: T, port: number): T {\n  const url = `http://localhost:${port}`;\n  return {\n    ...entry,\n    url,\n    entry: `${url}/mf-manifest.json`,\n    port,\n  };\n}\n\nexport async function prepareDevelopmentRuntimeConfig(\n  runtimeConfig: RuntimeConfig,\n  options?: { hostPort?: number; ssr?: boolean },\n): Promise<RuntimeConfig> {\n  const usedPorts = new Set<number>();\n  const hostPort = await pickAvailablePort(\n    options?.hostPort ??\n      (runtimeConfig.hostUrl ? parsePort(runtimeConfig.hostUrl) : DEFAULT_HOST_PORT),\n    usedPorts,\n  );\n\n  const next: RuntimeConfig = {\n    ...runtimeConfig,\n    hostUrl: `http://localhost:${hostPort}`,\n    ui: { ...runtimeConfig.ui },\n    api: { ...runtimeConfig.api },\n    plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\n  };\n\n  if (next.ui.source === \"local\" && next.ui.localPath) {\n    const uiPort = await pickAvailablePort(next.ui.port ?? DEFAULT_UI_PORT, usedPorts);\n    next.ui = withLocalRuntimeUrl(next.ui, uiPort);\n    if (options?.ssr) {\n      const ssrPort = await pickAvailablePort(uiPort + 1, usedPorts);\n      next.ui.ssrUrl = `http://localhost:${ssrPort}`;\n    } else {\n      next.ui.ssrUrl = undefined;\n    }\n  }\n\n  if (next.api.source === \"local\" && next.api.localPath) {\n    const apiPort = await pickAvailablePort(next.api.port ?? DEFAULT_API_PORT, usedPorts);\n    next.api = withLocalRuntimeUrl(next.api, apiPort);\n  }\n\n  if (next.plugins) {\n    const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));\n    let pluginBasePort = DEFAULT_PLUGIN_PORT_START;\n\n    for (const [pluginId, plugin] of entries) {\n      if (plugin.source !== \"local\" || !plugin.localPath) {\n        continue;\n      }\n\n      const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);\n      next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n      pluginBasePort = pluginPort + 1;\n    }\n  }\n\n  return next;\n}\n"],"mappings":"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"}

package/dist/app.mjs

@@ -0,0 +1,153 @@
+import { getNetworkIdForAccount } from "./network.mjs";
+import { getProjectRoot, isLocalDevelopmentTarget, parsePort, resolveLocalDevelopmentPath } from "./config.mjs";
+import "./orchestrator.mjs";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { Effect } from "effect";
+import { createConnection } from "node:net";
+
+//#region src/app.ts
+const DEFAULT_HOST_PORT = 3e3;
+const DEFAULT_UI_PORT = 3002;
+const DEFAULT_API_PORT = 3014;
+const DEFAULT_PLUGIN_PORT_START = 3021;
+function detectLocalPackages(bosConfig, runtimeConfig) {
+	const packages = [];
+	const configDir = getProjectRoot();
+	const uiLocalPath = runtimeConfig?.ui.localPath ?? resolveLocalDevelopmentPath(bosConfig?.app.ui.development, configDir);
+	if (uiLocalPath && existsSync(join(uiLocalPath, "package.json"))) packages.push("ui");
+	const apiLocalPath = runtimeConfig?.api.localPath ?? resolveLocalDevelopmentPath(bosConfig?.app.api.development, configDir);
+	if (apiLocalPath && existsSync(join(apiLocalPath, "package.json"))) packages.push("api");
+	const hostLocalPath = resolveLocalDevelopmentPath(bosConfig?.app.host.development, configDir);
+	if (hostLocalPath && existsSync(join(hostLocalPath, "package.json"))) packages.push("host");
+	else if (existsSync(join(configDir, "host", "package.json"))) packages.push("host");
+	for (const [pluginId, pluginConfig] of Object.entries(runtimeConfig?.plugins ?? {})) if (pluginConfig.localPath && existsSync(join(pluginConfig.localPath, "package.json"))) packages.push(`plugin:${pluginId}`);
+	return packages;
+}
+function buildRuntimeConfig(bosConfig, options) {
+	const configDir = getProjectRoot();
+	const uiConfig = bosConfig.app.ui;
+	const apiConfig = bosConfig.app.api;
+	const uiSource = options.uiSource ?? "local";
+	const apiSource = options.apiSource ?? "local";
+	const uiLocalPath = resolveLocalDevelopmentPath(uiConfig.development, configDir);
+	const apiLocalPath = resolveLocalDevelopmentPath(apiConfig.development, configDir);
+	const uiLocalUrl = !uiLocalPath && uiConfig.development && !isLocalDevelopmentTarget(uiConfig.development) ? uiConfig.development : "";
+	const apiLocalUrl = !apiLocalPath && apiConfig.development && !isLocalDevelopmentTarget(apiConfig.development) ? apiConfig.development : "";
+	return {
+		env: options.env ?? "development",
+		account: bosConfig.account,
+		domain: bosConfig.domain,
+		networkId: getNetworkIdForAccount(bosConfig.account),
+		hostUrl: options.hostUrl,
+		shared: bosConfig.shared,
+		ui: uiConfig ? {
+			name: uiConfig.name,
+			url: uiSource === "remote" ? uiConfig.production ?? "" : uiLocalUrl,
+			entry: uiSource === "remote" ? `${uiConfig.production ?? ""}/mf-manifest.json` : uiLocalUrl ? `${uiLocalUrl}/mf-manifest.json` : "/mf-manifest.json",
+			localPath: uiSource === "local" ? uiLocalPath ?? void 0 : void 0,
+			port: uiSource === "local" && uiLocalUrl ? parsePort(uiLocalUrl) : void 0,
+			ssrUrl: uiSource === "remote" ? uiConfig.ssr : void 0,
+			ssrIntegrity: uiSource === "remote" ? uiConfig.ssrIntegrity : void 0,
+			integrity: uiSource === "remote" ? uiConfig.productionIntegrity : void 0,
+			source: uiSource === "local" ? uiLocalPath ? "local" : "remote" : "remote"
+		} : {
+			name: "ui",
+			url: "",
+			entry: "/mf-manifest.json",
+			source: uiSource
+		},
+		api: apiConfig ? {
+			name: apiConfig.name,
+			url: apiSource === "remote" ? apiConfig.production ?? "" : apiLocalUrl,
+			entry: apiSource === "remote" ? `${apiConfig.production ?? ""}/mf-manifest.json` : apiLocalUrl ? `${apiLocalUrl}/mf-manifest.json` : "/mf-manifest.json",
+			localPath: apiSource === "local" ? apiLocalPath ?? void 0 : void 0,
+			port: apiSource === "local" && apiLocalUrl ? parsePort(apiLocalUrl) : void 0,
+			source: apiSource === "local" ? apiLocalPath ? "local" : "remote" : "remote",
+			proxy: options.proxy ?? apiConfig.proxy,
+			variables: apiConfig.variables,
+			secrets: apiConfig.secrets,
+			integrity: apiSource === "remote" ? apiConfig.productionIntegrity : void 0
+		} : {
+			name: "api",
+			url: "",
+			entry: "/mf-manifest.json",
+			source: apiSource
+		},
+		plugins: options.plugins
+	};
+}
+function probeTcpOpen(port, timeoutMs = 250) {
+	return new Promise((resolve) => {
+		const socket = createConnection({
+			host: "127.0.0.1",
+			port
+		});
+		const timer = setTimeout(() => {
+			socket.destroy();
+			resolve(false);
+		}, timeoutMs);
+		socket.once("connect", () => {
+			clearTimeout(timer);
+			socket.destroy();
+			resolve(true);
+		});
+		socket.once("error", () => {
+			clearTimeout(timer);
+			resolve(false);
+		});
+	});
+}
+async function pickAvailablePort(preferred, usedPorts) {
+	let port = preferred;
+	while (usedPorts.has(port) || await probeTcpOpen(port)) port += 1;
+	usedPorts.add(port);
+	return port;
+}
+function withLocalRuntimeUrl(entry, port) {
+	const url = `http://localhost:${port}`;
+	return {
+		...entry,
+		url,
+		entry: `${url}/mf-manifest.json`,
+		port
+	};
+}
+async function prepareDevelopmentRuntimeConfig(runtimeConfig, options) {
+	const usedPorts = /* @__PURE__ */ new Set();
+	const hostPort = await pickAvailablePort(options?.hostPort ?? (runtimeConfig.hostUrl ? parsePort(runtimeConfig.hostUrl) : DEFAULT_HOST_PORT), usedPorts);
+	const next = {
+		...runtimeConfig,
+		hostUrl: `http://localhost:${hostPort}`,
+		ui: { ...runtimeConfig.ui },
+		api: { ...runtimeConfig.api },
+		plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : void 0
+	};
+	if (next.ui.source === "local" && next.ui.localPath) {
+		const uiPort = await pickAvailablePort(next.ui.port ?? DEFAULT_UI_PORT, usedPorts);
+		next.ui = withLocalRuntimeUrl(next.ui, uiPort);
+		if (options?.ssr) {
+			const ssrPort = await pickAvailablePort(uiPort + 1, usedPorts);
+			next.ui.ssrUrl = `http://localhost:${ssrPort}`;
+		} else next.ui.ssrUrl = void 0;
+	}
+	if (next.api.source === "local" && next.api.localPath) {
+		const apiPort = await pickAvailablePort(next.api.port ?? DEFAULT_API_PORT, usedPorts);
+		next.api = withLocalRuntimeUrl(next.api, apiPort);
+	}
+	if (next.plugins) {
+		const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));
+		let pluginBasePort = DEFAULT_PLUGIN_PORT_START;
+		for (const [pluginId, plugin] of entries) {
+			if (plugin.source !== "local" || !plugin.localPath) continue;
+			const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);
+			next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);
+			pluginBasePort = pluginPort + 1;
+		}
+	}
+	return next;
+}
+
+//#endregion
+export { buildRuntimeConfig, detectLocalPackages, prepareDevelopmentRuntimeConfig };
+//# sourceMappingURL=app.mjs.map

package/dist/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","names":[],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createConnection } from \"node:net\";\nimport { join } from \"node:path\";\nimport { Effect } from \"effect\";\nimport {\n  getProjectRoot,\n  isLocalDevelopmentTarget,\n  parsePort,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport { getNetworkIdForAccount } from \"./network\";\nimport { makeDevProcess, type ProcessCallbacks, type ProcessHandle } from \"./orchestrator\";\nimport type { ProcessRegistry } from \"./process-registry\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport interface AppOrchestrator {\n  packages: string[];\n  env: Record<string, string>;\n  description: string;\n  bosConfig: BosConfig;\n  runtimeConfig: RuntimeConfig;\n  port?: number;\n  interactive?: boolean;\n}\n\nconst STARTUP_ORDER = [\"ui-ssr\", \"ui\", \"api\", \"plugin\", \"host-build\", \"host\"];\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_UI_PORT = 3002;\nconst DEFAULT_API_PORT = 3014;\nconst DEFAULT_PLUGIN_PORT_START = 3021;\n\nconst sortByOrder = (packages: string[]): string[] => {\n  return [...packages].sort((a, b) => {\n    const aIdx = a.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(a);\n    const bIdx = b.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(b);\n    if (aIdx === -1 && bIdx === -1) return 0;\n    if (aIdx === -1) return 1;\n    if (bIdx === -1) return -1;\n    return aIdx - bIdx;\n  });\n};\n\n// Note: log filtering and persistence lives at the CLI layer.\n\nexport interface DevServersHandle {\n  handles: ProcessHandle[];\n  shutdown: Effect.Effect<void>;\n}\n\nexport const startDevServers = (\n  orchestrator: AppOrchestrator,\n  callbacks: ProcessCallbacks,\n  registry?: ProcessRegistry,\n) => {\n  const run = Effect.gen(function* () {\n    const orderedPackages = sortByOrder(orchestrator.packages);\n    const handles: ProcessHandle[] = [];\n\n    const startProcess = (pkg: string) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      return makeDevProcess(\n        pkg,\n        orchestrator.env,\n        callbacks,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n        registry,\n      );\n    };\n\n    const startGroup = (packages: string[]) =>\n      Effect.forEach(packages, startProcess, { concurrency: \"unbounded\" });\n\n    const awaitReady = (pkg: string, handle: ProcessHandle) =>\n      Effect.race(\n        handle.waitForReady,\n        Effect.sleep(\"30 seconds\").pipe(\n          Effect.andThen(\n            Effect.sync(() => {\n              callbacks.onLog(pkg, \"Timeout waiting for ready, continuing...\", true);\n            }),\n          ),\n        ),\n      );\n\n    const nonHostPackages = orderedPackages.filter((pkg) => pkg !== \"host\");\n    const hostPackages = orderedPackages.filter((pkg) => pkg === \"host\");\n\n    const nonHostHandles = yield* startGroup(nonHostPackages);\n    handles.push(...nonHostHandles);\n\n    yield* Effect.forEach(\n      nonHostHandles.map((handle, index) => ({\n        handle,\n        pkg: nonHostPackages[index] ?? handle.name,\n      })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const hostHandles = yield* startGroup(hostPackages);\n    handles.push(...hostHandles);\n\n    yield* Effect.forEach(\n      hostHandles.map((handle, index) => ({ handle, pkg: hostPackages[index] ?? handle.name })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const shutdown = Effect.gen(function* () {\n      const reversed = [...handles].reverse();\n      for (const handle of reversed) {\n        yield* Effect.tryPromise({\n          try: () => handle.kill(),\n          catch: () => null,\n        }).pipe(Effect.ignore);\n      }\n    });\n\n    return { handles, shutdown } satisfies DevServersHandle;\n  });\n\n  return run;\n};\n\nexport function detectLocalPackages(\n  bosConfig?: BosConfig,\n  runtimeConfig?: RuntimeConfig,\n): string[] {\n  const packages: string[] = [];\n  const configDir = getProjectRoot();\n\n  const uiLocalPath =\n    runtimeConfig?.ui.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.ui.development, configDir);\n  if (uiLocalPath && existsSync(join(uiLocalPath, \"package.json\"))) {\n    packages.push(\"ui\");\n  }\n\n  const apiLocalPath =\n    runtimeConfig?.api.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.api.development, configDir);\n  if (apiLocalPath && existsSync(join(apiLocalPath, \"package.json\"))) {\n    packages.push(\"api\");\n  }\n\n  const hostLocalPath = resolveLocalDevelopmentPath(bosConfig?.app.host.development, configDir);\n  if (hostLocalPath && existsSync(join(hostLocalPath, \"package.json\"))) {\n    packages.push(\"host\");\n  } else if (existsSync(join(configDir, \"host\", \"package.json\"))) {\n    packages.push(\"host\");\n  }\n\n  for (const [pluginId, pluginConfig] of Object.entries(runtimeConfig?.plugins ?? {})) {\n    if (pluginConfig.localPath && existsSync(join(pluginConfig.localPath, \"package.json\"))) {\n      packages.push(`plugin:${pluginId}`);\n    }\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    hostUrl: string;\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  const configDir = getProjectRoot();\n  const uiConfig = bosConfig.app.ui;\n  const apiConfig = bosConfig.app.api;\n  const uiSource = options.uiSource ?? \"local\";\n  const apiSource = options.apiSource ?? \"local\";\n  const uiLocalPath = resolveLocalDevelopmentPath(uiConfig.development, configDir);\n  const apiLocalPath = resolveLocalDevelopmentPath(apiConfig.development, configDir);\n  const uiLocalUrl =\n    !uiLocalPath && uiConfig.development && !isLocalDevelopmentTarget(uiConfig.development)\n      ? uiConfig.development\n      : \"\";\n  const apiLocalUrl =\n    !apiLocalPath && apiConfig.development && !isLocalDevelopmentTarget(apiConfig.development)\n      ? apiConfig.development\n      : \"\";\n\n  return {\n    env: options.env ?? \"development\",\n    account: bosConfig.account,\n    domain: bosConfig.domain,\n    networkId: getNetworkIdForAccount(bosConfig.account),\n    hostUrl: options.hostUrl,\n    shared: bosConfig.shared,\n    ui: uiConfig\n      ? {\n          name: uiConfig.name,\n          url: uiSource === \"remote\" ? (uiConfig.production ?? \"\") : uiLocalUrl,\n          entry:\n            uiSource === \"remote\"\n              ? `${uiConfig.production ?? \"\"}/mf-manifest.json`\n              : uiLocalUrl\n                ? `${uiLocalUrl}/mf-manifest.json`\n                : \"/mf-manifest.json\",\n          localPath: uiSource === \"local\" ? (uiLocalPath ?? undefined) : undefined,\n          port: uiSource === \"local\" && uiLocalUrl ? parsePort(uiLocalUrl) : undefined,\n          ssrUrl: uiSource === \"remote\" ? uiConfig.ssr : undefined,\n          ssrIntegrity: uiSource === \"remote\" ? uiConfig.ssrIntegrity : undefined,\n          integrity: uiSource === \"remote\" ? uiConfig.productionIntegrity : undefined,\n          source: uiSource === \"local\" ? (uiLocalPath ? \"local\" : \"remote\") : \"remote\",\n        }\n      : {\n          name: \"ui\",\n          url: \"\",\n          entry: \"/mf-manifest.json\",\n          source: uiSource,\n        },\n    api: apiConfig\n      ? {\n          name: apiConfig.name,\n          url: apiSource === \"remote\" ? (apiConfig.production ?? \"\") : apiLocalUrl,\n          entry:\n            apiSource === \"remote\"\n              ? `${apiConfig.production ?? \"\"}/mf-manifest.json`\n              : apiLocalUrl\n                ? `${apiLocalUrl}/mf-manifest.json`\n                : \"/mf-manifest.json\",\n          localPath: apiSource === \"local\" ? (apiLocalPath ?? undefined) : undefined,\n          port: apiSource === \"local\" && apiLocalUrl ? parsePort(apiLocalUrl) : undefined,\n          source: apiSource === \"local\" ? (apiLocalPath ? \"local\" : \"remote\") : \"remote\",\n          proxy: options.proxy ?? apiConfig.proxy,\n          variables: apiConfig.variables,\n          secrets: apiConfig.secrets,\n          integrity: apiSource === \"remote\" ? apiConfig.productionIntegrity : undefined,\n        }\n      : {\n          name: \"api\",\n          url: \"\",\n          entry: \"/mf-manifest.json\",\n          source: apiSource,\n        },\n    plugins: options.plugins,\n  };\n}\n\nfunction probeTcpOpen(port: number, timeoutMs = 250): Promise<boolean> {\n  return new Promise((resolve) => {\n    const socket = createConnection({ host: \"127.0.0.1\", port });\n    const timer = setTimeout(() => {\n      socket.destroy();\n      resolve(false);\n    }, timeoutMs);\n\n    socket.once(\"connect\", () => {\n      clearTimeout(timer);\n      socket.destroy();\n      resolve(true);\n    });\n\n    socket.once(\"error\", () => {\n      clearTimeout(timer);\n      resolve(false);\n    });\n  });\n}\n\nasync function pickAvailablePort(preferred: number, usedPorts: Set<number>): Promise<number> {\n  let port = preferred;\n  while (usedPorts.has(port) || (await probeTcpOpen(port))) {\n    port += 1;\n  }\n  usedPorts.add(port);\n  return port;\n}\n\nfunction withLocalRuntimeUrl<\n  T extends { url: string; entry: string; port?: number; localPath?: string },\n>(entry: T, port: number): T {\n  const url = `http://localhost:${port}`;\n  return {\n    ...entry,\n    url,\n    entry: `${url}/mf-manifest.json`,\n    port,\n  };\n}\n\nexport async function prepareDevelopmentRuntimeConfig(\n  runtimeConfig: RuntimeConfig,\n  options?: { hostPort?: number; ssr?: boolean },\n): Promise<RuntimeConfig> {\n  const usedPorts = new Set<number>();\n  const hostPort = await pickAvailablePort(\n    options?.hostPort ??\n      (runtimeConfig.hostUrl ? parsePort(runtimeConfig.hostUrl) : DEFAULT_HOST_PORT),\n    usedPorts,\n  );\n\n  const next: RuntimeConfig = {\n    ...runtimeConfig,\n    hostUrl: `http://localhost:${hostPort}`,\n    ui: { ...runtimeConfig.ui },\n    api: { ...runtimeConfig.api },\n    plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\n  };\n\n  if (next.ui.source === \"local\" && next.ui.localPath) {\n    const uiPort = await pickAvailablePort(next.ui.port ?? DEFAULT_UI_PORT, usedPorts);\n    next.ui = withLocalRuntimeUrl(next.ui, uiPort);\n    if (options?.ssr) {\n      const ssrPort = await pickAvailablePort(uiPort + 1, usedPorts);\n      next.ui.ssrUrl = `http://localhost:${ssrPort}`;\n    } else {\n      next.ui.ssrUrl = undefined;\n    }\n  }\n\n  if (next.api.source === \"local\" && next.api.localPath) {\n    const apiPort = await pickAvailablePort(next.api.port ?? DEFAULT_API_PORT, usedPorts);\n    next.api = withLocalRuntimeUrl(next.api, apiPort);\n  }\n\n  if (next.plugins) {\n    const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));\n    let pluginBasePort = DEFAULT_PLUGIN_PORT_START;\n\n    for (const [pluginId, plugin] of entries) {\n      if (plugin.source !== \"local\" || !plugin.localPath) {\n        continue;\n      }\n\n      const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);\n      next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n      pluginBasePort = pluginPort + 1;\n    }\n  }\n\n  return next;\n}\n"],"mappings":";;;;;;;;;AA0BA,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AACzB,MAAM,4BAA4B;AAqGlC,SAAgB,oBACd,WACA,eACU;CACV,MAAM,WAAqB,EAAE;CAC7B,MAAM,YAAY,gBAAgB;CAElC,MAAM,cACJ,eAAe,GAAG,aAClB,4BAA4B,WAAW,IAAI,GAAG,aAAa,UAAU;AACvE,KAAI,eAAe,WAAW,KAAK,aAAa,eAAe,CAAC,CAC9D,UAAS,KAAK,KAAK;CAGrB,MAAM,eACJ,eAAe,IAAI,aACnB,4BAA4B,WAAW,IAAI,IAAI,aAAa,UAAU;AACxE,KAAI,gBAAgB,WAAW,KAAK,cAAc,eAAe,CAAC,CAChE,UAAS,KAAK,MAAM;CAGtB,MAAM,gBAAgB,4BAA4B,WAAW,IAAI,KAAK,aAAa,UAAU;AAC7F,KAAI,iBAAiB,WAAW,KAAK,eAAe,eAAe,CAAC,CAClE,UAAS,KAAK,OAAO;UACZ,WAAW,KAAK,WAAW,QAAQ,eAAe,CAAC,CAC5D,UAAS,KAAK,OAAO;AAGvB,MAAK,MAAM,CAAC,UAAU,iBAAiB,OAAO,QAAQ,eAAe,WAAW,EAAE,CAAC,CACjF,KAAI,aAAa,aAAa,WAAW,KAAK,aAAa,WAAW,eAAe,CAAC,CACpF,UAAS,KAAK,UAAU,WAAW;AAIvC,QAAO;;AAGT,SAAgB,mBACd,WACA,SAQe;CACf,MAAM,YAAY,gBAAgB;CAClC,MAAM,WAAW,UAAU,IAAI;CAC/B,MAAM,YAAY,UAAU,IAAI;CAChC,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,cAAc,4BAA4B,SAAS,aAAa,UAAU;CAChF,MAAM,eAAe,4BAA4B,UAAU,aAAa,UAAU;CAClF,MAAM,aACJ,CAAC,eAAe,SAAS,eAAe,CAAC,yBAAyB,SAAS,YAAY,GACnF,SAAS,cACT;CACN,MAAM,cACJ,CAAC,gBAAgB,UAAU,eAAe,CAAC,yBAAyB,UAAU,YAAY,GACtF,UAAU,cACV;AAEN,QAAO;EACL,KAAK,QAAQ,OAAO;EACpB,SAAS,UAAU;EACnB,QAAQ,UAAU;EAClB,WAAW,uBAAuB,UAAU,QAAQ;EACpD,SAAS,QAAQ;EACjB,QAAQ,UAAU;EAClB,IAAI,WACA;GACE,MAAM,SAAS;GACf,KAAK,aAAa,WAAY,SAAS,cAAc,KAAM;GAC3D,OACE,aAAa,WACT,GAAG,SAAS,cAAc,GAAG,qBAC7B,aACE,GAAG,WAAW,qBACd;GACR,WAAW,aAAa,UAAW,eAAe,SAAa;GAC/D,MAAM,aAAa,WAAW,aAAa,UAAU,WAAW,GAAG;GACnE,QAAQ,aAAa,WAAW,SAAS,MAAM;GAC/C,cAAc,aAAa,WAAW,SAAS,eAAe;GAC9D,WAAW,aAAa,WAAW,SAAS,sBAAsB;GAClE,QAAQ,aAAa,UAAW,cAAc,UAAU,WAAY;GACrE,GACD;GACE,MAAM;GACN,KAAK;GACL,OAAO;GACP,QAAQ;GACT;EACL,KAAK,YACD;GACE,MAAM,UAAU;GAChB,KAAK,cAAc,WAAY,UAAU,cAAc,KAAM;GAC7D,OACE,cAAc,WACV,GAAG,UAAU,cAAc,GAAG,qBAC9B,cACE,GAAG,YAAY,qBACf;GACR,WAAW,cAAc,UAAW,gBAAgB,SAAa;GACjE,MAAM,cAAc,WAAW,cAAc,UAAU,YAAY,GAAG;GACtE,QAAQ,cAAc,UAAW,eAAe,UAAU,WAAY;GACtE,OAAO,QAAQ,SAAS,UAAU;GAClC,WAAW,UAAU;GACrB,SAAS,UAAU;GACnB,WAAW,cAAc,WAAW,UAAU,sBAAsB;GACrE,GACD;GACE,MAAM;GACN,KAAK;GACL,OAAO;GACP,QAAQ;GACT;EACL,SAAS,QAAQ;EAClB;;AAGH,SAAS,aAAa,MAAc,YAAY,KAAuB;AACrE,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,SAAS,iBAAiB;GAAE,MAAM;GAAa;GAAM,CAAC;EAC5D,MAAM,QAAQ,iBAAiB;AAC7B,UAAO,SAAS;AAChB,WAAQ,MAAM;KACb,UAAU;AAEb,SAAO,KAAK,iBAAiB;AAC3B,gBAAa,MAAM;AACnB,UAAO,SAAS;AAChB,WAAQ,KAAK;IACb;AAEF,SAAO,KAAK,eAAe;AACzB,gBAAa,MAAM;AACnB,WAAQ,MAAM;IACd;GACF;;AAGJ,eAAe,kBAAkB,WAAmB,WAAyC;CAC3F,IAAI,OAAO;AACX,QAAO,UAAU,IAAI,KAAK,IAAK,MAAM,aAAa,KAAK,CACrD,SAAQ;AAEV,WAAU,IAAI,KAAK;AACnB,QAAO;;AAGT,SAAS,oBAEP,OAAU,MAAiB;CAC3B,MAAM,MAAM,oBAAoB;AAChC,QAAO;EACL,GAAG;EACH;EACA,OAAO,GAAG,IAAI;EACd;EACD;;AAGH,eAAsB,gCACpB,eACA,SACwB;CACxB,MAAM,4BAAY,IAAI,KAAa;CACnC,MAAM,WAAW,MAAM,kBACrB,SAAS,aACN,cAAc,UAAU,UAAU,cAAc,QAAQ,GAAG,oBAC9D,UACD;CAED,MAAM,OAAsB;EAC1B,GAAG;EACH,SAAS,oBAAoB;EAC7B,IAAI,EAAE,GAAG,cAAc,IAAI;EAC3B,KAAK,EAAE,GAAG,cAAc,KAAK;EAC7B,SAAS,cAAc,UAAU,EAAE,GAAG,cAAc,SAAS,GAAG;EACjE;AAED,KAAI,KAAK,GAAG,WAAW,WAAW,KAAK,GAAG,WAAW;EACnD,MAAM,SAAS,MAAM,kBAAkB,KAAK,GAAG,QAAQ,iBAAiB,UAAU;AAClF,OAAK,KAAK,oBAAoB,KAAK,IAAI,OAAO;AAC9C,MAAI,SAAS,KAAK;GAChB,MAAM,UAAU,MAAM,kBAAkB,SAAS,GAAG,UAAU;AAC9D,QAAK,GAAG,SAAS,oBAAoB;QAErC,MAAK,GAAG,SAAS;;AAIrB,KAAI,KAAK,IAAI,WAAW,WAAW,KAAK,IAAI,WAAW;EACrD,MAAM,UAAU,MAAM,kBAAkB,KAAK,IAAI,QAAQ,kBAAkB,UAAU;AACrF,OAAK,MAAM,oBAAoB,KAAK,KAAK,QAAQ;;AAGnD,KAAI,KAAK,SAAS;EAChB,MAAM,UAAU,OAAO,QAAQ,KAAK,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;EACnF,IAAI,iBAAiB;AAErB,OAAK,MAAM,CAAC,UAAU,WAAW,SAAS;AACxC,OAAI,OAAO,WAAW,WAAW,CAAC,OAAO,UACvC;GAGF,MAAM,aAAa,MAAM,kBAAkB,OAAO,QAAQ,gBAAgB,UAAU;AACpF,QAAK,QAAQ,YAAY,oBAAoB,QAAQ,WAAW;AAChE,oBAAiB,aAAa;;;AAIlC,QAAO"}

package/dist/cli/catalog.cjs

@@ -0,0 +1,30 @@
+const require_contract = require('../contract.cjs');
+const require_contract_meta = require('../contract.meta.cjs');
+
+//#region src/cli/catalog.ts
+function splitCamelCase(value) {
+	return value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/\s+/).map((part) => part.trim()).filter(Boolean).map((part) => part.toLowerCase());
+}
+const commandCatalog = Object.entries(require_contract.bosContract).map(([key, procedure]) => {
+	const meta = require_contract_meta.cliCommandMeta[key] ?? { summary: splitCamelCase(String(key)).join(" ") };
+	return {
+		key,
+		commandPath: meta.commandPath ?? splitCamelCase(String(key)),
+		summary: meta.summary,
+		meta,
+		procedure
+	};
+});
+function findCommandDescriptor(args) {
+	const sorted = [...commandCatalog].sort((a, b) => b.commandPath.length - a.commandPath.length);
+	for (const descriptor of sorted) if (args.slice(0, descriptor.commandPath.length).map((part) => part.toLowerCase()).join(" ") === descriptor.commandPath.join(" ")) return {
+		descriptor,
+		consumed: descriptor.commandPath.length
+	};
+	return null;
+}
+
+//#endregion
+exports.commandCatalog = commandCatalog;
+exports.findCommandDescriptor = findCommandDescriptor;
+//# sourceMappingURL=catalog.cjs.map

package/dist/cli/catalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.cjs","names":["bosContract","cliCommandMeta"],"sources":["../../src/cli/catalog.ts"],"sourcesContent":["import { bosContract } from \"../contract\";\nimport { type CliCommandMeta, cliCommandMeta } from \"../contract.meta\";\n\nexport type CommandDescriptor = {\n  key: keyof typeof bosContract;\n  commandPath: string[];\n  summary: string;\n  meta: CliCommandMeta;\n  procedure: (typeof bosContract)[keyof typeof bosContract];\n};\n\nfunction splitCamelCase(value: string): string[] {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .split(/\\s+/)\n    .map((part) => part.trim())\n    .filter(Boolean)\n    .map((part) => part.toLowerCase());\n}\n\nexport const commandCatalog: CommandDescriptor[] = (\n  Object.entries(bosContract) as Array<\n    [keyof typeof bosContract, (typeof bosContract)[keyof typeof bosContract]]\n  >\n).map(([key, procedure]) => {\n  const meta = cliCommandMeta[key as keyof typeof cliCommandMeta] ?? {\n    summary: splitCamelCase(String(key)).join(\" \"),\n  };\n  return {\n    key,\n    commandPath: meta.commandPath ?? splitCamelCase(String(key)),\n    summary: meta.summary,\n    meta,\n    procedure,\n  };\n});\n\nexport function findCommandDescriptor(\n  args: string[],\n): { descriptor: CommandDescriptor; consumed: number } | null {\n  const sorted = [...commandCatalog].sort((a, b) => b.commandPath.length - a.commandPath.length);\n  for (const descriptor of sorted) {\n    const parts = args.slice(0, descriptor.commandPath.length).map((part) => part.toLowerCase());\n    if (parts.join(\" \") === descriptor.commandPath.join(\" \")) {\n      return { descriptor, consumed: descriptor.commandPath.length };\n    }\n  }\n  return null;\n}\n"],"mappings":";;;;AAWA,SAAS,eAAe,OAAyB;AAC/C,QAAO,MACJ,QAAQ,sBAAsB,QAAQ,CACtC,MAAM,MAAM,CACZ,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ,CACf,KAAK,SAAS,KAAK,aAAa,CAAC;;AAGtC,MAAa,iBACX,OAAO,QAAQA,6BAAY,CAG3B,KAAK,CAAC,KAAK,eAAe;CAC1B,MAAM,OAAOC,qCAAe,QAAuC,EACjE,SAAS,eAAe,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,EAC/C;AACD,QAAO;EACL;EACA,aAAa,KAAK,eAAe,eAAe,OAAO,IAAI,CAAC;EAC5D,SAAS,KAAK;EACd;EACA;EACD;EACD;AAEF,SAAgB,sBACd,MAC4D;CAC5D,MAAM,SAAS,CAAC,GAAG,eAAe,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,SAAS,EAAE,YAAY,OAAO;AAC9F,MAAK,MAAM,cAAc,OAEvB,KADc,KAAK,MAAM,GAAG,WAAW,YAAY,OAAO,CAAC,KAAK,SAAS,KAAK,aAAa,CAAC,CAClF,KAAK,IAAI,KAAK,WAAW,YAAY,KAAK,IAAI,CACtD,QAAO;EAAE;EAAY,UAAU,WAAW,YAAY;EAAQ;AAGlE,QAAO"}