@launchfile/macos-dev 0.1.4 → 0.3.0

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";

package/src/resources/mysql.ts

@@ -1,98 +0,0 @@
-/**
- * MySQL resource provisioner via Homebrew.
- */
-
-import type { NormalizedRequirement } from "@launchfile/sdk";
-import { shell, shellOk } from "../shell.js";
-import { generatePassword } from "../secret-generator.js";
-import type { ResourceState } from "../state.js";
-import type { ProvisionOpts, ResourceProperties, ResourceProvisioner } from "./types.js";
-
-const DEFAULT_PORT = 3306;
-const DEFAULT_HOST = "localhost";
-
-// Security: validate identifiers before interpolating into shell/SQL commands
-const SAFE_IDENTIFIER = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-
-export class MysqlProvisioner implements ResourceProvisioner {
-	readonly type = "mysql";
-
-	async isRunning(): Promise<boolean> {
-		return shellOk("mysqladmin ping -h localhost --silent");
-	}
-
-	async provision(
-		req: NormalizedRequirement,
-		opts: ProvisionOpts,
-		existingState?: ResourceState,
-	): Promise<{ properties: ResourceProperties; state: ResourceState }> {
-		if (!(await this.isRunning())) {
-			console.log("  Starting MySQL via brew...");
-			const started = await shellOk("brew services start mysql");
-			if (!started) {
-				await shell("brew install mysql");
-				await shell("brew services start mysql");
-			}
-		}
-
-		const resourceName = req.name ?? req.type;
-		const safeName = opts.appName.replace(/-/g, "_");
-		const dbName = existingState?.dbName ?? `launchfile_${safeName}`;
-		const user = existingState?.user ?? `launchfile_${safeName}`;
-		const password = existingState?.password ?? generatePassword();
-		const port = DEFAULT_PORT;
-
-		// Create database and user (idempotent)
-		await shell(
-			`mysql -h ${DEFAULT_HOST} -u root -e "CREATE DATABASE IF NOT EXISTS \\\`${dbName}\\\`;"`,
-			{ allowFailure: true },
-		);
-		await shell(
-			`mysql -h ${DEFAULT_HOST} -u root -e "CREATE USER IF NOT EXISTS '${user}'@'${DEFAULT_HOST}' IDENTIFIED BY '${password}';"`,
-			{ allowFailure: true },
-		);
-		await shell(
-			`mysql -h ${DEFAULT_HOST} -u root -e "GRANT ALL PRIVILEGES ON \\\`${dbName}\\\`.* TO '${user}'@'${DEFAULT_HOST}';"`,
-			{ allowFailure: true },
-		);
-
-		const url = `mysql://${user}:${password}@${DEFAULT_HOST}:${port}/${dbName}`;
-
-		const properties: ResourceProperties = {
-			url,
-			host: DEFAULT_HOST,
-			port,
-			user,
-			password,
-			name: dbName,
-		};
-
-		const state: ResourceState = {
-			type: "mysql",
-			name: resourceName,
-			brewService: "mysql",
-			port,
-			dbName,
-			user,
-			password,
-		};
-
-		return { properties, state };
-	}
-
-	async destroy(state: ResourceState): Promise<void> {
-		// Security: state values come from disk (state.json) — validate before SQL interpolation
-		if (state.dbName && SAFE_IDENTIFIER.test(state.dbName)) {
-			await shell(
-				`mysql -h ${DEFAULT_HOST} -u root -e "DROP DATABASE IF EXISTS \\\`${state.dbName}\\\`;"`,
-				{ allowFailure: true },
-			);
-		}
-		if (state.user && SAFE_IDENTIFIER.test(state.user)) {
-			await shell(
-				`mysql -h ${DEFAULT_HOST} -u root -e "DROP USER IF EXISTS '${state.user}'@'${DEFAULT_HOST}';"`,
-				{ allowFailure: true },
-			);
-		}
-	}
-}

package/src/resources/postgres.ts

