onveloz 0.0.0-beta.27 → 0.0.0-beta.28

package/dist/index.mjs

@@ -237,6 +237,192 @@ function resolveServiceSizeFromResources(cpu, memory) {
 	for (const [key, tier] of Object.entries(SERVICE_SIZES)) if (tier.cpu === cpu && tier.memory === memory) return key;
 	return null;
 }
+/** All known flag keys. Used for validation and UI rendering. */
+const PROJECT_FLAG_DEFINITIONS = {
+	cloudflareSaas: {
+		label: "Cloudflare for SaaS",
+		description: "SSL de domínios customizados via Cloudflare (em vez de Let's Encrypt)"
+	},
+	cloudflareTunnel: {
+		label: "Cloudflare Tunnel",
+		description: "Roteamento de tráfego via túnel Cloudflare (em vez de IP direto). Domínios customizados apontam para proxy.onveloz.com"
+	},
+	buildkit: {
+		label: "BuildKit",
+		description: "Build de imagens via BuildKit no cluster (em vez de Depot externo). Mais controle e sem dependência de serviço externo."
+	}
+};
+const PROJECT_FLAG_KEYS = Object.keys(PROJECT_FLAG_DEFINITIONS);
+/**
+* Allowlist of user-configurable PostgreSQL parameters with validation bounds.
+* PGTune-relevant params + commonly tuned settings.
+*/
+const PG_CONFIGURABLE_PARAMS = {
+	shared_buffers: {
+		type: "integer",
+		unit: "MB",
+		min: 16,
+		max: 16384,
+		description: "Memória dedicada para cache de dados do PostgreSQL",
+		requiresRestart: true
+	},
+	effective_cache_size: {
+		type: "integer",
+		unit: "MB",
+		min: 64,
+		max: 65536,
+		description: "Estimativa de memória disponível para cache do sistema operacional",
+		requiresRestart: false
+	},
+	work_mem: {
+		type: "integer",
+		unit: "MB",
+		min: 1,
+		max: 2048,
+		description: "Memória por operação de ordenação/hash",
+		requiresRestart: false
+	},
+	maintenance_work_mem: {
+		type: "integer",
+		unit: "MB",
+		min: 16,
+		max: 2048,
+		description: "Memória para operações de manutenção (VACUUM, CREATE INDEX)",
+		requiresRestart: false
+	},
+	wal_buffers: {
+		type: "integer",
+		unit: "MB",
+		min: 1,
+		max: 64,
+		description: "Memória para buffers de WAL",
+		requiresRestart: true
+	},
+	min_wal_size: {
+		type: "integer",
+		unit: "MB",
+		min: 32,
+		max: 4096,
+		description: "Tamanho mínimo de WAL antes de reciclar",
+		requiresRestart: false
+	},
+	max_wal_size: {
+		type: "integer",
+		unit: "MB",
+		min: 64,
+		max: 16384,
+		description: "Tamanho máximo de WAL antes de forçar checkpoint",
+		requiresRestart: false
+	},
+	max_connections: {
+		type: "integer",
+		min: 20,
+		max: 1e3,
+		description: "Número máximo de conexões simultâneas",
+		requiresRestart: true
+	},
+	random_page_cost: {
+		type: "real",
+		min: .1,
+		max: 10,
+		description: "Custo estimado de leitura aleatória de página (SSD ≈ 1.1, HDD ≈ 4.0)",
+		requiresRestart: false
+	},
+	effective_io_concurrency: {
+		type: "integer",
+		min: 0,
+		max: 1e3,
+		description: "Número de operações de I/O simultâneas (SSD ≈ 200)",
+		requiresRestart: false
+	},
+	max_worker_processes: {
+		type: "integer",
+		min: 1,
+		max: 128,
+		description: "Número máximo de processos worker",
+		requiresRestart: true
+	},
+	max_parallel_workers: {
+		type: "integer",
+		min: 0,
+		max: 128,
+		description: "Número máximo de workers paralelos",
+		requiresRestart: false
+	},
+	max_parallel_workers_per_gather: {
+		type: "integer",
+		min: 0,
+		max: 64,
+		description: "Número máximo de workers por operação Gather",
+		requiresRestart: false
+	},
+	max_parallel_maintenance_workers: {
+		type: "integer",
+		min: 0,
+		max: 64,
+		description: "Número máximo de workers para manutenção paralela",
+		requiresRestart: false
+	},
+	checkpoint_completion_target: {
+		type: "real",
+		min: .1,
+		max: 1,
+		description: "Fração do intervalo de checkpoint para completar a escrita",
+		requiresRestart: false
+	},
+	autovacuum_max_workers: {
+		type: "integer",
+		min: 1,
+		max: 16,
+		description: "Número máximo de processos autovacuum",
+		requiresRestart: true
+	},
+	autovacuum_naptime: {
+		type: "integer",
+		unit: "s",
+		min: 1,
+		max: 86400,
+		description: "Intervalo entre execuções do autovacuum",
+		requiresRestart: false
+	},
+	log_min_duration_statement: {
+		type: "integer",
+		unit: "ms",
+		min: -1,
+		max: 6e5,
+		description: "Log de queries mais lentas que N ms (-1 desabilita)",
+		requiresRestart: false
+	},
+	log_statement: {
+		type: "enum",
+		enumValues: [
+			"none",
+			"ddl",
+			"mod",
+			"all"
+		],
+		description: "Tipos de statements que são logados",
+		requiresRestart: false
+	},
+	statement_timeout: {
+		type: "integer",
+		unit: "ms",
+		min: 0,
+		max: 864e5,
+		description: "Timeout para execução de statements (0 desabilita)",
+		requiresRestart: false
+	},
+	idle_in_transaction_session_timeout: {
+		type: "integer",
+		unit: "ms",
+		min: 0,
+		max: 864e5,
+		description: "Timeout para sessões idle em transação (0 desabilita)",
+		requiresRestart: false
+	}
+};
+/** All user-configurable param keys. */
+const PG_CONFIGURABLE_PARAM_KEYS = Object.keys(PG_CONFIGURABLE_PARAMS);
 
 //#endregion
 //#region ../../packages/config/veloz-config.ts
