@minecraft-docker/mcctl-api 1.7.6

package/dist/utils/docker-compose.js

@@ -0,0 +1,100 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { config } from '../config/index.js';
+const execPromise = promisify(exec);
+// ============================================================
+// Configuration
+// ============================================================
+/**
+ * Platform directory path.
+ * Uses config.platformPath which is resolved from:
+ *   1. PLATFORM_PATH environment variable
+ *   2. MCCTL_ROOT environment variable
+ *   3. ~/minecraft-servers (default)
+ */
+function getPlatformPath() {
+    return config.platformPath;
+}
+// ============================================================
+// Server Name Validation
+// ============================================================
+/**
+ * Server name validation regex.
+ * Allows alphanumeric characters, hyphens, and underscores.
+ * Must start with a letter or number.
+ */
+const SERVER_NAME_REGEX = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+export function isValidServerName(name) {
+    if (!name || name.length === 0 || name.length > 64) {
+        return false;
+    }
+    return SERVER_NAME_REGEX.test(name);
+}
+export function sanitizeServerName(name) {
+    // Decode URI component if encoded
+    try {
+        name = decodeURIComponent(name);
+    }
+    catch {
+        // If decoding fails, use as-is
+    }
+    return name.trim();
+}
+// ============================================================
+// Docker Compose Commands
+// ============================================================
+/**
+ * Execute a docker compose command for a specific server action.
+ */
+export async function executeServerAction(serverName, action) {
+    const platformPath = getPlatformPath();
+    const serviceName = `mc-${serverName}`;
+    let command;
+    switch (action) {
+        case 'start':
+            command = `docker compose up -d ${serviceName}`;
+            break;
+        case 'stop':
+            command = `docker compose stop ${serviceName}`;
+            break;
+        case 'restart':
+            command = `docker compose restart ${serviceName}`;
+            break;
+        default:
+            return {
+                success: false,
+                error: `Unknown action: ${action}`,
+            };
+    }
+    const options = {
+        cwd: platformPath,
+        timeout: 60000, // 60 second timeout
+        env: {
+            ...process.env,
+            // Ensure Docker Compose uses the correct compose file
+            COMPOSE_FILE: 'docker-compose.yml',
+        },
+    };
+    try {
+        const { stdout, stderr } = await execPromise(command, options);
+        return {
+            success: true,
+            stdout: typeof stdout === 'string' ? stdout.trim() : stdout?.toString().trim(),
+            stderr: typeof stderr === 'string' ? stderr.trim() : stderr?.toString().trim(),
+        };
+    }
+    catch (error) {
+        const execError = error;
+        return {
+            success: false,
+            stdout: typeof execError.stdout === 'string' ? execError.stdout.trim() : execError.stdout?.toString().trim(),
+            stderr: typeof execError.stderr === 'string' ? execError.stderr.trim() : execError.stderr?.toString().trim(),
+            error: execError.message ?? 'Unknown error',
+        };
+    }
+}
+// ============================================================
+// Export for Testing
+// ============================================================
+export { getPlatformPath };
+//# sourceMappingURL=docker-compose.js.map

package/dist/utils/docker-compose.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@minecraft-docker/mcctl-api",
+  "version": "1.7.6",
+  "description": "REST API server for managing Docker Minecraft servers",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcctl-api": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:pm2": "pm2 start dist/index.js --name mcctl-api",
+    "stop:pm2": "pm2 stop mcctl-api",
+    "restart:pm2": "pm2 restart mcctl-api",
+    "logs:pm2": "pm2 logs mcctl-api",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "minecraft",
+    "docker",
+    "api",
+    "fastify",
+    "mc-router",
+    "server-management"
+  ],
+  "author": "smallmiro",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smallmiro/minecraft-server-manager.git",
+    "directory": "platform/services/mcctl-api"
+  },
+  "homepage": "https://minecraft-server-manager.readthedocs.io/",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.2",
+    "@fastify/helmet": "^12.0.1",
+    "@fastify/swagger": "^9.6.1",
+    "@fastify/swagger-ui": "^5.2.4",
+    "@minecraft-docker/shared": "^1.7.6",
+    "@sinclair/typebox": "^0.34.48",
+    "bcrypt": "^6.0.0",
+    "dotenv": "^16.4.7",
+    "fastify": "^5.2.1",
+    "fastify-plugin": "^5.1.0",
+    "ip-range-check": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^6.0.0",
+    "@types/node": "^20.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.8"
+  }
+}