@botim/botim-cli 0.1.3 → 0.1.6

package/dist/templates/templates/react/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@botim/react-mp-template",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host",
+    "build": "vite build",
+    "preview": "vite preview",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit --skipLibCheck",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@botim/bootstrap-mp": "^1.1.1",
+    "@botim/bot": "^2.1.0",
+    "@botim/bot-plus": "^2.1.0",
+    "@botim/bridge": "57.0.1",
+    "@botim/buckit2-icons": "^1.0.3",
+    "@botim/buckit2-react": "^1.0.27",
+    "@botim/buckit2-resolver": "^0.0.1",
+    "@botim/framework": "^1.1.1",
+    "@botim/interceptors": "^0.2.0",
+    "@botim/login": "^1.0.6",
+    "@botim/react-sentry": "^0.0.5",
+    "@botim/report": "^1.0.5",
+    "@botim/request": "^0.0.3",
+    "@botim/sentry": "^0.2.3",
+    "@botim/unplugin-sentry": "^0.2.2",
+    "@emotion/react": "^11.11.0",
+    "@emotion/styled": "^11.11.0",
+    "@readme/http-status-codes": "^9.0.2",
+    "@sentry/react": "^9.30.0",
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "axios": "^1.9.0",
+    "classnames": "^2.5.1",
+    "crypto-js": "^4.2.0",
+    "date-fns": "^4.1.0",
+    "dayjs": "^1.11.13",
+    "i18next": "^25.3.6",
+    "js-sha256": "^0.9.0",
+    "jsencrypt": "^3.3.2",
+    "lodash-es": "^4.17.21",
+    "lottie-react": "^2.4.1",
+    "node-rsa": "^1.1.1",
+    "query-string": "^9.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-i18next": "^15.6.1",
+    "react-router-dom": "^6.11.2",
+    "tslib": "^2.8.1",
+    "vconsole": "^3.15.1",
+    "vite-tsconfig-paths": "^5.1.4",
+    "webpack": "^5.99.9",
+    "zustand": "^4.3.8"
+  },
+  "devDependencies": {
+    "@botim/unplugin-mp": "^0.1.28",
+    "@emotion/babel-plugin": "^11.13.5",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.34.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/minimatch": "^6.0.0",
+    "@types/node": "^20.2.5",
+    "@types/node-rsa": "^1.1.4",
+    "@types/react": "^18.2.7",
+    "@types/react-dom": "^18.2.4",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "@typescript-eslint/types": "^8.40.0",
+    "@typescript-eslint/utils": "^8.40.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "eslint": "^9.34.0",
+    "eslint-import-resolver-alias": "^1.1.2",
+    "eslint-import-resolver-typescript": "^4.3.4",
+    "eslint-plugin-better-styled-components": "^1.1.2",
+    "eslint-plugin-i18next": "^6.1.3",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-no-secrets": "^2.2.1",
+    "eslint-plugin-no-unsanitized": "^4.1.2",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.1",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-unicorn": "^59.0.0",
+    "fs-extra": "^11.3.0",
+    "globals": "^16.0.0",
+    "husky": "^8.0.0",
+    "jiti": "^2.4.2",
+    "lint-staged": "^9.5.0",
+    "semver": "^7.7.1",
+    "simple-git": "^3.27.0",
+    "typescript": "^5.0.4",
+    "typescript-eslint": "^8.41.0",
+    "unplugin-auto-import": "^19.1.2",
+    "vite": "5.4.8",
+    "vite-plugin-vconsole": "^2.1.1",
+    "vitest": "^3.2.4"
+  }
+}

package/dist/templates/templates/react/scripts/setup.sh

