@boltic/cli 1.0.6-beta.1 → 1.0.6-beta.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Boltic.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -3,7 +3,9 @@
 > A powerful CLI tool for creating, managing, and publishing Boltic integrations.
 
 [![NPM Version](https://img.shields.io/npm/v/@boltic/cli)](https://www.npmjs.com/package/@boltic/cli)
+[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-blue?logo=github)](https://github.com/<your-username>/<your-repo>)
 [![License](https://img.shields.io/npm/l/@boltic/cli)](./LICENSE)
+[![Node.js Package](https://github.com/bolticio/cli/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/bolticio/cli/actions/workflows/npm-publish.yml)
 
 ---
 
@@ -64,26 +66,26 @@ boltic integration edit
 boltic integration sync
 ```
 
-### 🚀 Publish an Integration
+### 🚀 Submit an Integration
 
 ```bash
-boltic integration publish
+boltic integration submit
 ```
 
 ---
 
 ## 📌 Command Reference
 
-| Command                      | Description                                              |
-| ---------------------------- | -------------------------------------------------------- |
-| `boltic login`               | Authenticate with Boltic                                 |
-| `boltic integration create`  | Create a new integration                                 |
-| `boltic integration sync`    | Sync changes to your draft                               |
-| `boltic integration publish` | Submit integration for review                            |
-| `boltic integration pull`    | Pull the latest changes of an integration from the Cloud |
-| `boltic integration edit`    | Edit an existing integration                             |
-| `boltic help`                | Show CLI help                                            |
-| `boltic version`             | Display CLI version                                      |
+| Command                     | Description                                              |
+| --------------------------- | -------------------------------------------------------- |
+| `boltic login`              | Authenticate with Boltic                                 |
+| `boltic integration create` | Create a new integration                                 |
+| `boltic integration sync`   | Sync changes to your draft                               |
+| `boltic integration submit` | Submit integration for review                            |
+| `boltic integration pull`   | Pull the latest changes of an integration from the Cloud |
+| `boltic integration edit`   | Edit an existing integration                             |
+| `boltic help`               | Show CLI help                                            |
+| `boltic version`            | Display CLI version                                      |
 
 ---
 
@@ -100,7 +102,7 @@ boltic integration create
 boltic integration sync
 
 # Step 5: Submit for publishing and review
-boltic integration publish
+boltic integration submit
 
 # Step 6: Pull the latest changes of a integration. Please call this command inside a integration folder.
 boltic integration pull

package/cli.js

@@ -114,7 +114,7 @@ async function showHelp(commands) {
 		packageJson = JSON.parse(
 			fs.readFileSync(path.join(process.cwd(), "package.json"))
 		);
-	} catch (_) {
+	} catch {
 		// Fallback version if package.json not found
 		packageJson = { version: "1.0.0" };
 	}
@@ -141,17 +141,25 @@ async function handleEnvironment(args) {
 }
 
 async function showVersion() {
-	let packageJson;
+	let version = "1.0.0"; // default fallback
 	try {
-		// Try to read package.json from current directory
-		packageJson = JSON.parse(
-			fs.readFileSync(path.join(process.cwd(), "package.json"))
+		let packageJsonPath;
+		if (typeof import.meta !== "undefined" && import.meta.url) {
+			// ES modules in Node.js
+			const currentDir = path.dirname(new URL(import.meta.url).pathname);
+			packageJsonPath = path.join(currentDir, "package.json");
+		} else {
+			// Jest or other environments
+			packageJsonPath = path.join(process.cwd(), "package.json");
+		}
+
+		const packageJson = JSON.parse(
+			fs.readFileSync(packageJsonPath, "utf-8")
 		);
-	} catch (_) {
-		// Fallback version if package.json not found
-		packageJson = { version: "1.0.0" };
+		version = packageJson.version;
+	} catch {
+		// fallback already defined
 	}
-	const version = packageJson.version;
 	console.log(`Boltic CLI Version: ${version}`);
 }
 

package/commands/integration.js

@@ -34,8 +34,12 @@ const commands = {
 		description: "Edit an existing integration",
 		action: handleEdit,
 	},
+	submit: {
+		description: "Submit an integration for review",
+		action: handleSubmit,
+	},
 	publish: {
-		description: "Publish an integration",
+		description: "Publish an integration (deprecated, use submit)",
 		action: handlePublish,
 	},
 	sync: {
@@ -50,6 +54,10 @@ const commands = {
 		description: "Show detailed information about an integration",
 		action: handleStatus,
 	},
+	test: {
+		description: "Run tests for the integration",
+		action: handleTest,
+	},
 	help: {
 		description: "Show help for integration commands",
 		action: showHelp,
@@ -147,6 +155,19 @@ async function handleSync(args) {
 	if (fs.existsSync(specPath)) {
 		const specContent = JSON.parse(fs.readFileSync(specPath, "utf8"));
 		// Update integration with spec.json content
+
+		if (
+			specContent.trigger_type &&
+			specContent.trigger_type !== "CloudTrigger"
+		) {
+			console.error(
+				chalk.red(
+					`Error: Invalid trigger_type "${specContent.trigger_type}". It should be "CloudTrigger" or null.`
+				)
+			);
+			return;
+		}
+
 		const updatedIntegration = await updateIntegration(
 			apiUrl,
 			token,
@@ -219,8 +240,8 @@ async function handleSync(args) {
 }
 
 // Publish an integration
-async function handlePublish(args) {
-	console.log(chalk.green("Publishing integration...\n"));
+async function handleSubmit(args) {
+	console.log(chalk.green("Submitting integration for review...\n"));
 	// Parse command line arguments
 	let currentDir = process.cwd();
 	const pathIndex = args.indexOf("--path");
@@ -245,6 +266,19 @@ async function handlePublish(args) {
 	if (fs.existsSync(specPath)) {
 		const specContent = JSON.parse(fs.readFileSync(specPath, "utf8"));
 		// Update integration with spec.json content
+
+		if (
+			specContent.trigger_type &&
+			specContent.trigger_type !== "CloudTrigger"
+		) {
+			console.error(
+				chalk.red(
+					`Error: Invalid trigger_type "${specContent.trigger_type}". It should be "CloudTrigger" or null.`
+				)
+			);
+			return;
+		}
+
 		const updatedIntegration = await updateIntegration(
 			apiUrl,
 			token,
@@ -317,18 +351,32 @@ async function handlePublish(args) {
 			if (review) {
 				console.log(
 					chalk.green(
-						"\n✅ Integration sent to review successfully!\n"
+						"\n✅ Integration submitted for review successfully!\n"
 					)
 				);
 			}
 		} else {
 			console.error(
-				chalk.red("\n❌ Error publishing integration:", data.message)
+				chalk.red("\n❌ Error submitting integration:", data.message)
 			);
 		}
 	}
 }
 
+async function handlePublish(args) {
+	console.log(
+		chalk.yellow(
+			"⚠️  WARNING: The 'publish' command is deprecated and will be removed in a future version."
+		)
+	);
+	console.log(
+		chalk.yellow("Please use 'boltic integration submit' instead.\n")
+	);
+
+	// Call the new submit function
+	await handleSubmit(args);
+}
+
 // Execute the integration command
 const execute = async (args) => {
 	const subCommand = args[0];
@@ -574,17 +622,20 @@ async function handleCreate() {
 				);
 
 				// Create folder structure with the integration name
-				await createIntegrationFolderStructure(integration);
+				await createIntegrationFolderStructure(
+					integration,
+					create_catalogue
+				);
 
-				// Also share Documentation URL to the user: https://docs.boltic.io/docs/integration-builder/develop/boilerplate
 				const documentationUrl =
 					"https://docs.boltic.io/docs/integration-builder/develop/boilerplate";
+
 				console.log(
 					chalk.cyan(
-						"\n📄 Documentation URL: " +
-							chalk.underline.blue(documentationUrl)
+						`📄 For detailed instructions on next steps, refer to the official documentation:`
 					)
 				);
+				console.log(chalk.underline.blue(documentationUrl));
 			}
 		} catch (error) {
 			console.error(
@@ -638,7 +689,12 @@ async function handleEdit() {
 		const choices =
 			integrations
 				.filter((integration) =>
-					["customActivity", "CloudTrigger"].includes(
+					[
+						"customActivity",
+						"CloudTrigger",
+						"applicationFdkActivity",
+						"platformFdkActivity",
+					].includes(
 						integration.activity_type || integration.trigger_type
 					)
 				)
@@ -793,7 +849,12 @@ async function handlePull(args) {
 			const choices =
 				integrations
 					.filter((integration) =>
-						["customActivity", "CloudTrigger"].includes(
+						[
+							"customActivity",
+							"CloudTrigger",
+							"applicationFdkActivity",
+							"platformFdkActivity",
+						].includes(
 							integration.activity_type ||
 								integration.trigger_type
 						)
@@ -899,7 +960,12 @@ async function handleStatus() {
 		const choices =
 			integrations
 				.filter((integration) =>
-					["customActivity", "CloudTrigger"].includes(
+					[
+						"customActivity",
+						"CloudTrigger",
+						"applicationFdkActivity",
+						"platformFdkActivity",
+					].includes(
 						integration.activity_type || integration.trigger_type
 					)
 				)
@@ -985,6 +1051,100 @@ async function handleStatus() {
 	}
 }
 
+async function handleTest(args) {
+	// Parse command line arguments
+	let currentDir = process.cwd();
+	const pathIndex = args.indexOf("--path");
+
+	if (pathIndex !== -1 && args[pathIndex + 1]) {
+		currentDir = args[pathIndex + 1];
+		// Validate the provided path
+		if (!fs.existsSync(currentDir)) {
+			console.error(
+				chalk.red(
+					`Error: The specified path does not exist: ${currentDir}`
+				)
+			);
+			return;
+		}
+	}
+
+	const { spawn } = await import("child_process");
+
+	console.log(chalk.cyan.bold("\n🧪 Running integration tests...\n"));
+
+	// Look for test directory
+	const testDirs = ["test", "tests", "__tests__"];
+	let testDir = null;
+
+	for (const dir of testDirs) {
+		if (fs.existsSync(dir)) {
+			testDir = dir;
+			break;
+		}
+	}
+
+	if (!testDir) {
+		console.log(
+			chalk.yellow(
+				"⚠️  No test directory found. Looked for: test, tests, __tests__"
+			)
+		);
+		return;
+	}
+
+	console.log(chalk.dim(`📁 Found test directory: ${testDir}`));
+
+	// Check if Jest is available
+	const packageJsonPath = path.join(process.cwd(), "package.json");
+	let hasJest = false;
+
+	if (fs.existsSync(packageJsonPath)) {
+		try {
+			const packageJson = JSON.parse(
+				fs.readFileSync(packageJsonPath, "utf-8")
+			);
+			hasJest = !!(
+				packageJson.devDependencies?.jest ||
+				packageJson.dependencies?.jest
+			);
+		} catch (error) {
+			console.log(chalk.yellow("⚠️  Could not read package.json"));
+		}
+	}
+
+	if (!hasJest) {
+		console.log(
+			chalk.red(
+				"❌ Jest is not installed. Please install Jest to run tests."
+			)
+		);
+		return;
+	}
+
+	// Run Jest with the test directory
+	return new Promise((resolve, reject) => {
+		const jestProcess = spawn("npx", ["jest", testDir, "--verbose"], {
+			stdio: "inherit",
+			shell: true,
+		});
+
+		jestProcess.on("close", (code) => {
+			if (code === 0) {
+				console.log(chalk.green.bold("\n✅ All tests passed!"));
+			} else {
+				console.log(chalk.red.bold("\n❌ Some tests failed."));
+			}
+			resolve(code);
+		});
+
+		jestProcess.on("error", (error) => {
+			console.error(chalk.red("❌ Error running tests:"), error.message);
+			reject(error);
+		});
+	});
+}
+
 export default {
 	execute,
 };

package/commands/login.js

@@ -40,7 +40,7 @@ function showHelp() {
 }
 
 // Handle login command
-async function handleLogin(args) {
+async function handleLogin() {
 	const { apiUrl, loginUrl, clientId, frontendUrl, name } =
 		await getCurrentEnv();
 

package/helper/env.js

@@ -11,7 +11,7 @@ export const getCurrentEnv = async () => {
 
 	try {
 		secrets = await getAllSecrets();
-	} catch (_) {
+	} catch {
 		// If getAllSecrets fails, use default bolt environment
 		secrets = null;
 	}

package/helper/folder.js

@@ -9,7 +9,10 @@ import {
 	webhook,
 } from "../templates/schemas.js";
 
-export const createIntegrationFolderStructure = async (integration) => {
+export const createIntegrationFolderStructure = async (
+	integration,
+	create_catalogue
+) => {
 	const { id, name, description, icon, activity_type, trigger_type, meta } =
 		integration;
 
@@ -47,13 +50,25 @@ export const createIntegrationFolderStructure = async (integration) => {
 	// Create template files
 	const files = {
 		"schemas/resources/resource1.json": JSON.stringify(resource1, null, 4),
-		"schemas/authentication.json": JSON.stringify(authentication, null, 4),
-		"schemas/base.json": JSON.stringify(base(name), null, 4),
+		...(create_catalogue && {
+			"schemas/authentication.json": JSON.stringify(
+				authentication,
+				null,
+				4
+			),
+		}),
+		"schemas/base.json": JSON.stringify(
+			base(name, create_catalogue),
+			null,
+			4
+		),
 		...(!isEmpty(trigger_type) && {
 			"schemas/webhook.json": JSON.stringify(webhook(name), null, 4),
 		}),
 		"spec.json": JSON.stringify(spec, null, 4),
-		"Authentication.mdx": `# ${name} Authentication`,
+		...(create_catalogue && {
+			"Authentication.mdx": `# ${name} Authentication`,
+		}),
 		"Documentation.mdx": `# ${name} Documentation`,
 	};