@@ -1,133 +0,0 @@
-/**
- * Postgres resource provisioner via Homebrew.
- *
- * Strategy:
- * - Check if postgres is already running via `brew services list`
- * - If not, install and start via brew
- * - Create an app-specific database and user
- * - Return connection properties
- */
-
-import type { NormalizedRequirement } from "@launchfile/sdk";
-import { shell, shellOk } from "../shell.js";
-import { generatePassword } from "../secret-generator.js";
-import type { ResourceState } from "../state.js";
-import type { ProvisionOpts, ResourceProperties, ResourceProvisioner } from "./types.js";
-
-const DEFAULT_PORT = 5432;
-const DEFAULT_HOST = "localhost";
-
-// Security: validate identifiers before interpolating into shell/SQL commands.
-// Only alphanumeric + underscore — safe for SQL identifiers and shell args.
-const SAFE_IDENTIFIER = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-
-export class PostgresProvisioner implements ResourceProvisioner {
-	readonly type = "postgres";
-
-	async isRunning(): Promise<boolean> {
-		return shellOk("pg_isready -q");
-	}
-
-	async provision(
-		req: NormalizedRequirement,
-		opts: ProvisionOpts,
-		existingState?: ResourceState,
-	): Promise<{ properties: ResourceProperties; state: ResourceState }> {
-		// Ensure postgres is running
-		if (!(await this.isRunning())) {
-			console.log("  Starting PostgreSQL via brew...");
-			// Try to start; if not installed, install first
-			const started = await shellOk("brew services start postgresql");
-			if (!started) {
-				// Try versioned formula
-				await shell("brew install postgresql@16");
-				await shell("brew services start postgresql@16");
-			}
-		}
-
-		// Wait for ready
-		await shell("pg_isready --timeout=10", { allowFailure: true });
-
-		// Determine database and user names
-		const resourceName = req.name ?? req.type;
-		const safeName = opts.appName.replace(/-/g, "_");
-		const dbName = existingState?.dbName ?? `launchfile_${safeName}`;
-		const user = existingState?.user ?? `launchfile_${safeName}`;
-		const password = existingState?.password ?? generatePassword();
-		const port = DEFAULT_PORT;
-
-		// Create user (idempotent)
-		await shell(
-			`psql -h ${DEFAULT_HOST} -p ${port} postgres -c "DO \\$\\$ BEGIN IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = '${user}') THEN CREATE ROLE ${user} WITH LOGIN PASSWORD '${password}' CREATEDB; END IF; END \\$\\$;"`,
-			{ allowFailure: true },
-		);
-
-		// Create database (idempotent)
-		const dbExists = await shellOk(
-			`psql -h ${DEFAULT_HOST} -p ${port} postgres -tAc "SELECT 1 FROM pg_database WHERE datname='${dbName}'"`,
-		);
-		if (!dbExists) {
-			await shell(
-				`createdb -h ${DEFAULT_HOST} -p ${port} -O ${user} ${dbName}`,
-				{ allowFailure: true },
-			);
-		}
-
-		// Handle extensions from config
-		// Security: extension names come from Launchfile config (untrusted input).
-		// Validate each against SAFE_IDENTIFIER before interpolating into SQL.
-		const extensions = req.config?.extensions;
-		if (Array.isArray(extensions)) {
-			for (const ext of extensions) {
-				if (typeof ext !== "string") continue;
-				if (!SAFE_IDENTIFIER.test(ext)) {
-					console.warn(`  Skipping invalid extension name: ${ext}`);
-					continue;
-				}
-				await shell(
-					`psql -h ${DEFAULT_HOST} -p ${port} ${dbName} -c "CREATE EXTENSION IF NOT EXISTS \\"${ext}\\";"`,
-					{ allowFailure: true },
-				);
-			}
-		}
-
-		const url = `postgresql://${user}:${password}@${DEFAULT_HOST}:${port}/${dbName}`;
-
-		const properties: ResourceProperties = {
-			url,
-			host: DEFAULT_HOST,
-			port,
-			user,
-			password,
-			name: dbName,
-		};
-
-		const state: ResourceState = {
-			type: "postgres",
-			name: resourceName,
-			brewService: "postgresql",
-			port,
-			dbName,
-			user,
-			password,
-		};
-
-		return { properties, state };
-	}
-
-	async destroy(state: ResourceState): Promise<void> {
-		// Security: state values come from disk (state.json) — validate before SQL interpolation
-		if (state.dbName && SAFE_IDENTIFIER.test(state.dbName)) {
-			await shell(`dropdb -h ${DEFAULT_HOST} --if-exists ${state.dbName}`, {
-				allowFailure: true,
-			});
-		}
-		if (state.user && SAFE_IDENTIFIER.test(state.user)) {
-			await shell(
-				`psql -h ${DEFAULT_HOST} postgres -c "DROP ROLE IF EXISTS ${state.user};"`,
-				{ allowFailure: true },
-			);
-		}
-		// Don't stop the brew service — it's shared
-	}
-}