@vibesdotdev/infra-deploy 0.0.1

package/src/infra-deploy.plugin.ts

@@ -0,0 +1,83 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/runtime';
+
+import infraGroup from './cli/infra.cli-group.descriptor.ts';
+import infraDeployGroup from './cli/infra-deploy.cli-group.descriptor.ts';
+import infraDeployRun from './cli/run/infra-deploy.run.cli-command.descriptor.ts';
+import infraDeployList from './cli/list/infra-deploy.list.cli-command.descriptor.ts';
+import infraDeployRegenerate from './cli/regenerate/infra-deploy.regenerate.cli-command.descriptor.ts';
+import infraLogs from './cli/logs/infra-logs.cli-command.descriptor.ts';
+import infraNpmGroup from './cli/npm/infra-npm.cli-group.descriptor.ts';
+import infraNpmPublish from './cli/npm/infra-npm-publish.cli-command.descriptor.ts';
+import infraAlertsGroup from './cli/alerts/infra-alerts.cli-group.descriptor.ts';
+import infraAlertsList from './cli/alerts/infra-alerts-list.cli-command.descriptor.ts';
+import infraAlertsCreate from './cli/alerts/infra-alerts-create.cli-command.descriptor.ts';
+import infraAlertsDelete from './cli/alerts/infra-alerts-delete.cli-command.descriptor.ts';
+import infraAudit from './cli/audit/infra-audit.cli-command.descriptor.ts';
+import infraObservabilityGroup from './cli/observability/infra-observability.cli-group.descriptor.ts';
+import infraObservabilityStatus from './cli/observability/infra-observability-status.cli-command.descriptor.ts';
+import infraObservabilitySet from './cli/observability/infra-observability-set.cli-command.descriptor.ts';
+import infraRumGroup from './cli/rum/infra-rum.cli-group.descriptor.ts';
+import infraRumStatus from './cli/rum/infra-rum-status.cli-command.descriptor.ts';
+
+export default createRuntimePlugin({
+	id: 'infra-deploy',
+	name: 'Infra Deploy',
+	description: 'Build and deploy apps declared in deployment.config.ts',
+
+	descriptors: [
+		infraGroup,
+		infraDeployGroup,
+		infraDeployRun,
+		infraDeployList,
+		infraDeployRegenerate,
+		infraLogs,
+		infraNpmGroup,
+		infraNpmPublish,
+		infraAlertsGroup,
+		infraAlertsList,
+		infraAlertsCreate,
+		infraAlertsDelete,
+		infraAudit,
+		infraObservabilityGroup,
+		infraObservabilityStatus,
+		infraObservabilitySet,
+		infraRumGroup,
+		infraRumStatus
+	],
+
+	loaders: [
+		loader('infra-deploy.run', () => import('./cli/run/infra-deploy.run.cli-command.impl.ts')),
+		loader('infra-deploy.list', () => import('./cli/list/infra-deploy.list.cli-command.impl.ts')),
+		loader(
+			'infra-deploy.regenerate',
+			() => import('./cli/regenerate/infra-deploy.regenerate.cli-command.impl.ts')
+		),
+		loader('infra-logs', () => import('./cli/logs/infra-logs.cli-command.impl.ts')),
+		loader(
+			'infra-npm.publish',
+			() => import('./cli/npm/infra-npm-publish.cli-command.impl.ts')
+		),
+		loader(
+			'infra-alerts.list',
+			() => import('./cli/alerts/infra-alerts-list.cli-command.impl.ts')
+		),
+		loader(
+			'infra-alerts.create',
+			() => import('./cli/alerts/infra-alerts-create.cli-command.impl.ts')
+		),
+		loader(
+			'infra-alerts.delete',
+			() => import('./cli/alerts/infra-alerts-delete.cli-command.impl.ts')
+		),
+		loader('infra-audit', () => import('./cli/audit/infra-audit.cli-command.impl.ts')),
+		loader(
+			'infra-observability.status',
+			() => import('./cli/observability/infra-observability-status.cli-command.impl.ts')
+		),
+		loader(
+			'infra-observability.set',
+			() => import('./cli/observability/infra-observability-set.cli-command.impl.ts')
+		),
+		loader('infra-rum.status', () => import('./cli/rum/infra-rum-status.cli-command.impl.ts'))
+	]
+});

