@launchfile/macos-dev 0.1.4 → 0.2.0

package/src/process-manager.ts

@@ -1,242 +0,0 @@
-/**
- * Lightweight process manager for multi-component Launchfile apps.
- *
- * Handles topological startup ordering, log multiplexing,
- * health check waits, and graceful shutdown.
- */
-
-import { spawn, type ChildProcess } from "node:child_process";
-import { createWriteStream, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import type { NormalizedHealth, NormalizedDependsOnEntry } from "@launchfile/sdk";
-import { waitForHealthy } from "./health.js";
-
-// ANSI colors for log prefixing
-const COLORS = [
-	"\x1b[36m", // cyan
-	"\x1b[33m", // yellow
-	"\x1b[32m", // green
-	"\x1b[35m", // magenta
-	"\x1b[34m", // blue
-	"\x1b[31m", // red
-];
-const RESET = "\x1b[0m";
-
-interface ManagedProcess {
-	name: string;
-	command: string;
-	env: Record<string, string>;
-	cwd: string;
-	dependsOn: NormalizedDependsOnEntry[];
-	health?: NormalizedHealth;
-	port?: number;
-	process?: ChildProcess;
-	status: "pending" | "starting" | "running" | "healthy" | "failed" | "stopped";
-}
-
-export class ProcessManager {
-	private processes = new Map<string, ManagedProcess>();
-	private logDir: string;
-
-	constructor(projectDir: string) {
-		this.logDir = join(projectDir, ".launchfile", "logs");
-		// Security: restrict permissions — logs may contain sensitive output
-		mkdirSync(this.logDir, { recursive: true, mode: 0o700 });
-	}
-
-	register(
-		name: string,
-		config: {
-			command: string;
-			env: Record<string, string>;
-			cwd: string;
-			dependsOn?: NormalizedDependsOnEntry[];
-			health?: NormalizedHealth;
-			port?: number;
-		},
-	): void {
-		this.processes.set(name, {
-			name,
-			command: config.command,
-			env: config.env,
-			cwd: config.cwd,
-			dependsOn: config.dependsOn ?? [],
-			health: config.health,
-			port: config.port,
-			status: "pending",
-		});
-	}
-
-	/**
-	 * Start all registered processes respecting dependency order.
-	 */
-	async startAll(): Promise<void> {
-		const batches = this.topologicalSort();
-
-		for (const batch of batches) {
-			// Start all processes in this batch concurrently
-			await Promise.all(batch.map((name) => this.startOne(name)));
-		}
-
-		console.log("\n  All components started.");
-	}
-
-	private async startOne(name: string): Promise<void> {
-		const proc = this.processes.get(name);
-		if (!proc) throw new Error(`Unknown component: ${name}`);
-
-		// Wait for dependencies
-		for (const dep of proc.dependsOn) {
-			const depProc = this.processes.get(dep.component);
-			if (!depProc) continue;
-
-			if (dep.condition === "healthy") {
-				console.log(`  [${name}] Waiting for ${dep.component} to be healthy...`);
-				if (depProc.health && depProc.port) {
-					await waitForHealthy(dep.component, depProc.health, depProc.port);
-				}
-			}
-			// For "started" condition, the process is already spawned by the time we get here
-		}
-
-		proc.status = "starting";
-		console.log(`  [${name}] Starting: ${proc.command}`);
-
-		const logFile = createWriteStream(join(this.logDir, `${name}.log`), { flags: "a" });
-		const colorIdx = [...this.processes.keys()].indexOf(name) % COLORS.length;
-		const color = COLORS[colorIdx]!;
-		const maxNameLen = Math.max(...[...this.processes.keys()].map((n) => n.length));
-		const paddedName = name.padEnd(maxNameLen);
-
-		proc.process = spawn("sh", ["-c", proc.command], {
-			env: { ...process.env, ...proc.env },
-			cwd: proc.cwd,
-			stdio: ["ignore", "pipe", "pipe"],
-		});
-
-		// Pipe stdout with prefix
-		proc.process.stdout?.on("data", (data: Buffer) => {
-			const lines = data.toString().split("\n");
-			for (const line of lines) {
-				if (line) {
-					process.stdout.write(`${color}[${paddedName}]${RESET} ${line}\n`);
-					logFile.write(`${new Date().toISOString()} ${line}\n`);
-				}
-			}
-		});
-
-		// Pipe stderr with prefix
-		proc.process.stderr?.on("data", (data: Buffer) => {
-			const lines = data.toString().split("\n");
-			for (const line of lines) {
-				if (line) {
-					process.stderr.write(`${color}[${paddedName}]${RESET} \x1b[2m${line}${RESET}\n`);
-					logFile.write(`${new Date().toISOString()} ERR ${line}\n`);
-				}
-			}
-		});
-
-		proc.process.on("exit", (code) => {
-			proc.status = code === 0 ? "stopped" : "failed";
-			console.log(
-				`${color}[${paddedName}]${RESET} Process exited with code ${code}`,
-			);
-			logFile.end();
-		});
-
-		proc.status = "running";
-	}
-
-	/**
-	 * Graceful shutdown in reverse dependency order.
-	 */
-	async stopAll(): Promise<void> {
-		const batches = this.topologicalSort().reverse();
-
-		for (const batch of batches) {
-			await Promise.all(
-				batch.map((name) => {
-					const proc = this.processes.get(name);
-					if (!proc?.process || proc.status === "stopped") return Promise.resolve();
-					return this.stopOne(proc);
-				}),
-			);
-		}
-	}
-
-	private stopOne(proc: ManagedProcess): Promise<void> {
-		return new Promise((resolve) => {
-			if (!proc.process) {
-				resolve();
-				return;
-			}
-
-			const timeout = setTimeout(() => {
-				proc.process?.kill("SIGKILL");
-			}, 10_000);
-
-			proc.process.once("exit", () => {
-				clearTimeout(timeout);
-				proc.status = "stopped";
-				resolve();
-			});
-
-			proc.process.kill("SIGTERM");
-		});
-	}
-
-	/**
-	 * Topological sort based on depends_on.
-	 * Returns batches of component names that can start concurrently.
-	 */
-	private topologicalSort(): string[][] {
-		const names = [...this.processes.keys()];
-		const inDegree = new Map<string, number>();
-		const dependents = new Map<string, string[]>();
-
-		for (const name of names) {
-			inDegree.set(name, 0);
-			dependents.set(name, []);
-		}
-
-		for (const [name, proc] of this.processes) {
-			for (const dep of proc.dependsOn) {
-				if (this.processes.has(dep.component)) {
-					inDegree.set(name, (inDegree.get(name) ?? 0) + 1);
-					dependents.get(dep.component)!.push(name);
-				}
-			}
-		}
-
-		const batches: string[][] = [];
-		let remaining = new Set(names);
-
-		while (remaining.size > 0) {
-			const batch = [...remaining].filter((n) => (inDegree.get(n) ?? 0) === 0);
-			if (batch.length === 0) {
-				// Circular dependency — just add remaining
-				batches.push([...remaining]);
-				break;
-			}
-			batches.push(batch);
-			for (const name of batch) {
-				remaining.delete(name);
-				for (const dependent of dependents.get(name) ?? []) {
-					inDegree.set(dependent, (inDegree.get(dependent) ?? 0) - 1);
-				}
-			}
-		}
-
-		return batches;
-	}
-
-	/** Get status summary for all processes */
-	getStatus(): Array<{ name: string; status: string; pid?: number; port?: number }> {
-		return [...this.processes.entries()].map(([name, proc]) => ({
-			name,
-			status: proc.status,
-			pid: proc.process?.pid,
-			port: proc.port,
-		}));
-	}
-}

package/src/provider.ts

@@ -1,415 +0,0 @@
-/**
- * Main provider orchestration — the `launch up` sequence.
- *
- * Reads a Launchfile, provisions resources, resolves env vars,
- * installs runtimes, and starts all components.
- */
-
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { readLaunch, type NormalizedLaunch } from "@launchfile/sdk";
-import { checkPrereqs } from "./prereqs.js";
-import { loadState, initState, saveState, ensureDirs } from "./state.js";
-import {
-	buildResolverContext,
-	resolveComponentEnv,
-	generateSecrets,
-	resolveGenerators,
-	writeEnvFile,
-} from "./env-writer.js";
-import { getProvisioner, type ResourceProperties } from "./resources/index.js";
-import { allocatePorts } from "./port-allocator.js";
-import { getRuntimeInstaller } from "./runtimes/index.js";
-import { detectPackageManager } from "./lockfile-detect.js";
-import { provisionStorage } from "./storage.js";
-import { ProcessManager } from "./process-manager.js";
-import { shell } from "./shell.js";
-
-export interface LaunchUpOpts {
-	withOptional?: boolean;
-	noBuild?: boolean;
-	detach?: boolean;
-	dryRun?: boolean;
-	projectDir?: string;
-}
-
-export async function launchUp(opts: LaunchUpOpts = {}): Promise<void> {
-	const projectDir = opts.projectDir ?? process.cwd();
-
-	// 1. Check prerequisites
-	console.log("Checking prerequisites...");
-	const prereqs = await checkPrereqs();
-	if (!prereqs.ok) {
-		console.error("Missing prerequisites:");
-		for (const m of prereqs.missing) console.error(`  - ${m}`);
-		process.exit(1);
-	}
-
-	// 2. Read and parse Launchfile
-	console.log("Reading Launchfile...");
-	const launchfilePath = join(projectDir, "Launchfile");
-	let launchfileContent: string;
-	try {
-		launchfileContent = await readFile(launchfilePath, "utf8");
-	} catch {
-		console.error(`No Launchfile found at ${launchfilePath}`);
-		process.exit(1);
-	}
-
-	const launch = readLaunch(launchfileContent);
-	console.log(`  App: ${launch.name}`);
-	const componentNames = Object.keys(launch.components);
-	console.log(`  Components: ${componentNames.join(", ")}`);
-
-	// 3. Load or init state
-	let state = await loadState(projectDir);
-	if (!state) {
-		state = initState(launch.name, launchfileContent);
-	}
-
-	// 4. Ensure directories
-	await ensureDirs(projectDir);
-
-	// 5. Generate secrets
-	console.log("Generating secrets...");
-	state.secrets = await generateSecrets(launch.secrets, state.secrets);
-
-	// 6. Provision required resources
-	console.log("Provisioning resources...");
-	const resourceMap: Record<string, ResourceProperties> = {};
-
-	for (const [_compName, component] of Object.entries(launch.components)) {
-		for (const req of component.requires ?? []) {
-			const resourceName = req.name ?? req.type;
-			if (resourceMap[resourceName]) continue; // Already provisioned
-
-			const provisioner = getProvisioner(req.type);
-			if (!provisioner) {
-				console.warn(`  No provisioner for resource type: ${req.type} (skipping)`);
-				continue;
-			}
-
-			if (opts.dryRun) {
-				console.log(`  [dry-run] Would provision ${req.type} as "${resourceName}"`);
-				resourceMap[resourceName] = { url: "", host: "localhost", port: 0 }; // placeholder for dedup
-				continue;
-			}
-
-			console.log(`  Provisioning ${req.type} (${resourceName})...`);
-			const existing = state.resources[resourceName];
-			const result = await provisioner.provision(req, { appName: launch.name, projectDir }, existing);
-			resourceMap[resourceName] = result.properties;
-			state.resources[resourceName] = result.state;
-		}
-
-		// Optional supports resources
-		if (opts.withOptional) {
-			for (const sup of component.supports ?? []) {
-				const resourceName = sup.name ?? sup.type;
-				if (resourceMap[resourceName]) continue;
-
-				const provisioner = getProvisioner(sup.type);
-				if (!provisioner) {
-					console.log(`  Optional resource ${sup.type} not supported (skipping)`);
-					continue;
-				}
-
-				if (opts.dryRun) {
-					console.log(`  [dry-run] Would provision optional ${sup.type} as "${resourceName}"`);
-					resourceMap[resourceName] = { url: "", host: "localhost", port: 0 };
-					continue;
-				}
-
-				try {
-					console.log(`  Provisioning optional ${sup.type} (${resourceName})...`);
-					const existing = state.resources[resourceName];
-					const result = await provisioner.provision(sup, { appName: launch.name, projectDir }, existing);
-					resourceMap[resourceName] = result.properties;
-					state.resources[resourceName] = result.state;
-				} catch (err) {
-					console.log(`  Optional resource ${sup.type} failed to provision (skipping): ${err}`);
-				}
-			}
-		}
-	}
-
-	// 7. Allocate ports
-	console.log("Allocating ports...");
-	const componentPorts = await allocatePorts(launch.components, launch.name, state.ports);
-	state.ports = componentPorts;
-
-	// 8. Build resolver context
-	const context = buildResolverContext(resourceMap, componentPorts, state.secrets);
-
-	// 9. Install runtimes
-	for (const [name, component] of Object.entries(launch.components)) {
-		if (!component.runtime) {
-			if (!component.image) {
-				console.warn(`  [${name}] No runtime declared — cannot run natively`);
-			}
-			continue;
-		}
-
-		const installer = getRuntimeInstaller(component.runtime);
-		if (!installer) {
-			console.warn(`  [${name}] No installer for runtime: ${component.runtime}`);
-			continue;
-		}
-
-		if (opts.dryRun) {
-			console.log(`  [dry-run] Would install runtime: ${component.runtime}`);
-			continue;
-		}
-
-		const version = await installer.detectVersion(projectDir);
-		if (version) {
-			console.log(`  [${name}] Runtime ${component.runtime} ${version}`);
-			await installer.install(version);
-		} else {
-			console.log(`  [${name}] Runtime ${component.runtime} (using system default)`);
-		}
-	}
-
-	// 10. Detect package manager
-	const pm = await detectPackageManager(projectDir);
-	if (pm) {
-		console.log(`  Package manager: ${pm.name} (${pm.lockfile})`);
-	}
-
-	// 11. Create storage directories
-	for (const [name, component] of Object.entries(launch.components)) {
-		await provisionStorage(component.storage, name, projectDir);
-	}
-
-	// 12. Resolve env vars and write .env files
-	console.log("Resolving environment variables...");
-	const allEnvs: Record<string, Record<string, string>> = {};
-	const isSingleComponent = componentNames.length === 1 && componentNames[0] === "default";
-
-	for (const [name, component] of Object.entries(launch.components)) {
-		const env = resolveComponentEnv(component, context, resourceMap);
-		await resolveGenerators(component, env);
-
-		const port = componentPorts[name];
-		if (port && !env.PORT) {
-			env.PORT = String(port);
-		}
-
-		allEnvs[name] = env;
-
-		if (opts.dryRun) {
-			console.log(`  [dry-run] Env for ${name}: ${Object.keys(env).join(", ")}`);
-			continue;
-		}
-
-		if (isSingleComponent) {
-			await writeEnvFile(join(projectDir, ".env.local"), env);
-			console.log(`  Wrote .env.local (${Object.keys(env).length} vars)`);
-		} else {
-			const { mkdir } = await import("node:fs/promises");
-			await mkdir(join(projectDir, ".launchfile", "env"), { recursive: true });
-			await writeEnvFile(join(projectDir, ".launchfile", "env", `${name}.env`), env);
-			console.log(`  Wrote .launchfile/env/${name}.env (${Object.keys(env).length} vars)`);
-		}
-	}
-
-	// 13. Save state before build (in case build fails, we still have resource state)
-	await saveState(projectDir, state);
-
-	if (opts.dryRun) {
-		console.log("\n[dry-run] Would now run build, release, and start commands.");
-		printSummary(launch, componentPorts, resourceMap);
-		return;
-	}
-
-	// 14. Run build commands
-	if (!opts.noBuild) {
-		for (const [name, component] of Object.entries(launch.components)) {
-			const buildCmd = component.commands?.build?.command;
-			const cmd = buildCmd ?? pm?.installCommand;
-			if (cmd) {
-				console.log(`\n  [${name}] Building: ${cmd}`);
-				await shell(cmd, {
-					cwd: projectDir,
-					env: allEnvs[name],
-				});
-			}
-		}
-	}
-
-	// 15. Run release commands (migrations)
-	for (const [name, component] of Object.entries(launch.components)) {
-		const releaseCmd = component.commands?.release?.command;
-		if (releaseCmd) {
-			console.log(`\n  [${name}] Release: ${releaseCmd}`);
-			await shell(releaseCmd, {
-				cwd: projectDir,
-				env: allEnvs[name],
-			});
-		}
-	}
-
-	// 16. Start all components
-	console.log("\nStarting components...");
-	const pm2 = new ProcessManager(projectDir);
-
-	for (const [name, component] of Object.entries(launch.components)) {
-		const startCmd = component.commands?.start?.command;
-		if (!startCmd) {
-			console.warn(`  [${name}] No start command — skipping`);
-			continue;
-		}
-
-		pm2.register(name, {
-			command: startCmd,
-			env: { ...process.env as Record<string, string>, ...allEnvs[name] },
-			cwd: projectDir,
-			dependsOn: component.depends_on,
-			health: component.health,
-			port: componentPorts[name],
-		});
-	}
-
-	// Handle Ctrl+C gracefully
-	process.on("SIGINT", async () => {
-		console.log("\n\nShutting down...");
-		await pm2.stopAll();
-		await saveState(projectDir, state!);
-		process.exit(0);
-	});
-
-	await pm2.startAll();
-
-	// 17. Print summary
-	printSummary(launch, componentPorts, resourceMap);
-
-	// Save final state
-	await saveState(projectDir, state);
-}
-
-function printSummary(
-	launch: NormalizedLaunch,
-	ports: Record<string, number>,
-	resources: Record<string, ResourceProperties>,
-): void {
-	console.log("\n" + "=".repeat(60));
-	console.log(`  ${launch.name} is running`);
-	console.log("=".repeat(60));
-
-	for (const [name, port] of Object.entries(ports)) {
-		const component = launch.components[name];
-		const exposed = component?.provides?.some((p) => p.exposed);
-		const label = exposed ? "(public)" : "(internal)";
-		console.log(`  ${name}: http://localhost:${port} ${label}`);
-	}
-
-	if (Object.keys(resources).length > 0) {
-		console.log("\n  Resources:");
-		for (const [name, props] of Object.entries(resources)) {
-			console.log(`    ${name}: ${props.url}`);
-		}
-	}
-
-	console.log("\n  Press Ctrl+C to stop all processes.");
-	console.log("=".repeat(60));
-}
-
-export async function launchDown(opts: { destroy?: boolean; projectDir?: string } = {}): Promise<void> {
-	const projectDir = opts.projectDir ?? process.cwd();
-	const state = await loadState(projectDir);
-	if (!state) {
-		console.log("No active launch state found.");
-		return;
-	}
-
-	if (opts.destroy) {
-		console.log("Destroying resources...");
-		for (const [name, resourceState] of Object.entries(state.resources)) {
-			const provisioner = getProvisioner(resourceState.type);
-			if (provisioner) {
-				console.log(`  Destroying ${resourceState.type} (${name})...`);
-				await provisioner.destroy(resourceState);
-			}
-		}
-
-		// Clean up state
-		const { rm } = await import("node:fs/promises");
-		await rm(join(projectDir, ".launchfile"), { recursive: true, force: true });
-		console.log("  Cleaned up .launchfile/");
-	} else {
-		console.log("Stopped. Resources are still running (use --destroy to remove them).");
-	}
-}
-
-export async function launchStatus(opts: { projectDir?: string } = {}): Promise<void> {
-	const projectDir = opts.projectDir ?? process.cwd();
-	const state = await loadState(projectDir);
-	if (!state) {
-		console.log("No active launch state found.");
-		return;
-	}
-
-	console.log(`App: ${state.appName}`);
-	console.log(`Created: ${state.createdAt}`);
-	console.log(`Updated: ${state.updatedAt}`);
-
-	if (Object.keys(state.ports).length > 0) {
-		console.log("\nComponents:");
-		for (const [name, port] of Object.entries(state.ports)) {
-			console.log(`  ${name}: http://localhost:${port}`);
-		}
-	}
-
-	if (Object.keys(state.resources).length > 0) {
-		console.log("\nResources:");
-		for (const [name, res] of Object.entries(state.resources)) {
-			const provisioner = getProvisioner(res.type);
-			const running = provisioner ? await provisioner.isRunning() : false;
-			console.log(`  ${name} (${res.type}): ${running ? "running" : "stopped"} on port ${res.port}`);
-		}
-	}
-}
-
-export async function launchEnv(opts: { component?: string; projectDir?: string } = {}): Promise<void> {
-	const projectDir = opts.projectDir ?? process.cwd();
-
-	const launchfileContent = await readFile(join(projectDir, "Launchfile"), "utf8");
-	const launch = readLaunch(launchfileContent);
-	const state = await loadState(projectDir);
-
-	if (!state) {
-		console.log("No active launch state. Run `launch up` first.");
-		return;
-	}
-
-	// Rebuild resource map from state
-	const resourceMap: Record<string, ResourceProperties> = {};
-	for (const [name, res] of Object.entries(state.resources)) {
-		const provisioner = getProvisioner(res.type);
-		if (provisioner) {
-			const result = await provisioner.provision(
-				{ type: res.type, name: res.name },
-				{ appName: state.appName, projectDir },
-				res,
-			);
-			resourceMap[name] = result.properties;
-		}
-	}
-
-	const context = buildResolverContext(resourceMap, state.ports, state.secrets);
-
-	for (const [name, component] of Object.entries(launch.components)) {
-		if (opts.component && name !== opts.component) continue;
-
-		const env = resolveComponentEnv(component, context, resourceMap);
-		await resolveGenerators(component, env);
-
-		const port = state.ports[name];
-		if (port && !env.PORT) env.PORT = String(port);
-
-		console.log(`\n# ${name}`);
-		for (const [key, value] of Object.entries(env).sort(([a], [b]) => a.localeCompare(b))) {
-			console.log(`${key}=${value}`);
-		}
-	}
-}

package/src/resources/index.ts

@@ -1,29 +0,0 @@
-/**
- * Resource provisioner registry.
- *
- * Maps resource type names to their provisioner implementations.
- */
-
-import type { ResourceProvisioner } from "./types.js";
-import { PostgresProvisioner } from "./postgres.js";
-import { RedisProvisioner } from "./redis.js";
-import { SqliteProvisioner } from "./sqlite.js";
-import { MysqlProvisioner } from "./mysql.js";
-
-const provisioners: Record<string, ResourceProvisioner> = {
-	postgres: new PostgresProvisioner(),
-	redis: new RedisProvisioner(),
-	sqlite: new SqliteProvisioner(),
-	mysql: new MysqlProvisioner(),
-	mariadb: new MysqlProvisioner(), // MariaDB is MySQL-compatible
-};
-
-export function getProvisioner(type: string): ResourceProvisioner | undefined {
-	return provisioners[type];
-}
-
-export function supportedResourceTypes(): string[] {
-	return Object.keys(provisioners);
-}
-
-export type { ResourceProvisioner, ResourceProperties, ProvisionOpts } from "./types.js";