mcp-twin 1.2.0

package/dist/config-detector.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Config Detector - Auto-detect MCP servers from multiple MCP clients
+ *
+ * Supports:
+ * - Claude Desktop
+ * - Claude Code
+ * - VS Code (GitHub Copilot)
+ * - Cursor
+ * - Cline
+ * - Windsurf
+ *
+ * Powered by Prax Chat - https://prax.chat
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assignPorts = assignPorts;
+exports.detectMCPServers = detectMCPServers;
+exports.detectMCPServersFromClaude = detectMCPServersFromClaude;
+exports.generateTwinConfig = generateTwinConfig;
+exports.autoConfigureTwins = autoConfigureTwins;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Get all possible MCP config paths for different clients
+ */
+function getAllConfigPaths() {
+    const platform = os.platform();
+    const home = os.homedir();
+    const cwd = process.cwd();
+    const paths = [];
+    // Claude Desktop
+    if (platform === 'darwin') {
+        paths.push({
+            client: 'Claude Desktop',
+            path: path.join(home, 'Library/Application Support/Claude/claude_desktop_config.json')
+        });
+    }
+    else if (platform === 'win32') {
+        paths.push({
+            client: 'Claude Desktop',
+            path: path.join(home, 'AppData/Roaming/Claude/claude_desktop_config.json')
+        });
+    }
+    else {
+        paths.push({
+            client: 'Claude Desktop',
+            path: path.join(home, '.config/claude/claude_desktop_config.json')
+        });
+    }
+    // Claude Code
+    paths.push({
+        client: 'Claude Code',
+        path: path.join(home, '.claude/claude_desktop_config.json')
+    });
+    // VS Code - workspace
+    paths.push({
+        client: 'VS Code (workspace)',
+        path: path.join(cwd, '.vscode/mcp.json')
+    });
+    // VS Code - user settings (macOS)
+    if (platform === 'darwin') {
+        paths.push({
+            client: 'VS Code (user)',
+            path: path.join(home, 'Library/Application Support/Code/User/settings.json')
+        });
+    }
+    // Cursor - workspace
+    paths.push({
+        client: 'Cursor (workspace)',
+        path: path.join(cwd, '.cursor/mcp.json')
+    });
+    // Cursor - global
+    paths.push({
+        client: 'Cursor (global)',
+        path: path.join(home, '.cursor/mcp.json')
+    });
+    // Windsurf
+    paths.push({
+        client: 'Windsurf',
+        path: path.join(home, '.windsurf/mcp.json')
+    });
+    // Cline (VS Code extension, uses VS Code settings)
+    // Already covered by VS Code paths
+    return paths;
+}
+/**
+ * Get path to Claude desktop config (legacy, for backwards compatibility)
+ */
+function getClaudeConfigPath() {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        return path.join(os.homedir(), 'Library/Application Support/Claude/claude_desktop_config.json');
+    }
+    else if (platform === 'win32') {
+        return path.join(os.homedir(), 'AppData/Roaming/Claude/claude_desktop_config.json');
+    }
+    else {
+        // Linux
+        return path.join(os.homedir(), '.config/claude/claude_desktop_config.json');
+    }
+}
+/**
+ * Extract script path from command args
+ */
+function extractScriptPath(command, args) {
+    // Common patterns:
+    // python3 /path/to/server.py
+    // node /path/to/server.js
+    // npx ts-node /path/to/server.ts
+    for (const arg of args) {
+        // Skip flags
+        if (arg.startsWith('-'))
+            continue;
+        // Check if it's a file path
+        const expanded = arg.replace('~', os.homedir());
+        if (fs.existsSync(expanded)) {
+            return expanded;
+        }
+        // Check common extensions
+        if (arg.endsWith('.py') || arg.endsWith('.js') || arg.endsWith('.ts')) {
+            return arg.replace('~', os.homedir());
+        }
+    }
+    return null;
+}
+/**
+ * Detect language from command
+ */
+function detectLanguage(command) {
+    const cmd = command.toLowerCase();
+    if (cmd.includes('python') || cmd.includes('python3')) {
+        return 'python';
+    }
+    if (cmd.includes('node') || cmd.includes('npx') || cmd.includes('tsx')) {
+        return 'node';
+    }
+    return 'unknown';
+}
+/**
+ * Assign deterministic ports based on server name
+ */
+function assignPorts(serverName) {
+    // Simple hash function
+    let hash = 0;
+    for (let i = 0; i < serverName.length; i++) {
+        const char = serverName.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    // Map to port range 8100-8298 (99 server pairs)
+    const basePort = 8100 + (Math.abs(hash) % 100) * 2;
+    return [basePort, basePort + 1];
+}
+/**
+ * Detect MCP servers from all supported MCP clients
+ */
+function detectMCPServers() {
+    const allPaths = getAllConfigPaths();
+    const servers = [];
+    const seen = new Set(); // Dedupe by server name
+    for (const { client, path: configPath } of allPaths) {
+        if (!fs.existsSync(configPath)) {
+            continue;
+        }
+        try {
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            // Support both mcpServers (Claude) and servers (VS Code/Cursor) formats
+            const mcpServers = config.mcpServers || config.servers || {};
+            for (const [name, entry] of Object.entries(mcpServers)) {
+                // Skip if already seen (first config wins)
+                if (seen.has(name))
+                    continue;
+                seen.add(name);
+                const args = entry.args || [];
+                const scriptPath = extractScriptPath(entry.command, args);
+                const language = detectLanguage(entry.command);
+                servers.push({
+                    name,
+                    command: entry.command,
+                    args,
+                    scriptPath,
+                    language,
+                    source: client
+                });
+            }
+        }
+        catch (err) {
+            // Skip invalid configs silently
+            continue;
+        }
+    }
+    return servers;
+}
+/**
+ * Detect MCP servers from Claude config only (legacy)
+ */
+function detectMCPServersFromClaude() {
+    const configPath = getClaudeConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return [];
+    }
+    try {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const servers = [];
+        if (!config.mcpServers) {
+            return [];
+        }
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const args = entry.args || [];
+            const scriptPath = extractScriptPath(entry.command, args);
+            const language = detectLanguage(entry.command);
+            servers.push({
+                name,
+                command: entry.command,
+                args,
+                scriptPath,
+                language,
+                source: 'Claude Desktop'
+            });
+        }
+        return servers;
+    }
+    catch (err) {
+        return [];
+    }
+}
+/**
+ * Generate twin config from detected servers
+ */
+function generateTwinConfig(servers) {
+    const config = {};
+    for (const server of servers) {
+        if (!server.scriptPath) {
+            console.log(`[ConfigDetector] Skipping ${server.name}: no script path found`);
+            continue;
+        }
+        const [portA, portB] = assignPorts(server.name);
+        config[server.name] = {
+            script: server.scriptPath,
+            ports: [portA, portB],
+            healthEndpoint: '/health',
+            startupTimeout: 10,
+            python: server.language === 'python' ? server.command : 'python3'
+        };
+    }
+    return config;
+}
+/**
+ * Auto-detect and update twin config
+ */
+function autoConfigureTwins() {
+    const detected = detectMCPServers();
+    const twinConfig = generateTwinConfig(detected);
+    return {
+        detected: detected.length,
+        configured: Object.keys(twinConfig).length,
+        servers: Object.keys(twinConfig)
+    };
+}
+// CLI test
+if (require.main === module) {
+    console.log('Detecting MCP servers...\n');
+    const servers = detectMCPServers();
+    if (servers.length === 0) {
+        console.log('No MCP servers found in Claude config.');
+    }
+    else {
+        console.log(`Found ${servers.length} servers:\n`);
+        for (const server of servers) {
+            console.log(`  ${server.name}`);
+            console.log(`    Command: ${server.command}`);
+            console.log(`    Script: ${server.scriptPath || '(not found)'}`);
+            console.log(`    Language: ${server.language}`);
+            console.log(`    Ports: ${assignPorts(server.name).join(', ')}`);
+            console.log();
+        }
+    }
+}
+exports.default = {
+    detectMCPServers,
+    generateTwinConfig,
+    autoConfigureTwins,
+    assignPorts
+};
+//# sourceMappingURL=config-detector.js.map

