everything-dev 1.49.0 → 1.50.0

package/dist/app.cjs

@@ -1,15 +1,17 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_config = require('./config.cjs');
+const require_process_registry = require('./process-registry.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_API_PORT = 3001;
-const DEFAULT_AUTH_PORT = 3002;
-const DEFAULT_UI_PORT = 3003;
-const DEFAULT_PLUGIN_PORT_START = 3010;
+const PROBE_TIMEOUT_MS = 250;
+const MAX_PORT_SCAN_STEPS = 1e3;
+const PARALLEL_PROBE_WINDOW = 8;
+var PortAllocationError = class extends effect.Data.TaggedError("PortAllocationError") {};
+var PortAllocator = class extends effect.Context.Tag("PortAllocator")() {};
 function detectLocalPackages(bosConfig, runtimeConfig) {
 	const packages = [];
 	const configDir = require_config.getProjectRoot();
@@ -38,97 +40,75 @@ function buildRuntimeConfig(bosConfig, options) {
 		plugins: options.plugins
 	});
 }
-function probeTcpOpen(port, timeoutMs = 250) {
-	return new Promise((resolve) => {
-		const socket = (0, node_net.createConnection)({
-			host: "127.0.0.1",
-			port
+function probePortBindable(port) {
+	return effect.Effect.async((resume) => {
+		const server = (0, node_net.createServer)();
+		server.once("listening", () => {
+			server.close(() => {
+				resume(effect.Effect.succeed(true));
+			});
 		});
-		const timer = setTimeout(() => {
-			socket.destroy();
-			resolve(false);
-		}, timeoutMs);
-		socket.once("connect", () => {
-			clearTimeout(timer);
-			socket.destroy();
-			resolve(true);
-		});
-		socket.once("error", () => {
-			clearTimeout(timer);
-			resolve(false);
+		server.once("error", () => {
+			server.removeAllListeners();
+			resume(effect.Effect.succeed(false));
 		});
+		server.listen(port, "127.0.0.1");
+		const timer = setTimeout(() => {
+			server.removeAllListeners();
+			try {
+				server.close();
+			} catch {}
+			resume(effect.Effect.succeed(false));
+		}, PROBE_TIMEOUT_MS);
+		server.once("listening", () => clearTimeout(timer));
+		server.once("error", () => clearTimeout(timer));
 	});
 }
-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 ?? DEFAULT_HOST_PORT, usedPorts);
-	const next = {
-		...runtimeConfig,
-		host: {
-			...runtimeConfig.host,
-			url: `http://localhost:${hostPort}`,
-			port: hostPort
-		},
-		ui: { ...runtimeConfig.ui },
-		api: { ...runtimeConfig.api },
-		auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : void 0,
-		plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : 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.auth?.source === "local" && next.auth.localPath) {
-		const authPort = await pickAvailablePort(next.auth.port ?? DEFAULT_AUTH_PORT, usedPorts);
-		next.auth = withLocalRuntimeUrl(next.auth, authPort);
-	}
-	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.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) {
-				const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);
-				next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);
-				pluginBasePort = pluginPort + 1;
+function pickAvailablePort(preferred, usedPorts, budget) {
+	return effect.Effect.gen(function* () {
+		const within = (candidate) => !budget || candidate >= budget.min && candidate <= budget.max;
+		let port = preferred;
+		if (!within(port)) port = budget ? budget.min : port;
+		const ceiling = budget ? budget.max + 1 : Number.MAX_SAFE_INTEGER;
+		let steps = 0;
+		const fail = () => effect.Effect.fail(new PortAllocationError({
+			preferred,
+			budget,
+			cause: budget ? `No free port in budget [${budget.min}, ${budget.max}] starting from ${preferred}` : `No free port found starting from ${preferred} within ${MAX_PORT_SCAN_STEPS} steps`
+		}));
+		while (true) {
+			if (port >= ceiling || steps > MAX_PORT_SCAN_STEPS) yield* fail();
+			const candidates = [];
+			for (let i = 0; i < PARALLEL_PROBE_WINDOW && port + i < ceiling; i++) {
+				const candidate = port + i;
+				if (!usedPorts.has(candidate)) candidates.push(candidate);
+			}
+			if (candidates.length === 0) {
+				port += PARALLEL_PROBE_WINDOW;
+				steps += PARALLEL_PROBE_WINDOW;
+				continue;
 			}
-			if (plugin.ui?.source === "local" && plugin.ui.localPath) {
-				const uiPort = await pickAvailablePort(plugin.ui.port ?? pluginBasePort, usedPorts);
-				next.plugins[pluginId] = {
-					...next.plugins[pluginId],
-					ui: withLocalRuntimeUrl(plugin.ui, uiPort)
-				};
-				pluginBasePort = uiPort + 1;
+			const firstFree = (yield* effect.Effect.forEach(candidates, (c) => probePortBindable(c).pipe(effect.Effect.map((free) => ({
+				port: c,
+				free
+			}))), { concurrency: "unbounded" })).find((r) => r.free);
+			if (firstFree) {
+				usedPorts.add(firstFree.port);
+				return firstFree.port;
 			}
+			port += PARALLEL_PROBE_WINDOW;
+			steps += PARALLEL_PROBE_WINDOW;
 		}
-	}
-	return next;
+	});
 }
+const PortAllocatorLive = effect.Layer.sync(PortAllocator, () => {
+	const usedPorts = require_process_registry.claimedPorts();
+	return { pickAvailable: (preferred, budget) => pickAvailablePort(preferred, usedPorts, budget) };
+});
 
 //#endregion
+exports.PortAllocator = PortAllocator;
+exports.PortAllocatorLive = PortAllocatorLive;
 exports.buildRuntimeConfig = buildRuntimeConfig;
 exports.detectLocalPackages = detectLocalPackages;
-exports.prepareDevelopmentRuntimeConfig = prepareDevelopmentRuntimeConfig;
 //# sourceMappingURL=app.cjs.map

package/dist/app.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"app.cjs","names":["getProjectRoot","resolveLocalDevelopmentPath","configBuildRuntimeConfig"],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createConnection } from \"node:net\";\nimport { join } from \"node:path\";\nimport {\n  buildRuntimeConfig as configBuildRuntimeConfig,\n  getProjectRoot,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport type { AppOrchestrator } from \"./service-descriptor\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport type { AppOrchestrator };\n\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_API_PORT = 3001;\nconst DEFAULT_AUTH_PORT = 3002;\nconst DEFAULT_UI_PORT = 3003;\nconst DEFAULT_PLUGIN_PORT_START = 3010;\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 =\n    runtimeConfig?.host?.localPath ??\n    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    if (pluginConfig.ui?.localPath && existsSync(join(pluginConfig.ui.localPath, \"package.json\"))) {\n      packages.push(`plugin-ui:${pluginId}`);\n    }\n  }\n\n  const authLocalPath =\n    runtimeConfig?.auth?.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.auth?.development, configDir);\n  if (authLocalPath && existsSync(join(authLocalPath, \"package.json\"))) {\n    packages.push(\"auth\");\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    hostSource?: \"local\" | \"remote\";\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    authSource?: \"local\" | \"remote\";\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  return configBuildRuntimeConfig(bosConfig, getProjectRoot(), options.env ?? \"development\", {\n    hostSource: options.hostSource,\n    uiSource: options.uiSource,\n    apiSource: options.apiSource,\n    authSource: options.authSource,\n    proxy: options.proxy,\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(options?.hostPort ?? DEFAULT_HOST_PORT, usedPorts);\n\n  const next: RuntimeConfig = {\n    ...runtimeConfig,\n    host: { ...runtimeConfig.host, url: `http://localhost:${hostPort}`, port: hostPort },\n    ui: { ...runtimeConfig.ui },\n    api: { ...runtimeConfig.api },\n    auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : undefined,\n    plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\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.auth?.source === \"local\" && next.auth.localPath) {\n    const authPort = await pickAvailablePort(next.auth.port ?? DEFAULT_AUTH_PORT, usedPorts);\n    next.auth = withLocalRuntimeUrl(next.auth, authPort);\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.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        const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);\n        next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n        pluginBasePort = pluginPort + 1;\n      }\n\n      if (plugin.ui?.source === \"local\" && plugin.ui.localPath) {\n        const uiPort = await pickAvailablePort(plugin.ui.port ?? pluginBasePort, usedPorts);\n        next.plugins[pluginId] = {\n          ...next.plugins[pluginId]!,\n          ui: withLocalRuntimeUrl(plugin.ui, uiPort),\n        };\n        pluginBasePort = uiPort + 1;\n      }\n    }\n  }\n\n  return next;\n}\n"],"mappings":"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"}
+{"version":3,"file":"app.cjs","names":["Data","Context","getProjectRoot","resolveLocalDevelopmentPath","configBuildRuntimeConfig","Effect","Layer","claimedPorts"],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createServer } from \"node:net\";\nimport { join } from \"node:path\";\nimport { Context, Data, Effect, Layer } from \"effect\";\nimport type { DevPortState } from \"./cli/infra\";\nimport {\n  buildRuntimeConfig as configBuildRuntimeConfig,\n  getProjectRoot,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport { claimedPorts } from \"./process-registry\";\nimport type { AppOrchestrator } from \"./service-descriptor\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport type { AppOrchestrator };\n\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_API_PORT = 3001;\nconst DEFAULT_AUTH_PORT = 3002;\nconst DEFAULT_UI_PORT = 3003;\nconst DEFAULT_PLUGIN_PORT_START = 3010;\n\nconst PROBE_TIMEOUT_MS = 250;\nconst MAX_PORT_SCAN_STEPS = 1000;\nconst PARALLEL_PROBE_WINDOW = 8;\n\nexport type PortBudget = { min: number; max: number };\n\nexport class PortAllocationError extends Data.TaggedError(\"PortAllocationError\")<{\n  preferred: number;\n  budget?: PortBudget;\n  cause?: unknown;\n}> {}\n\nexport class PortAllocator extends Context.Tag(\"PortAllocator\")<\n  PortAllocator,\n  {\n    pickAvailable: (\n      preferred: number,\n      budget?: PortBudget,\n    ) => Effect.Effect<number, PortAllocationError>;\n  }\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 =\n    runtimeConfig?.host?.localPath ??\n    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    if (pluginConfig.ui?.localPath && existsSync(join(pluginConfig.ui.localPath, \"package.json\"))) {\n      packages.push(`plugin-ui:${pluginId}`);\n    }\n  }\n\n  const authLocalPath =\n    runtimeConfig?.auth?.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.auth?.development, configDir);\n  if (authLocalPath && existsSync(join(authLocalPath, \"package.json\"))) {\n    packages.push(\"auth\");\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    hostSource?: \"local\" | \"remote\";\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    authSource?: \"local\" | \"remote\";\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  return configBuildRuntimeConfig(bosConfig, getProjectRoot(), options.env ?? \"development\", {\n    hostSource: options.hostSource,\n    uiSource: options.uiSource,\n    apiSource: options.apiSource,\n    authSource: options.authSource,\n    proxy: options.proxy,\n    plugins: options.plugins,\n  });\n}\n\nfunction probePortBindable(port: number): Effect.Effect<boolean> {\n  return Effect.async<boolean>((resume) => {\n    const server = createServer();\n\n    server.once(\"listening\", () => {\n      server.close(() => {\n        resume(Effect.succeed(true));\n      });\n    });\n\n    server.once(\"error\", () => {\n      server.removeAllListeners();\n      // EADDRINUSE, EACCES, or any other bind error → not available\n      resume(Effect.succeed(false));\n    });\n\n    server.listen(port, \"127.0.0.1\");\n\n    const timer = setTimeout(() => {\n      server.removeAllListeners();\n      try {\n        server.close();\n      } catch {\n        // ignore\n      }\n      resume(Effect.succeed(false));\n    }, PROBE_TIMEOUT_MS);\n\n    server.once(\"listening\", () => clearTimeout(timer));\n    server.once(\"error\", () => clearTimeout(timer));\n  });\n}\n\nfunction pickAvailablePort(\n  preferred: number,\n  usedPorts: Set<number>,\n  budget?: PortBudget,\n): Effect.Effect<number, PortAllocationError> {\n  return Effect.gen(function* () {\n    const within = (candidate: number): boolean =>\n      !budget || (candidate >= budget.min && candidate <= budget.max);\n\n    let port = preferred;\n    if (!within(port)) {\n      port = budget ? budget.min : port;\n    }\n\n    const ceiling = budget ? budget.max + 1 : Number.MAX_SAFE_INTEGER;\n    let steps = 0;\n\n    const fail = () =>\n      Effect.fail(\n        new PortAllocationError({\n          preferred,\n          budget,\n          cause: budget\n            ? `No free port in budget [${budget.min}, ${budget.max}] starting from ${preferred}`\n            : `No free port found starting from ${preferred} within ${MAX_PORT_SCAN_STEPS} steps`,\n        }),\n      );\n\n    while (true) {\n      if (port >= ceiling || steps > MAX_PORT_SCAN_STEPS) {\n        yield* fail();\n      }\n\n      const candidates: number[] = [];\n      for (let i = 0; i < PARALLEL_PROBE_WINDOW && port + i < ceiling; i++) {\n        const candidate = port + i;\n        if (!usedPorts.has(candidate)) {\n          candidates.push(candidate);\n        }\n      }\n\n      if (candidates.length === 0) {\n        port += PARALLEL_PROBE_WINDOW;\n        steps += PARALLEL_PROBE_WINDOW;\n        continue;\n      }\n\n      const results = yield* Effect.forEach(\n        candidates,\n        (c) => probePortBindable(c).pipe(Effect.map((free) => ({ port: c, free }))),\n        { concurrency: \"unbounded\" },\n      );\n\n      const firstFree = results.find((r) => r.free);\n      if (firstFree) {\n        usedPorts.add(firstFree.port);\n        return firstFree.port;\n      }\n\n      port += PARALLEL_PROBE_WINDOW;\n      steps += PARALLEL_PROBE_WINDOW;\n    }\n  });\n}\n\nexport const PortAllocatorLive: Layer.Layer<PortAllocator> = Layer.sync(PortAllocator, () => {\n  const usedPorts = claimedPorts();\n  return {\n    pickAvailable: (preferred, budget) => pickAvailablePort(preferred, usedPorts, budget),\n  };\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 interface DevPortOptions {\n  hostPort?: number;\n  apiPort?: number;\n  uiPort?: number;\n  authPort?: number;\n  pluginPortStart?: number;\n  ssr?: boolean;\n  portBudget?: PortBudget;\n}\n\nexport interface PreparedDevRuntime {\n  runtimeConfig: RuntimeConfig;\n  devPorts: DevPortState;\n}\n\nexport function prepareDevelopmentRuntimeConfig(\n  runtimeConfig: RuntimeConfig,\n  options?: DevPortOptions,\n): Effect.Effect<PreparedDevRuntime, PortAllocationError, PortAllocator> {\n  return Effect.gen(function* () {\n    const allocator = yield* PortAllocator;\n    const budget = options?.portBudget;\n\n    const pickedHostPort = yield* allocator.pickAvailable(\n      options?.hostPort ?? DEFAULT_HOST_PORT,\n      budget,\n    );\n\n    const hostIsLocal = runtimeConfig.host.source === \"local\";\n    const next: RuntimeConfig = {\n      ...runtimeConfig,\n      host: hostIsLocal\n        ? {\n            ...runtimeConfig.host,\n            url: `http://localhost:${pickedHostPort}`,\n            port: pickedHostPort,\n          }\n        : { ...runtimeConfig.host },\n      ui: { ...runtimeConfig.ui },\n      api: { ...runtimeConfig.api },\n      auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : undefined,\n      plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\n    };\n\n    const devPorts: DevPortState = {\n      host: hostIsLocal ? pickedHostPort : undefined,\n      api: undefined,\n      ui: undefined,\n      auth: undefined,\n      pluginPortStart: undefined,\n    };\n\n    if (next.api.source === \"local\" && next.api.localPath) {\n      const apiPort = yield* allocator.pickAvailable(\n        options?.apiPort ?? next.api.port ?? DEFAULT_API_PORT,\n        budget,\n      );\n      next.api = withLocalRuntimeUrl(next.api, apiPort);\n      devPorts.api = apiPort;\n    }\n\n    if (next.auth?.source === \"local\" && next.auth.localPath) {\n      const authPort = yield* allocator.pickAvailable(\n        options?.authPort ?? next.auth.port ?? DEFAULT_AUTH_PORT,\n        budget,\n      );\n      next.auth = withLocalRuntimeUrl(next.auth, authPort);\n      devPorts.auth = authPort;\n    }\n\n    if (next.ui.source === \"local\" && next.ui.localPath) {\n      const uiPort = yield* allocator.pickAvailable(\n        options?.uiPort ?? next.ui.port ?? DEFAULT_UI_PORT,\n        budget,\n      );\n      next.ui = withLocalRuntimeUrl(next.ui, uiPort);\n      devPorts.ui = uiPort;\n      if (options?.ssr) {\n        const ssrPort = yield* allocator.pickAvailable(uiPort + 1, budget);\n        next.ui.ssrUrl = `http://localhost:${ssrPort}`;\n      } else {\n        next.ui.ssrUrl = undefined;\n      }\n    }\n\n    if (next.plugins) {\n      const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));\n      let pluginBasePort = options?.pluginPortStart ?? DEFAULT_PLUGIN_PORT_START;\n      let firstLocalPluginPort: number | undefined;\n\n      for (const [pluginId, plugin] of entries) {\n        if (plugin.source === \"local\" && plugin.localPath) {\n          const pluginPort = yield* allocator.pickAvailable(plugin.port ?? pluginBasePort, budget);\n          next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n          if (firstLocalPluginPort === undefined) firstLocalPluginPort = pluginPort;\n          pluginBasePort = pluginPort + 1;\n        }\n\n        if (plugin.ui?.source === \"local\" && plugin.ui.localPath) {\n          const pluginUiPort = yield* allocator.pickAvailable(\n            plugin.ui.port ?? pluginBasePort,\n            budget,\n          );\n          next.plugins[pluginId] = {\n            ...next.plugins[pluginId]!,\n            ui: withLocalRuntimeUrl(plugin.ui, pluginUiPort),\n          };\n          if (firstLocalPluginPort === undefined) firstLocalPluginPort = pluginUiPort;\n          pluginBasePort = pluginUiPort + 1;\n        }\n      }\n\n      devPorts.pluginPortStart = firstLocalPluginPort;\n    }\n\n    return { runtimeConfig: next, devPorts };\n  });\n}\n"],"mappings":"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"}