package/src/regenerate.ts

@@ -0,0 +1,230 @@
+/**
+ * wrangler.jsonc regeneration orchestrator.
+ *
+ * Reads an app's `deployment.config.ts` (via the config-loader subprocess,
+ * which surfaces the canonical wrangler.jsonc string from
+ * `@vibesdotdev/infra-cloudflare/regen` when the export is a managed
+ * web-app deployment), compares it against the on-disk `wrangler.jsonc`,
+ * and either reports drift or rewrites the file.
+ *
+ * Two modes:
+ *   - `check` — read-only; returns `'drift'` when the on-disk file
+ *     doesn't match the rendered string. Used by CI and pre-deploy gates.
+ *   - `write` — overwrites the on-disk file with the rendered string.
+ *     Used during local development after editing `deployment.config.ts`.
+ *
+ * Apps that haven't opted in via `managed: true` are reported as
+ * `'skipped'` — neither check nor write happens. Once every app is on
+ * the regen pipeline, the `managed` flag can be defaulted true and the
+ * skipped path removed.
+ *
+ * Provider dispatch is implicit: only Cloudflare web-app deployments
+ * currently surface a `wranglerJsoncString`. Other providers (DO App
+ * Spec) skip regen by construction.
+ */
+
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import { loadDeploymentConfig } from './config-loader.ts';
+
+export type RegenStatus = 'unchanged' | 'updated' | 'drift' | 'skipped' | 'error';
+
+export interface RegenResult {
+	appId: string;
+	appDir: string;
+	wranglerJsoncPath: string;
+	status: RegenStatus;
+	/** Workers script name, when known. */
+	workerName?: string;
+	/** Reason text for 'skipped' (e.g., "not managed") or 'error'. */
+	reason?: string;
+	/** Unified diff snippet on `drift`. Truncated to ~120 lines. */
+	diff?: string;
+}
+
+export interface RegenerateOptions {
+	/** `check`: read-only drift detection. `write`: rewrite on drift. */
+	mode: 'check' | 'write';
+}
+
+const CONFIG_FILENAMES = new Set([
+	'deployment.config.ts',
+	'deployment.config.js',
+	'deployment.config.mjs'
+]);
+const IGNORED_DIRS = new Set([
+	'node_modules',
+	'.git',
+	'.svelte-kit',
+	'dist',
+	'.next',
+	'.turbo',
+	'.vite',
+	'.wrangler'
+]);
+
+/**
+ * Recursive discovery for `deployment.config.ts` under `root`. Mirrors
+ * the `infra deploy list` walker (kept private here to avoid a circular
+ * dep through the CLI command). Synchronous because the orchestrator
+ * is called from short-lived processes (deploy hooks + CLI).
+ */
+function findDeploymentConfigs(root: string, maxDepth = 4): string[] {
+	const found: string[] = [];
+	function walk(dir: string, depth: number): void {
+		if (depth > maxDepth) return;
+		let entries: string[];
+		try {
+			entries = readdirSync(dir);
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (CONFIG_FILENAMES.has(entry)) {
+				found.push(join(dir, entry));
+			}
+		}
+		for (const entry of entries) {
+			if (IGNORED_DIRS.has(entry) || entry.startsWith('.')) continue;
+			const full = join(dir, entry);
+			let info;
+			try {
+				info = statSync(full);
+			} catch {
+				continue;
+			}
+			if (info.isDirectory()) walk(full, depth + 1);
+		}
+	}
+	walk(root, 0);
+	return found;
+}
+
+function unifiedDiffSnippet(existing: string, rendered: string, contextLines = 3): string {
+	// Compact line-by-line diff. Not a full unified-diff (no @@ hunks),
+	// just enough for a human to spot the drift in a CI log without
+	// pulling in a diff library. Caps total output at ~120 lines.
+	const a = existing.split('\n');
+	const b = rendered.split('\n');
+	const max = Math.max(a.length, b.length);
+	const lines: string[] = [];
+	let lastShown = -contextLines - 1;
+	for (let i = 0; i < max; i++) {
+		const left = a[i];
+		const right = b[i];
+		if (left === right) continue;
+		// Backfill context above first change.
+		for (let j = Math.max(lastShown + 1, i - contextLines); j < i; j++) {
+			if (lines.length >= 120) break;
+			lines.push(`  ${a[j] ?? ''}`);
+		}
+		if (lines.length >= 120) break;
+		if (left !== undefined) lines.push(`- ${left}`);
+		if (right !== undefined) lines.push(`+ ${right}`);
+		lastShown = i;
+	}
+	if (lines.length === 0) return '';
+	return lines.join('\n');
+}
+
+/**
+ * Regenerate (or check) a single app's wrangler.jsonc. The caller
+ * passes the app directory containing `deployment.config.ts`.
+ */
+export async function regenerateApp(
+	appDir: string,
+	options: RegenerateOptions
+): Promise<RegenResult> {
+	const absoluteAppDir = resolve(appDir);
+	const wranglerJsoncPath = join(absoluteAppDir, 'wrangler.jsonc');
+	let loaded;
+	try {
+		loaded = await loadDeploymentConfig(absoluteAppDir);
+	} catch (err) {
+		return {
+			appId: relative(process.cwd(), absoluteAppDir) || '.',
+			appDir: absoluteAppDir,
+			wranglerJsoncPath,
+			status: 'error',
+			reason: `Failed to load deployment.config: ${(err as Error).message}`
+		};
+	}
+
+	const appId = loaded.deployment.appId;
+	const workerName = loaded.workerName ?? undefined;
+
+	if (!loaded.managed || loaded.wranglerJsoncString === null) {
+		return {
+			appId,
+			appDir: absoluteAppDir,
+			wranglerJsoncPath,
+			status: 'skipped',
+			workerName,
+			reason: loaded.managed
+				? 'deployment is not a managed Cloudflare web-app'
+				: 'deployment.config.ts does not opt in via managed: true'
+		};
+	}
+
+	const rendered = loaded.wranglerJsoncString;
+	const existing = existsSync(wranglerJsoncPath)
+		? readFileSync(wranglerJsoncPath, 'utf-8')
+		: null;
+
+	if (existing === rendered) {
+		return {
+			appId,
+			appDir: absoluteAppDir,
+			wranglerJsoncPath,
+			status: 'unchanged',
+			workerName
+		};
+	}
+
+	if (options.mode === 'check') {
+		return {
+			appId,
+			appDir: absoluteAppDir,
+			wranglerJsoncPath,
+			status: 'drift',
+			workerName,
+			diff: existing === null ? '(no existing wrangler.jsonc)' : unifiedDiffSnippet(existing, rendered)
+		};
+	}
+
+	writeFileSync(wranglerJsoncPath, rendered, 'utf-8');
+	return {
+		appId,
+		appDir: absoluteAppDir,
+		wranglerJsoncPath,
+		status: 'updated',
+		workerName
+	};
+}
+
+/**
+ * Regenerate (or check) every `deployment.config.ts` under `root`.
+ * Non-managed deployments report `'skipped'`; the caller decides
+ * whether to treat skips as failure (typically: no).
+ */
+export async function regenerateAll(
+	root: string,
+	options: RegenerateOptions
+): Promise<RegenResult[]> {
+	const configPaths = findDeploymentConfigs(resolve(root));
+	const results: RegenResult[] = [];
+	for (const configPath of configPaths) {
+		const appDir = configPath.replace(/\/deployment\.config\.(ts|js|mjs)$/, '');
+		results.push(await regenerateApp(appDir, options));
+	}
+	return results;
+}
+
+/** Exit code logic for CLI / CI use. */
+export function regenExitCode(results: RegenResult[], mode: 'check' | 'write'): number {
+	for (const r of results) {
+		if (r.status === 'error') return 1;
+		if (mode === 'check' && r.status === 'drift') return 1;
+	}
+	return 0;
+}