@@ -0,0 +1,304 @@
+#!/bin/bash
+
+# Botim CLI and MCP Setup Script
+# This script automates the installation of Botim CLI and configuration of MCP servers
+# Usage: ./setup.sh [BOTIM_MP_URL]
+# Example: ./setup.sh http://localhost:3002/mcp
+
+set -e  # Exit on error
+
+# Default MCP URL
+DEFAULT_BOTIM_MP_MCP_URL="http://botim-mcp-aeuat1.k8s-aeuat1.uae-azure.ops.algento.com/mcp"
+BOTIM_MP_MCP_URL="http://botim-mcp-aeuat1.k8s-aeuat1.uae-azure.ops.algento.com/mcp"
+
+# Hosts entries to add
+HOSTS_ENTRIES=(
+    "10.37.80.6 botim-mcp-aeuat1.k8s-aeuat1.uae-azure.ops.algento.com"
+)
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Function to print colored messages
+print_success() {
+    echo -e "${GREEN}✓ $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}✗ $1${NC}"
+}
+
+print_info() {
+    echo -e "${BLUE}ℹ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠ $1${NC}"
+}
+
+print_header() {
+    echo -e "\n${BLUE}═══════════════════════════════════════════════════════${NC}"
+    echo -e "${BLUE}  $1${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════════════════════${NC}\n"
+}
+
+# Function to check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Function to configure /etc/hosts entries
+configure_hosts() {
+    print_header "Step 1: Configuring /etc/hosts"
+
+    HOSTS_FILE="/etc/hosts"
+
+    for entry in "${HOSTS_ENTRIES[@]}"; do
+        IP=$(echo "$entry" | awk '{print $1}')
+        HOSTNAME=$(echo "$entry" | awk '{print $2}')
+
+        # Check if entry already exists
+        if grep -q "$HOSTNAME" "$HOSTS_FILE" 2>/dev/null; then
+            print_info "Host entry for $HOSTNAME already exists"
+        else
+            print_info "Adding host entry: $entry"
+
+            # Add entry to /etc/hosts (requires sudo)
+            if echo "$entry" | sudo tee -a "$HOSTS_FILE" > /dev/null; then
+                print_success "Added: $IP -> $HOSTNAME"
+            else
+                print_error "Failed to add host entry. Please add manually:"
+                echo "  sudo sh -c 'echo \"$entry\" >> /etc/hosts'"
+            fi
+        fi
+    done
+
+    print_success "Hosts configuration completed"
+}
+
+# Function to install Botim CLI
+install_botim_cli() {
+    print_header "Step 2: Installing Botim CLI"
+    
+    if ! command_exists npm; then
+        print_error "npm is not installed. Please install Node.js and npm first."
+        exit 1
+    fi
+    
+    print_info "Installing botim-cli globally..."
+
+    if sudo npm i -g @botim/botim-cli; then
+        print_success "Botim CLI installed successfully"
+    else
+        print_error "Failed to install Botim CLI."
+        print_info "Please ensure you have npm registry access configured."
+        exit 1
+    fi
+    
+    # Verify installation
+    if command_exists botim; then
+        BOTIM_VERSION=$(botim --version 2>/dev/null || echo "unknown")
+        print_success "Botim CLI is ready (version: $BOTIM_VERSION)"
+    else
+        print_warning "Botim CLI installed but not found in PATH. You may need to restart your terminal."
+    fi
+}
+
+# Function to configure MCP servers
+configure_mcp_servers() {
+    print_header "Step 3: Configuring MCP Servers"
+    
+    CLAUDE_CONFIG="$HOME/.claude.json"
+    
+    # Check if Claude config exists
+    if [ ! -f "$CLAUDE_CONFIG" ]; then
+        print_warning "Claude configuration file not found at $CLAUDE_CONFIG"
+        read -p "Would you like to create it? (y/n): " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            echo '{}' > "$CLAUDE_CONFIG"
+            print_success "Created new Claude configuration file"
+        else
+            print_error "Cannot proceed without Claude configuration file"
+            exit 1
+        fi
+    fi
+    
+    print_info "Backing up existing configuration..."
+    cp "$CLAUDE_CONFIG" "${CLAUDE_CONFIG}.backup.$(date +%Y%m%d_%H%M%S)"
+    print_success "Backup created"
+    
+    print_info "Adding MCP server configuration..."
+    
+    # Use Node.js to safely update JSON
+    CLAUDE_CONFIG="$CLAUDE_CONFIG" BOTIM_MP_MCP_URL="$BOTIM_MP_MCP_URL" node - <<'NODESCRIPT'
+const fs = require('fs');
+const configFile = process.env.CLAUDE_CONFIG;
+const botimMpUrl = process.env.BOTIM_MP_MCP_URL;
+
+let config = {};
+
+// Read existing config
+try {
+    const content = fs.readFileSync(configFile, 'utf8');
+    if (content.trim()) {
+        config = JSON.parse(content);
+    }
+} catch (error) {
+    // If file doesn't exist or is invalid, start with empty object
+    config = {};
+}
+
+// Add or update mcpServers
+if (!config.mcpServers) {
+    config.mcpServers = {};
+}
+
+config.mcpServers['botim-figma-mcp'] = {
+    type: 'http',
+    url: 'https://mcp.figma.com/mcp'
+};
+
+config.mcpServers['botim-mp-mcp'] = {
+    type: 'http',
+    url: botimMpUrl
+};
+
+// Write updated config
+fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + '\n', 'utf8');
+
+console.log('MCP servers configured successfully');
+NODESCRIPT
+    
+    if [ $? -eq 0 ]; then
+        print_success "MCP servers configured in $CLAUDE_CONFIG"
+    else
+        print_error "Failed to configure MCP servers"
+        exit 1
+    fi
+}
+
+# Function to verify MCP setup
+verify_mcp_setup() {
+    print_header "Step 4: Verification"
+    
+    print_info "Checking Claude configuration..."
+    
+    if grep -q "botim-figma-mcp" "$HOME/.claude.json" && grep -q "botim-mp-mcp" "$HOME/.claude.json"; then
+        print_success "MCP servers found in configuration"
+    else
+        print_error "MCP servers not properly configured"
+        exit 1
+    fi
+    
+    print_info "\nConfiguration summary:"
+    echo "  • Botim CLI: Installed"
+    echo "  • MCP Servers: Configured"
+    echo "    - botim-figma-mcp: https://mcp.figma.com/mcp"
+    echo "    - botim-mp-mcp: $BOTIM_MP_MCP_URL"
+}
+
+# Function to display next steps
+display_next_steps() {
+    print_header "Next Steps"
+    
+    echo "1. Restart Claude Desktop to load the new MCP configuration"
+    echo ""
+    echo "2. In Claude Desktop, type: /mcp list"
+    echo "   You should see both MCP servers listed"
+    echo ""
+    echo "3. Authorize Figma MCP:"
+    echo "   - Select 'botim-figma-mcp' from the list"
+    echo "   - Click 'Authorize' when prompted"
+    echo "   - Complete the authorization flow"
+    echo ""
+    echo "4. Ensure the botim-mp-mcp server is running:"
+    echo "   - The server should be accessible at $BOTIM_MP_MCP_URL"
+    echo ""
+    echo "5. Install Botim Claude Plugin:"
+    echo "   - In Claude Desktop, type:"
+    echo "     /plugin marketplace add git@gitlab.corp.algento.com:open-platform/mp-templates/botim-mp-plugin.git"
+    echo ""
+    echo "   - Then install the plugin:"
+    echo "     /plugin install botim-mp"
+    echo ""
+    print_success "Setup completed successfully!"
+    echo ""
+    print_info "Run 'botim --help' to see available commands"
+}
+
+# Main execution
+main() {
+    clear
+    print_header "Botim CLI and MCP Setup"
+    
+    # Check if URL was passed as argument
+    if [ -n "$1" ]; then
+        BOTIM_MP_MCP_URL="$1"
+        print_info "Using provided Botim MP MCP URL: $BOTIM_MP_MCP_URL"
+    else
+        print_info "Botim MP MCP URL Configuration"
+        echo ""
+        read -p "Enter Botim MP MCP URL (press Enter for default: $DEFAULT_BOTIM_MP_MCP_URL): " USER_INPUT
+        
+        if [ -z "$USER_INPUT" ]; then
+            BOTIM_MP_MCP_URL="$DEFAULT_BOTIM_MP_MCP_URL"
+            print_info "Using default URL: $BOTIM_MP_MCP_URL"
+        else
+            BOTIM_MP_MCP_URL="$USER_INPUT"
+            print_success "Using custom URL: $BOTIM_MP_MCP_URL"
+        fi
+    fi
+    
+    echo ""
+    echo "This script will:"
+    echo "  1. Configure /etc/hosts entries"
+    echo "  2. Install Botim CLI globally"
+    echo "  3. Configure MCP servers in Claude"
+    echo "  4. Verify the installation"
+    echo ""
+    echo "Configuration:"
+    echo "  • Botim Figma MCP: https://mcp.figma.com/mcp"
+    echo "  • Botim MP MCP: $BOTIM_MP_MCP_URL"
+    echo ""
+    
+    read -p "Do you want to continue? (y/n): " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        print_info "Setup cancelled"
+        exit 0
+    fi
+    
+    # Check prerequisites
+    print_header "Checking Prerequisites"
+    
+    if ! command_exists node; then
+        print_error "Node.js is not installed. Please install Node.js first."
+        exit 1
+    else
+        NODE_VERSION=$(node --version)
+        print_success "Node.js is installed ($NODE_VERSION)"
+    fi
+    
+    if ! command_exists npm; then
+        print_error "npm is not installed. Please install npm first."
+        exit 1
+    else
+        NPM_VERSION=$(npm --version)
+        print_success "npm is installed (v$NPM_VERSION)"
+    fi
+    
+    # Run setup steps
+    configure_hosts
+    install_botim_cli
+    configure_mcp_servers
+    verify_mcp_setup
+    display_next_steps
+}
+
+# Run main function
+main