package/dist/app.mjs

@@ -1,14 +1,16 @@
 import { buildRuntimeConfig as buildRuntimeConfig$1, getProjectRoot, resolveLocalDevelopmentPath } from "./config.mjs";
+import { claimedPorts } from "./process-registry.mjs";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { createConnection } from "node:net";
+import { Context, Data, Effect, Layer } from "effect";
+import { createServer } from "node:net";
 
 //#region src/app.ts
-const DEFAULT_HOST_PORT = 3e3;
-const DEFAULT_API_PORT = 3001;
-const DEFAULT_AUTH_PORT = 3002;
-const DEFAULT_UI_PORT = 3003;
-const DEFAULT_PLUGIN_PORT_START = 3010;
+const PROBE_TIMEOUT_MS = 250;
+const MAX_PORT_SCAN_STEPS = 1e3;
+const PARALLEL_PROBE_WINDOW = 8;
+var PortAllocationError = class extends Data.TaggedError("PortAllocationError") {};
+var PortAllocator = class extends Context.Tag("PortAllocator")() {};
 function detectLocalPackages(bosConfig, runtimeConfig) {
 	const packages = [];
 	const configDir = getProjectRoot();
@@ -37,95 +39,72 @@ function buildRuntimeConfig(bosConfig, options) {
 		plugins: options.plugins
 	});
 }
