@base44-preview/cli 0.0.15-pr.19.c30ead7 → 0.0.15-pr.87.be3c643

package/dist/{program.js → cli/index.js}

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 import { EventEmitter, addAbortListener, on, once, setMaxListeners } from "node:events";
 import childProcess, { ChildProcess, execFile, spawn, spawnSync } from "node:child_process";
@@ -30351,31 +30352,11 @@ async function deployAll(projectData) {
 //#region src/core/project/app-config.ts
 let cache = null;
 /**
-* Load app config from BASE44_CLI_TEST_OVERRIDES env var.
-* @returns true if override was applied, false otherwise
-*/
-function loadFromTestOverrides() {
-	const overrides = process.env.BASE44_CLI_TEST_OVERRIDES;
-	if (!overrides) return false;
-	try {
-		const data = JSON.parse(overrides);
-		if (data.appConfig?.id && data.appConfig?.projectRoot) {
-			cache = {
-				id: data.appConfig.id,
-				projectRoot: data.appConfig.projectRoot
-			};
-			return true;
-		}
-	} catch {}
-	return false;
-}
-/**
 * Initialize app config by reading from .app.jsonc.
 * Must be called before using getAppConfig().
 * @throws Error if no project found or .app.jsonc missing
 */
 async function initAppConfig() {
-	if (loadFromTestOverrides()) return;
 	if (cache) return;
 	const projectRoot = await findProjectRoot();
 	if (!projectRoot) throw new Error("No Base44 project found. Run this command from a project directory with a config.jsonc file.");
@@ -31069,6 +31050,58 @@ async function printBanner() {
 	else console.log(theme.colors.base44Orange(BANNER_LINES.join("\n")));
 }
 
+//#endregion
+//#region src/cli/utils/json.ts
+/**
+* JSON output utilities for CLI commands.
+*
+* These utilities support the `--json` flag which outputs machine-readable JSON
+* instead of human-friendly formatted output.
+*/
+let jsonModeEnabled = false;
+/**
+* Enable JSON output mode. Called by runCommand when --json flag is detected.
+*/
+function setJsonMode(enabled) {
+	jsonModeEnabled = enabled;
+}
+/**
+* Check if JSON output mode is currently active.
+*/
+function isJsonMode() {
+	return jsonModeEnabled;
+}
+/**
+* Output a success JSON response to stdout.
+* Only outputs if JSON mode is enabled.
+*/
+function outputJson(data) {
+	if (!jsonModeEnabled) return;
+	const response = {
+		success: true,
+		data
+	};
+	console.log(JSON.stringify(response, null, 2));
+}
+/**
+* Output an error JSON response to stderr.
+* Only outputs if JSON mode is enabled.
+*
+* @param error - The error to output
+* @param code - Optional error code
+*/
+function outputJsonError(error, code$1) {
+	if (!jsonModeEnabled) return;
+	const response = {
+		success: false,
+		error: {
+			message: error instanceof Error ? error.message : error,
+			...code$1 && { code: code$1 }
+		}
+	};
+	console.error(JSON.stringify(response, null, 2));
+}
+
 //#endregion
 //#region src/cli/utils/runCommand.ts
 /**
@@ -31102,25 +31135,35 @@ async function printBanner() {
 *   });
 */
 async function runCommand(commandFn, options) {
-	console.log();
-	if (options?.fullBanner) {
-		await printBanner();
-		Ie("");
-	} else Ie(theme.colors.base44OrangeBackground(" Base 44 "));
+	const jsonMode = isJsonMode();
+	if (!jsonMode) {
+		console.log();
+		if (options?.fullBanner) {
+			await printBanner();
+			Ie("");
+		} else Ie(theme.colors.base44OrangeBackground(" Base 44 "));
+	}
 	try {
 		if (options?.requireAuth) {
 			if (!await isLoggedIn()) {
+				if (jsonMode) throw new Error("Authentication required. Please run 'base44 login' first.");
 				M.info("You need to login first to continue.");
 				await login();
 			}
 		}
 		if (options?.requireAppConfig !== false) await initAppConfig();
-		const { outroMessage } = await commandFn();
-		Se(outroMessage || "");
+		const { outroMessage, data } = await commandFn();
+		if (jsonMode) outputJson(data ?? {});
+		else Se(outroMessage || "");
 	} catch (e$1) {
-		if (e$1 instanceof Error) M.error(e$1.stack ?? e$1.message);
-		else M.error(String(e$1));
-		throw new CLIExitError(1);
+		if (jsonMode) {
+			outputJsonError(e$1 instanceof Error ? e$1 : String(e$1));
+			process.exit(1);
+		} else {
+			if (e$1 instanceof Error) M.error(e$1.stack ?? e$1.message);
+			else M.error(String(e$1));
+			process.exit(1);
+		}
 	}
 }
 
@@ -31130,6 +31173,8 @@ async function runCommand(commandFn, options) {
 * Wraps an async operation with automatic spinner management.
 * The spinner is automatically started, and stopped on both success and error.
 *
+* In JSON mode, the spinner is suppressed and the operation runs silently.
+*
 * @param startMessage - Message to show when spinner starts
 * @param operation - The async operation to execute. Receives an updateMessage function
 *                    to update the spinner text during long-running operations.
@@ -31165,6 +31210,10 @@ async function runCommand(commandFn, options) {
 * );
 */
 async function runTask(startMessage, operation, options) {
+	if (isJsonMode()) {
+		const noopUpdateMessage = () => {};
+		return await operation(noopUpdateMessage);
+	}
 	const s = Y();
 	s.start(startMessage);
 	const updateMessage = (message) => s.message(message);
@@ -31205,6 +31254,10 @@ function getDashboardUrl(projectId) {
 
 //#endregion
 //#region src/cli/commands/auth/login.ts
+/**
+* Login command does not support --json output.
+* It requires interactive browser authentication via device code flow.
+*/
 async function generateAndDisplayDeviceCode() {
 	const deviceCodeResponse = await runTask("Generating device code...", async () => {
 		return await generateDeviceCode();
@@ -31266,7 +31319,13 @@ const loginCommand = new Command("login").description("Authenticate with Base44"
 //#region src/cli/commands/auth/whoami.ts
 async function whoami() {
 	const auth = await readAuth();
-	return { outroMessage: `Logged in as: ${theme.styles.bold(auth.email)}` };
+	return {
+		outroMessage: `Logged in as: ${theme.styles.bold(auth.email)}`,
+		data: {
+			email: auth.email,
+			name: auth.name
+		}
+	};
 }
 const whoamiCommand = new Command("whoami").description("Display current authenticated user").action(async () => {
 	await runCommand(whoami, {
@@ -31277,6 +31336,10 @@ const whoamiCommand = new Command("whoami").description("Display current authent
 
 //#endregion
 //#region src/cli/commands/auth/logout.ts
+/**
+* Logout command does not support --json output.
+* It is a user-facing auth command that is rarely scripted.
+*/
 async function logout() {
 	await deleteAuth();
 	return { outroMessage: "Logged out successfully" };
@@ -31289,19 +31352,31 @@ const logoutCommand = new Command("logout").description("Logout from current dev
 //#region src/cli/commands/entities/push.ts
 async function pushEntitiesAction() {
 	const { entities } = await readProjectConfig();
-	if (entities.length === 0) return { outroMessage: "No entities found in project" };
-	const entityNames = entities.map((e$1) => e$1.name).join(", ");
-	M.info(`Found ${entities.length} entities to push: ${entityNames}`);
+	if (entities.length === 0) return {
+		outroMessage: "No entities found in project",
+		data: {
+			created: [],
+			updated: [],
+			deleted: []
+		}
+	};
+	if (!isJsonMode()) M.info(`Found ${entities.length} entities to push`);
 	const result = await runTask("Pushing entities to Base44", async () => {
 		return await pushEntities(entities);
 	}, {
 		successMessage: "Entities pushed successfully",
 		errorMessage: "Failed to push entities"
 	});
-	if (result.created.length > 0) M.success(`Created: ${result.created.join(", ")}`);
-	if (result.updated.length > 0) M.success(`Updated: ${result.updated.join(", ")}`);
-	if (result.deleted.length > 0) M.warn(`Deleted: ${result.deleted.join(", ")}`);
-	return {};
+	if (!isJsonMode()) {
+		if (result.created.length > 0) M.success(`Created: ${result.created.join(", ")}`);
+		if (result.updated.length > 0) M.success(`Updated: ${result.updated.join(", ")}`);
+		if (result.deleted.length > 0) M.warn(`Deleted: ${result.deleted.join(", ")}`);
+	}
+	return { data: {
+		created: result.created,
+		updated: result.updated,
+		deleted: result.deleted
+	} };
 }
 const entitiesPushCommand = new Command("entities").description("Manage project entities").addCommand(new Command("push").description("Push local entities to Base44").action(async () => {
 	await runCommand(pushEntitiesAction, { requireAuth: true });
@@ -31311,21 +31386,32 @@ const entitiesPushCommand = new Command("entities").description("Manage project
 //#region src/cli/commands/functions/deploy.ts
 async function deployFunctionsAction() {
 	const { functions } = await readProjectConfig();
-	if (functions.length === 0) return { outroMessage: "No functions found. Create functions in the 'functions' directory." };
-	M.info(`Found ${functions.length} ${functions.length === 1 ? "function" : "functions"} to deploy`);
+	if (functions.length === 0) return {
+		outroMessage: "No functions found. Create functions in the 'functions' directory.",
+		data: {
+			deployed: [],
+			deleted: []
+		}
+	};
+	if (!isJsonMode()) M.info(`Found ${functions.length} ${functions.length === 1 ? "function" : "functions"} to deploy`);
 	const result = await runTask("Deploying functions to Base44", async () => {
 		return await pushFunctions(functions);
 	}, {
 		successMessage: "Functions deployed successfully",
 		errorMessage: "Failed to deploy functions"
 	});
-	if (result.deployed.length > 0) M.success(`Deployed: ${result.deployed.join(", ")}`);
-	if (result.deleted.length > 0) M.warn(`Deleted: ${result.deleted.join(", ")}`);
+	if (!isJsonMode()) {
+		if (result.deployed.length > 0) M.success(`Deployed: ${result.deployed.join(", ")}`);
+		if (result.deleted.length > 0) M.warn(`Deleted: ${result.deleted.join(", ")}`);
+	}
 	if (result.errors && result.errors.length > 0) {
 		const errorMessages = result.errors.map((e$1) => `'${e$1.name}' function: ${e$1.message}`).join("\n");
 		throw new Error(`Function deployment errors:\n${errorMessages}`);
 	}
-	return {};
+	return { data: {
+		deployed: result.deployed,
+		deleted: result.deleted
+	} };
 }
 const functionsDeployCommand = new Command("functions").description("Manage project functions").addCommand(new Command("deploy").description("Deploy local functions to Base44").action(async () => {
 	await runCommand(deployFunctionsAction, { requireAuth: true });
@@ -38010,8 +38096,9 @@ async function getTemplateById(templateId) {
 	return template;
 }
 function validateNonInteractiveFlags$1(command) {
-	const { name: name$1, path: path$16 } = command.opts();
+	const { name: name$1, path: path$16, json } = command.optsWithGlobals();
 	const providedCount = [name$1, path$16].filter(Boolean).length;
+	if (json && providedCount < 2) command.error("JSON mode requires all flags: --name, --path");
 	if (providedCount > 0 && providedCount < 2) command.error("Non-interactive mode requires all flags: --name, --path");
 }
 async function chooseCreate(options) {
@@ -38135,10 +38222,20 @@ async function executeCreate({ template, name: rawName, description, projectPath
 			finalAppUrl = appUrl;
 		}
 	}
-	M.message(`${theme.styles.header("Project")}: ${theme.colors.base44Orange(name$1)}`);
-	M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(projectId))}`);
-	if (finalAppUrl) M.message(`${theme.styles.header("Site")}: ${theme.colors.links(finalAppUrl)}`);
-	return { outroMessage: "Your project is set up and ready to use" };
+	if (!isJsonMode()) {
+		M.message(`${theme.styles.header("Project")}: ${theme.colors.base44Orange(name$1)}`);
+		M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(projectId))}`);
+		if (finalAppUrl) M.message(`${theme.styles.header("Site")}: ${theme.colors.links(finalAppUrl)}`);
+	}
+	return {
+		outroMessage: "Your project is set up and ready to use",
+		data: {
+			projectId,
+			path: resolvedPath,
+			dashboardUrl,
+			...finalAppUrl && { appUrl: finalAppUrl }
+		}
+	};
 }
 const createCommand = new Command("create").description("Create a new Base44 project").option("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("-p, --path <path>", "Path where to create the project").option("-t, --template <id>", "Template ID (e.g., backend-only, backend-and-client)").option("--deploy", "Build and deploy the site").hook("preAction", validateNonInteractiveFlags$1).action(async (options) => {
 	await chooseCreate(options);
@@ -38685,13 +38782,17 @@ var open_default = open;
 
 //#endregion
 //#region src/cli/commands/project/dashboard.ts
-async function openDashboard() {
-	const dashboardUrl = getDashboardUrl();
-	if (!process.env.CI) await open_default(dashboardUrl);
-	return { outroMessage: `Dashboard opened at ${dashboardUrl}` };
+async function openDashboard(options) {
+	const dashboardUrl$1 = getDashboardUrl();
+	const shouldOpen = !isJsonMode() && options.open !== false;
+	if (shouldOpen) await open_default(dashboardUrl$1);
+	return {
+		outroMessage: shouldOpen ? `Dashboard opened at ${dashboardUrl$1}` : `Dashboard URL: ${dashboardUrl$1}`,
+		data: { dashboardUrl: dashboardUrl$1 }
+	};
 }
-const dashboardCommand = new Command("dashboard").description("Open the app dashboard in your browser").action(async () => {
-	await runCommand(openDashboard, { requireAuth: true });
+const dashboardCommand = new Command("dashboard").description("Open the app dashboard in your browser").option("--no-open", "Print the URL without opening the browser").action(async (options) => {
+	await runCommand(() => openDashboard(options), { requireAuth: true });
 });
 
 //#endregion
@@ -38726,7 +38827,8 @@ const deployCommand = new Command("deploy").description("Deploy all project reso
 //#endregion
 //#region src/cli/commands/project/link.ts
 function validateNonInteractiveFlags(command) {
-	const { create: create$1, name: name$1 } = command.opts();
+	const { create: create$1, name: name$1, json } = command.optsWithGlobals();
+	if (json && (!create$1 || !name$1)) command.error("JSON mode requires flags: --create, --name");
 	if (create$1 && !name$1) command.error("--name is required when using --create");
 }
 async function promptForProjectDetails() {
@@ -38778,8 +38880,14 @@ async function link(options) {
 		id: projectId,
 		projectRoot: projectRoot.root
 	});
-	M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(projectId))}`);
-	return { outroMessage: "Project linked" };
+	if (!isJsonMode()) M.message(`${theme.styles.header("Dashboard")}: ${theme.colors.links(getDashboardUrl(projectId))}`);
+	return {
+		outroMessage: "Project linked",
+		data: {
+			projectId,
+			dashboardUrl
+		}
+	};
 }
 const linkCommand = new Command("link").description("Link a local project to a Base44 project").option("-c, --create", "Create a new project (skip selection prompt)").option("-n, --name <name>", "Project name (required when --create is used)").option("-d, --description <description>", "Project description").hook("preAction", validateNonInteractiveFlags).action(async (options) => {
 	await runCommand(() => link(options), {
@@ -38794,16 +38902,23 @@ async function deployAction(options) {
 	const { project } = await readProjectConfig();
 	if (!project.site?.outputDirectory) throw new Error("No site configuration found. Please add 'site.outputDirectory' to your config.jsonc");
 	const outputDir = resolve(project.root, project.site.outputDirectory);
-	if (!options.yes) {
+	if (!options.yes && !isJsonMode()) {
 		const shouldDeploy = await ye({ message: `Deploy site from ${project.site.outputDirectory}?` });
-		if (pD(shouldDeploy) || !shouldDeploy) return { outroMessage: "Deployment cancelled" };
+		if (pD(shouldDeploy) || !shouldDeploy) return {
+			outroMessage: "Deployment cancelled",
+			data: { cancelled: true }
+		};
 	}
-	return { outroMessage: `Visit your site at: ${(await runTask("Creating archive and deploying site...", async () => {
+	const result = await runTask("Creating archive and deploying site...", async () => {
 		return await deploySite(outputDir);
 	}, {
 		successMessage: "Site deployed successfully",
 		errorMessage: "Deployment failed"
-	})).appUrl}` };
+	});
+	return {
+		outroMessage: `Visit your site at: ${result.appUrl}`,
+		data: { appUrl: result.appUrl }
+	};
 }
 const siteDeployCommand = new Command("site").description("Manage site deployments").addCommand(new Command("deploy").description("Deploy built site files to Base44 hosting").option("-y, --yes", "Skip confirmation prompt").action(async (options) => {
 	await runCommand(() => deployAction(options), { requireAuth: true });
@@ -38814,47 +38929,24 @@ const siteDeployCommand = new Command("site").description("Manage site deploymen
 var version = "0.0.15";
 
 //#endregion
-//#region src/cli/program.ts
-/**
-* Custom error class for CLI exit codes.
-* Thrown instead of calling process.exit() directly to allow testing.
-* The bin/run.js entry point catches this and calls process.exit().
-*/
-var CLIExitError = class extends Error {
-	constructor(code$1) {
-		super(`CLI exited with code ${code$1}`);
-		this.code = code$1;
-		this.name = "CLIExitError";
-	}
-};
-/**
-* Creates a new Commander program instance with all commands registered.
-* Use this factory for testing to get a fresh program instance per test.
-*/
-function createProgram() {
-	const program$2 = new Command();
-	program$2.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version);
-	program$2.configureHelp({ sortSubcommands: true });
-	program$2.exitOverride((err) => {
-		throw err;
-	});
-	program$2.configureOutput({
-		writeOut: (str) => process.stdout.write(str),
-		writeErr: (str) => process.stderr.write(str)
-	});
-	program$2.addCommand(loginCommand);
-	program$2.addCommand(whoamiCommand);
-	program$2.addCommand(logoutCommand);
-	program$2.addCommand(createCommand);
-	program$2.addCommand(dashboardCommand);
-	program$2.addCommand(deployCommand);
-	program$2.addCommand(linkCommand);
-	program$2.addCommand(entitiesPushCommand);
-	program$2.addCommand(functionsDeployCommand);
-	program$2.addCommand(siteDeployCommand);
-	return program$2;
-}
-const program = createProgram();
-
-//#endregion
-export { CLIExitError, createProgram, program };
+//#region src/cli/index.ts
+const program = new Command();
+program.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version).option("--json", "Output results as JSON (for scripting)");
+program.hook("preAction", (thisCommand) => {
+	if (thisCommand.optsWithGlobals().json) setJsonMode(true);
+});
+program.configureHelp({ sortSubcommands: true });
+program.addCommand(loginCommand);
+program.addCommand(whoamiCommand);
+program.addCommand(logoutCommand);
+program.addCommand(createCommand);
+program.addCommand(dashboardCommand);
+program.addCommand(deployCommand);
+program.addCommand(linkCommand);
+program.addCommand(entitiesPushCommand);
+program.addCommand(functionsDeployCommand);
+program.addCommand(siteDeployCommand);
+program.parse();
+
+//#endregion
+export {  };

package/package.json

@@ -1,26 +1,23 @@
 {
   "name": "@base44-preview/cli",
-  "version": "0.0.15-pr.19.c30ead7",
+  "version": "0.0.15-pr.87.be3c643",
   "description": "Base44 CLI - Unified interface for managing Base44 applications",
   "type": "module",
-  "main": "./dist/program.js",
-  "bin": {
-    "base44": "./bin/run.js"
-  },
+  "main": "./dist/cli/index.js",
+  "bin": "./dist/cli/index.js",
   "exports": {
-    ".": "./dist/program.js"
+    ".": "./dist/cli/index.js"
   },
   "files": [
-    "dist",
-    "bin"
+    "dist"
   ],
   "scripts": {
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
-    "dev": "./bin/dev.js",
-    "start": "./bin/run.js",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js",
     "clean": "rm -rf dist",
-    "lint": "eslint src tests",
+    "lint": "eslint src",
     "test": "vitest run",
     "test:watch": "vitest"
   },
@@ -56,12 +53,9 @@
     "json5": "^2.2.3",
     "ky": "^1.14.2",
     "lodash.kebabcase": "^4.1.1",
-    "msw": "^2.12.7",
     "open": "^11.0.0",
     "p-wait-for": "^6.0.0",
-    "strip-ansi": "^7.1.2",
     "tar": "^7.5.4",
-    "tmp-promise": "^3.0.3",
     "tsdown": "^0.12.4",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",

package/bin/dev.cmd

@@ -1,2 +0,0 @@
-@echo off
-npx tsx "%~dp0\dev.js" %*

package/bin/dev.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env tsx
-import { program, CLIExitError } from '../src/cli/program.ts';
-
-try {
-  await program.parseAsync();
-} catch (e) {
-  if (e instanceof CLIExitError) {
-    process.exit(e.code);  // Clean exit, no stack trace
-  }
-  // Commander throws for --help and --version with exitCode 0
-  if (e?.code === 'commander.helpDisplayed' || e?.code === 'commander.version') {
-    process.exit(0);
-  }
-  // For other Commander errors, exit with the provided code
-  if (e?.exitCode !== undefined) {
-    process.exit(e.exitCode);
-  }
-  console.error(e);
-  process.exit(1);
-}

package/bin/run.cmd

@@ -1,2 +0,0 @@
-@echo off
-node "%~dp0\run.js" %*

package/bin/run.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-import { program, CLIExitError } from '../dist/program.js';
-
-try {
-  await program.parseAsync();
-} catch (e) {
-  if (e instanceof CLIExitError) {
-    process.exit(e.code);  // Clean exit, no stack trace
-  }
-  // Commander throws for --help and --version with exitCode 0
-  if (e?.code === 'commander.helpDisplayed' || e?.code === 'commander.version') {
-    process.exit(0);
-  }
-  // For other Commander errors, exit with the provided code
-  if (e?.exitCode !== undefined) {
-    process.exit(e.exitCode);
-  }
-  console.error(e);
-  process.exit(1);
-}