package/dist/templates/templates/react/src/api/http-client.ts

@@ -0,0 +1,8 @@
+import axios from 'axios';
+
+export const httpClient = axios.create({
+    baseURL: '/api',
+    timeout: 15_000
+});
+
+httpClient.interceptors.response.use((response) => response, (error) => Promise.reject(error));

package/dist/templates/templates/react/src/api/modules/example.ts

@@ -0,0 +1,12 @@
+import { httpClient } from '../http-client';
+
+export type ExampleResponse = {
+    id: string;
+    name: string;
+};
+
+export async function fetchExample(): Promise<ExampleResponse> {
+    const { data } = await httpClient.get<ExampleResponse>('/example');
+
+    return data;
+}

package/dist/templates/templates/react/src/app.tsx

@@ -0,0 +1,27 @@
+import { Suspense } from 'react';
+import { RouterProvider } from 'react-router-dom';
+import { AppProviders } from '@modules/core/app-providers';
+import { router } from './routes';
+
+export default function App(): JSX.Element {
+    return (
+        <AppProviders>
+            <Suspense 
+                fallback={
+                    <div style={{
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                        height: '100vh',
+                        fontSize: '16px',
+                        color: '#666'
+                    }}>
+                        Loading...
+                    </div>
+                }
+            >
+                <RouterProvider router={router} />
+            </Suspense>
+        </AppProviders>
+    );
+}

