@hellocoop/admin-mcp/src/analytics.js

Model Context Protocol (MCP) for Hellō Admin API.

import { version } from './package.js';
import { NODE_ENV, HELLO_DOMAIN, MCP_BASE_URL } from './config.js';
import { getLogContext } from './log.js';

// Session store to maintain client information across requests
let sessionClientInfo = null;

/**
 * Set client information for the current session
 * @param {Object} clientInfo - Client information from initialize request
 * @param {string} protocolVersion - MCP protocol version
 * @param {string} transport - Transport type (http, stdio, or unknown)
 */
function setSessionClientInfo(clientInfo, protocolVersion, transport) {
    sessionClientInfo = {
        client_name: clientInfo?.name,
        client_version: clientInfo?.version || 'unknown',
        mcp_protocol_version: protocolVersion || 'unknown',
        transport: transport || 'unknown'
    };
}

/**
 * Get current session client information
 * @returns {Object|null} - Client information or null if not set
 */
function getSessionClientInfo() {
    return sessionClientInfo;
}

/**
 * Check if analytics should be enabled based on environment
 * @returns {boolean} - True if analytics should be sent
 */
function shouldSendAnalytics() {
    // Only send analytics in beta or production environments
    return NODE_ENV === 'production' || HELLO_DOMAIN === 'hello-beta.net';
}

async function sendPlausibleEvent(url) {
    // Skip analytics if not in beta or production
    if (!shouldSendAnalytics()) {
        console.log('Analytics disabled for development environment');
        return;
    }

    try {
        const clientInfo = getSessionClientInfo();
        const logContext = getLogContext();
        
        const eventData = {
            name: 'mcp_test',
            url: url,
            domain: MCP_BASE_URL.replace('https://', ''),
            props: {
                client_name: clientInfo?.client_name,
                client_version: clientInfo?.client_version,
                transport: clientInfo?.transport,
                mcp_protocol_version: clientInfo?.mcp_protocol_version,
                admin_mcp_version: version,
            }
        };
    
        
        // Prepare headers for Plausible
        const headers = {
            'Content-Type': 'application/json',
            'User-Agent': `HelloAdminMCP/${version}`
        };
        
        // Add client IP from logging context if available
        if (logContext?.clientIP && logContext.clientIP !== 'unknown') {
            headers['X-Forwarded-For'] = logContext.clientIP;
            // 'X-Debug-Request': 'true'
        }

        const response = await fetch('https://plausible.io/api/event', {
            method: 'POST',
            headers,
            body: JSON.stringify(eventData)
        });
        
        if (!response.ok) {
            console.error('Plausible event failed:', response.status, response.statusText);
            throw response;
        }

        console.log('Plausible event sent:', JSON.stringify(eventData, null, 2));
        
    } catch (error) {
        console.error('Failed to send Plausible event:', error);
    }
}

export {
    sendPlausibleEvent,
    setSessionClientInfo,
    getSessionClientInfo
}