-function probeTcpOpen(port, timeoutMs = 250) {
-	return new Promise((resolve) => {
-		const socket = createConnection({
-			host: "127.0.0.1",
-			port
+function probePortBindable(port) {
+	return Effect.async((resume) => {
+		const server = createServer();
+		server.once("listening", () => {
+			server.close(() => {
+				resume(Effect.succeed(true));
+			});
 		});
-		const timer = setTimeout(() => {
-			socket.destroy();
-			resolve(false);
-		}, timeoutMs);
-		socket.once("connect", () => {
-			clearTimeout(timer);
-			socket.destroy();
-			resolve(true);
-		});
-		socket.once("error", () => {
-			clearTimeout(timer);
-			resolve(false);
+		server.once("error", () => {
+			server.removeAllListeners();
+			resume(Effect.succeed(false));
 		});
+		server.listen(port, "127.0.0.1");
+		const timer = setTimeout(() => {
+			server.removeAllListeners();
+			try {
+				server.close();
+			} catch {}
+			resume(Effect.succeed(false));
+		}, PROBE_TIMEOUT_MS);
+		server.once("listening", () => clearTimeout(timer));
+		server.once("error", () => clearTimeout(timer));
 	});
 }
-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 ?? DEFAULT_HOST_PORT, usedPorts);
-	const next = {
-		...runtimeConfig,
-		host: {
-			...runtimeConfig.host,
-			url: `http://localhost:${hostPort}`,
-			port: hostPort
-		},
-		ui: { ...runtimeConfig.ui },
-		api: { ...runtimeConfig.api },
-		auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : void 0,
-		plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : 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.auth?.source === "local" && next.auth.localPath) {
-		const authPort = await pickAvailablePort(next.auth.port ?? DEFAULT_AUTH_PORT, usedPorts);
-		next.auth = withLocalRuntimeUrl(next.auth, authPort);
-	}
-	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.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) {
-				const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);
-				next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);
-				pluginBasePort = pluginPort + 1;
+function pickAvailablePort(preferred, usedPorts, budget) {
+	return Effect.gen(function* () {
+		const within = (candidate) => !budget || candidate >= budget.min && candidate <= budget.max;
+		let port = preferred;
+		if (!within(port)) port = budget ? budget.min : port;
+		const ceiling = budget ? budget.max + 1 : Number.MAX_SAFE_INTEGER;
+		let steps = 0;
+		const fail = () => Effect.fail(new PortAllocationError({
+			preferred,
+			budget,
+			cause: budget ? `No free port in budget [${budget.min}, ${budget.max}] starting from ${preferred}` : `No free port found starting from ${preferred} within ${MAX_PORT_SCAN_STEPS} steps`
+		}));
+		while (true) {
+			if (port >= ceiling || steps > MAX_PORT_SCAN_STEPS) yield* fail();
+			const candidates = [];
+			for (let i = 0; i < PARALLEL_PROBE_WINDOW && port + i < ceiling; i++) {
+				const candidate = port + i;
+				if (!usedPorts.has(candidate)) candidates.push(candidate);
+			}
+			if (candidates.length === 0) {
+				port += PARALLEL_PROBE_WINDOW;
+				steps += PARALLEL_PROBE_WINDOW;
+				continue;
 			}
-			if (plugin.ui?.source === "local" && plugin.ui.localPath) {
-				const uiPort = await pickAvailablePort(plugin.ui.port ?? pluginBasePort, usedPorts);
-				next.plugins[pluginId] = {
-					...next.plugins[pluginId],
-					ui: withLocalRuntimeUrl(plugin.ui, uiPort)
-				};
-				pluginBasePort = uiPort + 1;
+			const firstFree = (yield* Effect.forEach(candidates, (c) => probePortBindable(c).pipe(Effect.map((free) => ({
+				port: c,
+				free
+			}))), { concurrency: "unbounded" })).find((r) => r.free);
+			if (firstFree) {
+				usedPorts.add(firstFree.port);
+				return firstFree.port;
 			}
+			port += PARALLEL_PROBE_WINDOW;
+			steps += PARALLEL_PROBE_WINDOW;
 		}
-	}
-	return next;
+	});
 }
+const PortAllocatorLive = Layer.sync(PortAllocator, () => {
+	const usedPorts = claimedPorts();
+	return { pickAvailable: (preferred, budget) => pickAvailablePort(preferred, usedPorts, budget) };
+});
 
 //#endregion
-export { buildRuntimeConfig, detectLocalPackages, prepareDevelopmentRuntimeConfig };
+export { PortAllocator, PortAllocatorLive, buildRuntimeConfig, detectLocalPackages };
 //# sourceMappingURL=app.mjs.map

package/dist/app.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app.mjs","names":["configBuildRuntimeConfig"],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createConnection } from \"node:net\";\nimport { join } from \"node:path\";\nimport {\n  buildRuntimeConfig as configBuildRuntimeConfig,\n  getProjectRoot,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport type { AppOrchestrator } from \"./service-descriptor\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport type { AppOrchestrator };\n\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_API_PORT = 3001;\nconst DEFAULT_AUTH_PORT = 3002;\nconst DEFAULT_UI_PORT = 3003;\nconst DEFAULT_PLUGIN_PORT_START = 3010;\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 =\n    runtimeConfig?.host?.localPath ??\n    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    if (pluginConfig.ui?.localPath && existsSync(join(pluginConfig.ui.localPath, \"package.json\"))) {\n      packages.push(`plugin-ui:${pluginId}`);\n    }\n  }\n\n  const authLocalPath =\n    runtimeConfig?.auth?.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.auth?.development, configDir);\n  if (authLocalPath && existsSync(join(authLocalPath, \"package.json\"))) {\n    packages.push(\"auth\");\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    hostSource?: \"local\" | \"remote\";\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    authSource?: \"local\" | \"remote\";\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  return configBuildRuntimeConfig(bosConfig, getProjectRoot(), options.env ?? \"development\", {\n    hostSource: options.hostSource,\n    uiSource: options.uiSource,\n    apiSource: options.apiSource,\n    authSource: options.authSource,\n    proxy: options.proxy,\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(options?.hostPort ?? DEFAULT_HOST_PORT, usedPorts);\n\n  const next: RuntimeConfig = {\n    ...runtimeConfig,\n    host: { ...runtimeConfig.host, url: `http://localhost:${hostPort}`, port: hostPort },\n    ui: { ...runtimeConfig.ui },\n    api: { ...runtimeConfig.api },\n    auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : undefined,\n    plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\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.auth?.source === \"local\" && next.auth.localPath) {\n    const authPort = await pickAvailablePort(next.auth.port ?? DEFAULT_AUTH_PORT, usedPorts);\n    next.auth = withLocalRuntimeUrl(next.auth, authPort);\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.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        const pluginPort = await pickAvailablePort(plugin.port ?? pluginBasePort, usedPorts);\n        next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n        pluginBasePort = pluginPort + 1;\n      }\n\n      if (plugin.ui?.source === \"local\" && plugin.ui.localPath) {\n        const uiPort = await pickAvailablePort(plugin.ui.port ?? pluginBasePort, usedPorts);\n        next.plugins[pluginId] = {\n          ...next.plugins[pluginId]!,\n          ui: withLocalRuntimeUrl(plugin.ui, uiPort),\n        };\n        pluginBasePort = uiPort + 1;\n      }\n    }\n  }\n\n  return next;\n}\n"],"mappings":"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"}
+{"version":3,"file":"app.mjs","names":["configBuildRuntimeConfig"],"sources":["../src/app.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createServer } from \"node:net\";\nimport { join } from \"node:path\";\nimport { Context, Data, Effect, Layer } from \"effect\";\nimport type { DevPortState } from \"./cli/infra\";\nimport {\n  buildRuntimeConfig as configBuildRuntimeConfig,\n  getProjectRoot,\n  resolveLocalDevelopmentPath,\n} from \"./config\";\nimport { claimedPorts } from \"./process-registry\";\nimport type { AppOrchestrator } from \"./service-descriptor\";\nimport type { BosConfig, RuntimeConfig, RuntimePluginConfig } from \"./types\";\n\nexport type { AppOrchestrator };\n\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_API_PORT = 3001;\nconst DEFAULT_AUTH_PORT = 3002;\nconst DEFAULT_UI_PORT = 3003;\nconst DEFAULT_PLUGIN_PORT_START = 3010;\n\nconst PROBE_TIMEOUT_MS = 250;\nconst MAX_PORT_SCAN_STEPS = 1000;\nconst PARALLEL_PROBE_WINDOW = 8;\n\nexport type PortBudget = { min: number; max: number };\n\nexport class PortAllocationError extends Data.TaggedError(\"PortAllocationError\")<{\n  preferred: number;\n  budget?: PortBudget;\n  cause?: unknown;\n}> {}\n\nexport class PortAllocator extends Context.Tag(\"PortAllocator\")<\n  PortAllocator,\n  {\n    pickAvailable: (\n      preferred: number,\n      budget?: PortBudget,\n    ) => Effect.Effect<number, PortAllocationError>;\n  }\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 =\n    runtimeConfig?.host?.localPath ??\n    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    if (pluginConfig.ui?.localPath && existsSync(join(pluginConfig.ui.localPath, \"package.json\"))) {\n      packages.push(`plugin-ui:${pluginId}`);\n    }\n  }\n\n  const authLocalPath =\n    runtimeConfig?.auth?.localPath ??\n    resolveLocalDevelopmentPath(bosConfig?.app.auth?.development, configDir);\n  if (authLocalPath && existsSync(join(authLocalPath, \"package.json\"))) {\n    packages.push(\"auth\");\n  }\n\n  return packages;\n}\n\nexport function buildRuntimeConfig(\n  bosConfig: BosConfig,\n  options: {\n    hostSource?: \"local\" | \"remote\";\n    uiSource?: \"local\" | \"remote\";\n    apiSource?: \"local\" | \"remote\";\n    authSource?: \"local\" | \"remote\";\n    proxy?: string;\n    env?: \"development\" | \"production\";\n    plugins?: Record<string, RuntimePluginConfig>;\n  },\n): RuntimeConfig {\n  return configBuildRuntimeConfig(bosConfig, getProjectRoot(), options.env ?? \"development\", {\n    hostSource: options.hostSource,\n    uiSource: options.uiSource,\n    apiSource: options.apiSource,\n    authSource: options.authSource,\n    proxy: options.proxy,\n    plugins: options.plugins,\n  });\n}\n\nfunction probePortBindable(port: number): Effect.Effect<boolean> {\n  return Effect.async<boolean>((resume) => {\n    const server = createServer();\n\n    server.once(\"listening\", () => {\n      server.close(() => {\n        resume(Effect.succeed(true));\n      });\n    });\n\n    server.once(\"error\", () => {\n      server.removeAllListeners();\n      // EADDRINUSE, EACCES, or any other bind error → not available\n      resume(Effect.succeed(false));\n    });\n\n    server.listen(port, \"127.0.0.1\");\n\n    const timer = setTimeout(() => {\n      server.removeAllListeners();\n      try {\n        server.close();\n      } catch {\n        // ignore\n      }\n      resume(Effect.succeed(false));\n    }, PROBE_TIMEOUT_MS);\n\n    server.once(\"listening\", () => clearTimeout(timer));\n    server.once(\"error\", () => clearTimeout(timer));\n  });\n}\n\nfunction pickAvailablePort(\n  preferred: number,\n  usedPorts: Set<number>,\n  budget?: PortBudget,\n): Effect.Effect<number, PortAllocationError> {\n  return Effect.gen(function* () {\n    const within = (candidate: number): boolean =>\n      !budget || (candidate >= budget.min && candidate <= budget.max);\n\n    let port = preferred;\n    if (!within(port)) {\n      port = budget ? budget.min : port;\n    }\n\n    const ceiling = budget ? budget.max + 1 : Number.MAX_SAFE_INTEGER;\n    let steps = 0;\n\n    const fail = () =>\n      Effect.fail(\n        new PortAllocationError({\n          preferred,\n          budget,\n          cause: budget\n            ? `No free port in budget [${budget.min}, ${budget.max}] starting from ${preferred}`\n            : `No free port found starting from ${preferred} within ${MAX_PORT_SCAN_STEPS} steps`,\n        }),\n      );\n\n    while (true) {\n      if (port >= ceiling || steps > MAX_PORT_SCAN_STEPS) {\n        yield* fail();\n      }\n\n      const candidates: number[] = [];\n      for (let i = 0; i < PARALLEL_PROBE_WINDOW && port + i < ceiling; i++) {\n        const candidate = port + i;\n        if (!usedPorts.has(candidate)) {\n          candidates.push(candidate);\n        }\n      }\n\n      if (candidates.length === 0) {\n        port += PARALLEL_PROBE_WINDOW;\n        steps += PARALLEL_PROBE_WINDOW;\n        continue;\n      }\n\n      const results = yield* Effect.forEach(\n        candidates,\n        (c) => probePortBindable(c).pipe(Effect.map((free) => ({ port: c, free }))),\n        { concurrency: \"unbounded\" },\n      );\n\n      const firstFree = results.find((r) => r.free);\n      if (firstFree) {\n        usedPorts.add(firstFree.port);\n        return firstFree.port;\n      }\n\n      port += PARALLEL_PROBE_WINDOW;\n      steps += PARALLEL_PROBE_WINDOW;\n    }\n  });\n}\n\nexport const PortAllocatorLive: Layer.Layer<PortAllocator> = Layer.sync(PortAllocator, () => {\n  const usedPorts = claimedPorts();\n  return {\n    pickAvailable: (preferred, budget) => pickAvailablePort(preferred, usedPorts, budget),\n  };\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 interface DevPortOptions {\n  hostPort?: number;\n  apiPort?: number;\n  uiPort?: number;\n  authPort?: number;\n  pluginPortStart?: number;\n  ssr?: boolean;\n  portBudget?: PortBudget;\n}\n\nexport interface PreparedDevRuntime {\n  runtimeConfig: RuntimeConfig;\n  devPorts: DevPortState;\n}\n\nexport function prepareDevelopmentRuntimeConfig(\n  runtimeConfig: RuntimeConfig,\n  options?: DevPortOptions,\n): Effect.Effect<PreparedDevRuntime, PortAllocationError, PortAllocator> {\n  return Effect.gen(function* () {\n    const allocator = yield* PortAllocator;\n    const budget = options?.portBudget;\n\n    const pickedHostPort = yield* allocator.pickAvailable(\n      options?.hostPort ?? DEFAULT_HOST_PORT,\n      budget,\n    );\n\n    const hostIsLocal = runtimeConfig.host.source === \"local\";\n    const next: RuntimeConfig = {\n      ...runtimeConfig,\n      host: hostIsLocal\n        ? {\n            ...runtimeConfig.host,\n            url: `http://localhost:${pickedHostPort}`,\n            port: pickedHostPort,\n          }\n        : { ...runtimeConfig.host },\n      ui: { ...runtimeConfig.ui },\n      api: { ...runtimeConfig.api },\n      auth: runtimeConfig.auth ? { ...runtimeConfig.auth } : undefined,\n      plugins: runtimeConfig.plugins ? { ...runtimeConfig.plugins } : undefined,\n    };\n\n    const devPorts: DevPortState = {\n      host: hostIsLocal ? pickedHostPort : undefined,\n      api: undefined,\n      ui: undefined,\n      auth: undefined,\n      pluginPortStart: undefined,\n    };\n\n    if (next.api.source === \"local\" && next.api.localPath) {\n      const apiPort = yield* allocator.pickAvailable(\n        options?.apiPort ?? next.api.port ?? DEFAULT_API_PORT,\n        budget,\n      );\n      next.api = withLocalRuntimeUrl(next.api, apiPort);\n      devPorts.api = apiPort;\n    }\n\n    if (next.auth?.source === \"local\" && next.auth.localPath) {\n      const authPort = yield* allocator.pickAvailable(\n        options?.authPort ?? next.auth.port ?? DEFAULT_AUTH_PORT,\n        budget,\n      );\n      next.auth = withLocalRuntimeUrl(next.auth, authPort);\n      devPorts.auth = authPort;\n    }\n\n    if (next.ui.source === \"local\" && next.ui.localPath) {\n      const uiPort = yield* allocator.pickAvailable(\n        options?.uiPort ?? next.ui.port ?? DEFAULT_UI_PORT,\n        budget,\n      );\n      next.ui = withLocalRuntimeUrl(next.ui, uiPort);\n      devPorts.ui = uiPort;\n      if (options?.ssr) {\n        const ssrPort = yield* allocator.pickAvailable(uiPort + 1, budget);\n        next.ui.ssrUrl = `http://localhost:${ssrPort}`;\n      } else {\n        next.ui.ssrUrl = undefined;\n      }\n    }\n\n    if (next.plugins) {\n      const entries = Object.entries(next.plugins).sort(([a], [b]) => a.localeCompare(b));\n      let pluginBasePort = options?.pluginPortStart ?? DEFAULT_PLUGIN_PORT_START;\n      let firstLocalPluginPort: number | undefined;\n\n      for (const [pluginId, plugin] of entries) {\n        if (plugin.source === \"local\" && plugin.localPath) {\n          const pluginPort = yield* allocator.pickAvailable(plugin.port ?? pluginBasePort, budget);\n          next.plugins[pluginId] = withLocalRuntimeUrl(plugin, pluginPort);\n          if (firstLocalPluginPort === undefined) firstLocalPluginPort = pluginPort;\n          pluginBasePort = pluginPort + 1;\n        }\n\n        if (plugin.ui?.source === \"local\" && plugin.ui.localPath) {\n          const pluginUiPort = yield* allocator.pickAvailable(\n            plugin.ui.port ?? pluginBasePort,\n            budget,\n          );\n          next.plugins[pluginId] = {\n            ...next.plugins[pluginId]!,\n            ui: withLocalRuntimeUrl(plugin.ui, pluginUiPort),\n          };\n          if (firstLocalPluginPort === undefined) firstLocalPluginPort = pluginUiPort;\n          pluginBasePort = pluginUiPort + 1;\n        }\n      }\n\n      devPorts.pluginPortStart = firstLocalPluginPort;\n    }\n\n    return { runtimeConfig: next, devPorts };\n  });\n}\n"],"mappings":"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"}

package/dist/cli/db-doctor.cjs

@@ -31,8 +31,9 @@ function readLocalMigrations(workspaceDir) {
 async function diagnosePlugin(info) {
 	const { Pool } = await Promise.resolve().then(() => require("../node_modules/pg/esm/index.cjs"));
 	const slug = require_db.pluginMigrationSlug(info.key);
-	const journalTable = `__drizzle_migrations_${slug}`;
-	const journalSchema = "drizzle";
+	const storage = require_db.getMigrationStorage(slug);
+	const journalTable = storage.table;
+	const journalSchema = storage.schema;
 	const journalRef = `"${journalSchema}"."${journalTable}"`;
 	const localMigrations = info.workspaceDir ? readLocalMigrations(info.workspaceDir) : [];
 	const expectedTables = require_db.extractExpectedTables(localMigrations);
@@ -63,10 +64,10 @@ async function diagnosePlugin(info) {
 			const existing = new Set(tableResult.rows.map((r) => r.table_name));
 			missingTables = expectedTables.filter((t) => !existing.has(t));
 		}
-		const legacyCount = await countLegacyHashes(pool, localHashes);
 		let diagnosis;
 		if (localMigrations.length === 0) diagnosis = "no-local-migrations";
-		else if (appliedHashCount === 0 && localHashes.length > 0) diagnosis = legacyCount > 0 ? "legacy-importable" : "unapplied";
+		else if (appliedHashCount === 0 && missingTables.length === 0 && localHashes.length > 0) diagnosis = "untracked-existing-schema";
+		else if (appliedHashCount === 0 && localHashes.length > 0) diagnosis = "unapplied";
 		else if (missingTables.length === 0) diagnosis = "healthy";
 		else if (missingTables.length === expectedTables.length) diagnosis = "drift-safe-repair";
 		else diagnosis = "drift-manual";
@@ -84,8 +85,7 @@ async function diagnosePlugin(info) {
 			expectedTables,
 			missingTables,
 			migrationHashes,
-			diagnosis,
-			legacyCount
+			diagnosis
 		};
 	} catch (error) {
 		return {
@@ -102,29 +102,12 @@ async function diagnosePlugin(info) {
 			missingTables: [],
 			migrationHashes: [],
 			diagnosis: "error",
-			legacyCount: 0,
 			error: error instanceof Error ? error.message : String(error)
 		};
 	} finally {
 		await pool.end().catch(() => {});
 	}
 }
-async function countLegacyHashes(pool, localHashes) {
-	if (localHashes.length === 0) return 0;
-	const candidates = [{
-		schema: "drizzle",
-		table: "__drizzle_migrations"
-	}, {
-		schema: "public",
-		table: "drizzle_migrations"
-	}];
-	let total = 0;
-	for (const c of candidates) try {
-		const result = await pool.query(`SELECT count(*)::int AS cnt FROM "${c.schema}"."${c.table}" WHERE hash = ANY($1)`, [localHashes]);
-		total += result.rows[0]?.cnt ?? 0;
-	} catch {}
-	return total;
-}
 
 //#endregion
 exports.diagnosePlugin = diagnosePlugin;

package/dist/cli/db-doctor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"db-doctor.cjs","names":["pluginMigrationSlug","extractExpectedTables"],"sources":["../../src/cli/db-doctor.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { extractExpectedTables, pluginMigrationSlug } from \"../db\";\nimport type { PluginDbInfo } from \"./db-studio\";\n\nexport interface DoctorReport {\n  plugin: string;\n  slug: string;\n  journalTable: string;\n  journalSchema: string;\n  dbSecret: string;\n  dbUrl: string;\n  workspaceDir: string | undefined;\n  localMigrationCount: number;\n  appliedHashCount: number;\n  expectedTables: string[];\n  missingTables: string[];\n  migrationHashes: string[];\n  diagnosis: string;\n  legacyCount: number;\n  error?: string;\n}\n\nfunction hashFile(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\ninterface LocalMigration {\n  tag: string;\n  hash: string;\n  sql: string[];\n}\n\nfunction readLocalMigrations(workspaceDir: string): LocalMigration[] {\n  const migrationsDir = resolve(workspaceDir, \"src/db/migrations\");\n  const metaDir = join(migrationsDir, \"meta\");\n  const journalPath = join(metaDir, \"_journal.json\");\n  if (!existsSync(journalPath)) return [];\n\n  const journal = JSON.parse(readFileSync(journalPath, \"utf8\")) as {\n    entries: { idx: number; tag: string }[];\n  };\n\n  return journal.entries.map((entry) => {\n    const sqlPath = join(migrationsDir, `${entry.tag}.sql`);\n    if (!existsSync(sqlPath)) {\n      return { tag: entry.tag, hash: \"\", sql: [] };\n    }\n    const raw = readFileSync(sqlPath, \"utf8\");\n    const sql = raw.split(\"--> statement-breakpoint\").map((s) => s.trim());\n    return { tag: entry.tag, hash: hashFile(raw), sql };\n  });\n}\n\nexport async function diagnosePlugin(info: PluginDbInfo): Promise<DoctorReport> {\n  const { Pool } = await import(\"pg\");\n\n  const slug = pluginMigrationSlug(info.key);\n  const journalTable = `__drizzle_migrations_${slug}`;\n  const journalSchema = \"drizzle\";\n  const journalRef = `\"${journalSchema}\".\"${journalTable}\"`;\n\n  const localMigrations = info.workspaceDir ? readLocalMigrations(info.workspaceDir) : [];\n\n  const expectedTables = extractExpectedTables(localMigrations);\n  const localHashes = localMigrations.map((m) => m.hash).filter(Boolean);\n  const migrationHashes = localHashes;\n\n  const pool = new Pool({\n    connectionString: info.databaseUrl,\n    ssl:\n      info.databaseUrl.includes(\"localhost\") || info.databaseUrl.includes(\"127.0.0.1\")\n        ? false\n        : { rejectUnauthorized: false },\n    max: 1,\n    connectionTimeoutMillis: 10_000,\n  });\n\n  try {\n    const journalExists = await pool.query(`\n      SELECT EXISTS (\n        SELECT 1 FROM information_schema.tables\n        WHERE table_schema = '${journalSchema}' AND table_name = '${journalTable}'\n      ) AS exists\n    `);\n\n    let appliedHashCount = 0;\n    if (journalExists.rows[0]?.exists) {\n      const result = await pool.query(`SELECT hash FROM ${journalRef}`);\n      appliedHashCount = result.rows.length;\n    }\n\n    let missingTables: string[] = [];\n    if (expectedTables.length > 0) {\n      const tableResult = await pool.query(\n        `\n        SELECT table_name FROM information_schema.tables\n        WHERE table_schema = 'public'\n          AND table_name = ANY($1)\n      `,\n        [expectedTables],\n      );\n      const existing = new Set(tableResult.rows.map((r: any) => r.table_name));\n      missingTables = expectedTables.filter((t) => !existing.has(t));\n    }\n\n    const legacyCount = await countLegacyHashes(pool, localHashes);\n\n    let diagnosis: string;\n    if (localMigrations.length === 0) {\n      diagnosis = \"no-local-migrations\";\n    } else if (appliedHashCount === 0 && localHashes.length > 0) {\n      diagnosis = legacyCount > 0 ? \"legacy-importable\" : \"unapplied\";\n    } else if (missingTables.length === 0) {\n      diagnosis = \"healthy\";\n    } else if (missingTables.length === expectedTables.length) {\n      diagnosis = \"drift-safe-repair\";\n    } else {\n      diagnosis = \"drift-manual\";\n    }\n\n    const masked = info.databaseUrl.replace(/\\/\\/[^:]+:[^@]+@/, \"//***:***@\");\n\n    return {\n      plugin: info.key,\n      slug,\n      journalTable,\n      journalSchema,\n      dbSecret: info.databaseSecret,\n      dbUrl: masked,\n      workspaceDir: info.workspaceDir,\n      localMigrationCount: localMigrations.length,\n      appliedHashCount,\n      expectedTables,\n      missingTables,\n      migrationHashes,\n      diagnosis,\n      legacyCount,\n    };\n  } catch (error) {\n    return {\n      plugin: info.key,\n      slug,\n      journalTable,\n      journalSchema,\n      dbSecret: info.databaseSecret,\n      dbUrl: info.databaseUrl.replace(/\\/\\/[^:]+:[^@]+@/, \"//***:***@\"),\n      workspaceDir: info.workspaceDir,\n      localMigrationCount: localMigrations.length,\n      appliedHashCount: 0,\n      expectedTables,\n      missingTables: [],\n      migrationHashes: [],\n      diagnosis: \"error\",\n      legacyCount: 0,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  } finally {\n    await pool.end().catch(() => {});\n  }\n}\n\nasync function countLegacyHashes(pool: any, localHashes: string[]): Promise<number> {\n  if (localHashes.length === 0) return 0;\n  const candidates = [\n    { schema: \"drizzle\", table: \"__drizzle_migrations\" },\n    { schema: \"public\", table: \"drizzle_migrations\" },\n  ];\n  let total = 0;\n  for (const c of candidates) {\n    try {\n      const result = await pool.query(\n        `SELECT count(*)::int AS cnt FROM \"${c.schema}\".\"${c.table}\" WHERE hash = ANY($1)`,\n        [localHashes],\n      );\n      total += result.rows[0]?.cnt ?? 0;\n    } catch {\n      // table might not exist\n    }\n  }\n  return total;\n}\n"],"mappings":"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"}
+{"version":3,"file":"db-doctor.cjs","names":["pluginMigrationSlug","getMigrationStorage","extractExpectedTables"],"sources":["../../src/cli/db-doctor.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { extractExpectedTables, getMigrationStorage, pluginMigrationSlug } from \"../db\";\nimport type { PluginDbInfo } from \"./db-studio\";\n\nexport interface DoctorReport {\n  plugin: string;\n  slug: string;\n  journalTable: string;\n  journalSchema: string;\n  dbSecret: string;\n  dbUrl: string;\n  workspaceDir: string | undefined;\n  localMigrationCount: number;\n  appliedHashCount: number;\n  expectedTables: string[];\n  missingTables: string[];\n  migrationHashes: string[];\n  diagnosis: string;\n  error?: string;\n}\n\nfunction hashFile(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\ninterface LocalMigration {\n  tag: string;\n  hash: string;\n  sql: string[];\n}\n\nfunction readLocalMigrations(workspaceDir: string): LocalMigration[] {\n  const migrationsDir = resolve(workspaceDir, \"src/db/migrations\");\n  const metaDir = join(migrationsDir, \"meta\");\n  const journalPath = join(metaDir, \"_journal.json\");\n  if (!existsSync(journalPath)) return [];\n\n  const journal = JSON.parse(readFileSync(journalPath, \"utf8\")) as {\n    entries: { idx: number; tag: string }[];\n  };\n\n  return journal.entries.map((entry) => {\n    const sqlPath = join(migrationsDir, `${entry.tag}.sql`);\n    if (!existsSync(sqlPath)) {\n      return { tag: entry.tag, hash: \"\", sql: [] };\n    }\n    const raw = readFileSync(sqlPath, \"utf8\");\n    const sql = raw.split(\"--> statement-breakpoint\").map((s) => s.trim());\n    return { tag: entry.tag, hash: hashFile(raw), sql };\n  });\n}\n\nexport async function diagnosePlugin(info: PluginDbInfo): Promise<DoctorReport> {\n  const { Pool } = await import(\"pg\");\n\n  const slug = pluginMigrationSlug(info.key);\n  const storage = getMigrationStorage(slug);\n  const journalTable = storage.table;\n  const journalSchema = storage.schema;\n  const journalRef = `\"${journalSchema}\".\"${journalTable}\"`;\n\n  const localMigrations = info.workspaceDir ? readLocalMigrations(info.workspaceDir) : [];\n\n  const expectedTables = extractExpectedTables(localMigrations);\n  const localHashes = localMigrations.map((m) => m.hash).filter(Boolean);\n  const migrationHashes = localHashes;\n\n  const pool = new Pool({\n    connectionString: info.databaseUrl,\n    ssl:\n      info.databaseUrl.includes(\"localhost\") || info.databaseUrl.includes(\"127.0.0.1\")\n        ? false\n        : { rejectUnauthorized: false },\n    max: 1,\n    connectionTimeoutMillis: 10_000,\n  });\n\n  try {\n    const journalExists = await pool.query(`\n      SELECT EXISTS (\n        SELECT 1 FROM information_schema.tables\n        WHERE table_schema = '${journalSchema}' AND table_name = '${journalTable}'\n      ) AS exists\n    `);\n\n    let appliedHashCount = 0;\n    if (journalExists.rows[0]?.exists) {\n      const result = await pool.query(`SELECT hash FROM ${journalRef}`);\n      appliedHashCount = result.rows.length;\n    }\n\n    let missingTables: string[] = [];\n    if (expectedTables.length > 0) {\n      const tableResult = await pool.query(\n        `\n        SELECT table_name FROM information_schema.tables\n        WHERE table_schema = 'public'\n          AND table_name = ANY($1)\n      `,\n        [expectedTables],\n      );\n      const existing = new Set(tableResult.rows.map((r: any) => r.table_name));\n      missingTables = expectedTables.filter((t) => !existing.has(t));\n    }\n\n    let diagnosis: string;\n    if (localMigrations.length === 0) {\n      diagnosis = \"no-local-migrations\";\n    } else if (appliedHashCount === 0 && missingTables.length === 0 && localHashes.length > 0) {\n      // Journal is empty but all expected public tables exist.\n      diagnosis = \"untracked-existing-schema\";\n    } else if (appliedHashCount === 0 && localHashes.length > 0) {\n      diagnosis = \"unapplied\";\n    } else if (missingTables.length === 0) {\n      diagnosis = \"healthy\";\n    } else if (missingTables.length === expectedTables.length) {\n      diagnosis = \"drift-safe-repair\";\n    } else {\n      diagnosis = \"drift-manual\";\n    }\n\n    const masked = info.databaseUrl.replace(/\\/\\/[^:]+:[^@]+@/, \"//***:***@\");\n\n    return {\n      plugin: info.key,\n      slug,\n      journalTable,\n      journalSchema,\n      dbSecret: info.databaseSecret,\n      dbUrl: masked,\n      workspaceDir: info.workspaceDir,\n      localMigrationCount: localMigrations.length,\n      appliedHashCount,\n      expectedTables,\n      missingTables,\n      migrationHashes,\n      diagnosis,\n    };\n  } catch (error) {\n    return {\n      plugin: info.key,\n      slug,\n      journalTable,\n      journalSchema,\n      dbSecret: info.databaseSecret,\n      dbUrl: info.databaseUrl.replace(/\\/\\/[^:]+:[^@]+@/, \"//***:***@\"),\n      workspaceDir: info.workspaceDir,\n      localMigrationCount: localMigrations.length,\n      appliedHashCount: 0,\n      expectedTables,\n      missingTables: [],\n      migrationHashes: [],\n      diagnosis: \"error\",\n      error: error instanceof Error ? error.message : String(error),\n    };\n  } finally {\n    await pool.end().catch(() => {});\n  }\n}\n"],"mappings":";;;;;;;AAuBA,SAAS,SAAS,KAAqB;AACrC,oCAAkB,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,MAAM;;AASvD,SAAS,oBAAoB,cAAwC;CACnE,MAAM,uCAAwB,cAAc,oBAAoB;CAEhE,MAAM,sDADe,eAAe,OACJ,EAAE,gBAAgB;AAClD,KAAI,yBAAY,YAAY,CAAE,QAAO,EAAE;AAMvC,QAJgB,KAAK,gCAAmB,aAAa,OAAO,CAI9C,CAAC,QAAQ,KAAK,UAAU;EACpC,MAAM,8BAAe,eAAe,GAAG,MAAM,IAAI,MAAM;AACvD,MAAI,yBAAY,QAAQ,CACtB,QAAO;GAAE,KAAK,MAAM;GAAK,MAAM;GAAI,KAAK,EAAE;GAAE;EAE9C,MAAM,gCAAmB,SAAS,OAAO;EACzC,MAAM,MAAM,IAAI,MAAM,2BAA2B,CAAC,KAAK,MAAM,EAAE,MAAM,CAAC;AACtE,SAAO;GAAE,KAAK,MAAM;GAAK,MAAM,SAAS,IAAI;GAAE;GAAK;GACnD;;AAGJ,eAAsB,eAAe,MAA2C;CAC9E,MAAM,EAAE,SAAS,2CAAM;CAEvB,MAAM,OAAOA,+BAAoB,KAAK,IAAI;CAC1C,MAAM,UAAUC,+BAAoB,KAAK;CACzC,MAAM,eAAe,QAAQ;CAC7B,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,aAAa,IAAI,cAAc,KAAK,aAAa;CAEvD,MAAM,kBAAkB,KAAK,eAAe,oBAAoB,KAAK,aAAa,GAAG,EAAE;CAEvF,MAAM,iBAAiBC,iCAAsB,gBAAgB;CAC7D,MAAM,cAAc,gBAAgB,KAAK,MAAM,EAAE,KAAK,CAAC,OAAO,QAAQ;CACtE,MAAM,kBAAkB;CAExB,MAAM,OAAO,IAAI,KAAK;EACpB,kBAAkB,KAAK;EACvB,KACE,KAAK,YAAY,SAAS,YAAY,IAAI,KAAK,YAAY,SAAS,YAAY,GAC5E,QACA,EAAE,oBAAoB,OAAO;EACnC,KAAK;EACL,yBAAyB;EAC1B,CAAC;AAEF,KAAI;EACF,MAAM,gBAAgB,MAAM,KAAK,MAAM;;;gCAGX,cAAc,sBAAsB,aAAa;;MAE3E;EAEF,IAAI,mBAAmB;AACvB,MAAI,cAAc,KAAK,IAAI,OAEzB,qBAAmB,MADE,KAAK,MAAM,oBAAoB,aAAa,EACvC,KAAK;EAGjC,IAAI,gBAA0B,EAAE;AAChC,MAAI,eAAe,SAAS,GAAG;GAC7B,MAAM,cAAc,MAAM,KAAK,MAC7B;;;;SAKA,CAAC,eAAe,CACjB;GACD,MAAM,WAAW,IAAI,IAAI,YAAY,KAAK,KAAK,MAAW,EAAE,WAAW,CAAC;AACxE,mBAAgB,eAAe,QAAQ,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;;EAGhE,IAAI;AACJ,MAAI,gBAAgB,WAAW,EAC7B,aAAY;WACH,qBAAqB,KAAK,cAAc,WAAW,KAAK,YAAY,SAAS,EAEtF,aAAY;WACH,qBAAqB,KAAK,YAAY,SAAS,EACxD,aAAY;WACH,cAAc,WAAW,EAClC,aAAY;WACH,cAAc,WAAW,eAAe,OACjD,aAAY;MAEZ,aAAY;EAGd,MAAM,SAAS,KAAK,YAAY,QAAQ,oBAAoB,aAAa;AAEzE,SAAO;GACL,QAAQ,KAAK;GACb;GACA;GACA;GACA,UAAU,KAAK;GACf,OAAO;GACP,cAAc,KAAK;GACnB,qBAAqB,gBAAgB;GACrC;GACA;GACA;GACA;GACA;GACD;UACM,OAAO;AACd,SAAO;GACL,QAAQ,KAAK;GACb;GACA;GACA;GACA,UAAU,KAAK;GACf,OAAO,KAAK,YAAY,QAAQ,oBAAoB,aAAa;GACjE,cAAc,KAAK;GACnB,qBAAqB,gBAAgB;GACrC,kBAAkB;GAClB;GACA,eAAe,EAAE;GACjB,iBAAiB,EAAE;GACnB,WAAW;GACX,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC9D;WACO;AACR,QAAM,KAAK,KAAK,CAAC,YAAY,GAAG"}