package/dist/templates/templates/react/src/components/not-found-content/index.ts

@@ -0,0 +1,2 @@
+export { NotFoundContent } from './not-found-content';
+export type { NotFoundContentProps } from './not-found-content';

package/dist/templates/templates/react/src/components/not-found-content/not-found-content.tsx

@@ -0,0 +1,24 @@
+import { useTranslation } from 'react-i18next';
+import { useNavigate } from 'react-router-dom';
+import { BotEmpty, BotButton } from '@botim/buckit2-react';
+
+export interface NotFoundContentProps {
+    className?: string;
+}
+
+export function NotFoundContent({ className }: NotFoundContentProps): JSX.Element {
+    const { t } = useTranslation();
+    const navigate = useNavigate();
+
+    const handleGoHome = (): void => {
+        navigate('/');
+    };
+
+    return (
+        <BotEmpty description={t('common.notFound')} className={className}>
+            <BotButton type="primary" onClick={handleGoHome}>
+                Go to Home
+            </BotButton>
+        </BotEmpty>
+    );
+}

package/dist/templates/templates/react/src/components/welcome-card/index.ts

@@ -0,0 +1 @@
+export { WelcomeCard } from './welcome-card';

package/dist/templates/templates/react/src/components/welcome-card/welcome-card.tsx

@@ -0,0 +1,10 @@
+import { useTranslation } from 'react-i18next';
+import { BotCell } from '@botim/buckit2-react';
+
+export function WelcomeCard(): JSX.Element {
+    const { t } = useTranslation();
+ 
+    return (
+     <BotCell title={t('home.title')}  label={t('home.welcome')} />
+    );
+}

package/dist/templates/templates/react/src/hooks/use-document-title.ts

@@ -0,0 +1,11 @@
+import { useEffect } from 'react';
+
+export function useDocumentTitle(title: string, restore = 'App'): void {
+    useEffect(() => {
+        document.title = title;
+
+        return () => {
+            document.title = restore;
+        };
+    }, [ title, restore ]);
+}

package/dist/templates/templates/react/src/i18n/index.ts

