@boltic/cli 1.0.6-beta.0 → 1.0.6-beta.11

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,8 +3,8 @@
 > 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 Version](https://img.shields.io/node/v/@boltic/cli)](https://nodejs.org/)
 
 ---
 
@@ -43,17 +43,14 @@ You’ll be prompted to enter:
 - **Name**: Letters and underscores only (e.g., My_Integration)
 - **Icon**: Select an SVG file from your computer
 - **Integration Type**:
-
     - Workflow Activity: Reusable components that perform specific tasks
     - Workflow Trigger: Components that start your workflow based on external events
     - You can choose to create both types for the same integration
 
 - **Descriptions**
-
     - Human-readable and AI-generated
 
 - **Integration Group**
-
     - e.g., Analytics, CRM, ERP, Marketing, Payment, Social Media, Other
 
 ### ✏️ Edit an Integration

package/cli.js

@@ -14,7 +14,8 @@ const createCLI = (consoleUrl, apiUrl, serviceName, env) => {
 	const commands = {
 		login: {
 			description: "Authenticate the user and save access token",
-			action: () => AuthCommands.handleLogin(consoleUrl, apiUrl, env),
+			action: async () =>
+				await AuthCommands.handleLogin(consoleUrl, apiUrl, env),
 		},
 		integration: {
 			description: "Manage integrations (create, list)",
@@ -74,9 +75,10 @@ const createCLI = (consoleUrl, apiUrl, serviceName, env) => {
 				return;
 			}
 
-			// Check if user is authenticated for all commands except login, help, and version
+			// Check if user is authenticated for all commands except login, logout, help, and version
 			if (
 				command !== "login" &&
+				command !== "logout" &&
 				command !== "help" &&
 				command !== "version"
 			) {
@@ -112,7 +114,7 @@ async function showHelp(commands) {
 		packageJson = JSON.parse(
 			fs.readFileSync(path.join(process.cwd(), "package.json"))
 		);
-	} catch (error) {
+	} catch {
 		// Fallback version if package.json not found
 		packageJson = { version: "1.0.0" };
 	}
@@ -139,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 (error) {
-		// 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

@@ -50,6 +50,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 +151,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,
@@ -245,6 +262,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,
@@ -574,7 +604,10 @@ 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 =
@@ -638,7 +671,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 +831,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 +942,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 +1033,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`,
 	};
 

package/helper/validation.js

@@ -154,6 +154,23 @@ const validateResources = (resourcesDir, resourceFields, errors) => {
 	});
 };
 
+// const validateParametersScema = (schema, errors) => {
+// 	if (!schema || !Array.isArray(schema.parameters)) {
+// 		errors.add(
+// 			`Schema is missing or parameters are not defined as an array.`
+// 		);
+// 		return;
+// 	}
+// 	schema.parameters.forEach((param) => {
+// 		const { meta } = param;
+// 		if (!param.name) {
+// 			errors.add(
+// 				`Parameter in schema is missing a name. Ensure all parameters have a "name" field.`
+// 			);
+// 		}
+// 	});
+// };
+
 // ─────────────────────────────────────────────────────────────────────────────
 // MAIN FUNCTION
 // ─────────────────────────────────────────────────────────────────────────────

package/package.json

@@ -1,18 +1,26 @@
 {
 	"name": "@boltic/cli",
-	"version": "1.0.6-beta.0",
+	"version": "1.0.6-beta.11",
 	"description": "A powerful CLI tool for managing Boltic Workflow integrations",
 	"main": "index.js",
 	"bin": {
 		"boltic": "index.js"
 	},
 	"author": "Ahmed Sakri <ahmedsakri@gofynd.com>",
-	"homepage": "https://www.boltic.io",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/bolticio/cli.git"
+	},
+	"homepage": "https://github.com/bolticio/cli#readme",
+	"bugs": {
+		"url": "https://github.com/bolticio/cli/issues"
+	},
 	"scripts": {
 		"start": "node index.js",
 		"dev": "nodemon index.js",
 		"test": "jest",
-		"prepare": "husky"
+		"prepare": "husky",
+		"lint": "eslint . --ext .js,.jsx,.ts,.tsx"
 	},
 	"keywords": [
 		"cli",
@@ -35,7 +43,8 @@
 		"chalk": "^5.3.0",
 		"keytar": "^7.9.0",
 		"open": "^10.1.0",
-		"uuid": "^11.1.0"
+		"uuid": "^11.1.0",
+		"lodash.isempty": "^4.4.0"
 	},
 	"devDependencies": {
 		"@babel/core": "^7.26.9",
@@ -51,7 +60,6 @@
 		"husky": "^9.1.7",
 		"jest": "^29.7.0",
 		"lint-staged": "^15.4.3",
-		"lodash.isempty": "^4.4.0",
 		"nodemon": "^3.1.9",
 		"prettier": "^3.5.3"
 	}

package/templates/schemas.js

@@ -45,10 +45,24 @@ const authentication = {
 	},
 };
 
-const base = (name) => {
-	return {
-		parameters: [
-			{
+const base = (name, create_catalogue) => {
+	const secretParameter = create_catalogue
+		? {
+				name: "secret",
+				meta: {
+					displayName: "Service Account",
+					displayType: "hidden",
+					placeholder: "Select Service Account",
+					description:
+						"Your service account credentials are encrypted & can be removed at any time.",
+					options: [],
+					value: `__BOLTIC_INTEGRATION_${name.toUpperCase()}`,
+					validation: {
+						required: true,
+					},
+				},
+			}
+		: {
 				name: "secret",
 				meta: {
 					displayName: "Service Account",
@@ -72,7 +86,11 @@ const base = (name) => {
 						required: true,
 					},
 				},
-			},
+			};
+
+	return {
+		parameters: [
+			secretParameter,
 			{
 				name: "resource",
 				meta: {

package/utils/integration.js

@@ -39,7 +39,7 @@ async function pickSvgFile() {
 			console.error("Unsupported platform for file picker");
 			return null;
 		}
-	} catch (_) {
+	} catch {
 		return null;
 	}
 }