@launchfile/macos-dev 0.1.4 → 0.2.0

package/src/__tests__/state.test.ts

@@ -1,33 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { initState, hashLaunchfile } from "../state.js";
-
-describe("initState", () => {
-	it("creates a state with correct app name", () => {
-		const state = initState("my-app", "name: my-app");
-		expect(state.appName).toBe("my-app");
-		expect(state.version).toBe(1);
-		expect(state.resources).toEqual({});
-		expect(state.secrets).toEqual({});
-		expect(state.ports).toEqual({});
-	});
-
-	it("hashes launchfile content", () => {
-		const state = initState("app", "some yaml content");
-		expect(state.launchfileHash).toBeTruthy();
-		expect(state.launchfileHash.length).toBe(16);
-	});
-});
-
-describe("hashLaunchfile", () => {
-	it("is deterministic", () => {
-		const a = hashLaunchfile("hello");
-		const b = hashLaunchfile("hello");
-		expect(a).toBe(b);
-	});
-
-	it("differs for different content", () => {
-		const a = hashLaunchfile("hello");
-		const b = hashLaunchfile("world");
-		expect(a).not.toBe(b);
-	});
-});

package/src/cli.ts

@@ -1,78 +0,0 @@
-#!/usr/bin/env bun
-/**
- * CLI entry point for the macOS dev provider.
- *
- * Usage:
- *   launch up [--with-optional] [--no-build] [--dry-run]
- *   launch down [--destroy]
- *   launch status
- *   launch env [component]
- */
-
-import { launchUp, launchDown, launchStatus, launchEnv } from "./provider.js";
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-function hasFlag(flag: string): boolean {
-	return args.includes(`--${flag}`);
-}
-
-function getArg(index: number): string | undefined {
-	return args[index];
-}
-
-async function main(): Promise<void> {
-	switch (command) {
-		case "up":
-			await launchUp({
-				withOptional: hasFlag("with-optional"),
-				noBuild: hasFlag("no-build"),
-				dryRun: hasFlag("dry-run"),
-				detach: hasFlag("detach"),
-			});
-			break;
-
-		case "down":
-			await launchDown({
-				destroy: hasFlag("destroy"),
-			});
-			break;
-
-		case "status":
-			await launchStatus();
-			break;
-
-		case "env":
-			await launchEnv({
-				component: getArg(1),
-			});
-			break;
-
-		default:
-			console.log(`launch — macOS dev provider for Launchfile
-
-Usage:
-  launch up [--with-optional] [--no-build] [--dry-run]
-    Provision resources, install deps, and start the app.
-
-  launch down [--destroy]
-    Stop processes. --destroy also drops databases and cleans up.
-
-  launch status
-    Show status of components and resources.
-
-  launch env [component]
-    Print resolved environment variables.
-`);
-			if (command && command !== "help" && command !== "--help") {
-				console.error(`Unknown command: ${command}`);
-				process.exit(1);
-			}
-	}
-}
-
-main().catch((err) => {
-	console.error(err.message ?? err);
-	process.exit(1);
-});

package/src/env-writer.ts

