@boltic/cli 1.0.10 → 1.0.12

package/package.json

@@ -1,35 +1,89 @@
 {
 	"name": "@boltic/cli",
-	"version": "1.0.10",
-	"description": "A powerful CLI tool for managing Boltic Workflow integrations",
+	"version": "1.0.12",
+	"description": "A powerful CLI tool for managing Boltic Workflow integrations - create, sync, test, and publish integrations with ease",
 	"main": "index.js",
 	"bin": {
 		"boltic": "index.js"
 	},
-	"author": "Ahmed Sakri <ahmedsakri@gofynd.com>",
+	"engines": {
+		"node": ">=18.0.0",
+		"npm": ">=8.0.0"
+	},
+	"files": [
+		"index.js",
+		"cli.js",
+		"commands/",
+		"api/",
+		"helper/",
+		"utils/",
+		"config/",
+		"templates/",
+		"README.md",
+		"LICENSE"
+	],
+	"author": {
+		"name": "Ahmed Sakri",
+		"email": "ahmedsakri@gofynd.com",
+		"url": "https://github.com/ahmedsakri"
+	},
+	"contributors": [
+		{
+			"name": "Boltic Team",
+			"url": "https://www.boltic.io"
+		}
+	],
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/bolticio/cli.git"
+		"url": "https://github.com/bolticio/cli.git",
+		"directory": "."
 	},
 	"homepage": "https://github.com/bolticio/cli#readme",
 	"bugs": {
-		"url": "https://github.com/bolticio/cli/issues"
+		"url": "https://github.com/bolticio/cli/issues",
+		"email": "support@boltic.io"
 	},
+	"funding": [
+		{
+			"type": "github",
+			"url": "https://github.com/sponsors/bolticio"
+		}
+	],
 	"scripts": {
 		"start": "node index.js",
 		"dev": "nodemon index.js",
 		"test": "jest",
+		"test:watch": "jest --watch",
+		"test:coverage": "jest --coverage",
 		"prepare": "husky",
-		"lint": "eslint . --ext .js,.jsx,.ts,.tsx"
+		"lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+		"lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"preversion": "npm run lint && npm run test",
+		"postversion": "git push && git push --tags",
+		"prepublishOnly": "npm run lint && npm run test"
 	},
 	"keywords": [
 		"cli",
 		"boltic",
-		"developer-tools",
-		"integration",
 		"workflow",
+		"integration",
 		"automation",
-		"fynd"
+		"developer-tools",
+		"fynd",
+		"integration-builder",
+		"workflow-automation",
+		"api-integration",
+		"no-code",
+		"low-code",
+		"enterprise",
+		"saas",
+		"productivity",
+		"development-tools",
+		"command-line",
+		"javascript",
+		"nodejs"
 	],
 	"license": "ISC",
 	"type": "module",
@@ -37,6 +91,24 @@
 		"access": "public",
 		"registry": "https://registry.npmjs.org/"
 	},
+	"badges": {
+		"npm": "https://img.shields.io/npm/v/@boltic/cli",
+		"downloads": "https://img.shields.io/npm/dm/@boltic/cli",
+		"license": "https://img.shields.io/npm/l/@boltic/cli",
+		"build": "https://github.com/bolticio/cli/actions/workflows/npm-publish.yml/badge.svg",
+		"coverage": "https://img.shields.io/codecov/c/github/bolticio/cli"
+	},
+	"social": {
+		"website": "https://boltic.io",
+		"documentation": "https://docs.boltic.io",
+		"twitter": "https://twitter.com/bolticHQ",
+		"blog": "https://boltic.io/blog"
+	},
+	"config": {
+		"commitizen": {
+			"path": "./node_modules/cz-conventional-changelog"
+		}
+	},
 	"dependencies": {
 		"@inquirer/prompts": "^7.3.2",
 		"axios": "^1.8.2",
@@ -62,5 +134,17 @@
 		"lint-staged": "^15.4.3",
 		"nodemon": "^3.1.9",
 		"prettier": "^3.5.3"
-	}
+	},
+	"peerDependencies": {
+		"node": ">=18.0.0"
+	},
+	"os": [
+		"darwin",
+		"linux",
+		"win32"
+	],
+	"cpu": [
+		"x64",
+		"arm64"
+	]
 }

