Bots.Business VS Code Extension

A powerful VS Code extension for seamless integration with the Bots.Business platform, providing file-first development workflow with automatic synchronization.

🚀 Features

Core Functionality

File-First Design: commands/**/*.js files are the source of truth
Automatic Synchronization: Save files to automatically upload to Bots.Business API
Bot Management: Easy bot selection and configuration
Command Metadata: Command IDs stored in CMD-blocks within files

Advanced Features

CRUD Synchronization: Complete Create, Read, Update, Delete operations
Bot Validation: Automatic bot ID validation with user-friendly dialogs
Unlink Functionality: Complete bot unlinking with cleanup of all IDs
GitHub Integration: Full GitHub repository management with Personal Access Tokens
Library Management: Create, delete, and validate library files
Professional UI: Clean submenu interface with VS Code codicons

🛠️ Requirements

VS Code 1.105.0 or higher
Node.js 22.x for development
Bots.Business account and API access
vsce package for VSIX creation (install with npm install -g @vscode/vsce)

🎯 Quick Start

Install the extension from VS Code Marketplace
Open Command Palette (Ctrl+Shift+P)
Run "Bots.Business: Login" to authenticate
Run "Bots.Business: Set Bot ID" to configure your bot
Start developing - your files will sync automatically!

📚 Documentation

Developer Guide - Complete development documentation
QA Testing Guide - Manual testing procedures
API Reference - Bots.Business API documentation
Architecture - Project architecture overview

🧪 Testing

The extension includes comprehensive test coverage using the official VS Code testing framework:

Unit Tests: Individual command functionality
Integration Tests: Full workflow testing with VS Code Extension Host
Test Configuration: Uses @vscode/test-cli with .vscode-test.mjs configuration
Mocha Integration: Tests run under Mocha with VS Code API access

Run tests:

npm test

Debug tests in VS Code:

Press F5 to launch Extension Development Host
Use "Test: Run All Tests" or "Test: Debug All Tests" commands

🔧 Development

Setup

npm ci
npm run package
# F5 to run Extension Development Host

Build & Lint

npm run lint          # Check code style
npm run lint:fix      # Fix code style issues
npm run check-types   # TypeScript type checking
npm run compile       # Build extension
npm run package       # Production build

Watch Mode

npm run watch         # Watch for changes and rebuild

VSIX Packaging

# Install vsce globally first
npm install -g @vscode/vsce

# Create VSIX package
npm run package:vsix

Available Scripts

Script	Description
`check-types`	TypeScript type checking
`lint`	ESLint validation
`lint:fix`	ESLint with auto-fix
`compile`	Build extension with esbuild
`package`	Production build
`test`	Run tests with @vscode/test-cli
`compile-tests`	Compile test files
`watch`	Watch mode for development
`watch:esbuild`	Watch esbuild only
`watch:tsc`	Watch TypeScript only
`package:vsix`	Create VSIX package

📝 Release Notes

2.0.1

Updated to VS Code 1.105.0 compatibility
Migrated to @vscode/test-cli for testing
Updated dependencies to latest versions
Improved build system with esbuild
Enhanced ESLint configuration

2.0.0

Complete rewrite with modern architecture
File-first development workflow
Automatic synchronization with Bots.Business API
Comprehensive test coverage
Professional UI with VS Code codicons

Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.