Next

.vscode/README.devsetup.md

@@ -0,0 +1,145 @@
+# Local Development Setup Guide - macOS/Ubuntu
+
+## Prerequisites
+- macOS 10.15 or later / Ubuntu 22.04/24.04 LTS
+- Terminal access
+- Homebrew package manager
+
+## Installation Steps
+
+### 1. Install [Homebrew](https://brew.sh/) (if not installed) (macOS only)
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+### 2. Install MongoDB
+
+[macOS](https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-os-x/):
+
+```bash
+brew tap mongodb/brew
+brew install mongodb-community
+brew services start mongodb-community
+```
+
+[Ubuntu](https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/):
+
+```bash
+# Install required packages
+sudo apt-get install -y gnupg curl unzip
+
+# Import MongoDB public GPG key
+curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
+   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
+   --dearmor
+
+# Create list file for MongoDB
+echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | \
+   sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
+
+# Update and install MongoDB
+sudo apt-get update
+sudo apt-get install -y mongodb-org
+
+# Start and enable MongoDB service
+sudo systemctl start mongod
+sudo systemctl enable mongod
+```
+
+### 3. Install [Fast Node Manager (fnm)](https://github.com/Schniz/fnm)  (if no Node.js version manager is installed)
+```bash
+curl -fsSL https://fnm.vercel.app/install | bash
+```
+
+Add fnm to your shell configuration:
+
+macOS:
+
+```bash
+echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
+source ~/.zshrc
+```
+Ubuntu:
+
+```bash
+echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### 4. Install Node.js
+```bash
+fnm install 22
+fnm use 22
+```
+
+Verify the installation:
+```bash
+node --version
+npm --version
+```
+
+### 5. Run Development Setup Script
+
+Copy the `devsetup.sh` script from `.vscode/devsetup.sh` to your project directory (script clones the repo automatically).
+1. Navigate to your project directory
+2. Make the setup script executable:
+```bash
+chmod +x ./devsetup.sh
+```
+
+1. Run the setup script:
+```bash
+./devsetup.sh
+```
+
+The script will:
+- Clone the repository
+- Install dependencies
+- Configure the development environment
+
+### 6. Start the Development of Server/Client
+
+Use the debug configuration(server/client) in VS Code to run the code.
+
+By default client runs on `locahost:6001` and server runs on `localhost:3001`
+
+
+## Verification
+After installation, verify all components:
+
+- MongoDB:
+
+macOS:
+
+```bash
+brew services list | grep mongodb
+```
+
+Ubuntu:
+
+```bash
+sudo systemctl status mongod
+```
+
+- Node.js:
+```bash
+node --version
+```
+
+## Troubleshooting
+- If MongoDB fails to start, try:
+
+macOS:
+
+```bash
+brew services restart mongodb-community
+```
+
+Ubuntu:
+
+```bash
+sudo systemctl restart mongod
+sudo systemctl status mongod
+```
+
+- If the setup script fails, check the generated log file in the current directory named \`setup_YYYYMMDD_HHMMSS.log\` 

.vscode/devsetup.sh

@@ -0,0 +1,197 @@
+#!/bin/bash
+# shellcheck disable=SC2016,SC2086,SC2046
+
+# Script configuration
+set -euo pipefail  # Exit on error, undefined vars, and pipe failures
+trap 'echo "Error on line $LINENO. Exit code: $?"' ERR
+
+# Configuration variables
+REPO_URL="git@github.com:Countly/countly-server.git"
+REPO_NAME="countly-community"
+BRANCH="master"
+LOG_FILE="community_setup_$(date +%Y%m%d_%H%M%S).log"
+DIR="$(pwd)/$REPO_NAME"
+
+# Plugins that will be disabled by default
+DISABLED_PLUGINS=(
+    "browser"
+    "empty"
+    "enterpriseinfo"
+    "hooks"
+    "ip_store"
+    "ldap"
+    "old-ui-compatibility"
+    "push"
+    "recaptcha"
+    "tracker"
+    "two-factor-auth"
+    "vue-example"
+    "white-labeling"
+)
+
+# Logging function
+log() {
+    local level=$1
+    shift
+    local message=$*
+    local timestamp
+    timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    echo -e "${timestamp} [${level}] ${message}" | tee -a "$LOG_FILE"
+}
+
+# Check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Prerequisites check
+check_prerequisites() {
+    log "INFO" "Checking prerequisites..."
+
+    local prerequisites=(git node npm)
+    for cmd in "${prerequisites[@]}"; do
+        if ! command_exists "$cmd"; then
+            log "ERROR" "Required command '$cmd' not found. Please install it and try again."
+            exit 1
+        fi
+    done
+
+    # Create nodejs symlink if it doesn't exist and node is not already available as nodejs
+    if ! command_exists nodejs && command_exists node; then
+        log "INFO" "Creating nodejs symlink..."
+        sudo ln -s "$(command -v node)" /usr/local/bin/nodejs || {
+            log "WARNING" "Could not create nodejs symlink, but continuing as node is available"
+        }
+    fi
+
+    log "INFO" "All prerequisites verified"
+}
+
+# Repository setup
+setup_repository() {
+    log "INFO" "Setting up repository..."
+
+    if [ -d "$REPO_NAME" ]; then
+        local answer
+        read -r -p "Directory $REPO_NAME already exists. Backup (b), remove (r), or exit (e)? " answer
+        case $answer in
+            b|B)
+                log "INFO" "Backing up existing directory..."
+                mv "$REPO_NAME" "${REPO_NAME}_backup_$(date +%Y%m%d_%H%M%S)"
+                ;;
+            r|R)
+                log "INFO" "Removing existing directory..."
+                rm -rf "$REPO_NAME"
+                ;;
+            *)
+                log "INFO" "Exiting as per user request"
+                exit 0
+                ;;
+        esac
+    fi
+
+    git clone "$REPO_URL" "$REPO_NAME" || {
+        log "ERROR" "Failed to clone repository. Please check your SSH key and repository access."
+        exit 1
+    }
+
+    cd "$REPO_NAME" || exit 1
+
+    # Git configuration
+    git config --global --add safe.directory "$DIR"
+    git config core.fileMode false
+    git checkout "$BRANCH"
+
+    # Submodules setup if any
+    log "INFO" "Setting up submodules..."
+    git submodule status
+    git pull
+    git submodule init
+    git submodule update
+}
+
+# Configuration setup
+setup_configuration() {
+    log "INFO" "Setting up configuration files..."
+
+    # Copy config files if they don't exist
+    cp -n "$DIR/api/config.sample.js" "$DIR/api/config.js" || log "WARNING" "Skipping api config - file may already exist"
+    cp -n "$DIR/plugins/plugins.default.json" "$DIR/plugins/plugins.json" || log "WARNING" "Skipping plugins config - file may already exist"
+    cp -n "$DIR/frontend/express/config.sample.js" "$DIR/frontend/express/config.js" || log "WARNING" "Skipping express config - file may already exist"
+    cp -n "$DIR/frontend/express/public/javascripts/countly/countly.config.sample.js" "$DIR/frontend/express/public/javascripts/countly/countly.config.js" || log "WARNING" "Skipping frontend config - file may already exist"
+
+    # Use platform-independent sed syntax
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        # macOS
+        sed -i '' 's#countlyGlobal.path#"http://localhost:3001"#g' "$DIR/frontend/express/public/javascripts/countly/countly.config.js"
+        sed -i '' 's/max_pool_size: 500/max_pool_size: 20/g' "$DIR/api/config.js"
+    else
+        # Linux and others
+        sed -i 's#countlyGlobal.path#"http://localhost:3001"#g' "$DIR/frontend/express/public/javascripts/countly/countly.config.js"
+        sed -i 's/max_pool_size: 500/max_pool_size: 20/g' "$DIR/api/config.js"
+    fi
+}
+
+# Plugin management
+manage_plugins() {
+    log "INFO" "Managing plugins..."
+
+    PLUGIN_JS_PATH="$DIR/bin/commands/scripts/plugin.js"
+    for dir in "$DIR/plugins"/*/; do
+        plugin=$(basename "$dir")
+
+        # Using a for loop to check array membership
+        is_disabled=0
+        for disabled_plugin in "${DISABLED_PLUGINS[@]}"; do
+            if [ "$plugin" = "$disabled_plugin" ]; then
+                is_disabled=1
+                break
+            fi
+        done
+
+        if [ "$is_disabled" -eq 1 ]; then
+            log "INFO" "Disabling $plugin..."
+            if node "$PLUGIN_JS_PATH" disable "$plugin"; then
+                log "INFO" "Successfully disabled $plugin"
+            else
+                log "ERROR" "Failed to disable $plugin"
+            fi
+        else
+            log "INFO" "Enabling $plugin..."
+            if node "$PLUGIN_JS_PATH" enable "$plugin"; then
+                log "INFO" "Successfully enabled $plugin"
+            else
+                log "ERROR" "Failed to enable $plugin"
+            fi
+        fi
+    done
+}
+
+# Main execution
+main() {
+    log "INFO" "Starting community setup script..."
+
+    check_prerequisites
+    setup_repository
+
+    # Set permissions - but don't fail if we don't have sudo
+    sudo chmod -R 766 "$DIR" || {
+        log "WARNING" "Could not set full permissions on $DIR. You may need to adjust permissions manually."
+    }
+
+    # Install dependencies
+    cd "$DIR" || exit 1
+    npm install
+
+    setup_configuration
+    manage_plugins
+
+    # build locales and sass
+    npx grunt dist-all
+
+    log "INFO" "Community setup completed successfully!"
+    log "INFO" "You can now start Countly by using the debugger"
+}
+
+# Execute main function
+main

.vscode/disable_plugins.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+set -e
+
+echo "Script started. Working directory: $(pwd)"
+echo "Received arguments: $*"
+
+if [ -z "$1" ]; then
+    echo "Error: No plugin names provided."
+    exit 1
+fi
+
+# Read the comma-separated list of plugin names
+IFS=',' read -ra PLUGINS <<< "$1"
+
+# Get the path to the plugin.js script
+PLUGIN_JS_PATH="$(pwd)/bin/commands/scripts/plugin.js"
+
+# Loop through each plugin name
+for plugin in "${PLUGINS[@]}"; do
+    # Trim whitespace
+    plugin=$(echo "$plugin" | xargs)
+
+    echo "Attempting to disable plugin: $plugin"
+
+    # Run the Node.js command for each plugin
+    if node --preserve-symlinks --preserve-symlinks-main "$PLUGIN_JS_PATH" disable "$plugin"; then
+        echo "Successfully disabled plugin: $plugin"
+    else
+        echo "Failed to disable plugin: $plugin"
+    fi
+done
+
+echo "Script completed."

.vscode/extensions.json

@@ -0,0 +1,15 @@
+{
+	"recommendations": [
+		"dbaeumer.vscode-eslint",
+		"github.vscode-pull-request-github",
+		"eamodio.gitlens",
+        "christian-kohler.npm-intellisense",
+        "christian-kohler.path-intellisense",
+        "ms-vscode-remote.remote-ssh",
+        "ms-vscode-remote.remote-ssh-edit",
+        "ms-vscode.remote-explorer",
+        "syler.sass-indented",
+        "vue.volar",
+        "usernamehw.vscode-error-lens"
+	]
+}