@base44-preview/cli 0.0.17-pr.104.57e16fe → 0.0.17-pr.104.ad47aa8

package/README.md

@@ -1,84 +1,247 @@
 # Base44 CLI
 
-Command-line interface for building applications with [Base44's backend service](https://docs.base44.com/developers/backend/overview/introduction).
+A unified command-line interface for managing Base44 applications, entities, functions, deployments, and related services.
 
-Base44's backend service provides a managed backend for your applications, including data storage with entities, serverless functions, authentication, and hosting. The CLI lets you:
-
-- **Create projects** from templates.
-- **Sync** resources defined in local code with your Base44 backend.
-- **Deploy sites** to Base44's hosting platform.
-
-To get started, see the full list of commands below or check out the [documentation](https://docs.base44.com/developers/references/cli/get-started/overview).
+**Zero dependencies** - installs in seconds with no dependency resolution.
 
 ## Installation
 
 ```bash
+# Using npm (globally)
 npm install -g base44
+
+# Or run directly with npx
+npx base44 <command>
 ```
 
-Or run commands directly with npx:
+## Quick Start
 
 ```bash
-npx base44 <command>
+# 1. Login to Base44
+base44 login
+
+# 2. Create a new project
+base44 create
+
+# 3. Deploy everything (entities, functions, and site)
+npm run build
+base44 deploy
 ```
 
-Requires Node.js 20.19.0 or higher.
+## Commands
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `base44 login` | Authenticate with Base44 using device code flow |
+| `base44 whoami` | Display current authenticated user |
+| `base44 logout` | Logout from current device |
+
+### Project Management
+
+| Command | Description |
+|---------|-------------|
+| `base44 create` | Create a new Base44 project from a template |
+| `base44 link` | Link a local project to Base44 (create new or link existing) |
+| `base44 dashboard` | Open the app dashboard in your browser |
+
+#### Link Command Options
 
-## Quick start
+The `link` command supports both creating new projects and linking to existing ones:
 
 ```bash
-# Authenticate
-base44 login
+# Interactive mode - choose to create new or link existing
+base44 link
 
-# Create a project
-base44 create
+# Create a new project (non-interactive)
+base44 link --create --name "my-app" --description "My app description"
+
+# Link to an existing project by ID (non-interactive)
+base44 link --projectId <app-id>
 ```
 
-The CLI will guide you through project setup. For step-by-step tutorials, see the quickstart guides:
+| Option | Description |
+|--------|-------------|
+| `-c, --create` | Create a new project (skip selection prompt) |
+| `-n, --name <name>` | Project name (required with --create) |
+| `-d, --description <desc>` | Project description (optional) |
+| `-p, --projectId <id>` | Link to an existing project by ID (skips selection prompt) |
 
-- [Backend only](https://docs.base44.com/developers/backend/quickstart/quickstart-backend-only) — for headless apps or custom frontends
-- [React](https://docs.base44.com/developers/backend/quickstart/quickstart-with-react) — full-stack with Vite + React
+### Deployment
 
-## Commands
+| Command | Description |
+|---------|-------------|
+| `base44 deploy` | Deploy all resources (entities, functions, and site) |
+
+### Entities
+
+| Command | Description |
+|---------|-------------|
+| `base44 entities push` | Push local entity schemas to Base44 |
+
+### Functions
+
+| Command | Description |
+|---------|-------------|
+| `base44 functions deploy` | Deploy local functions to Base44 |
+
+### Site
+
+| Command | Description |
+|---------|-------------|
+| `base44 site deploy` | Deploy built site files to Base44 hosting |
+
+### Connectors
+
+Manage OAuth integrations to connect your app with external services. Connectors are stored in the `connectors` property of your project's `config.jsonc` file.
 
 | Command | Description |
-| ------- | ----------- |
-| [`create`](https://docs.base44.com/developers/references/cli/commands/create) | Create a new Base44 project from a template |
-| [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) | Deploy resources and site to Base44 |
-| [`link`](https://docs.base44.com/developers/references/cli/commands/link) | Link a local project to a project on Base44 |
-| [`dashboard`](https://docs.base44.com/developers/references/cli/commands/dashboard) | Open the app dashboard in your browser |
-| [`login`](https://docs.base44.com/developers/references/cli/commands/login) | Authenticate with Base44 |
-| [`logout`](https://docs.base44.com/developers/references/cli/commands/logout) | Sign out and clear stored credentials |
-| [`whoami`](https://docs.base44.com/developers/references/cli/commands/whoami) | Display the current authenticated user |
-| [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push) | Push local entity schemas to Base44 |
-| [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy) | Deploy local functions to Base44 |
-| [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) | Deploy built site files to Base44 hosting |
-| `connectors add [type]` | Connect an OAuth integration |
-| `connectors list` | List all connected integrations |
-| `connectors push` | Sync connectors with backend (connect new, remove missing) |
-| `connectors remove [type]` | Disconnect an integration |
-
-
-<!--| [`eject`](https://docs.base44.com/developers/references/cli/commands/eject) | Create a Base44 backend project from an existing Base44 app | -->
-
-## Help
+|---------|-------------|
+| `base44 connectors add [type]` | Add and connect an OAuth integration |
+| `base44 connectors list` | List all connectors (local and connected) |
+| `base44 connectors push` | Sync connectors with backend (connect new, remove missing) |
+| `base44 connectors remove [type]` | Remove an integration |
+| `base44 connectors remove [type] --hard` | Permanently remove an integration |
+
+**Supported integrations:** Slack, Google Calendar, Google Drive, Gmail, Google Sheets, Google Docs, Google Slides, Notion, Salesforce, HubSpot, LinkedIn, TikTok
+
+**Example workflow:**
+```bash
+# Add a connector interactively (saves to config.jsonc and opens OAuth)
+base44 connectors add slack
+
+# List connectors showing local vs connected status
+base44 connectors list
+# Output:
+# ● Slack - user@example.com
+# ○ Google Calendar (not connected)
+
+# Sync all connectors (connects new, removes missing from config)
+base44 connectors push
+# Output:
+# 1 connector to connect:
+#   + Google Calendar
+# 1 connector to remove:
+#   - Notion (user@example.com)
+# Apply 2 changes? (Y/n)
+
+# Remove a single connector
+base44 connectors remove slack
+```
+
+**Configuration** (`base44/config.jsonc`):
+```jsonc
+{
+  "name": "my-app",
+  "connectors": {
+    "slack": {},
+    "googlecalendar": { "scopes": ["calendar.readonly"] }
+  }
+}
+```
+
+Once connected, use the SDK's `connectors.getAccessToken()` to retrieve tokens:
+```javascript
+const token = await base44.connectors.getAccessToken("slack");
+```
+
+## Configuration
+
+### Project Configuration
+
+Base44 projects are configured via a `config.jsonc` (or `config.json`) file in the `base44/` subdirectory:
+
+```jsonc
+// base44/config.jsonc
+{
+  "name": "My Project",
+  "entitiesDir": "./entities",   // Default: ./entities
+  "functionsDir": "./functions", // Default: ./functions
+  "site": {
+    "outputDirectory": "../dist" // Path to built site files
+  }
+}
+```
+
+### App Configuration
+
+Your app ID is stored in a `.app.jsonc` file in the `base44/` directory. This file is created automatically when you run `base44 create` or `base44 link`:
+
+```jsonc
+// base44/.app.jsonc
+{
+  "id": "your-app-id"
+}
+```
+
+## Project Structure
+
+A typical Base44 project has this structure:
+
+```
+my-project/
+├── base44/
+│   ├── config.jsonc           # Project configuration
+│   ├── .app.jsonc             # App ID (git-ignored)
+│   ├── entities/              # Entity schema files
+│   │   ├── user.jsonc
+│   │   └── product.jsonc
+│   └── functions/             # Backend functions
+│       └── my-function/
+│           ├── config.jsonc
+│           └── index.js
+├── src/                       # Your frontend code
+├── dist/                      # Built site files (for deployment)
+└── package.json
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 20.19.0
+- npm
+
+### Setup
 
 ```bash
-base44 --help
-base44 <command> --help
+# Clone the repository
+git clone https://github.com/base44/cli.git
+cd cli
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development mode
+npm run dev -- <command>
 ```
 
-## Version
+### Available Scripts
 
 ```bash
-base44 --version
+npm run build      # Build with tsdown
+npm run typecheck  # Type check with tsc
+npm run dev        # Run in development mode with tsx
+npm run lint       # Lint with ESLint
+npm test           # Run tests with Vitest
 ```
 
-## Alpha
+### Running the Built CLI
+
+```bash
+# After building
+npm start -- <command>
 
-The CLI and Base44 backend service are currently in alpha. We're actively improving them based on user feedback. Share your thoughts and feature requests on our [GitHub Discussions](https://github.com/orgs/base44/discussions).
+# Or directly
+./dist/cli/index.js <command>
+```
+## Contributing
 
-Found a bug? [Open an issue](https://github.com/base44/cli/issues).
+See [AGENTS.md](./AGENTS.md) for development guidelines and architecture documentation.
 
 ## License
 

package/dist/{index.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";
@@ -30740,21 +30741,6 @@ async function getUserInfo(accessToken) {
 	return result.data;
 }
 
-//#endregion
-//#region src/cli/errors.ts
-/**
-* Error thrown to signal a controlled CLI exit with a specific exit code.
-* This allows proper error propagation without calling process.exit() directly,
-* making the code more testable and maintaining a single exit point.
-*/
-var CLIExitError = class extends Error {
-	constructor(code$1) {
-		super(`CLI exited with code ${code$1}`);
-		this.code = code$1;
-		this.name = "CLIExitError";
-	}
-};
-
 //#endregion
 //#region node_modules/chalk/source/vendor/ansi-styles/index.js
 const ANSI_BACKGROUND_OFFSET = 10;
@@ -31324,7 +31310,7 @@ async function runCommand(commandFn, options) {
 	} 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);
+		process.exit(1);
 	}
 }
 
@@ -39260,48 +39246,6 @@ function getIntegrationDisplayName(type) {
 	return type;
 }
 
-//#endregion
-//#region src/core/connectors/oauth.ts
-/**
-* Polls for OAuth completion status.
-* Returns when status becomes ACTIVE or FAILED, or times out.
-*/
-async function waitForOAuthCompletion(integrationType, connectionId, options) {
-	let accountEmail;
-	let error;
-	try {
-		await pWaitFor(async () => {
-			const status = await checkOAuthStatus(integrationType, connectionId);
-			if (status.status === "ACTIVE") {
-				accountEmail = status.accountEmail ?? void 0;
-				return true;
-			}
-			if (status.status === "FAILED") {
-				error = status.error || "Authorization failed";
-				throw new Error(error);
-			}
-			options?.onPending?.();
-			return false;
-		}, {
-			interval: OAUTH_POLL_INTERVAL_MS,
-			timeout: OAUTH_POLL_TIMEOUT_MS
-		});
-		return {
-			success: true,
-			accountEmail
-		};
-	} catch (err) {
-		if (err instanceof Error && err.message.includes("timed out")) return {
-			success: false,
-			error: "Authorization timed out. Please try again."
-		};
-		return {
-			success: false,
-			error: error || (err instanceof Error ? err.message : "Unknown error")
-		};
-	}
-}
-
 //#endregion
 //#region src/core/connectors/config.ts
 /**
@@ -39363,20 +39307,6 @@ async function removeLocalConnector(type, projectRoot) {
 	return await writeLocalConnectors(filtered, projectRoot);
 }
 
-//#endregion
-//#region src/core/connectors/state.ts
-/**
-* Fetches both local config and backend connectors in parallel.
-* Gracefully handles failures by returning empty arrays.
-*/
-async function fetchConnectorState() {
-	const [local, backend] = await Promise.all([readLocalConnectors().catch(() => []), listConnectors().catch(() => [])]);
-	return {
-		local,
-		backend
-	};
-}
-
 //#endregion
 //#region src/cli/commands/connectors/add.ts
 function validateIntegrationType(type) {
@@ -39400,13 +39330,45 @@ async function promptForIntegrationType() {
 	}
 	return selected;
 }
-async function pollForOAuthCompletion(integrationType, connectionId) {
-	return await runTask("Waiting for authorization...", async () => {
-		return await waitForOAuthCompletion(integrationType, connectionId);
-	}, {
-		successMessage: "Authorization completed!",
-		errorMessage: "Authorization failed"
-	});
+async function waitForOAuthCompletion(integrationType, connectionId) {
+	let accountEmail;
+	let error;
+	try {
+		await runTask("Waiting for authorization...", async (updateMessage) => {
+			await pWaitFor(async () => {
+				const status = await checkOAuthStatus(integrationType, connectionId);
+				if (status.status === "ACTIVE") {
+					accountEmail = status.accountEmail ?? void 0;
+					return true;
+				}
+				if (status.status === "FAILED") {
+					error = status.error || "Authorization failed";
+					throw new Error(error);
+				}
+				updateMessage("Waiting for authorization in browser...");
+				return false;
+			}, {
+				interval: OAUTH_POLL_INTERVAL_MS,
+				timeout: OAUTH_POLL_TIMEOUT_MS
+			});
+		}, {
+			successMessage: "Authorization completed!",
+			errorMessage: "Authorization failed"
+		});
+		return {
+			success: true,
+			accountEmail
+		};
+	} catch (err) {
+		if (err instanceof Error && err.message.includes("timed out")) return {
+			success: false,
+			error: "Authorization timed out. Please try again."
+		};
+		return {
+			success: false,
+			error: error || (err instanceof Error ? err.message : "Unknown error")
+		};
+	}
 }
 async function addConnector(integrationType) {
 	const selectedType = integrationType ? validateIntegrationType(integrationType) : await promptForIntegrationType();
@@ -39424,7 +39386,7 @@ async function addConnector(integrationType) {
 	if (initiateResponse.error === "different_user" && initiateResponse.other_user_email) throw new Error(`This app is already connected to ${displayName} by ${initiateResponse.other_user_email}`);
 	if (!initiateResponse.redirect_url || !initiateResponse.connection_id) throw new Error("Invalid response from server: missing redirect URL or connection ID");
 	M.info(`Please authorize ${displayName} at:\n${theme.colors.links(initiateResponse.redirect_url)}`);
-	const result = await pollForOAuthCompletion(selectedType, initiateResponse.connection_id);
+	const result = await waitForOAuthCompletion(selectedType, initiateResponse.connection_id);
 	if (!result.success) throw new Error(result.error || "Authorization failed");
 	await addLocalConnector(selectedType);
 	const accountInfo = result.accountEmail ? ` as ${theme.styles.bold(result.accountEmail)}` : "";
@@ -39488,7 +39450,10 @@ function formatConnectorLine(connector) {
 	return `${bullet} ${displayName}${statusText}`;
 }
 async function listConnectorsCommand() {
-	const { local: localConnectors, backend: backendConnectors } = await runTask("Fetching connectors...", fetchConnectorState, {
+	const [localConnectors, backendConnectors] = await runTask("Fetching connectors...", async () => {
+		const [local, backend] = await Promise.all([readLocalConnectors().catch(() => []), listConnectors().catch(() => [])]);
+		return [local, backend];
+	}, {
 		successMessage: "Connectors loaded",
 		errorMessage: "Failed to fetch connectors"
 	});
@@ -39548,15 +39513,45 @@ async function connectSingleConnector(connector) {
 		error: "Invalid response from server"
 	};
 	M.info(`Please authorize ${displayName} at:\n${theme.colors.links(initiateResponse.redirect_url)}`);
-	return await runTask("Waiting for authorization...", async () => {
-		return await waitForOAuthCompletion(type, initiateResponse.connection_id);
-	}, {
-		successMessage: "Authorization completed!",
-		errorMessage: "Authorization failed"
-	});
+	let accountEmail;
+	try {
+		await runTask("Waiting for authorization...", async () => {
+			await pWaitFor(async () => {
+				const status = await checkOAuthStatus(type, initiateResponse.connection_id);
+				if (status.status === "ACTIVE") {
+					accountEmail = status.accountEmail ?? void 0;
+					return true;
+				}
+				if (status.status === "FAILED") throw new Error(status.error || "Authorization failed");
+				return false;
+			}, {
+				interval: OAUTH_POLL_INTERVAL_MS,
+				timeout: OAUTH_POLL_TIMEOUT_MS
+			});
+		}, {
+			successMessage: "Authorization completed!",
+			errorMessage: "Authorization failed"
+		});
+		return {
+			success: true,
+			accountEmail
+		};
+	} catch (err) {
+		if (err instanceof Error && err.message.includes("timed out")) return {
+			success: false,
+			error: "Authorization timed out. Please try again."
+		};
+		return {
+			success: false,
+			error: err instanceof Error ? err.message : "Unknown error"
+		};
+	}
 }
 async function pushConnectorsCommand() {
-	const { local: localConnectors, backend: backendConnectors } = await runTask("Checking connector status...", fetchConnectorState, {
+	const [localConnectors, backendConnectors] = await runTask("Checking connector status...", async () => {
+		const [local, backend] = await Promise.all([readLocalConnectors(), listConnectors().catch(() => [])]);
+		return [local, backend];
+	}, {
 		successMessage: "Status checked",
 		errorMessage: "Failed to check status"
 	});
@@ -39680,7 +39675,10 @@ async function promptForConnectorToRemove(connectors) {
 }
 async function removeConnectorCommand(integrationType, options = {}) {
 	const isHardDelete = options.hard === true;
-	const { local: localConnectors, backend: backendConnectors } = await runTask("Fetching connectors...", fetchConnectorState, {
+	const [localConnectors, backendConnectors] = await runTask("Fetching connectors...", async () => {
+		const [local, backend] = await Promise.all([readLocalConnectors().catch(() => []), listConnectors().catch(() => [])]);
+		return [local, backend];
+	}, {
 		successMessage: "Connectors loaded",
 		errorMessage: "Failed to fetch connectors"
 	});
@@ -39725,7 +39723,7 @@ const connectorsCommand = new Command("connectors").description("Manage OAuth co
 var version = "0.0.17";
 
 //#endregion
-//#region src/cli/program.ts
+//#region src/cli/index.ts
 const program = new Command();
 program.name("base44").description("Base44 CLI - Unified interface for managing Base44 applications").version(version);
 program.configureHelp({ sortSubcommands: true });
@@ -39740,6 +39738,7 @@ program.addCommand(entitiesPushCommand);
 program.addCommand(functionsDeployCommand);
 program.addCommand(siteDeployCommand);
 program.addCommand(connectorsCommand);
+program.parse();
 
 //#endregion
-export { CLIExitError, program };
+export {  };

package/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@base44-preview/cli",
-  "version": "0.0.17-pr.104.57e16fe",
+  "version": "0.0.17-pr.104.ad47aa8",
   "description": "Base44 CLI - Unified interface for managing Base44 applications",
   "type": "module",
-  "bin": {
-    "base44": "./bin/run.js"
+  "main": "./dist/cli/index.js",
+  "bin": "./dist/cli/index.js",
+  "exports": {
+    ".": "./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",
     "test": "vitest run",

package/bin/dev.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env tsx
-import { program, CLIExitError } from "../src/cli/index.ts";
-
-try {
-  await program.parseAsync();
-} catch (error) {
-  if (error instanceof CLIExitError) {
-    process.exit(error.code);
-  }
-  console.error(error);
-  process.exit(1);
-}

package/bin/run.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import { program, CLIExitError } from "../dist/index.js";
-
-try {
-  await program.parseAsync();
-} catch (error) {
-  if (error instanceof CLIExitError) {
-    process.exit(error.code);
-  }
-  console.error(error);
-  process.exit(1);
-}