@@ -0,0 +1,40 @@
+import { createInstance, InitOptions } from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import en from './languages/en.json';
+
+const defaultOptions: InitOptions = {
+    lng: 'en',
+    fallbackLng: 'en',
+    defaultNS: 'translation',
+    interpolation: {
+        escapeValue: false
+    },
+    resources: {
+        en: {
+            translation: en
+        }
+    },
+    debug: false
+};
+
+let cachedInstance: ReturnType<typeof createInstance> | null = null;
+
+export function initI18n(options?: InitOptions) {
+    if (cachedInstance?.isInitialized)
+        return cachedInstance;
+
+    const instance = createInstance();
+
+    instance.use(initReactI18next).init({
+        ...defaultOptions,
+        ...options,
+        resources: {
+            ...defaultOptions.resources,
+            ...(options?.resources ?? {})
+        }
+    });
+
+    cachedInstance = instance;
+
+    return instance;
+}

package/dist/templates/templates/react/src/i18n/languages/en.json

@@ -0,0 +1,10 @@
+{
+    "home": {
+      "title": "Home",
+      "welcome": "Welcome to your new mini application"
+    },
+    "common": {
+      "loading": "Loading...",
+      "notFound": "The page you are looking for could not be found"
+    }
+}

package/dist/templates/templates/react/src/main.tsx

@@ -0,0 +1,27 @@
+import '@botim/buckit2-react/css/index.css';
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { useFramework } from '@botim/framework';
+import App from './app';
+import { AppProviders } from '@modules/core/app-providers';
+
+
+async function bootstrap() {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    await useFramework();
+    
+    const rootElement = document.getElementById('root');
+
+    if (!rootElement)
+        throw new Error('Root element #root is missing');
+    
+    createRoot(rootElement).render(
+        <StrictMode>
+            <AppProviders>
+                <App />
+            </AppProviders>
+        </StrictMode>
+    );
+}
+
+bootstrap();

package/dist/templates/templates/react/src/modules/common/README.md

@@ -0,0 +1,7 @@
+# Common Module
+
+Place shared domain logic, constants, and utilities here. This folder mirrors the structure of the source application and can be extended with sub-folders such as:
+
+- `constants/` for reusable values and enums.
+- `utilities/` for helpers that are consumed across modules.
+- `data-tracking/` or similar analytics-related integrations.

package/dist/templates/templates/react/src/modules/common/constants.ts

@@ -0,0 +1,3 @@
+export const STORAGE_KEYS = {
+    language: 'app:language'
+} as const;

package/dist/templates/templates/react/src/modules/core/README.md

@@ -0,0 +1,7 @@
+# Core Module
+
+The core module aggregates cross-cutting concerns such as providers, API infrastructure, and application-wide constants. Extend this area with sub-folders for:
+
+- `api/` – shared HTTP clients, interceptors, and error helpers.
+- `constants/` – environment tokens or application identifiers.
+- `utils/` – low-level helpers that modules can build upon.

package/dist/templates/templates/react/src/modules/core/api/error.ts

@@ -0,0 +1,6 @@
+export class ApiError extends Error {
+    constructor(message: string, public readonly status?: number) {
+        super(message);
+        this.name = 'ApiError';
+    }
+}

package/dist/templates/templates/react/src/modules/core/app-providers.tsx

@@ -0,0 +1,18 @@
+import { PropsWithChildren } from 'react';
+import { I18nextProvider } from 'react-i18next';
+import { GlobalStyle } from '@styles/global-style';
+import { AppThemeProvider } from '@theme/index';
+import { initI18n } from '@i18n/index';
+
+const i18n = initI18n();
+
+export function AppProviders({ children }: PropsWithChildren): JSX.Element {
+    return (
+        <AppThemeProvider>
+            <I18nextProvider i18n={i18n}>
+                <GlobalStyle />
+                {children}
+            </I18nextProvider>
+        </AppThemeProvider>
+    );
+}

package/dist/templates/templates/react/src/modules/core/index.ts

@@ -0,0 +1,2 @@
+export { AppProviders } from './app-providers';
+export { ApiError } from './api/error';

package/dist/templates/templates/react/src/pages/home/index.tsx

@@ -0,0 +1,13 @@
+import { useTranslation } from 'react-i18next';
+import { useDocumentTitle } from '@hooks/use-document-title';
+import { BotCell } from '@botim/buckit2-react';
+
+export default function HomePage(): JSX.Element {
+    const { t } = useTranslation();
+
+    useDocumentTitle(t('home.title'));
+
+    return (
+        <BotCell title={t('home.title')} label={t('home.welcome')} />
+    );
+}