@@ -1798,6 +1984,54 @@ volumesGroup.command("sync", {
 
 //#endregion
 //#region src/commands/config.ts
+/**
+* Sync server-side config updates back to veloz.json.
+* Maps server field names to veloz.json service config paths.
+*/
+function syncConfigToVelozJson(serviceKey, updates) {
+	try {
+		if (!loadConfig()) return;
+		patchConfig((raw) => {
+			const svc = raw.services[serviceKey];
+			if (!svc) return;
+			for (const [field, value] of Object.entries(updates)) switch (field) {
+				case "name":
+					svc.name = value;
+					break;
+				case "buildCommand":
+					if (!svc.build) svc.build = {};
+					svc.build.command = value;
+					break;
+				case "startCommand":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.command = value;
+					break;
+				case "preStartCommand":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.preStartCommand = value;
+					break;
+				case "port":
+					if (!svc.runtime) svc.runtime = {};
+					svc.runtime.port = value;
+					break;
+				case "rootDirectory":
+					svc.root = value ?? ".";
+					break;
+				case "instanceCount":
+					if (!svc.resources) svc.resources = {};
+					svc.resources.instances = value;
+					break;
+				case "size":
+					if (!svc.resources) svc.resources = {};
+					svc.resources.size = value;
+					break;
+				case "branch":
+					svc.branch = value;
+					break;
+			}
+		});
+	} catch {}
+}
 function formatValue(value) {
 	if (value === null || value === void 0 || value === "") return chalk.dim("—");
 	return chalk.cyan(String(value));
@@ -1888,7 +2122,8 @@ configGroup.command("set", {
 		instances: "i"
 	},
 	async run(c) {
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service } = await resolveService(c.options.service);
+		const serviceId = service.id;
 		const client = await getClient();
 		const updates = {};
 		if (c.options.name) updates.name = c.options.name;
@@ -1912,6 +2147,7 @@ configGroup.command("set", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações atualizadas com sucesso!");
 		console.log(chalk.dim("\nValores atualizados:"));
 		for (const [key, value] of Object.entries(updates)) {
@@ -1928,7 +2164,8 @@ configGroup.command("edit", {
 	middleware: [requireAuth],
 	options: z.object({ service: z.string().optional().describe("Serviço alvo (chave ou nome)") }),
 	async run(c) {
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service: resolved } = await resolveService(c.options.service);
+		const serviceId = resolved.id;
 		const client = await getClient();
 		const svc = await withSpinner({
 			text: "Buscando configurações atuais...",
@@ -1969,6 +2206,7 @@ configGroup.command("edit", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações atualizadas com sucesso!");
 		info("Execute 'veloz deploy' para aplicar as mudanças.");
 		return { updated: updates };
@@ -1987,7 +2225,8 @@ configGroup.command("reset", {
 	}),
 	async run(c) {
 		requireMcpConfirmation(c.options.userConfirmation, "resetar configurações para os padrões");
-		const serviceId = await resolveServiceId(c.options.service);
+		const { key: serviceKey, service } = await resolveService(c.options.service);
+		const serviceId = service.id;
 		const client = await getClient();
 		const updates = {};
 		if (c.options.all) {
@@ -2011,6 +2250,7 @@ configGroup.command("reset", {
 				...updates
 			})
 		});
+		syncConfigToVelozJson(serviceKey, updates);
 		success("Configurações resetadas para os padrões!");
 		info("Execute 'veloz deploy' para aplicar as mudanças.");
 		return { reset: Object.keys(updates) };
@@ -2721,6 +2961,116 @@ dbGroup.command("tunnel", {
 		});
 	}
 });
+dbGroup.command("config", {
+	description: "Ver ou alterar configuração do PostgreSQL",
+	middleware: [requireAuth],
+	args: z.object({ name: z.string().describe("Nome ou ID do banco de dados") }),
+	options: z.object({
+		set: z.string().optional().describe("Definir parâmetro (formato: chave=valor)"),
+		reset: z.boolean().optional().describe("Resetar para configuração auto-tuned"),
+		params: z.boolean().optional().describe("Listar parâmetros configuráveis"),
+		userConfirmation: z.string().optional()
+	}),
+	output: z.object({
+		params: z.array(z.object({
+			name: z.string(),
+			type: z.string(),
+			unit: z.string().optional(),
+			requiresRestart: z.boolean(),
+			description: z.string()
+		})).optional(),
+		effective: z.record(z.string(), z.string()).optional(),
+		userOverrides: z.record(z.string(), z.string()).optional(),
+		updated: z.boolean().optional(),
+		key: z.string().optional(),
+		value: z.string().optional(),
+		requiresRestart: z.boolean().optional(),
+		reset: z.boolean().optional()
+	}),
+	async run(c) {
+		const db = await resolveDatabaseByName(getProjectId(), c.args.name);
+		const client = await getClient();
+		if (c.options.params) {
+			log(chalk.bold("\n  Parâmetros configuráveis:\n"));
+			log(`  ${chalk.bold("Parâmetro".padEnd(40))}${chalk.bold("Tipo".padEnd(12))}${chalk.bold("Reinício?")}`);
+			log(chalk.dim("  " + "─".repeat(65)));
+			const params = Object.entries(PG_CONFIGURABLE_PARAMS).map(([key, def]) => {
+				const typeLabel = def.unit ? `${def.type} (${def.unit})` : def.type;
+				const restartLabel = def.requiresRestart ? chalk.yellow("Sim") : chalk.green("Não");
+				log(`  ${key.padEnd(40)}${typeLabel.padEnd(12)}${restartLabel}`);
+				return {
+					name: key,
+					type: def.type,
+					unit: def.unit,
+					requiresRestart: def.requiresRestart,
+					description: def.description
+				};
+			});
+			log("");
+			return { params };
+		}
+		if (db.engine !== "postgresql") throw new Error("Configuração personalizada só é suportada para PostgreSQL.");
+		if (c.options.reset) {
+			requireMcpConfirmation(c.options.userConfirmation, `resetar configuração do banco de dados "${db.name}" para auto-tuned`);
+			if (!c.options.userConfirmation && isInteractive()) {
+				if (!await promptConfirm(`Resetar toda a configuração personalizada de "${db.name}" para auto-tuned?`, false)) {
+					info("Operação cancelada.");
+					return {};
+				}
+			}
+			const result = await withSpinner({
+				text: "Resetando configuração...",
+				fn: () => client.databases.resetConfig({ serviceId: db.id })
+			});
+			success("Configuração resetada para auto-tuned.");
+			info("O banco de dados será reiniciado para aplicar as alterações.");
+			return {
+				reset: true,
+				effective: result.effective
+			};
+		}
+		if (c.options.set) {
+			const eqIndex = c.options.set.indexOf("=");
+			if (eqIndex === -1) throw new Error("Formato inválido. Use: --set chave=valor (ex: --set shared_buffers=512MB)");
+			const key = c.options.set.slice(0, eqIndex).trim();
+			const value = c.options.set.slice(eqIndex + 1).trim();
+			const result = await withSpinner({
+				text: `Atualizando ${key}...`,
+				fn: () => client.databases.updateConfig({
+					serviceId: db.id,
+					config: { [key]: value }
+				})
+			});
+			success(`${key} = ${value}`);
+			if (result.requiresRestart) warn("Esta alteração requer reinício do banco de dados para ter efeito.");
+			return {
+				updated: true,
+				key,
+				value,
+				requiresRestart: result.requiresRestart
+			};
+		}
+		const config = await withSpinner({
+			text: "Carregando configuração...",
+			fn: () => client.databases.getConfig({ serviceId: db.id })
+		});
+		log(chalk.bold(`\n  Configuração PostgreSQL — ${db.name}\n`));
+		log(`  ${chalk.bold("Parâmetro".padEnd(40))}${chalk.bold("Valor".padEnd(20))}${chalk.bold("Origem")}`);
+		log(chalk.dim("  " + "─".repeat(70)));
+		for (const [key, value] of Object.entries(config.effective)) {
+			const isOverride = key in config.userOverrides;
+			const originLabel = isOverride ? chalk.cyan("personalizado") : chalk.dim("auto-tuned");
+			const valueLabel = isOverride ? chalk.cyan(value) : value;
+			log(`  ${key.padEnd(40)}${String(valueLabel).padEnd(20)}${originLabel}`);
+		}
+		if (Object.keys(config.userOverrides).length > 0) log(chalk.dim(`\n  ${Object.keys(config.userOverrides).length} parâmetro(s) personalizado(s)`));
+		log("");
+		return {
+			effective: config.effective,
+			userOverrides: config.userOverrides
+		};
+	}
+});
 
 //#endregion
 //#region src/commands/template.ts
@@ -5052,6 +5402,18 @@ function extractEnvVars(files) {
 	}
 	return vars;
 }
+/**
+* Extract the major Node.js version from a package.json string's `engines.node` field.
+* Handles ranges like `>=22`, `^20`, `~18.0`, `22.x`, `20`, `>=22.0.0`.
+* Returns the major version string (e.g. "22") or undefined if not parseable.
+*/
+function detectNodeVersion(pkgJsonStr) {
+	const pkg = safeParsePkg(pkgJsonStr);
+	if (!pkg?.engines?.node) return void 0;
+	const match = pkg.engines.node.trim().match(/(\d+)/);
+	if (!match) return void 0;
+	return match[1];
+}
 function analyzeRepo(files) {
 	const packageManager = detectPackageManager$1(files);
 	const envVars = extractEnvVars(files);
@@ -5069,6 +5431,7 @@ function analyzeRepo(files) {
 		const appPath = filePath.replace("/package.json", "");
 		const appName = nested.name || appPath.split("/").pop() || appPath;
 		let appFramework = detectFramework(content, packageManager);
+		if (!appFramework && !nested.scripts?.start) continue;
 		if (appFramework && rootPkg) {
 			if (rootPkg.scripts?.[`build:${appName}`]) appFramework = {
 				...appFramework,
@@ -5086,7 +5449,8 @@ function analyzeRepo(files) {
 			name: appName,
 			path: appPath,
 			framework: appFramework,
-			usesNodeFs: sourceEntries.some(([srcPath, fileContent]) => srcPath.startsWith(`${appPath}/`) && usesNodeFs(fileContent))
+			usesNodeFs: sourceEntries.some(([srcPath, fileContent]) => srcPath.startsWith(`${appPath}/`) && usesNodeFs(fileContent)),
+			nodeVersion: detectNodeVersion(content)
 		});
 	}
 	return {
@@ -5095,7 +5459,8 @@ function analyzeRepo(files) {
 		envVars,
 		isMonorepo,
 		monorepoApps,
-		usesNodeFs: sourceEntries.some(([, content]) => usesNodeFs(content))
+		usesNodeFs: sourceEntries.some(([, content]) => usesNodeFs(content)),
+		nodeVersion: rootPkgContent ? detectNodeVersion(rootPkgContent) : void 0
 	};
 }
 
@@ -5318,7 +5683,7 @@ const LOGO_LINES = [
 ];
 const BRAND_COLOR = "#FF4D00";
 function getVersion() {
-	return "0.0.0-beta.27";
+	return "0.0.0-beta.28";
 }
 function printBanner(subtitle) {
 	const version = getVersion();
@@ -6342,7 +6707,7 @@ async function fetchLatestVersion() {
 	}
 }
 function getCurrentVersion() {
-	return "0.0.0-beta.27";
+	return "0.0.0-beta.28";
 }
 /**
 * Install a specific CLI version. Returns true on success.
@@ -6920,7 +7285,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
 			port: a.framework?.port ?? 3e3,
-			usesNodeFs: a.usesNodeFs
+			usesNodeFs: a.usesNodeFs,
+			nodeVersion: a.nodeVersion
 		}));
 		let selectedApps;
 		if (opts.yes) if (opts.app) {
@@ -6987,7 +7353,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 					buildCommand: app.buildCommand ?? void 0,
 					startCommand: app.startCommand ?? void 0,
 					port: app.port ?? 3e3,
-					framework: app.framework ?? void 0
+					framework: app.framework ?? void 0,
+					nodeVersion: app.nodeVersion
 				}))
 			});
 			success(`Serviço criado: ${chalk.bold(service$1.name)}`);
@@ -7079,7 +7446,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			buildCommand: settings.buildCommand ?? void 0,
 			startCommand: settings.startCommand ?? void 0,
 			port: settings.port,
-			framework: settings.framework ?? void 0
+			framework: settings.framework ?? void 0,
+			nodeVersion: detection.nodeVersion
 		}))
 	});
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
@@ -7197,7 +7565,8 @@ async function addServiceFlow(existingConfig, opts) {
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
 			port: a.framework?.port ?? 3e3,
-			usesNodeFs: a.usesNodeFs
+			usesNodeFs: a.usesNodeFs,
+			nodeVersion: a.nodeVersion
 		}));
 		const availableApps = allApps.filter((a) => !existingRoots.has(a.root));
 		if (availableApps.length === 0) {
@@ -7271,7 +7640,8 @@ async function addServiceFlow(existingConfig, opts) {
 					buildCommand: hasDockerfile ? void 0 : app.buildCommand ?? void 0,
 					startCommand: hasDockerfile ? void 0 : app.startCommand ?? void 0,
 					port: app.port ?? 3e3,
-					framework: hasDockerfile ? "docker" : app.framework ?? void 0
+					framework: hasDockerfile ? "docker" : app.framework ?? void 0,
+					nodeVersion: hasDockerfile ? void 0 : app.nodeVersion
 				}))
 			});
 			success(`Serviço criado: ${chalk.bold(service$1.name)}`);
@@ -7382,7 +7752,8 @@ async function addServiceFlow(existingConfig, opts) {
 			buildCommand: settings.buildCommand ?? void 0,
 			startCommand: settings.startCommand ?? void 0,
 			port: settings.port,
-			framework: settings.framework ?? void 0
+			framework: settings.framework ?? void 0,
+			nodeVersion: detection.nodeVersion
 		}))
 	});
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
@@ -8016,7 +8387,7 @@ function registerUpdate(cli$1) {
 //#region src/index.ts
 if (process.argv.includes("--mcp")) process.env.VELOZ_MCP = "true";
 const cli = Cli.create("veloz", {
-	version: "0.0.0-beta.27",
+	version: "0.0.0-beta.28",
 	description: "CLI da plataforma Veloz — deploy rápido para o Brasil",
 	env: z.object({ VELOZ_ENV: z.string().optional().describe("Ambiente alvo (ex: preview, staging)") }),
 	mcp: { command: "npx -y onveloz --mcp" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onveloz",
-  "version": "0.0.0-beta.27",
+  "version": "0.0.0-beta.28",
   "description": "CLI da plataforma Veloz — deploy rápido para o Brasil",
   "keywords": [
     "brasil",