@@ -1,231 +0,0 @@
-/**
- * Environment variable resolver and writer.
- *
- * Connects provisioned resource properties to the SDK's expression resolver,
- * then writes the results to .env files.
- */
-
-import { writeFile, mkdir } from "node:fs/promises";
-import { join } from "node:path";
-import {
-	resolveExpression,
-	isExpression,
-	type NormalizedComponent,
-	type NormalizedLaunch,
-	type Secret,
-} from "@launchfile/sdk";
-import type { ResourceProperties } from "./resources/types.js";
-import { generateValue } from "./secret-generator.js";
-
-/**
- * Context for the SDK's resolveExpression().
- * Mirrors the interface from sdk/src/resolver.ts since it's not exported.
- */
-export interface ResolverContext {
-	resource?: Record<string, string | number>;
-	resources?: Record<string, Record<string, string | number>>;
-	components?: Record<string, Record<string, string | number>>;
-	secrets?: Record<string, string>;
-}
-
-/**
- * Build a ResolverContext from provisioned resources, component ports, and secrets.
- */
-export function buildResolverContext(
-	resourceMap: Record<string, ResourceProperties>,
-	componentPorts: Record<string, number>,
-	secrets: Record<string, string>,
-): ResolverContext {
-	// Build components map from ports
-	const components: Record<string, Record<string, string | number>> = {};
-	for (const [name, port] of Object.entries(componentPorts)) {
-		components[name] = {
-			url: `http://localhost:${port}`,
-			host: "localhost",
-			port,
-		};
-	}
-
-	// Build named resources map
-	const resources: Record<string, Record<string, string | number>> = {};
-	for (const [name, props] of Object.entries(resourceMap)) {
-		const record: Record<string, string | number> = {};
-		for (const [k, v] of Object.entries(props)) {
-			if (v !== undefined) {
-				record[k] = v;
-			}
-		}
-		resources[name] = record;
-	}
-
-	return { resources, components, secrets };
-}
-
-/**
- * Resolve all environment variables for a single component.
- */
-export function resolveComponentEnv(
-	component: NormalizedComponent,
-	context: ResolverContext,
-	resourceMap: Record<string, ResourceProperties>,
-): Record<string, string> {
-	const env: Record<string, string> = {};
-
-	// 1. Resolve set_env from requires
-	for (const req of component.requires ?? []) {
-		const resourceName = req.name ?? req.type;
-		const props = resourceMap[resourceName];
-		if (!req.set_env || !props) continue;
-
-		// Build resource-scoped context (enclosing resource)
-		const resourceRecord: Record<string, string | number> = {};
-		for (const [k, v] of Object.entries(props)) {
-			if (v !== undefined) resourceRecord[k] = v;
-		}
-		const scopedContext: ResolverContext = {
-			...context,
-			resource: resourceRecord,
-		};
-
-		for (const [envKey, expr] of Object.entries(req.set_env)) {
-			env[envKey] = resolveExpression(expr, scopedContext);
-		}
-	}
-
-	// 2. Resolve set_env from supports (only if resource was provisioned)
-	for (const sup of component.supports ?? []) {
-		const resourceName = sup.name ?? sup.type;
-		const props = resourceMap[resourceName];
-		if (!sup.set_env || !props) continue;
-
-		const resourceRecord: Record<string, string | number> = {};
-		for (const [k, v] of Object.entries(props)) {
-			if (v !== undefined) resourceRecord[k] = v;
-		}
-		const scopedContext: ResolverContext = {
-			...context,
-			resource: resourceRecord,
-		};
-
-		for (const [envKey, expr] of Object.entries(sup.set_env)) {
-			env[envKey] = resolveExpression(expr, scopedContext);
-		}
-	}
-
-	// 3. Resolve component-level env vars
-	if (component.env) {
-		for (const [key, envVar] of Object.entries(component.env)) {
-			if (env[key] !== undefined) continue; // set_env takes precedence
-
-			if (envVar.default !== undefined) {
-				const defaultStr = String(envVar.default);
-				if (isExpression(defaultStr)) {
-					env[key] = resolveExpression(defaultStr, context);
-				} else {
-					env[key] = defaultStr;
-				}
-			}
-			// required + no default + no generator → left unset (provider should prompt)
-		}
-	}
-
-	return env;
-}
-
-/**
- * Generate all app-wide secrets, reusing values from state when available.
- */
-export async function generateSecrets(
-	secretDefs: Record<string, Secret> | undefined,
-	existingSecrets: Record<string, string>,
-): Promise<Record<string, string>> {
-	if (!secretDefs) return { ...existingSecrets };
-
-	const secrets = { ...existingSecrets };
-	for (const [name, def] of Object.entries(secretDefs)) {
-		if (!secrets[name]) {
-			secrets[name] = await generateValue(def.generator);
-		}
-	}
-	return secrets;
-}
-
-/**
- * Generate values for env vars that have generators.
- * Mutates the env record in place.
- */
-export async function resolveGenerators(
-	component: NormalizedComponent,
-	env: Record<string, string>,
-): Promise<void> {
-	if (!component.env) return;
-
-	for (const [key, envVar] of Object.entries(component.env)) {
-		if (env[key] !== undefined) continue;
-		if (envVar.generator) {
-			env[key] = await generateValue(envVar.generator);
-		}
-	}
-}
-
-/**
- * Write resolved env vars to a .env file.
- */
-export async function writeEnvFile(
-	filePath: string,
-	env: Record<string, string>,
-): Promise<void> {
-	const lines = Object.entries(env)
-		.sort(([a], [b]) => a.localeCompare(b))
-		.map(([key, value]) => {
-			// Quote values that contain spaces, #, or newlines
-			if (/[\s#\n]/.test(value)) {
-				return `${key}="${value.replace(/"/g, '\\"')}"`;
-			}
-			return `${key}=${value}`;
-		});
-
-	const content = `# Generated by launch up — do not edit manually\n${lines.join("\n")}\n`;
-	// Security: env files contain database URLs with passwords and generated secrets
-	await writeFile(filePath, content, { mode: 0o600 });
-}
-
-/**
- * Resolve and write env files for all components.
- * Single-component → .env.local at project root.
- * Multi-component → .launchfile/env/<component>.env per component.
- */
-export async function writeAllEnvFiles(
-	launch: NormalizedLaunch,
-	context: ResolverContext,
-	resourceMap: Record<string, ResourceProperties>,
-	componentPorts: Record<string, number>,
-	projectDir: string,
-): Promise<Record<string, Record<string, string>>> {
-	const allEnvs: Record<string, Record<string, string>> = {};
-	const componentNames = Object.keys(launch.components);
-	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);
-
-		// Inject PORT if not already set and component has provides
-		const port = componentPorts[name];
-		if (port && !env.PORT) {
-			env.PORT = String(port);
-		}
-
-		allEnvs[name] = env;
-
-		if (isSingleComponent) {
-			await writeEnvFile(join(projectDir, ".env.local"), env);
-		} else {
-			const envDir = join(projectDir, ".launchfile", "env");
-			await mkdir(envDir, { recursive: true });
-			await writeEnvFile(join(envDir, `${name}.env`), env);
-		}
-	}
-
-	return allEnvs;
-}

