@boltic/cli 0.0.1

package/README.md

@@ -0,0 +1,149 @@
+# ⚡ Boltic CLI
+
+> 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)
+[![License](https://img.shields.io/npm/l/@boltic/cli)](./LICENSE)
+[![Node Version](https://img.shields.io/node/v/@boltic/cli)](https://nodejs.org/)
+
+---
+
+## 📦 Installation
+
+Install Boltic CLI globally via NPM:
+
+```bash
+npm install -g @boltic/cli
+```
+
+---
+
+## 🔐 Authentication
+
+To log in:
+
+```bash
+boltic login
+```
+
+Follow the interactive prompt to enter your credentials. Your token will be stored securely for future use.
+
+---
+
+## 🧩 Integration Management
+
+### ➕ Create a New Integration
+
+```bash
+boltic integration create
+```
+
+You’ll be prompted to enter:
+
+- **Name**
+- **Icon URL**
+- **Integration Type**
+
+    - Workflow Activity or Trigger
+
+- **Descriptions**
+
+    - Human-readable and AI-generated
+
+- **Integration Group**
+
+    - e.g., Analytics, CRM, ERP, Marketing, Payment, Social Media, Other
+
+### ✏️ Edit an Integration
+
+```bash
+boltic integration edit
+```
+
+### 🔄 Sync an Integration
+
+```bash
+boltic integration sync
+```
+
+### 🚀 Publish an Integration
+
+```bash
+boltic integration publish
+```
+
+---
+
+## 📌 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                                      |
+
+---
+
+## 🔁 Typical Workflow
+
+```bash
+# Step 1: Authenticate
+boltic login
+
+# Step 2: Start a new integration
+boltic integration create
+
+# Step 3: Save changes
+boltic integration sync
+
+# Step 5: Submit for publishing and review
+boltic integration publish
+
+# Step 6: Pull the latest changes of a integration. Please call this command inside a integration folder.
+boltic integration pull
+
+# Step 7: Use this command if you don't have folder of a particular integration. Please call this command outside of any existing integration folder.
+boltic integration edit
+```
+
+---
+
+## 🛠️ Troubleshooting
+
+### Login Errors
+
+- Make sure you're online and using valid credentials.
+- Retry `boltic login` if your token has expired.
+
+### Integration Issues
+
+- Ensure all required fields (e.g., name, type, icon URL) are filled.
+- Verify the icon URL is publicly accessible.
+- Double-check the selected integration type and group.
+
+---
+
+## 📚 Help
+
+Get help directly in the CLI:
+
+```bash
+# View all commands
+boltic help
+
+# View integration command options
+boltic integration help
+```
+
+Or visit the [Boltic Docs](https://docs.boltic.io) for full documentation.
+
+---
+
+## 🧾 License
+
+MIT © [Boltic](https://boltic.io)

package/api/integration.js

@@ -0,0 +1,469 @@
+import axios from "axios";
+import FormData from "form-data";
+import fs from "fs";
+import { handleError } from "../helper/error.js";
+import { logApi } from "../helper/verbose.js";
+
+const getIntegrationGroups = async (apiUrl, accountId, token, session) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const axiosOptions = {
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integration-groups`,
+			params: {
+				page: 1,
+				per_page: 999,
+			},
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		};
+
+		const response = await axios(axiosOptions);
+		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const listAllIntegrations = async (apiUrl, token, accountId, session) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const axiosOptions = {
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations`,
+			params: {
+				page: 1,
+				per_page: 999,
+			},
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		};
+
+		const response = await axios(axiosOptions);
+		logApi(axiosOptions.method, axiosOptions.url, response.status);
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const saveIntegration = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integration
+) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const response = await axios({
+			method: "post",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations`,
+			data: integration,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const editIntegration = async (apiUrl, token, accountId, session, payload) => {
+	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); // Exit the CLI with an error code
+	}
+	const { id } = payload;
+	try {
+		const response = await axios({
+			method: "post",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${id}/edit`,
+			data: payload,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const updateIntegration = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integration
+) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const { id, ...rest } = integration;
+		const response = await axios({
+			method: "patch",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${id}`,
+			data: rest,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getIntegrationById = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integrationId
+) => {
+	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); // Exit the CLI with an error code
+	}
+
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${integrationId}`,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getAuthenticationByIntegrationId = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integrationId
+) => {
+	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); // Exit the CLI with an error code
+	}
+
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}integrations/${integrationId}/authentication`,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getWebhooksByIntegrationId = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integrationId
+) => {
+	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); // Exit the CLI with an error code
+	}
+
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}integrations/${integrationId}/webhooks`,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getConfigurationByIntegrationId = async (
+	apiUrl,
+	token,
+	session,
+	accountId,
+	integrationId
+) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}integrations/${integrationId}/configuration`,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const syncIntegration = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integration
+) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const response = await axios({
+			method: "post",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${integration.integration_id}/deploy`,
+			data: integration,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const sendIntegrationForReview = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	integration
+) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const response = await axios({
+			method: "post",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integration-reviews`,
+			data: integration,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const purgeCache = async (apiUrl, token, accountId, session, integration) => {
+	const { integration_id } = integration;
+	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); // Exit the CLI with an error code
+	}
+
+	try {
+		const response = await axios({
+			method: "post",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${integration_id}/cache`,
+			data: {},
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+		return response.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const pullIntegration = async (apiUrl, token, accountId, session, id) => {
+	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); // Exit the CLI with an error code
+	}
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/panel/temporal/v1.0/${accountId}/integrations/${id}/pull`,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`,
+				Cookie: session,
+			},
+		});
+
+		return response.data.data;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const uploadFileToCloud = async (
+	apiUrl,
+	token,
+	accountId,
+	session,
+	filePath
+) => {
+	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);
+	}
+
+	if (!fs.existsSync(filePath)) {
+		throw new Error("File does not exist: " + filePath);
+	}
+
+	try {
+		const form = new FormData();
+		form.append("files", fs.createReadStream(filePath));
+
+		const response = await axios.post(
+			`${apiUrl}/service/panel/temporal/v1.0/${accountId}/utility/upload`,
+			form,
+			{
+				headers: {
+					...form.getHeaders(),
+					Authorization: `Bearer ${token}`,
+					Cookie: session,
+				},
+			}
+		);
+
+		return response.data?.data?.[0];
+	} catch (error) {
+		console.error(
+			"❌ Upload failed:",
+			error?.response?.data || error.message
+		);
+		throw error;
+	}
+};
+export {
+	editIntegration,
+	getAuthenticationByIntegrationId,
+	getConfigurationByIntegrationId,
+	getIntegrationById,
+	getIntegrationGroups,
+	getWebhooksByIntegrationId,
+	listAllIntegrations,
+	pullIntegration,
+	purgeCache,
+	saveIntegration,
+	sendIntegrationForReview,
+	syncIntegration,
+	updateIntegration,
+	uploadFileToCloud,
+};

package/api/login.js

@@ -0,0 +1,50 @@
+import axios from "axios";
+import { handleError } from "../helper/error.js";
+
+const getProductAccounts = async (consoleUrl, token, orgId) => {
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${consoleUrl}/service/platform/payment/v1/productAccounts?orgId=${orgId}`,
+			headers: {
+				Cookie: `fc.session=${token}`,
+			},
+		});
+		return response;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getCliSession = async (apiUrl, requestCode) => {
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/auth/v1.0/authentication/cli/${requestCode}`,
+			headers: {
+				"Content-Type": "application/json",
+			},
+		});
+		return response;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+const getCliBearerToken = async (apiUrl, account_id, session) => {
+	try {
+		const response = await axios({
+			method: "get",
+			url: `${apiUrl}/service/web/token/${account_id}`,
+			headers: {
+				"Content-Type": "application/json",
+				Cookie: `bolt.session=${session}`,
+			},
+		});
+		return response;
+	} catch (error) {
+		handleError(error);
+	}
+};
+
+export { getCliBearerToken, getCliSession, getProductAccounts };