onveloz 0.0.0-beta.13 → 0.0.0-beta.14

package/dist/index.mjs

@@ -72,6 +72,7 @@ const SERVICE_TYPES = [
 ];
 const BUILD_TIMEOUT_MS = 600 * 1e3;
 const DEPLOY_TIMEOUT_MS = 300 * 1e3;
+const DEFAULT_SLEEP_CHECK_INTERVAL_MS = 300 * 1e3;
 
 //#endregion
 //#region ../../packages/config/veloz-config.ts
@@ -118,6 +119,17 @@ const EnvVarDefinitionSchema = z.object({
 	required: z.boolean().default(false).optional(),
 	example: z.string().optional()
 });
+const VolumeConfigSchema = z.object({
+	name: z.string().min(1).max(63).regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/),
+	mountPath: z.string().min(1).regex(/^\//).refine((value) => value !== "/", "Montar na raiz '/' não é permitido").refine((value) => value !== "/tmp" && !value.startsWith("/tmp/"), "Caminhos dentro de /tmp não são permitidos").refine((value) => ![
+		"/proc",
+		"/sys",
+		"/dev",
+		"/etc",
+		"/var/run"
+	].some((p) => value === p || value.startsWith(p + "/")), "Caminho de montagem não permitido por segurança"),
+	sizeGb: z.number().int().min(1).max(100).optional().default(1)
+});
 const ServiceConfigSchema = z.object({
 	id: z.string(),
 	name: z.string(),
@@ -127,6 +139,7 @@ const ServiceConfigSchema = z.object({
 	build: BuildConfigSchema.optional(),
 	runtime: RuntimeConfigSchema.optional(),
 	env: z.record(z.string().regex(/^[A-Z][A-Z0-9_]*$/), EnvVarDefinitionSchema).optional(),
+	volumes: z.array(VolumeConfigSchema).optional(),
 	resources: ResourcesSchema.optional()
 });
 const ProjectConfigSchema = z.object({
@@ -886,6 +899,8 @@ const linkCommand = new Command("link").description("Verificar vínculo do proje
 
 //#endregion
 //#region ../../packages/api/src/lib/framework-detector.ts
+const SOURCE_FILE_REGEX = /\.(?:[cm]?[jt]sx?)$/;
+const NODE_FS_IMPORT_REGEX = /(?:from\s+["'](?:node:)?fs(?:\/promises)?["']|require\(\s*["'](?:node:)?fs(?:\/promises)?["']\s*\)|import\(\s*["'](?:node:)?fs(?:\/promises)?["']\s*\))/;
 function safeParsePkg(content) {
 	try {
 		return JSON.parse(content);
@@ -897,6 +912,12 @@ function pmRun(pm, script) {
 	if (pm === "yarn") return `yarn ${script}`;
 	return `${pm} run ${script}`;
 }
+function isSourceFile(path) {
+	return SOURCE_FILE_REGEX.test(path);
+}
+function usesNodeFs(content) {
+	return NODE_FS_IMPORT_REGEX.test(content);
+}
 function detectFramework(pkgJsonStr, pm) {
 	const pkg = safeParsePkg(pkgJsonStr);
 	if (!pkg) return null;
@@ -1070,6 +1091,7 @@ function extractEnvVars(files) {
 function analyzeRepo(files) {
 	const packageManager = detectPackageManager$1(files);
 	const envVars = extractEnvVars(files);
+	const sourceEntries = Object.entries(files).filter(([path]) => isSourceFile(path));
 	const rootPkgContent = files["package.json"];
 	const rootPkg = rootPkgContent ? safeParsePkg(rootPkgContent) : null;
 	const isMonorepo = "pnpm-workspace.yaml" in files || !!rootPkg?.workspaces;
@@ -1099,7 +1121,8 @@ function analyzeRepo(files) {
 		monorepoApps.push({
 			name: appName,
 			path: appPath,
-			framework: appFramework
+			framework: appFramework,
+			usesNodeFs: sourceEntries.some(([filePath$1, fileContent]) => filePath$1.startsWith(`${appPath}/`) && usesNodeFs(fileContent))
 		});
 	}
 	return {
@@ -1107,7 +1130,8 @@ function analyzeRepo(files) {
 		framework,
 		envVars,
 		isMonorepo,
-		monorepoApps
+		monorepoApps,
+		usesNodeFs: sourceEntries.some(([, content]) => usesNodeFs(content))
 	};
 }
 
@@ -1406,7 +1430,10 @@ async function deployServicesInParallel(services) {
 	const sizeMB = Math.round(sizeInBytes / (1024 * 1024) * 10) / 10;
 	const deploymentPromises = services.map(async (service) => {
 		try {
-			const deployment = await withRetry(() => client.deployments.create({ serviceId: service.serviceId }));
+			const deployment = await withRetry(() => client.deployments.create({
+				serviceId: service.serviceId,
+				serviceConfig: service.serviceConfig
+			}));
 			await withRetry(() => uploadSource(deployment.id, projectRoot, service.extraFiles));
 			trackDeployment(deployment.id);
 			progressMap.set(service.serviceId, {
@@ -1781,7 +1808,7 @@ const LOGO_LINES = [
 ];
 const BRAND_COLOR = "#FF4D00";
 function getVersion() {
-	return "0.0.0-beta.13";
+	return "0.0.0-beta.14";
 }
 function printBanner(subtitle) {
 	const mode = getOutputMode();
@@ -1815,7 +1842,8 @@ function resolveServiceConf(velozConfig, serviceId) {
 	for (const [, conf] of Object.entries(velozConfig.services)) if (conf.id === serviceId) {
 		const merged = mergeServiceWithDefaults(conf, velozConfig.defaults);
 		return {
-			type: merged.type,
+			type: merged.type?.toUpperCase(),
+			branch: merged.branch,
 			buildCommand: merged.build?.command ?? void 0,
 			startCommand: merged.runtime?.command ?? void 0,
 			port: merged.runtime?.port ?? void 0,
@@ -1829,29 +1857,11 @@ function resolveServiceConf(velozConfig, serviceId) {
 			nodeVersion: merged.build?.nodeVersion ?? void 0,
 			nixpkgsArchive: merged.build?.nixpkgsArchive ?? void 0,
 			packageManager: merged.build?.packageManager ?? void 0,
-			installCommand: merged.build?.installCommand ?? void 0
+			installCommand: merged.build?.installCommand ?? void 0,
+			volumes: merged.volumes ?? void 0
 		};
 	}
 }
-async function syncServiceConfig(client, serviceId, conf) {
-	await withRetry(() => client.services.update({
-		serviceId,
-		type: conf.type?.toUpperCase(),
-		port: conf.port,
-		instanceCount: conf.instanceCount,
-		cpuLimit: conf.cpuLimit,
-		memoryLimit: conf.memoryLimit,
-		buildCommand: conf.buildCommand,
-		startCommand: conf.startCommand,
-		rootDirectory: conf.rootDirectory,
-		healthCheckPath: conf.healthCheckPath,
-		aptPackages: conf.aptPackages,
-		nodeVersion: conf.nodeVersion,
-		nixpkgsArchive: conf.nixpkgsArchive,
-		packageManager: conf.packageManager,
-		installCommand: conf.installCommand
-	}));
-}
 
 //#endregion
 //#region src/lib/deploy-checks.ts
@@ -2285,7 +2295,7 @@ async function fetchLatestVersion() {
 async function autoUpdate() {
 	const pm = detectPackageManager();
 	if (!pm) return;
-	const currentVersion = "0.0.0-beta.13";
+	const currentVersion = "0.0.0-beta.14";
 	const latestVersion = await fetchLatestVersion();
 	if (!latestVersion || latestVersion === currentVersion) return;
 	const installCmd = getInstallCommand(pm, latestVersion);
@@ -2324,7 +2334,6 @@ function prepareExtraFiles(_detection, serviceConfig) {
 }
 async function computeExtraFilesForServices(services) {
 	const velozConfig = loadConfig();
-	const client = await getClient();
 	const results = [];
 	const allWarnings = [];
 	for (const svc of services) {
@@ -2347,10 +2356,11 @@ async function computeExtraFilesForServices(services) {
 	});
 	for (const svc of services) {
 		const serviceConf = resolveServiceConf(velozConfig, svc.serviceId);
-		if (serviceConf) await syncServiceConfig(client, svc.serviceId, serviceConf);
 		const detection = detectLocalRepo(serviceConf?.rootDirectory || ".");
+		warnIfEphemeralFsDetected(detection, serviceConf, svc.serviceName);
 		results.push({
 			...svc,
+			serviceConfig: serviceConf,
 			extraFiles: prepareExtraFiles(detection, serviceConf)
 		});
 	}
@@ -2364,8 +2374,9 @@ async function triggerDeploy(serviceId, serviceName, preDetection) {
 		if (sizeMB > 5) spinUpload.text = `Fazendo upload (${sizeMB} MB)...`;
 		const client = await getClient();
 		const serviceConf = resolveServiceConf(loadConfig(), serviceId);
-		if (serviceConf) await syncServiceConfig(client, serviceId, serviceConf);
-		const extraFiles = prepareExtraFiles(preDetection ?? detectLocalRepo(), serviceConf);
+		const detection = preDetection ?? detectLocalRepo();
+		warnIfEphemeralFsDetected(detection, serviceConf, serviceName ?? void 0);
+		const extraFiles = prepareExtraFiles(detection, serviceConf);
 		const warnings = runPreDeployChecks(serviceConf?.rootDirectory || ".");
 		if (warnings.length > 0) {
 			spinUpload.stop();
@@ -2373,7 +2384,10 @@ async function triggerDeploy(serviceId, serviceName, preDetection) {
 			spinUpload.start();
 		}
 		spinUpload.text = "Iniciando deploy...";
-		const deployment = await withRetry(() => client.deployments.create({ serviceId }));
+		const deployment = await withRetry(() => client.deployments.create({
+			serviceId,
+			serviceConfig: serviceConf
+		}));
 		spinUpload.text = "Fazendo upload do código...";
 		await withRetry(() => uploadSource(deployment.id, process.cwd(), extraFiles));
 		spinUpload.stop();
@@ -2390,6 +2404,25 @@ async function triggerDeploy(serviceId, serviceName, preDetection) {
 		handleError(error);
 	}
 }
+function warnIfEphemeralFsDetected(detection, serviceConf, serviceLabel) {
+	if (!detection.usesNodeFs || (serviceConf?.volumes?.length ?? 0) > 0) return;
+	warn$1(`Uso de fs/node:fs detectado${serviceLabel ? ` no serviço ${chalk.bold(serviceLabel)}` : ""}. O filesystem do container é efêmero; configure um volume em veloz.json ou use 'veloz volumes create'.`);
+}
+async function maybeConfigurePersistentVolume(serviceConfig, detection, opts, serviceLabel) {
+	if (!detection.usesNodeFs || (serviceConfig.volumes?.length ?? 0) > 0) return;
+	if (opts.yes) return;
+	if (!await promptConfirm(`Deseja adicionar um volume persistente para ${serviceLabel}?`, true)) return;
+	const name = await prompt(`Nome do volume ${chalk.dim("(data)")}:`) || "data";
+	const mountPath = await prompt(`Mount path ${chalk.dim("(/data)")}:`) || "/data";
+	const sizeInput = await prompt(`Tamanho em GB ${chalk.dim("(1)")}:`);
+	const parsedSize = Number.parseInt(sizeInput || "1", 10);
+	serviceConfig.volumes = [{
+		name,
+		mountPath,
+		sizeGb: Number.isInteger(parsedSize) && parsedSize > 0 ? parsedSize : 1
+	}];
+	info(`Volume persistente configurado para ${serviceLabel}.`);
+}
 async function findServicesFromConfig() {
 	const config = loadConfig();
 	if (!config) return [];
@@ -2413,6 +2446,41 @@ function readLocalFile(path) {
 		return null;
 	}
 }
+const SOURCE_FILE_NAME = /\.(?:[cm]?[jt]sx?)$/;
+const SOURCE_SCAN_IGNORED_DIRS = new Set([
+	".git",
+	".next",
+	".turbo",
+	"coverage",
+	"dist",
+	"build",
+	"node_modules"
+]);
+const MAX_SOURCE_FILES = 200;
+const MAX_SOURCE_FILE_BYTES = 64 * 1024;
+function collectSourceFiles(scanRoot, outputPrefix, files, counter) {
+	if (!existsSync(scanRoot) || counter.count >= MAX_SOURCE_FILES) return;
+	try {
+		const entries = readdirSync(scanRoot, { withFileTypes: true });
+		for (const entry of entries) {
+			if (counter.count >= MAX_SOURCE_FILES) return;
+			const fullPath = join(scanRoot, entry.name);
+			const relativePath = outputPrefix ? `${outputPrefix}/${entry.name}` : entry.name;
+			if (entry.isDirectory()) {
+				if (SOURCE_SCAN_IGNORED_DIRS.has(entry.name)) continue;
+				collectSourceFiles(fullPath, relativePath, files, counter);
+				continue;
+			}
+			if (!entry.isFile() || !SOURCE_FILE_NAME.test(entry.name)) continue;
+			try {
+				const content = readFileSync(fullPath, "utf-8");
+				if (Buffer.byteLength(content, "utf-8") > MAX_SOURCE_FILE_BYTES) continue;
+				files[relativePath] = content;
+				counter.count += 1;
+			} catch {}
+		}
+	} catch {}
+}
 function printSummary(settings) {
 	const { type: serviceType, ...rest } = settings;
 	output({
@@ -2437,6 +2505,7 @@ function printSummary(settings) {
 }
 function detectLocalRepo(basePath = ".") {
 	const files = {};
+	const sourceCounter = { count: 0 };
 	const pkgJson = readLocalFile(join(basePath, "package.json"));
 	if (pkgJson) files["package.json"] = pkgJson;
 	const envExample = readLocalFile(join(basePath, ".env.example"));
@@ -2482,22 +2551,26 @@ function detectLocalRepo(basePath = ".") {
 			}
 		}
 	}
+	if (workspacePatterns.length === 0) collectSourceFiles(resolve(process.cwd(), basePath), "", files, sourceCounter);
 	for (const pattern of workspacePatterns) {
 		const hasGlob = /\/?\*\*?$/.test(pattern);
 		const base = pattern.replace(/\/?\*\*?$/, "");
 		if (hasGlob) {
-			const dirPath = resolve(process.cwd(), base);
+			const dirPath = resolve(process.cwd(), basePath, base);
 			if (!existsSync(dirPath)) continue;
 			try {
 				const entries = readdirSync(dirPath, { withFileTypes: true });
 				for (const entry of entries) if (entry.isDirectory()) {
-					const nestedPkg = readLocalFile(join(basePath, base, entry.name, "package.json"));
-					if (nestedPkg) files[`${base}/${entry.name}/package.json`] = nestedPkg;
+					const appPrefix = `${base}/${entry.name}`;
+					const nestedPkg = readLocalFile(join(basePath, appPrefix, "package.json"));
+					if (nestedPkg) files[`${appPrefix}/package.json`] = nestedPkg;
+					collectSourceFiles(resolve(process.cwd(), basePath, appPrefix), appPrefix, files, sourceCounter);
 				}
 			} catch {}
 		} else {
 			const nestedPkg = readLocalFile(join(basePath, base, "package.json"));
 			if (nestedPkg) files[`${base}/package.json`] = nestedPkg;
+			collectSourceFiles(resolve(process.cwd(), basePath, base), base, files, sourceCounter);
 		}
 	}
 	return analyzeRepo(files);
@@ -2540,7 +2613,8 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			framework: a.framework?.name ?? null,
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
-			port: a.framework?.port ?? 3e3
+			port: a.framework?.port ?? 3e3,
+			usesNodeFs: a.usesNodeFs
 		}));
 		let selectedApps;
 		if (opts.yes) if (opts.app) {
@@ -2590,7 +2664,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 				if (newPort) app.port = parseInt(newPort, 10) || app.port;
 			}
 		}
-		const config = {
+		const config$1 = {
 			version: "1.0",
 			project: {
 				id: projectId,
@@ -2619,7 +2693,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 				service: service$1,
 				app
 			});
-			config.services[app.root] = {
+			config$1.services[app.root] = {
 				id: service$1.id,
 				name: service$1.name,
 				type: "web",
@@ -2631,8 +2705,9 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 					port: app.port ?? 3e3
 				}
 			};
+			await maybeConfigurePersistentVolume(config$1.services[app.root], detectLocalRepo(app.root), opts, app.name);
 		}
-		saveConfig(config);
+		saveConfig(config$1);
 		info(`Arquivo ${getConfigFileName()} criado na raiz do projeto.`);
 		if (!opts.yes) for (const { service: service$1, app } of createdServices) {
 			console.log(chalk.cyan(`\n── Configurando variáveis: ${app.name} ──\n`));
@@ -2643,6 +2718,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			serviceId: service$1.id,
 			serviceName: app.name,
 			path: resolve(process.cwd(), app.root),
+			serviceConfig: resolveServiceConf(config$1, service$1.id),
 			extraFiles: prepareExtraFiles(detectLocalRepo(app.root), {
 				type: "WEB",
 				buildCommand: app.buildCommand ?? void 0,
@@ -2708,7 +2784,7 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 	spinService.stop();
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
 	if (!opts.yes) await promptEnvVars(service.id, detection.envVars.map((v) => v.key));
-	saveConfig({
+	const config = {
 		version: "1.0",
 		project: {
 			id: projectId,
@@ -2730,7 +2806,9 @@ async function createServiceFlow(projectId, projectName, repoName, opts = {}) {
 			}
 		} },
 		created: (/* @__PURE__ */ new Date()).toISOString()
-	});
+	};
+	await maybeConfigurePersistentVolume(config.services.main, detection, opts, service.name);
+	saveConfig(config);
 	info(`Arquivo ${getConfigFileName()} criado na raiz do projeto.`);
 	return service.id;
 }
@@ -2819,7 +2897,8 @@ async function addServiceFlow(existingConfig, opts) {
 			framework: a.framework?.name ?? null,
 			buildCommand: a.framework?.buildCommand ?? null,
 			startCommand: a.framework?.startCommand ?? null,
-			port: a.framework?.port ?? 3e3
+			port: a.framework?.port ?? 3e3,
+			usesNodeFs: a.usesNodeFs
 		})).filter((a) => !existingRoots.has(a.root));
 		if (availableApps.length === 0) {
 			info("Todos os apps do monorepo já estão configurados.");
@@ -2877,7 +2956,7 @@ async function addServiceFlow(existingConfig, opts) {
 				if (newPort) app.port = parseInt(newPort, 10) || app.port;
 			}
 		}
-		const updatedConfig = {
+		const updatedConfig$1 = {
 			...existingConfig,
 			services: { ...existingConfig.services }
 		};
@@ -2900,7 +2979,7 @@ async function addServiceFlow(existingConfig, opts) {
 				service: service$1,
 				app
 			});
-			updatedConfig.services[app.root] = {
+			updatedConfig$1.services[app.root] = {
 				id: service$1.id,
 				name: service$1.name,
 				type: "web",
@@ -2912,9 +2991,10 @@ async function addServiceFlow(existingConfig, opts) {
 					port: app.port ?? 3e3
 				}
 			};
+			await maybeConfigurePersistentVolume(updatedConfig$1.services[app.root], detectLocalRepo(app.root), opts, app.name);
 		}
-		updatedConfig.updated = (/* @__PURE__ */ new Date()).toISOString();
-		saveConfig(updatedConfig);
+		updatedConfig$1.updated = (/* @__PURE__ */ new Date()).toISOString();
+		saveConfig(updatedConfig$1);
 		info(`Arquivo ${getConfigFileName()} atualizado com ${createdServices.length} novo(s) serviço(s).`);
 		if (!opts.yes) for (const { service: service$1, app } of createdServices) {
 			console.log(chalk.cyan(`\n── Configurando variáveis: ${app.name} ──\n`));
@@ -2925,6 +3005,7 @@ async function addServiceFlow(existingConfig, opts) {
 			serviceId: service$1.id,
 			serviceName: app.name,
 			path: resolve(process.cwd(), app.root),
+			serviceConfig: resolveServiceConf(updatedConfig$1, service$1.id),
 			extraFiles: prepareExtraFiles(detectLocalRepo(app.root), {
 				type: "WEB",
 				buildCommand: app.buildCommand ?? void 0,
@@ -2984,7 +3065,7 @@ async function addServiceFlow(existingConfig, opts) {
 	success(`Serviço criado: ${chalk.bold(service.name)}`);
 	if (!opts.yes) await promptEnvVars(service.id, detection.envVars.map((v) => v.key));
 	const serviceKey = settings.rootDir !== "." ? settings.rootDir : settings.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
-	saveConfig({
+	const updatedConfig = {
 		...existingConfig,
 		services: {
 			...existingConfig.services,
@@ -3005,7 +3086,9 @@ async function addServiceFlow(existingConfig, opts) {
 			}
 		},
 		updated: (/* @__PURE__ */ new Date()).toISOString()
-	});
+	};
+	await maybeConfigurePersistentVolume(updatedConfig.services[serviceKey], detection, opts, service.name);
+	saveConfig(updatedConfig);
 	info(`Arquivo ${getConfigFileName()} atualizado.`);
 	await triggerDeploy(service.id, service.name);
 }
@@ -3732,6 +3815,198 @@ domainsCommand.command("delete <domainId>").alias("deletar").description("Remove
 	}
 });
 
+//#endregion
+//#region src/lib/volume-config.ts
+function updateServiceVolumesInConfig(serviceKey, updater) {
+	const config = loadRawConfig();
+	if (!config) return false;
+	const currentService = config.services[serviceKey];
+	if (!currentService) return false;
+	currentService.volumes = updater([...currentService.volumes ?? []]);
+	config.updated = (/* @__PURE__ */ new Date()).toISOString();
+	saveConfig(config);
+	return true;
+}
+
+//#endregion
+//#region src/commands/volumes.ts
+const STATUS_COLORS = {
+	READY: chalk.green,
+	PENDING: chalk.yellow,
+	ERROR: chalk.red
+};
+function formatStatus(status) {
+	return (STATUS_COLORS[status] ?? chalk.dim)(status);
+}
+async function resolveRemoteVolume(serviceId, volumeRef) {
+	const volume = (await (await getClient()).volumes.list({ serviceId })).find((entry) => entry.id === volumeRef || entry.name === volumeRef);
+	if (!volume) throw new Error(`Volume '${volumeRef}' não encontrado para este serviço.`);
+	return volume;
+}
+async function promptAndSyncDeployment(serviceId) {
+	if (!await promptConfirm("Reiniciar o serviço agora para aplicar as alterações de volumes?", false)) {
+		info("O serviço não foi reiniciado. Reinicie manualmente quando desejar.");
+		return;
+	}
+	const spin = spinner("Reiniciando serviço...");
+	try {
+		await (await getClient()).volumes.syncDeployment({ serviceId });
+		spin.stop();
+		success("Serviço reiniciando com os volumes atualizados.");
+	} catch (error) {
+		spin.stop();
+		handleError(error);
+	}
+}
+const volumesCommand = new Command("volumes").alias("volume").description("Gerenciar volumes persistentes");
+volumesCommand.command("list").alias("listar").description("Listar volumes dos serviços").option("--service <service>", "Filtrar por serviço (chave ou nome)").action(async (opts) => {
+	const spin = spinner("Carregando volumes...");
+	try {
+		const { services } = resolveAllServices(opts.service);
+		const client = await getClient();
+		const showHeaders = services.length > 1;
+		let totalVolumes = 0;
+		const allVolumes = [];
+		for (const { service, index } of services) {
+			const volumes = await client.volumes.list({ serviceId: service.id });
+			totalVolumes += volumes.length;
+			allVolumes.push({
+				service,
+				index,
+				volumes
+			});
+		}
+		spin.stop();
+		for (const { service, index, volumes } of allVolumes) {
+			if (showHeaders) console.log(`\n${getServiceHeader(service.name, index)}`);
+			if (volumes.length === 0) {
+				info("Nenhum volume configurado.");
+				continue;
+			}
+			printTable([
+				"Nome",
+				"Montagem",
+				"Tamanho",
+				"Status"
+			], volumes.map((volume) => [
+				chalk.bold(volume.name),
+				chalk.dim(volume.mountPath),
+				`${volume.sizeGb} GB`,
+				formatStatus(volume.status)
+			]), volumes.map((volume) => ({
+				id: volume.id,
+				name: volume.name,
+				mountPath: volume.mountPath,
+				sizeGb: volume.sizeGb,
+				status: volume.status
+			})));
+		}
+		if (totalVolumes === 0 && !showHeaders) info("Nenhum volume configurado.");
+	} catch (error) {
+		spin.stop();
+		handleError(error);
+	}
+});
+volumesCommand.command("create <name>").alias("criar").description("Criar um volume persistente").requiredOption("--mount <path>", "Caminho de montagem no container").option("--size <gb>", "Tamanho em GB", "1").option("--service <service>", "Serviço alvo (chave ou nome)").option("--restart", "Reiniciar o serviço imediatamente após criar").action(async (name, opts) => {
+	let spin;
+	try {
+		const { key, service } = await resolveService(opts.service);
+		const client = await getClient();
+		const sizeGb = Number.parseInt(opts.size, 10);
+		if (!Number.isInteger(sizeGb) || sizeGb < 1 || sizeGb > 100) throw new Error("O tamanho do volume deve ser um inteiro entre 1 e 100 GB.");
+		spin = spinner("Criando volume...");
+		const volume = await client.volumes.create({
+			serviceId: service.id,
+			name,
+			mountPath: opts.mount,
+			sizeGb
+		});
+		spin.stop();
+		updateServiceVolumesInConfig(key, (volumes) => [...volumes.filter((entry) => entry.name !== volume.name), {
+			name: volume.name,
+			mountPath: volume.mountPath,
+			sizeGb: volume.sizeGb
+		}]);
+		success(`Volume ${chalk.bold(volume.name)} criado.`);
+		if (opts.restart) {
+			const syncSpin = spinner("Reiniciando serviço...");
+			await client.volumes.syncDeployment({ serviceId: service.id });
+			syncSpin.stop();
+			success("Serviço reiniciando com os volumes atualizados.");
+		} else await promptAndSyncDeployment(service.id);
+	} catch (error) {
+		spin?.stop();
+		handleError(error);
+	}
+});
+volumesCommand.command("expand <volume>").alias("resize").description("Expandir um volume existente").requiredOption("--size <gb>", "Novo tamanho em GB").option("--service <service>", "Serviço alvo (chave ou nome)").action(async (volumeRef, opts) => {
+	let spin;
+	try {
+		const { key, service } = await resolveService(opts.service);
+		const client = await getClient();
+		const sizeGb = Number.parseInt(opts.size, 10);
+		if (!Number.isInteger(sizeGb) || sizeGb < 1 || sizeGb > 100) throw new Error("O tamanho do volume deve ser um inteiro entre 1 e 100 GB.");
+		const volume = await resolveRemoteVolume(service.id, volumeRef);
+		spin = spinner("Expandindo volume...");
+		await client.volumes.update({
+			volumeId: volume.id,
+			sizeGb
+		});
+		spin.stop();
+		updateServiceVolumesInConfig(key, (volumes) => volumes.map((entry) => entry.name === volume.name ? {
+			...entry,
+			sizeGb
+		} : entry));
+		success(`Volume ${chalk.bold(volume.name)} expandido para ${sizeGb} GB.`);
+	} catch (error) {
+		spin?.stop();
+		handleError(error);
+	}
+});
+volumesCommand.command("delete <volume>").alias("deletar").description("Remover um volume do serviço (dados mantidos por 30 dias)").option("--service <service>", "Serviço alvo (chave ou nome)").option("--restart", "Reiniciar o serviço imediatamente após remover").option("--yes", "Pular confirmação").action(async (volumeRef, opts) => {
+	let spin;
+	try {
+		const { key, service } = await resolveService(opts.service);
+		const client = await getClient();
+		const volume = await resolveRemoteVolume(service.id, volumeRef);
+		if (!opts.yes) {
+			if (!await promptConfirm(`Remover volume ${chalk.bold(volume.name)} (${volume.mountPath}) do serviço? Os dados serão mantidos por 30 dias.`, false)) {
+				info("Operação cancelada.");
+				return;
+			}
+		}
+		spin = spinner("Removendo volume...");
+		await client.volumes.delete({ volumeId: volume.id });
+		spin.stop();
+		updateServiceVolumesInConfig(key, (volumes) => volumes.filter((entry) => entry.name !== volume.name));
+		success(`Volume ${chalk.bold(volume.name)} removido do serviço.`);
+		info("Os dados serão mantidos por 30 dias.");
+		if (opts.restart) {
+			const syncSpin = spinner("Reiniciando serviço...");
+			await client.volumes.syncDeployment({ serviceId: service.id });
+			syncSpin.stop();
+			success("Serviço reiniciando sem o volume.");
+		} else await promptAndSyncDeployment(service.id);
+	} catch (error) {
+		spin?.stop();
+		handleError(error);
+	}
+});
+volumesCommand.command("sync").description("Reiniciar o serviço para aplicar alterações de volumes").option("--service <service>", "Serviço alvo (chave ou nome)").action(async (opts) => {
+	let spin;
+	try {
+		const { service } = await resolveService(opts.service);
+		const client = await getClient();
+		spin = spinner("Sincronizando volumes...");
+		await client.volumes.syncDeployment({ serviceId: service.id });
+		spin.stop();
+		success("Serviço reiniciando com os volumes atualizados.");
+	} catch (error) {
+		spin?.stop();
+		handleError(error);
+	}
+});
+
 //#endregion
 //#region src/commands/config.ts
 function formatValue(value) {
@@ -4057,7 +4332,7 @@ const whoamiCommand = new Command("whoami").description("Mostrar usuário autent
 
 //#endregion
 //#region src/index.ts
-const program = new Command().name("veloz").description("CLI da plataforma Veloz — deploy rápido para o Brasil").version("0.0.0-beta.13").option("--output <format>", "Formato de saída: fancy, json, github-actions, plain").option("--env <environment>", "Ambiente alvo (ex: preview, staging)").hook("preAction", (thisCommand) => {
+const program = new Command().name("veloz").description("CLI da plataforma Veloz — deploy rápido para o Brasil").version("0.0.0-beta.14").option("--output <format>", "Formato de saída: fancy, json, github-actions, plain").option("--env <environment>", "Ambiente alvo (ex: preview, staging)").hook("preAction", (thisCommand) => {
 	const opts = thisCommand.opts();
 	if (opts.output) {
 		const valid = [
@@ -4082,6 +4357,7 @@ program.addCommand(deployCommand);
 program.addCommand(logsCommand);
 program.addCommand(envCommand);
 program.addCommand(domainsCommand);
+program.addCommand(volumesCommand);
 program.addCommand(configCommand);
 program.addCommand(useCommand);
 program.addCommand(apikeyCommand);

package/package.json

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