package/src/health.ts

@@ -1,80 +0,0 @@
-/**
- * Health check polling for components.
- */
-
-import type { NormalizedHealth } from "@launchfile/sdk";
-import { shell } from "./shell.js";
-
-/** Parse a duration string like "30s", "1m", "500ms" to milliseconds */
-export function parseDuration(duration: string): number {
-	const match = /^(\d+)(ms|s|m)$/.exec(duration);
-	if (!match) return 0;
-	const value = Number.parseInt(match[1]!, 10);
-	switch (match[2]) {
-		case "ms":
-			return value;
-		case "s":
-			return value * 1000;
-		case "m":
-			return value * 60_000;
-		default:
-			return 0;
-	}
-}
-
-/**
- * Wait for a component to become healthy.
- * Returns true if healthy, false if timed out.
- */
-export async function waitForHealthy(
-	name: string,
-	health: NormalizedHealth,
-	port: number,
-	overallTimeout: number = 60_000,
-): Promise<boolean> {
-	const startPeriod = parseDuration(health.start_period ?? "0s");
-	const interval = parseDuration(health.interval ?? "3s");
-	const checkTimeout = parseDuration(health.timeout ?? "5s");
-
-	// Wait for start period
-	if (startPeriod > 0) {
-		console.log(`  [${name}] Waiting ${health.start_period} start period...`);
-		await sleep(startPeriod);
-	}
-
-	const deadline = Date.now() + overallTimeout;
-
-	while (Date.now() < deadline) {
-		try {
-			if (health.path) {
-				const resp = await fetch(`http://localhost:${port}${health.path}`, {
-					signal: AbortSignal.timeout(checkTimeout),
-				});
-				if (resp.ok) {
-					console.log(`  [${name}] Healthy`);
-					return true;
-				}
-			} else if (health.command) {
-				await shell(health.command, { timeout: checkTimeout, silent: true });
-				console.log(`  [${name}] Healthy`);
-				return true;
-			} else {
-				// No specific check — try connecting to the port
-				const resp = await fetch(`http://localhost:${port}/`, {
-					signal: AbortSignal.timeout(checkTimeout),
-				}).catch(() => null);
-				if (resp) return true;
-			}
-		} catch {
-			// Expected — service not ready yet
-		}
-		await sleep(interval);
-	}
-
-	console.error(`  [${name}] Health check timed out after ${overallTimeout}ms`);
-	return false;
-}
-
-function sleep(ms: number): Promise<void> {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/src/index.ts

@@ -1,9 +0,0 @@
-/**
- * macOS Dev Provider for Launchfile.
- *
- * Run apps locally on macOS with brew services for databases
- * and native runtimes for the app itself.
- */
-
-export { launchUp, launchDown, launchStatus, launchEnv } from "./provider.js";
-export type { LaunchUpOpts } from "./provider.js";

package/src/lockfile-detect.ts

@@ -1,48 +0,0 @@
-/**
- * Detect the package manager from lockfile presence.
- */
-
-import { access } from "node:fs/promises";
-import { join } from "node:path";
-
-export interface PackageManager {
-	name: string;
-	installCommand: string;
-	lockfile: string;
-}
-
-const LOCKFILE_ORDER: PackageManager[] = [
-	{ name: "bun", installCommand: "bun install", lockfile: "bun.lockb" },
-	{ name: "bun", installCommand: "bun install", lockfile: "bun.lock" },
-	{ name: "pnpm", installCommand: "pnpm install", lockfile: "pnpm-lock.yaml" },
-	{ name: "yarn", installCommand: "yarn install", lockfile: "yarn.lock" },
-	{ name: "npm", installCommand: "npm install", lockfile: "package-lock.json" },
-	{ name: "bundler", installCommand: "bundle install", lockfile: "Gemfile.lock" },
-	{ name: "go", installCommand: "go mod download", lockfile: "go.sum" },
-	{ name: "cargo", installCommand: "cargo build", lockfile: "Cargo.lock" },
-	{ name: "pip", installCommand: "pip install -r requirements.txt", lockfile: "requirements.txt" },
-	{ name: "poetry", installCommand: "poetry install", lockfile: "poetry.lock" },
-	{ name: "uv", installCommand: "uv sync", lockfile: "uv.lock" },
-];
-
-async function fileExists(path: string): Promise<boolean> {
-	try {
-		await access(path);
-		return true;
-	} catch {
-		return false;
-	}
-}
-
-/**
- * Detect the package manager from lockfile presence in a directory.
- * Returns the first match in priority order, or null.
- */
-export async function detectPackageManager(projectDir: string): Promise<PackageManager | null> {
-	for (const pm of LOCKFILE_ORDER) {
-		if (await fileExists(join(projectDir, pm.lockfile))) {
-			return pm;
-		}
-	}
-	return null;
-}

package/src/port-allocator.ts

@@ -1,97 +0,0 @@
-/**
- * Deterministic port allocation for Launchfile apps.
- *
- * Ports are derived from a hash of the app name so they're stable across runs
- * and machines. If a port is in use, we scan upward for the next free one.
- */
-
-import { createServer } from "node:net";
-
-/** Base range for allocated ports */
-const PORT_RANGE_START = 10_000;
-const PORT_RANGE_SIZE = 10_000;
-
-/** Simple string hash → number in a range */
-function hashToRange(input: string, rangeSize: number): number {
-	let hash = 0;
-	for (let i = 0; i < input.length; i++) {
-		hash = (hash * 31 + input.charCodeAt(i)) | 0;
-	}
-	return Math.abs(hash) % rangeSize;
-}
-
-/** Check if a port is available by attempting to listen on it */
-async function isPortFree(port: number): Promise<boolean> {
-	return new Promise((resolve) => {
-		const server = createServer();
-		server.once("error", () => resolve(false));
-		server.once("listening", () => {
-			server.close(() => resolve(true));
-		});
-		server.listen(port, "127.0.0.1");
-	});
-}
-
-/**
- * Allocate a port for a given key (e.g., "myapp" or "myapp:backend").
- * Uses deterministic hashing for stability, with fallback scan.
- */
-export async function allocatePort(
-	key: string,
-	existingPorts: Set<number>,
-): Promise<number> {
-	const preferred = PORT_RANGE_START + hashToRange(key, PORT_RANGE_SIZE);
-
-	// Try the preferred port first
-	if (!existingPorts.has(preferred) && (await isPortFree(preferred))) {
-		return preferred;
-	}
-
-	// Scan upward for the next free port
-	for (let offset = 1; offset < PORT_RANGE_SIZE; offset++) {
-		const candidate = PORT_RANGE_START + ((preferred - PORT_RANGE_START + offset) % PORT_RANGE_SIZE);
-		if (!existingPorts.has(candidate) && (await isPortFree(candidate))) {
-			return candidate;
-		}
-	}
-
-	throw new Error(`No free port found in range ${PORT_RANGE_START}–${PORT_RANGE_START + PORT_RANGE_SIZE}`);
-}
-
-/**
- * Allocate ports for all components in a launch config.
- * Returns a map of component name → port.
- */
-export async function allocatePorts(
-	components: Record<string, { provides?: Array<{ port: number }> }>,
-	appName: string,
-	savedPorts?: Record<string, number>,
-): Promise<Record<string, number>> {
-	const allocated = new Set<number>();
-	const result: Record<string, number> = {};
-
-	for (const [name, component] of Object.entries(components)) {
-		// Reuse saved port if still free
-		const saved = savedPorts?.[name];
-		if (saved && (await isPortFree(saved))) {
-			result[name] = saved;
-			allocated.add(saved);
-			continue;
-		}
-
-		// Use the component's declared port if free
-		const declaredPort = component.provides?.[0]?.port;
-		if (declaredPort && !allocated.has(declaredPort) && (await isPortFree(declaredPort))) {
-			result[name] = declaredPort;
-			allocated.add(declaredPort);
-			continue;
-		}
-
-		// Fall back to deterministic allocation
-		const port = await allocatePort(`${appName}:${name}`, allocated);
-		result[name] = port;
-		allocated.add(port);
-	}
-
-	return result;
-}

package/src/prereqs.ts

@@ -1,32 +0,0 @@
-/**
- * Prerequisite checks for the macOS dev provider.
- */
-
-import { shellOk } from "./shell.js";
-
-export interface PrereqResult {
-	ok: boolean;
-	missing: string[];
-	warnings: string[];
-}
-
-export async function checkPrereqs(): Promise<PrereqResult> {
-	const missing: string[] = [];
-	const warnings: string[] = [];
-
-	// Homebrew is required
-	if (!(await shellOk("which brew"))) {
-		missing.push("Homebrew — install from https://brew.sh");
-	}
-
-	// Git is required (for cloning)
-	if (!(await shellOk("which git"))) {
-		missing.push("git — install via: brew install git");
-	}
-
-	return {
-		ok: missing.length === 0,
-		missing,
-		warnings,
-	};
-}