package/dist/config-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-detector.js","sourceRoot":"","sources":["../src/config-detector.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * MCP Twin Plugin - Entry Point
+ * Zero-downtime MCP server updates for Claude Code
+ *
+ * Powered by Prax - https://prax.chat
+ */
+import { getTwinManager, MCPTwinManager } from './twin-manager';
+import { detectMCPServers, generateTwinConfig, autoConfigureTwins } from './config-detector';
+export { MCPTwinManager, getTwinManager };
+export { detectMCPServers, generateTwinConfig, autoConfigureTwins };
+/**
+ * Plugin Commands
+ */
+export declare const commands: {
+    /**
+     * /twin start [server]
+     */
+    start(serverName?: string): Promise<string>;
+    /**
+     * /twin stop [server]
+     */
+    stop(serverName?: string): Promise<string>;
+    /**
+     * /twin reload <server>
+     */
+    reload(serverName: string): Promise<string>;
+    /**
+     * /twin swap <server>
+     */
+    swap(serverName: string): Promise<string>;
+    /**
+     * /twin status [server]
+     */
+    status(serverName?: string): Promise<string>;
+    /**
+     * /twin detect - Auto-detect MCP servers
+     */
+    detect(): Promise<string>;
+    /**
+     * /twin help
+     */
+    help(): string;
+};
+/**
+ * Main command router
+ */
+export declare function handleCommand(args: string[]): Promise<string>;
+declare const _default: {
+    commands: {
+        /**
+         * /twin start [server]
+         */
+        start(serverName?: string): Promise<string>;
+        /**
+         * /twin stop [server]
+         */
+        stop(serverName?: string): Promise<string>;
+        /**
+         * /twin reload <server>
+         */
+        reload(serverName: string): Promise<string>;
+        /**
+         * /twin swap <server>
+         */
+        swap(serverName: string): Promise<string>;
+        /**
+         * /twin status [server]
+         */
+        status(serverName?: string): Promise<string>;
+        /**
+         * /twin detect - Auto-detect MCP servers
+         */
+        detect(): Promise<string>;
+        /**
+         * /twin help
+         */
+        help(): string;
+    };
+    handleCommand: typeof handleCommand;
+    getTwinManager: typeof getTwinManager;
+    detectMCPServers: typeof detectMCPServers;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAKpE;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;uBACsB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCjD;;OAEG;sBACqB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsChD;;OAEG;uBACsB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBjD;;OAEG;qBACoB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB/C;;OAEG;wBACuB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoElD;;OAEG;cACa,OAAO,CAAC,MAAM,CAAC;IAmB/B;;OAEG;YACK,MAAM;CAuBf,CAAC;AAEF;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBnE;;;QAzRC;;WAEG;2BACsB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAwCjD;;WAEG;0BACqB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAsChD;;WAEG;2BACsB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAuBjD;;WAEG;yBACoB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAsB/C;;WAEG;4BACuB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAoElD;;WAEG;kBACa,OAAO,CAAC,MAAM,CAAC;QAmB/B;;WAEG;gBACK,MAAM;;;;;;AAoDhB,wBAKE"}

package/dist/index.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * MCP Twin Plugin - Entry Point
+ * Zero-downtime MCP server updates for Claude Code
+ *
+ * Powered by Prax - https://prax.chat
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = exports.autoConfigureTwins = exports.generateTwinConfig = exports.detectMCPServers = exports.getTwinManager = exports.MCPTwinManager = void 0;
+exports.handleCommand = handleCommand;
+const twin_manager_1 = require("./twin-manager");
+Object.defineProperty(exports, "getTwinManager", { enumerable: true, get: function () { return twin_manager_1.getTwinManager; } });
+Object.defineProperty(exports, "MCPTwinManager", { enumerable: true, get: function () { return twin_manager_1.MCPTwinManager; } });
+const config_detector_1 = require("./config-detector");
+Object.defineProperty(exports, "detectMCPServers", { enumerable: true, get: function () { return config_detector_1.detectMCPServers; } });
+Object.defineProperty(exports, "generateTwinConfig", { enumerable: true, get: function () { return config_detector_1.generateTwinConfig; } });
+Object.defineProperty(exports, "autoConfigureTwins", { enumerable: true, get: function () { return config_detector_1.autoConfigureTwins; } });
+// Branding
+const PRAX_FOOTER = '\n─────────────────────────────────────────\n⚡ Powered by Prax Chat | prax.chat/mcp-twin';
+/**
+ * Plugin Commands
+ */
+exports.commands = {
+    /**
+     * /twin start [server]
+     */
+    async start(serverName) {
+        const manager = (0, twin_manager_1.getTwinManager)();
+        if (!serverName) {
+            // Show available servers
+            const status = await manager.status();
+            const available = status.available || [];
+            if (available.length === 0) {
+                return `No MCP servers configured.
+
+Run auto-detect to find servers:
+  /twin detect
+
+Or add manually:
+  /twin add <name> <script-path>`;
+            }
+            return `Available servers:
+${available.map((s) => `  - ${s}`).join('\n')}
+
+Start twins:
+  /twin start <server-name>`;
+        }
+        const result = await manager.startTwins(serverName);
+        if (!result.ok) {
+            return `Failed to start twins: ${result.error}`;
+        }
+        return `Started twins for ${serverName}
+
+  Server A: port ${result.pidA ? result.statusA : 'failed'} ${result.statusA === 'running' ? '●' : '○'}
+  Server B: port ${result.pidB ? result.statusB : 'failed'} ${result.statusB === 'running' ? '●' : '○'}
+  Active: A
+
+${result.hint}${PRAX_FOOTER}`;
+    },
+    /**
+     * /twin stop [server]
+     */
+    async stop(serverName) {
+        const manager = (0, twin_manager_1.getTwinManager)();
+        if (!serverName) {
+            return `Usage: /twin stop <server-name>
+
+Or stop all: /twin stop --all`;
+        }
+        if (serverName === '--all') {
+            const status = await manager.status();
+            const running = Object.keys(status.twins || {});
+            if (running.length === 0) {
+                return 'No twins running.';
+            }
+            const results = [];
+            for (const name of running) {
+                const result = await manager.stopTwins(name);
+                results.push(`  ${name}: ${result.ok ? 'stopped' : 'failed'}`);
+            }
+            return `Stopped all twins:\n${results.join('\n')}`;
+        }
+        const result = await manager.stopTwins(serverName);
+        if (!result.ok) {
+            return `Failed to stop: ${result.error}`;
+        }
+        return `Stopped ${serverName} twins
+
+  Server A: stopped
+  Server B: stopped`;
+    },
+    /**
+     * /twin reload <server>
+     */
+    async reload(serverName) {
+        if (!serverName) {
+            return 'Usage: /twin reload <server-name>';
+        }
+        const manager = (0, twin_manager_1.getTwinManager)();
+        const result = await manager.reloadStandby(serverName);
+        if (!result.ok) {
+            return `Reload failed: ${result.error}
+
+${result.hint || ''}`;
+        }
+        return `Reloaded ${serverName} standby
+
+  ${result.reloaded}
+  Health: ${result.healthy ? 'passing ●' : 'FAILED ○'}
+  Reload count: ${result.reloadCount}
+
+${result.hint}`;
+    },
+    /**
+     * /twin swap <server>
+     */
+    async swap(serverName) {
+        if (!serverName) {
+            return 'Usage: /twin swap <server-name>';
+        }
+        const manager = (0, twin_manager_1.getTwinManager)();
+        const result = await manager.swapActive(serverName);
+        if (!result.ok) {
+            return `Swap failed: ${result.error}
+
+${result.hint || ''}`;
+        }
+        return `Swapped ${serverName}
+
+  Previous: ${result.previousActive}
+  Now active: ${result.newActive}
+
+${result.hint}${PRAX_FOOTER}`;
+    },
+    /**
+     * /twin status [server]
+     */
+    async status(serverName) {
+        const manager = (0, twin_manager_1.getTwinManager)();
+        const result = await manager.status(serverName);
+        if (!result.ok) {
+            return `Error: ${result.error}`;
+        }
+        if (serverName) {
+            // Detailed single server status
+            const { serverA, serverB, active, reloadCount, lastSwap } = result;
+            return `${serverName} Twin Status
+${'═'.repeat(40)}
+
+Server A (port ${serverA.port})
+  State: ${serverA.state}
+  Health: ${serverA.healthy ? 'healthy ●' : 'unhealthy ○'}
+  ${serverA.isActive ? '← ACTIVE' : '  standby'}
+
+Server B (port ${serverB.port})
+  State: ${serverB.state}
+  Health: ${serverB.healthy ? 'healthy ●' : 'unhealthy ○'}
+  ${serverB.isActive ? '← ACTIVE' : '  standby'}
+
+Reloads: ${reloadCount}
+Last swap: ${lastSwap ? new Date(lastSwap).toLocaleTimeString() : 'never'}`;
+        }
+        // All twins summary
+        const twins = result.twins || {};
+        const twinNames = Object.keys(twins);
+        if (twinNames.length === 0) {
+            const available = result.available || [];
+            return `No twins running.
+
+Available servers:
+${available.map((s) => `  - ${s}`).join('\n')}
+
+Start with: /twin start <server>`;
+        }
+        let output = `MCP Twin Status
+${'═'.repeat(40)}
+
+`;
+        for (const [name, info] of Object.entries(twins)) {
+            const activeLabel = info.active.toUpperCase();
+            const [healthA, healthB] = info.healthy;
+            output += `${name}
+  Active: ${activeLabel} (${info.ports[info.active === 'a' ? 0 : 1]}) ${healthA || healthB ? '●' : '○'}
+  Standby: ${info.active === 'a' ? 'B' : 'A'} (${info.ports[info.active === 'a' ? 1 : 0]}) ${(info.active === 'a' ? healthB : healthA) ? '●' : '○'}
+  Reloads: ${info.reloadCount}
+
+`;
+        }
+        const notRunning = (result.available || []).filter((s) => !twins[s]);
+        if (notRunning.length > 0) {
+            output += `Not running: ${notRunning.join(', ')}`;
+        }
+        return output;
+    },
+    /**
+     * /twin detect - Auto-detect MCP servers
+     */
+    async detect() {
+        const result = (0, config_detector_1.autoConfigureTwins)();
+        if (result.detected === 0) {
+            return `No MCP servers found in Claude config.
+
+Add servers manually:
+  /twin add <name> <script-path> <port1> <port2>`;
+        }
+        return `Detected ${result.detected} MCP servers:
+${result.servers.map(s => `  - ${s}`).join('\n')}
+
+${result.configured} configured for twins.
+
+Start twins:
+  /twin start <server-name>`;
+    },
+    /**
+     * /twin help
+     */
+    help() {
+        return `MCP Twin - Zero-Downtime Server Updates
+${'═'.repeat(44)}
+
+Commands:
+  /twin start [server]   Start twin servers
+  /twin stop [server]    Stop twin servers
+  /twin reload <server>  Reload standby with new code
+  /twin swap <server>    Switch traffic to standby
+  /twin status [server]  Show twin status
+  /twin detect           Auto-detect MCP servers
+  /twin help             Show this help
+
+Workflow:
+  1. /twin start my-server  → Start A (active) + B (standby)
+  2. Edit your server code
+  3. /twin reload my-server → Update standby B
+  4. /twin swap my-server   → Switch to B
+  5. Keep coding - no restart needed!
+${PRAX_FOOTER}
+
+Pro features coming soon: prax.chat/mcp-twin/pro`;
+    }
+};
+/**
+ * Main command router
+ */
+async function handleCommand(args) {
+    const [subcommand, ...rest] = args;
+    switch (subcommand?.toLowerCase()) {
+        case 'start':
+            return exports.commands.start(rest[0]);
+        case 'stop':
+            return exports.commands.stop(rest[0]);
+        case 'reload':
+            return exports.commands.reload(rest[0]);
+        case 'swap':
+            return exports.commands.swap(rest[0]);
+        case 'status':
+            return exports.commands.status(rest[0]);
+        case 'detect':
+            return exports.commands.detect();
+        case 'help':
+        case undefined:
+            return exports.commands.help();
+        default:
+            return `Unknown command: ${subcommand}\n\nRun /twin help for usage.`;
+    }
+}
+exports.default = {
+    commands: exports.commands,
+    handleCommand,
+    getTwinManager: twin_manager_1.getTwinManager,
+    detectMCPServers: config_detector_1.detectMCPServers
+};
+//# sourceMappingURL=index.js.map