@boltic/cli 1.0.41 → 1.0.42

package/README.md

@@ -112,7 +112,11 @@ Boltic CLI uses a secure OAuth 2.0 flow with browser-based authentication for en
 ### Initial Login
 
 ```bash
+# Interactive browser login
 boltic login
+
+# Login with Permanent Access Token (PAT)
+boltic login --token YOUR_PAT_TOKEN --account-id YOUR_ACCOUNT_ID
 ```
 
 The authentication process follows these steps:
@@ -401,6 +405,48 @@ boltic serverless status
 
 # Check status by name
 boltic serverless status --name my-function
+
+# Watch status until running/failed/degraded
+boltic serverless status --name my-function --watch
+```
+
+### Viewing Builds
+
+```bash
+# List all builds for a serverless function
+boltic serverless builds
+
+# List builds by name
+boltic serverless builds --name my-function
+```
+
+### Viewing Logs
+
+```bash
+# View runtime logs (interactive selection)
+boltic serverless logs
+
+# View logs by name
+boltic serverless logs --name my-function
+
+# Follow logs in real-time
+boltic serverless logs --name my-function --follow
+
+# Limit number of lines
+boltic serverless logs --name my-function --lines 50
+```
+
+### Viewing Build Logs
+
+```bash
+# View build logs (interactive selection)
+boltic serverless build logs
+
+# View build logs by name (will prompt for build selection)
+boltic serverless build logs --name my-function
+
+# View specific build logs
+boltic serverless build logs --name my-function --build BUILD_ID
 ```
 
 ---
@@ -409,12 +455,12 @@ boltic serverless status --name my-function
 
 ### Core Commands
 
-| Command          | Description                       | Options |
-| ---------------- | --------------------------------- | ------- |
-| `boltic login`   | Authenticate with Boltic platform |         |
-| `boltic logout`  | Clear stored credentials          |         |
-| `boltic version` | Display CLI version               |         |
-| `boltic help`    | Show comprehensive help           |         |
+| Command          | Description                       | Options                                  |
+| ---------------- | --------------------------------- | ---------------------------------------- |
+| `boltic login`   | Authenticate with Boltic platform | `--token` `--account-id`                 |
+| `boltic logout`  | Clear stored credentials          |                                          |
+| `boltic version` | Display CLI version               |                                          |
+| `boltic help`    | Show comprehensive help           |                                          |
 
 ### Integration Commands
 
@@ -437,15 +483,18 @@ boltic serverless status --name my-function
 
 ### Serverless Commands
 
-| Command                      | Description                          | Options                                              |
-| ---------------------------- | ------------------------------------ | ---------------------------------------------------- |
-| `boltic serverless create`   | Create a new serverless function     | `--type, -t` `--name, -n` `--language, -l` `--directory, -d` |
-| `boltic serverless test`     | Test serverless function locally     | `--port, -p` `--language, -l` `--directory, -d`      |
-| `boltic serverless publish`  | Publish/deploy serverless function   | `--directory, -d`                                    |
-| `boltic serverless pull`     | Pull existing serverless function    | `--path`                                             |
-| `boltic serverless list`     | List all serverless functions        |                                                      |
-| `boltic serverless status`   | Show status of a serverless function | `--name, -n`                                         |
-| `boltic serverless help`     | Show help for serverless commands    |                                                      |
+| Command                         | Description                          | Options                                              |
+| ------------------------------- | ------------------------------------ | ---------------------------------------------------- |
+| `boltic serverless create`      | Create a new serverless function     | `--type, -t` `--name, -n` `--language, -l` `--directory, -d` |
+| `boltic serverless test`        | Test serverless function locally     | `--port, -p` `--language, -l` `--directory, -d`      |
+| `boltic serverless publish`     | Publish/deploy serverless function   | `--directory, -d`                                    |
+| `boltic serverless pull`        | Pull existing serverless function    | `--path`                                             |
+| `boltic serverless list`        | List all serverless functions        |                                                      |
+| `boltic serverless status`      | Show status of a serverless function | `--name, -n` `--watch, -w`                           |
+| `boltic serverless builds`      | List builds for a serverless         | `--name, -n`                                         |
+| `boltic serverless logs`        | Show runtime logs                    | `--name, -n` `--follow, -f` `--lines, -l`            |
+| `boltic serverless build logs`  | Show logs for a specific build       | `--name, -n` `--build, -b`                           |
+| `boltic serverless help`        | Show help for serverless commands    |                                                      |
 
 ### Help and Documentation
 

package/api/serverless.js

@@ -3,7 +3,7 @@ import FormData from "form-data";
 import fs from "fs";
 import https from "https";
 import { handleError } from "../helper/error.js";
-import { logApi } from "../helper/verbose.js";
+import { logApi, logApiRequest, logApiResponse } from "../helper/verbose.js";
 
 const getHttpsAgentForUrl = (baseUrl) => {
 	try {
@@ -62,8 +62,12 @@ const listAllServerless = async (
 			httpsAgent: getHttpsAgentForUrl(apiUrl),
 		};
 
+		logApiRequest(
+			axiosOptions.method,
+			`${axiosOptions.url}?${new URLSearchParams(params).toString()}`
+		);
 		const response = await axios(axiosOptions);
-		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		logApiResponse(response.status, response.data);
 		return response.data.data;
 	} catch (error) {
 		handleError(error);
@@ -80,9 +84,11 @@ const pullServerless = async (apiUrl, token, accountId, session, id) => {
 		process.exit(1); // Exit the CLI with an error code
 	}
 	try {
+		const url = `${apiUrl}/service/panel/serverless/v1.0/apps/${id}`;
+		logApiRequest("get", url);
 		const response = await axios({
 			method: "get",
-			url: `${apiUrl}/service/panel/serverless/v1.0/apps/${id}`,
+			url,
 			headers: {
 				"Content-Type": "application/json",
 				Authorization: `Bearer ${token}`,
@@ -90,6 +96,7 @@ const pullServerless = async (apiUrl, token, accountId, session, id) => {
 			},
 			httpsAgent: getHttpsAgentForUrl(apiUrl),
 		});
+		logApiResponse(response.status, response?.data);
 		return response?.data;
 	} catch (error) {
 		handleError(error);
@@ -166,9 +173,147 @@ const updateServerless = async (
 	}
 };
 
+const getServerlessBuilds = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	serverlessId,
+	options = {}
+) => {
+	if (!token || !session || !accountId) {
+		console.error(
+			"\x1b[31mError:\x1b[0m Authentication credentials are required."
+		);
+		console.log("\n🔹 Please log in first using:");
+		console.log("\x1b[32m$ boltic login\x1b[0m\n");
+		process.exit(1);
+	}
+	try {
+		const axiosOptions = {
+			method: "get",
+			url: `${apiUrl}/service/panel/serverless/v1.0/apps/${serverlessId}/builds`,
+			params: {
+				page: options.page || 1,
+				limit: options.limit || 20,
+				sortBy: "CreatedAt",
+				sortOrder: "desc",
+			},
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+			httpsAgent: getHttpsAgentForUrl(apiUrl),
+		};
+
+		const response = await axios(axiosOptions);
+		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		return response.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getServerlessLogs = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	serverlessId,
+	options = {}
+) => {
+	if (!token || !session || !accountId) {
+		console.error(
+			"\x1b[31mError:\x1b[0m Authentication credentials are required."
+		);
+		console.log("\n🔹 Please log in first using:");
+		console.log("\x1b[32m$ boltic login\x1b[0m\n");
+		process.exit(1);
+	}
+	try {
+		// Calculate timestamp range (default: last 24 hours)
+		const now = Math.floor(Date.now() / 1000);
+		const defaultStart = now - 24 * 60 * 60; // 24 hours ago
+
+		const params = {
+			page: options.page || 1,
+			limit: options.limit || 50,
+			sortBy: "Timestamp",
+			sortOrder: options.sortOrder || "DESC",
+			timestampStart: options.timestampStart || defaultStart,
+			timestampEnd: options.timestampEnd || now,
+			metric_interval: 60,
+		};
+
+		const axiosOptions = {
+			method: "get",
+			url: `${apiUrl}/service/panel/serverless/v1.0/apps/${serverlessId}/logs`,
+			params,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+			httpsAgent: getHttpsAgentForUrl(apiUrl),
+		};
+
+		const response = await axios(axiosOptions);
+		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		return response.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getBuildLogs = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	serverlessId,
+	buildId
+) => {
+	if (!token || !session || !accountId) {
+		console.error(
+			"\x1b[31mError:\x1b[0m Authentication credentials are required."
+		);
+		console.log("\n🔹 Please log in first using:");
+		console.log("\x1b[32m$ boltic login\x1b[0m\n");
+		process.exit(1);
+	}
+	try {
+		const axiosOptions = {
+			method: "get",
+			url: `${apiUrl}/service/panel/serverless/v1.0/apps/${serverlessId}/builds/${buildId}/logs`,
+			params: {
+				limit: -1,
+				tail: false,
+				sortOrder: "asc",
+				sortBy: "Timestamp",
+			},
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+			httpsAgent: getHttpsAgentForUrl(apiUrl),
+		};
+
+		const response = await axios(axiosOptions);
+		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		return response.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
 export {
 	listAllServerless,
 	pullServerless,
 	publishServerless,
 	updateServerless,
+	getServerlessBuilds,
+	getServerlessLogs,
+	getBuildLogs,
 };

package/cli.js

@@ -19,67 +19,74 @@ const createCLI = (consoleUrl, apiUrl, serviceName, env) => {
 			description: "Authenticate the user and save access token",
 			action: async (args) => {
 				// Support PAT-based login via flags, e.g.:
-				//   boltic login --pat XXXXX --account_id YYYYYY
-				//   boltic login --pat=XXXXX --account-id=YYYYYY
-				let patFromArg;
-				let accountIdFromArg;
-				let hasPatFlag = false;
-				let hasAccountIdFlag = false;
+				//   boltic login --token XXXXX --account-id YYYYYY
+				//   boltic login --token=XXXXX --acc-id=YYYYYY
+				let tokenFromArg;
+				let orgIdFromArg;
+				let hasTokenFlag = false;
+				let hasOrgIdFlag = false;
 
 				for (let i = 0; i < args.length; i++) {
 					const arg = args[i];
 
-					if (arg === "--pat") {
-						hasPatFlag = true;
+					if (arg === "--token") {
+						hasTokenFlag = true;
 						if (
 							i + 1 < args.length &&
 							!args[i + 1].startsWith("--")
 						) {
-							patFromArg = args[i + 1];
+							tokenFromArg = args[i + 1];
 							i++;
 						}
 						continue;
 					}
 
-					if (arg === "--account_id" || arg === "--account-id") {
-						hasAccountIdFlag = true;
+					if (
+						arg === "--account_id" ||
+						arg === "--account-id" ||
+						arg === "--acc_id" ||
+						arg === "--acc-id"
+					) {
+						hasOrgIdFlag = true;
 						if (
 							i + 1 < args.length &&
 							!args[i + 1].startsWith("--")
 						) {
-							accountIdFromArg = args[i + 1];
+							orgIdFromArg = args[i + 1];
 							i++;
 						}
 						continue;
 					}
 
-					if (arg.startsWith("--pat=")) {
-						hasPatFlag = true;
-						patFromArg = arg.split("=")[1];
+					if (arg.startsWith("--token=")) {
+						hasTokenFlag = true;
+						tokenFromArg = arg.split("=")[1];
 						continue;
 					}
 
 					if (
 						arg.startsWith("--account_id=") ||
-						arg.startsWith("--account-id=")
+						arg.startsWith("--account-id=") ||
+						arg.startsWith("--acc_id=") ||
+						arg.startsWith("--acc-id=")
 					) {
-						hasAccountIdFlag = true;
-						accountIdFromArg = arg.split("=")[1];
+						hasOrgIdFlag = true;
+						orgIdFromArg = arg.split("=")[1];
 						continue;
 					}
 				}
 
-				// If any PAT-related flag is present, delegate to PAT login handler.
+				// If any token-related flag is present, delegate to PAT login handler.
 				// `handlePatLogin` will decide whether to prompt based on which values are provided.
 				if (
-					hasPatFlag ||
-					hasAccountIdFlag ||
-					patFromArg ||
-					accountIdFromArg
+					hasTokenFlag ||
+					hasOrgIdFlag ||
+					tokenFromArg ||
+					orgIdFromArg
 				) {
 					await AuthCommands.handlePatLogin(
-						patFromArg,
-						accountIdFromArg
+						tokenFromArg,
+						orgIdFromArg
 					);
 					return;
 				}
@@ -128,13 +135,15 @@ const createCLI = (consoleUrl, apiUrl, serviceName, env) => {
 			}
 
 			const command = args[2];
-			const subCommand = args.length >= 3 ? args[3] : undefined;
 
-			if (!command) {
+			// Show global help only if no command or command is --help/-h
+			if (!command || command === "--help" || command === "-h") {
 				showHelp(commands);
 				return;
 			}
 
+			const subCommand = args.length >= 3 ? args[3] : undefined;
+
 			if (!commands[command]) {
 				console.log(
 					chalk.bgRed.white("\n ❌ Error ") +
@@ -217,15 +226,41 @@ async function showHelp(commands) {
 	}
 
 	console.log(chalk.bold.yellow(`\nBoltic CLI Version: ${version}\n`));
-	console.log("\nUsage: boltic [command]\n");
-	console.log("Available commands:");
+	console.log(chalk.cyan("Usage:") + " boltic [command] [options]\n");
+
+	console.log(chalk.cyan("Commands:"));
 	Object.keys(commands).forEach((cmd) => {
-		console.log(`  ${cmd} - ${commands[cmd].description}`);
+		console.log(
+			chalk.bold(`  ${cmd.padEnd(15)}`) + commands[cmd].description
+		);
 	});
-	console.log("\nExamples:");
-	console.log("  boltic login");
-	console.log("  boltic integration create");
-	console.log("  boltic help\n");
+
+	console.log(chalk.cyan("\nGlobal Options:"));
+	console.log(
+		chalk.bold("  --help, -h".padEnd(18)) + "Show help for a command"
+	);
+	console.log(chalk.bold("  --verbose".padEnd(18)) + "Enable verbose output");
+
+	console.log(chalk.cyan("\nLogin Options:"));
+	console.log(
+		chalk.bold("  --token <token>".padEnd(18)) + "Personal access token"
+	);
+	console.log(
+		chalk.bold("  --account-id <id>".padEnd(18)) +
+			"Account ID (alias: --acc-id)"
+	);
+
+	console.log(chalk.cyan("\nExamples:"));
+	console.log(chalk.dim("  # Interactive browser login"));
+	console.log("  boltic login\n");
+	console.log(chalk.dim("  # Login with PAT token"));
+	console.log(
+		"  boltic login --token YOUR_TOKEN --account-id YOUR_ACCOUNT_ID\n"
+	);
+	console.log(chalk.dim("  # Get help for serverless commands"));
+	console.log("  boltic serverless --help\n");
+	console.log(chalk.dim("  # Create an integration"));
+	console.log("  boltic integration create\n");
 }
 
 async function handleIntegration(args) {

package/commands/env.js

@@ -23,13 +23,22 @@ const commands = {
 const execute = async (args) => {
 	const subCommand = args[0];
 
-	if (!subCommand) {
+	// Handle help flags
+	if (
+		!subCommand ||
+		subCommand === "--help" ||
+		subCommand === "-h" ||
+		args.includes("--help") ||
+		args.includes("-h")
+	) {
 		showHelp();
 		return;
 	}
 
 	if (!commands[subCommand]) {
-		console.log(chalk.red("Unknown or missing environment sub-command.\n"));
+		console.log(
+			chalk.red(`Unknown environment command: "${subCommand}"\n`)
+		);
 		showHelp();
 		return;
 	}

package/commands/integration.js

@@ -456,13 +456,22 @@ async function handlePublish(args) {
 const execute = async (args) => {
 	const subCommand = args[0];
 
-	if (!subCommand) {
+	// Handle help flags
+	if (
+		!subCommand ||
+		subCommand === "--help" ||
+		subCommand === "-h" ||
+		args.includes("--help") ||
+		args.includes("-h")
+	) {
 		showHelp();
 		return;
 	}
 
 	if (!commands[subCommand]) {
-		console.log(chalk.red("Unknown or missing integration sub-command.\n"));
+		console.log(
+			chalk.red(`Unknown integration command: "${subCommand}"\n`)
+		);
 		showHelp();
 		return;
 	}

package/commands/mcp.js

@@ -22,13 +22,20 @@ const commands = {
 const execute = async (args) => {
 	const subCommand = args[0];
 
-	if (!subCommand) {
+	// Handle help flags
+	if (
+		!subCommand ||
+		subCommand === "--help" ||
+		subCommand === "-h" ||
+		args.includes("--help") ||
+		args.includes("-h")
+	) {
 		showHelp();
 		return;
 	}
 
 	if (!commands[subCommand]) {
-		console.log(chalk.red("Unknown or missing mcp sub-command.\n"));
+		console.log(chalk.red(`Unknown mcp command: "${subCommand}"\n`));
 		showHelp();
 		return;
 	}