package/templates/component-schemas.js

@@ -110,6 +110,7 @@ const select = {
 			url: "/api/options",
 			labelKey: "label",
 			valueKey: "value",
+			condition: "{{sample-condition}}",
 			body: {
 				secret: "secret",
 				loadOptionsMethod: "get",
@@ -199,6 +200,7 @@ const autocomplete = {
 			url: "/api/autocomplete",
 			labelKey: "label",
 			valueKey: "value",
+			condition: "{{sample-condition}}",
 			body: {},
 			multiple: false,
 			limitTags: 3,
@@ -675,6 +677,7 @@ const multiselect = {
 			url: "/api/options",
 			labelKey: "label",
 			valueKey: "value",
+			condition: "{{sample-condition}}",
 			body: {},
 		},
 		validation: {
@@ -785,21 +788,10 @@ const multitext = {
 		displayName: "Name",
 		displayType: "multitext",
 		description: "Multiple field container",
+		placeholder: "Enter text",
 		value: [],
 		readOnly: false,
 		isDisabled: false,
-		children: [
-			{
-				name: "field1",
-				meta: {
-					displayType: "text",
-					displayName: "Field 1",
-					validation: {
-						required: true,
-					},
-				},
-			},
-		],
 		htmlProps: {
 			allowAdd: true,
 			allowRemove: true,

package/ahmed_test_cases_test/Authentication.mdx

@@ -1 +0,0 @@
-# Ahmed_Test_Cases_Test Authentication

package/ahmed_test_cases_test/Documentation.mdx

@@ -1 +0,0 @@
-# Ahmed_Test_Cases_Test Documentation

package/ahmed_test_cases_test/schemas/authentication.json

@@ -1,45 +0,0 @@
-{
-    "parameters": [
-        {
-            "name": "type",
-            "meta": {
-                "displayName": "Authentication Type",
-                "displayType": "select",
-                "placeholder": "Select an authentication type",
-                "description": "Choose the type of authentication you want to use.",
-                "options": [
-                    {
-                        "label": "API Key",
-                        "value": "api_key"
-                    }
-                ],
-                "value": "api_key",
-                "validation": {
-                    "required": true,
-                    "requiredDetail": {
-                        "errorMsg": "Authentication type is required"
-                    }
-                }
-            }
-        }
-    ],
-    "api_key": {
-        "parameters": [
-            {
-                "name": "api_key",
-                "meta": {
-                    "displayName": "API Key",
-                    "displayType": "password",
-                    "placeholder": "Enter API Key",
-                    "description": "Your API key for authentication",
-                    "validation": {
-                        "required": true,
-                        "requiredDetail": {
-                            "errorMsg": "API key is required"
-                        }
-                    }
-                }
-            }
-        ]
-    }
-}

package/ahmed_test_cases_test/schemas/base.json

@@ -1,56 +0,0 @@
-{
-    "parameters": [
-        {
-            "name": "secret",
-            "meta": {
-                "displayName": "Service Account",
-                "displayType": "autocomplete",
-                "placeholder": "Select Service Account",
-                "description": "Your service account credentials are encrypted & can be removed at any time.",
-                "options": [],
-                "config": {
-                    "urlType": "secret",
-                    "method": "get",
-                    "url": "/AHMED_TEST_CASES_TEST?current_page=1&page_size=999",
-                    "labelKey": "name",
-                    "valueKey": "_id"
-                },
-                "htmlProps": {
-                    "showAddNew": true
-                },
-                "value": "",
-                "validation": {
-                    "required": true
-                }
-            }
-        },
-        {
-            "name": "resource",
-            "meta": {
-                "displayName": "Resource",
-                "displayType": "select",
-                "placeholder": "Select a resource",
-                "description": "Select the resource you want to work with.",
-                "options": [
-                    {
-                        "label": "Resource 1",
-                        "value": "resource1",
-                        "description": "Description for Resource 1"
-                    }
-                ],
-                "value": "",
-                "validation": {
-                    "required": true
-                },
-                "dependencies": {
-                    "conditions": [
-                        {
-                            "field": "secret",
-                            "operator": "NOT_EMPTY"
-                        }
-                    ]
-                }
-            }
-        }
-    ]
-}

package/ahmed_test_cases_test/schemas/resources/resource1.json

@@ -1,134 +0,0 @@
-{
-    "parameters": [
-        {
-            "name": "operation",
-            "meta": {
-                "displayName": "Operation",
-                "displayType": "select",
-                "placeholder": "Select an operation",
-                "description": "Select the operation you want to perform.",
-                "options": [
-                    {
-                        "label": "Create Account",
-                        "value": "resource1.create",
-                        "description": "Create a new account."
-                    },
-                    {
-                        "label": "Delete Account",
-                        "value": "resource1.delete",
-                        "description": "Delete an existing account."
-                    }
-                ],
-                "validation": {
-                    "required": true
-                },
-                "dependencies": {
-                    "conditions": [
-                        {
-                            "field": "resource",
-                            "operator": "EQUALS",
-                            "value": "resource1"
-                        }
-                    ]
-                }
-            }
-        }
-    ],
-    "create": {
-        "definition": {
-            "method": "post",
-            "url": "https://dummyjson.com/products",
-            "headers": {
-                "ContentType": "application/json"
-            },
-            "body": "{{parameters}}",
-            "response": {
-                "output": "{{response.data}}",
-                "error": {
-                    "message": "{{response.data.errors.message}}",
-                    "code": "{{response.data.errors.code}}"
-                }
-            }
-        },
-        "parameters": [
-            {
-                "name": "name",
-                "meta": {
-                    "displayName": "Product Name",
-                    "displayType": "text",
-                    "placeholder": "Enter the name of the product",
-                    "description": "Enter the name of the product you want to create.",
-                    "validation": {
-                        "required": true
-                    }
-                }
-            },
-            {
-                "name": "description",
-                "meta": {
-                    "displayName": "Product Description",
-                    "displayType": "text",
-                    "placeholder": "Enter the description of the product",
-                    "description": "Enter the description of the product you want to create.",
-                    "validation": {
-                        "required": true
-                    }
-                }
-            },
-            {
-                "name": "price",
-                "meta": {
-                    "displayName": "Product Price",
-                    "displayType": "number",
-                    "placeholder": "Enter the price of the product",
-                    "description": "Enter the price of the product you want to create.",
-                    "validation": {
-                        "required": true
-                    }
-                }
-            },
-            {
-                "name": "discountPercentage",
-                "meta": {
-                    "displayName": "Discount Percentage",
-                    "displayType": "number",
-                    "placeholder": "Enter the discount percentage",
-                    "description": "Enter the discount percentage for the product you want to create.",
-                    "validation": {
-                        "required": true
-                    }
-                }
-            }
-        ]
-    },
-    "delete": {
-        "parameters": [
-            {
-                "name": "id",
-                "meta": {
-                    "displayName": "Account ID",
-                    "displayType": "text",
-                    "placeholder": "Enter the Account ID",
-                    "description": "Enter the ID of the account you want to delete.",
-                    "validation": {
-                        "required": true
-                    }
-                }
-            }
-        ],
-        "definition": {
-            "method": "delete",
-            "url": "https://dummyjson.com/products/{{parameters.id}}",
-            "headers": {
-                "ContentType": "application/json"
-            },
-            "response": {
-                "output": "{{response.data}}",
-                "error": {
-                    "message": "{{response.data.errors.message}}",
-                    "code": "{{response.data.errors.code}}"
-                }
-            }
-        }
-    }
-}

package/ahmed_test_cases_test/spec.json

@@ -1,17 +0,0 @@
-{
-    "id": "766689c4-e6c9-4adf-8b21-f69c3a281307",
-    "name": "Ahmed_Test_Cases_Test",
-    "description": {
-        "trigger": "",
-        "integration": "Sample Test Case Integration"
-    },
-    "icon": "https://cdn.pixelbin.io/v2/fyndcloud/original/Temporal/Uploads/bolt/e8b51f71-6062-4c30-958e-f87351ed13bf/images/Paddle_1752734761014.svg",
-    "activity_type": "customActivity",
-    "trigger_type": null,
-    "meta": {
-        "ai_description": {
-            "trigger": "",
-            "integration": "Sample AI Test Case Integration"
-        }
-    }
-}

package/llm.txt

@@ -1,295 +0,0 @@
-# Boltic CLI - Developer Documentation for AI Assistants
-
-## Overview
-The Boltic CLI is a Node.js command-line interface for managing Boltic Workflow integrations. It provides tools for creating, editing, syncing, and publishing integrations to the Boltic platform.
-
-**Package**: @boltic/cli
-**Repository**: https://github.com/bolticio/cli
-**License**: ISC
-
-## Core Architecture
-
-### Entry Point
-- `index.js` - Main entry point and binary executable
-- `cli.js` - Core CLI module with command routing and execution
-
-### Command Structure
-The CLI follows a modular command structure:
-
-```
-boltic [command] [subcommand] [options]
-```
-
-### Main Commands
-
-#### Authentication Commands (`commands/login.js`)
-- `boltic login` - Authenticate with Boltic platform
-- `boltic logout` - Clear authentication tokens
-
-#### Integration Commands (`commands/integration.js`)
-- `boltic integration create` - Create new integration
-- `boltic integration edit` - Edit existing integration
-- `boltic integration sync` - Sync changes to draft
-- `boltic integration submit` - Submit for review
-- `boltic integration publish` - Submit for review (deprecated, use submit)
-- `boltic integration pull` - Pull latest changes
-- `boltic integration status` - Show integration details
-
-#### Environment Commands (`commands/env.js`)
-- `boltic env list` - List available environments
-- `boltic env set` - Set current environment
-- `boltic env show` - Show current environment
-
-### API Layer (`api/`)
-- `integration.js` - Integration management API calls
-- `login.js` - Authentication API calls
-- `environment.js` - Environment management API calls
-
-### Helper Modules (`helper/`)
-- `validation.js` - Schema validation for integrations
-- `folder.js` - File system operations for integration folders
-- `secure-storage.js` - Secure credential storage using keytar
-- `env.js` - Environment configuration management
-- `error.js` - Error handling and formatting
-- `command-suggestions.js` - Command similarity suggestions
-- `verbose.js` - Verbose logging control
-
-### Templates (`templates/`)
-- `schemas.js` - Schema templates for integrations
-
-### Utilities (`utils/`)
-- `integration.js` - Integration utility functions
-
-## Key Features
-
-### Authentication
-- OAuth-based authentication with secure token storage
-- Multiple environment support (bolt, fcz0, fcz5)
-- Automatic token refresh and session management
-
-### Integration Management
-- **Create**: Interactive creation wizard with prompts for:
-  - Integration name (letters and underscores only)
-  - SVG icon upload
-  - Integration type (Activity, Trigger, or both)
-  - Descriptions (human and AI-generated)
-  - Integration group selection
-- **Edit**: Modify existing integrations
-- **Sync**: Upload changes to draft version
-- **Submit**: Submit integration for review
-- **Publish**: Submit integration for review (deprecated, use submit)
-- **Pull**: Download latest changes from cloud
-- **Status**: View integration details and metadata
-
-### Validation System
-The validation system (`helper/validation.js`) ensures integration schemas are correct:
-
-#### Required Files
-- `Documentation.mdx` - Integration documentation
-- `spec.json` - Integration specification
-- `schemas/base.json` - Base schema configuration
-- `schemas/resources/*.json` - Resource-specific schemas
-- `schemas/webhook.json` - Webhook configuration (if trigger_type defined)
-
-#### Schema Structure
-All option objects must include:
-- `label` - Human-readable label
-- `value` - Machine-readable value
-- `description` - Detailed description
-
-#### Validation Rules
-- Resource fields must reference existing resource files
-- Operation fields must reference valid operations in resource files
-- Operations must have both `parameters` and `definition` properties
-- Webhook configuration must match trigger_type in spec.json
-
-### Environment Configuration
-Three supported environments defined in `config/environments.js`:
-- **bolt** (production): console.boltic.io
-- **fcz0** (staging): fcz0.de
-- **fcz5** (UAT): uat.fcz0.de
-
-### File System Operations
-- Automatic folder structure creation
-- JSON file parsing and validation
-- SVG file handling for icons
-- Resource file management
-
-## Development Workflow
-
-### Testing
-- **Framework**: Jest with comprehensive test coverage
-- **Coverage**: 96.45% statement coverage, 91.68% branch coverage
-- **Test Files**: Located in `__tests__/` directory
-- **Run Tests**: `npm test`
-
-### Code Quality
-- **Linting**: ESLint with Prettier integration
-- **Pre-commit**: Husky hooks with lint-staged
-- **Standards**: ES6+ modules, async/await patterns
-
-### Dependencies
-**Production**:
-- `@inquirer/prompts` - Interactive CLI prompts
-- `axios` - HTTP client for API calls
-- `chalk` - Terminal string styling
-- `keytar` - Secure credential storage
-- `open` - Browser launching
-- `uuid` - Unique identifier generation
-- `lodash.isempty` - Empty value checking
-
-**Development**:
-- `jest` - Testing framework
-- `eslint` - Code linting
-- `prettier` - Code formatting
-- `husky` - Git hooks
-- `nodemon` - Development server
-
-## Common Patterns
-
-### Error Handling
-- Centralized error handling in `helper/error.js`
-- Axios error interception and formatting
-- User-friendly error messages with suggestions
-
-### Async Operations
-- Consistent async/await usage
-- Promise-based API calls
-- Proper error propagation
-
-### User Interaction
-- Interactive prompts using @inquirer/prompts
-- Progress indicators for long operations
-- Color-coded output using chalk
-
-### File Operations
-- Safe JSON parsing with error handling
-- Atomic file operations
-- Directory existence checking
-
-## Configuration
-
-### Schema Templates
-Integration schemas are generated from templates in `templates/schemas.js`:
-- **Authentication**: API key-based authentication
-- **Base**: Core integration configuration
-- **Webhook**: Trigger configuration
-- **Resource**: Resource-specific operations
-
-### Environment Variables
-- Environment selection stored in secure storage
-- API endpoints configured per environment
-- OAuth client IDs per environment
-
-## Security Considerations
-
-### Credential Storage
-- Secure token storage using keytar (OS keychain)
-- No plaintext credential storage
-- Automatic token cleanup on logout
-
-### API Security
-- OAuth 2.0 authentication flow
-- Bearer token authentication
-- Environment-specific API endpoints
-
-### Input Validation
-- Schema validation for all integration files
-- SVG file validation for icons
-- Input sanitization for user prompts
-
-## Troubleshooting
-
-### Common Issues
-1. **Authentication Errors**: Check network connectivity and credentials
-2. **Validation Errors**: Ensure all required schema fields are present
-3. **File System Errors**: Verify file permissions and paths
-4. **API Errors**: Check environment configuration and network
-
-### Debug Mode
-Use `--verbose` flag for detailed logging:
-```bash
-boltic --verbose integration create
-```
-
-### Log Files
-- API calls logged in verbose mode
-- Error stack traces available in debug mode
-- Progress indicators for long operations
-
-## Contributing
-
-### Code Style
-- ES6+ modules with import/export
-- Async/await for asynchronous operations
-- Functional programming patterns where applicable
-- Comprehensive error handling
-
-### Testing Requirements
-- Unit tests for all new features
-- Integration tests for API calls
-- Mocking external dependencies
-- Minimum 95% code coverage
-
-### Documentation
-- JSDoc comments for complex functions
-- README updates for new features
-- Schema documentation for integration formats
-- API documentation for external integrations
-
-## Integration Schema Format
-
-### Base Schema Structure
-```json
-{
-  "parameters": [
-    {
-      "name": "resource",
-      "meta": {
-        "options": [
-          {
-            "value": "users",
-            "label": "Users",
-            "description": "Manage users"
-          }
-        ]
-      }
-    }
-  ]
-}
-```
-
-### Resource Schema Structure
-```json
-{
-  "parameters": [
-    {
-      "name": "operation",
-      "meta": {
-        "options": [
-          {
-            "value": "users.list",
-            "label": "List Users",
-            "description": "List all users"
-          }
-        ]
-      }
-    }
-  ],
-  "list": {
-    "parameters": [],
-    "definition": {}
-  }
-}
-```
-
-### Spec.json Format
-```json
-{
-  "name": "Integration Name",
-  "activity_type": "customActivity",
-  "trigger_type": "webhook" // optional
-}
-```
-
-This documentation provides a comprehensive guide for AI assistants working with the Boltic CLI codebase, covering architecture, features, development practices, and troubleshooting procedures.