@minecraft-docker/shared 1.5.0 → 1.6.1

package/dist/infrastructure/adapters/WorldRepository.js

@@ -0,0 +1,213 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { Paths } from '../../utils/index.js';
+import { World } from '../../domain/index.js';
+import { getContainerStatus } from '../../docker/index.js';
+/**
+ * WorldRepository
+ * Implements IWorldRepository for world data access
+ */
+export class WorldRepository {
+    paths;
+    worldsDir;
+    locksDir;
+    constructor(paths) {
+        this.paths = paths ?? new Paths();
+        this.worldsDir = join(this.paths.root, 'worlds');
+        this.locksDir = join(this.worldsDir, '.locks');
+    }
+    /**
+     * Get all worlds
+     */
+    async findAll() {
+        const names = await this.listNames();
+        const worlds = [];
+        for (const name of names) {
+            const world = await this.findByName(name);
+            if (world) {
+                worlds.push(world);
+            }
+        }
+        return worlds;
+    }
+    /**
+     * Find world by name
+     */
+    async findByName(name) {
+        const worldPath = join(this.worldsDir, name);
+        if (!existsSync(worldPath)) {
+            return null;
+        }
+        const world = new World(name, worldPath);
+        // Get lock status
+        const lockData = await this.getLockStatus(name);
+        if (lockData) {
+            world.lockTo(lockData.serverName, lockData.pid);
+        }
+        // Get world metadata
+        try {
+            const worldStat = await stat(worldPath);
+            const size = await this.getDirectorySize(worldPath);
+            world.setMetadata(size, worldStat.mtime);
+        }
+        catch {
+            // Ignore metadata errors
+        }
+        return world;
+    }
+    /**
+     * Check if world exists
+     */
+    async exists(name) {
+        const worldPath = join(this.worldsDir, name);
+        return existsSync(worldPath);
+    }
+    /**
+     * Get unlocked worlds
+     */
+    async findUnlocked() {
+        const worlds = await this.findAll();
+        return worlds.filter((w) => !w.isLocked);
+    }
+    /**
+     * Get locked worlds
+     */
+    async findLocked() {
+        const worlds = await this.findAll();
+        return worlds.filter((w) => w.isLocked);
+    }
+    /**
+     * Get worlds locked by a specific server
+     */
+    async findByServer(serverName) {
+        const worlds = await this.findAll();
+        return worlds.filter((w) => w.lockedBy === serverName);
+    }
+    /**
+     * List world names
+     */
+    async listNames() {
+        if (!existsSync(this.worldsDir)) {
+            return [];
+        }
+        try {
+            const entries = await readdir(this.worldsDir, { withFileTypes: true });
+            return entries
+                .filter((entry) => entry.isDirectory())
+                .filter((entry) => !entry.name.startsWith('.')) // Skip hidden dirs like .locks
+                .map((entry) => entry.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get lock status for a world
+     */
+    async getLockStatus(name) {
+        const lockFile = join(this.locksDir, `${name}.lock`);
+        if (!existsSync(lockFile)) {
+            return null;
+        }
+        try {
+            const content = await readFile(lockFile, 'utf-8');
+            const [serverName, timestampStr, pidStr] = content.trim().split(':');
+            if (!serverName || !timestampStr) {
+                return null;
+            }
+            return {
+                worldName: name,
+                serverName,
+                timestamp: new Date(parseInt(timestampStr, 10) * 1000),
+                pid: pidStr ? parseInt(pidStr, 10) : undefined,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get all worlds with their server status
+     * Returns worlds categorized by availability
+     */
+    async findAllWithServerStatus() {
+        const worlds = await this.findAll();
+        const results = [];
+        for (const world of worlds) {
+            if (!world.isLocked) {
+                // World is not locked by any server - available
+                results.push({
+                    world,
+                    category: 'available',
+                });
+            }
+            else {
+                // World is locked - check server status
+                const serverName = world.lockedBy;
+                const containerName = serverName.startsWith('mc-')
+                    ? serverName
+                    : `mc-${serverName}`;
+                const containerStatus = getContainerStatus(containerName);
+                let serverStatus;
+                let category;
+                if (containerStatus === 'running') {
+                    serverStatus = 'running';
+                    category = 'running';
+                }
+                else if (containerStatus === 'not_found') {
+                    serverStatus = 'not_found';
+                    // If container not found, treat as available (stale lock)
+                    category = 'available';
+                }
+                else {
+                    // exited, paused, created, etc. - server is stopped
+                    serverStatus = 'stopped';
+                    category = 'stopped';
+                }
+                results.push({
+                    world,
+                    assignedServer: serverName,
+                    serverStatus,
+                    category,
+                });
+            }
+        }
+        // Sort: available first, then stopped, then running
+        const categoryOrder = {
+            available: 0,
+            stopped: 1,
+            running: 2,
+        };
+        return results.sort((a, b) => {
+            const orderDiff = categoryOrder[a.category] - categoryOrder[b.category];
+            if (orderDiff !== 0)
+                return orderDiff;
+            return a.world.name.localeCompare(b.world.name);
+        });
+    }
+    /**
+     * Get directory size recursively
+     */
+    async getDirectorySize(dirPath) {
+        let totalSize = 0;
+        try {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const entryPath = join(dirPath, entry.name);
+                if (entry.isFile()) {
+                    const fileStat = await stat(entryPath);
+                    totalSize += fileStat.size;
+                }
+                else if (entry.isDirectory()) {
+                    totalSize += await this.getDirectorySize(entryPath);
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return totalSize;
+    }
+}
+//# sourceMappingURL=WorldRepository.js.map

package/dist/infrastructure/adapters/WorldRepository.js.map

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

package/dist/infrastructure/adapters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Infrastructure Adapters
+ * Concrete implementations of application ports
+ */
+export { ShellAdapter, type ShellAdapterOptions } from './ShellAdapter.js';
+export { ServerRepository } from './ServerRepository.js';
+export { WorldRepository } from './WorldRepository.js';
+export { DocsAdapter } from './DocsAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/infrastructure/adapters/index.js

@@ -0,0 +1,9 @@
+/**
+ * Infrastructure Adapters
+ * Concrete implementations of application ports
+ */
+export { ShellAdapter } from './ShellAdapter.js';
+export { ServerRepository } from './ServerRepository.js';
+export { WorldRepository } from './WorldRepository.js';
+export { DocsAdapter } from './DocsAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Infrastructure Layer
+ * Adapters for external systems (shell, repositories, docs)
+ */
+export * from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,6 @@
+/**
+ * Infrastructure Layer
+ * Adapters for external systems (shell, repositories, docs)
+ */
+export * from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Server status types
+ */
+export type ContainerStatus = 'running' | 'exited' | 'paused' | 'restarting' | 'dead' | 'created' | 'not_found';
+export type HealthStatus = 'healthy' | 'unhealthy' | 'starting' | 'none' | 'unknown';
+export interface ServerInfo {
+    name: string;
+    container: string;
+    status: ContainerStatus;
+    health: HealthStatus;
+    hostname: string;
+}
+export interface RouterInfo {
+    name: string;
+    status: ContainerStatus;
+    health: HealthStatus;
+    port: number;
+}
+export interface AvahiInfo {
+    name: string;
+    status: string;
+    type: 'system';
+}
+export interface PlatformStatus {
+    router: RouterInfo;
+    avahi_daemon: AvahiInfo;
+    servers: ServerInfo[];
+}
+/**
+ * Configuration types
+ */
+export interface McctlConfig {
+    version: string;
+    initialized: string;
+    dataDir: string;
+    defaultType: ServerType;
+    defaultVersion: string;
+    autoStart: boolean;
+    avahiEnabled: boolean;
+}
+export type ServerType = 'PAPER' | 'VANILLA' | 'FORGE' | 'FABRIC' | 'SPIGOT' | 'BUKKIT';
+export interface ServerConfig {
+    name: string;
+    type: ServerType;
+    version: string;
+    memory: string;
+    motd?: string;
+    seed?: string;
+    worldUrl?: string;
+    world?: string;
+}
+export interface EnvConfig {
+    HOST_IP?: string;
+    RCON_PASSWORD?: string;
+    TZ?: string;
+    DEFAULT_VERSION?: string;
+    DEFAULT_MEMORY?: string;
+    MINECRAFT_NETWORK?: string;
+    MINECRAFT_SUBNET?: string;
+    BACKUP_GITHUB_TOKEN?: string;
+    BACKUP_GITHUB_REPO?: string;
+    BACKUP_GITHUB_BRANCH?: string;
+    BACKUP_AUTO_ON_STOP?: boolean;
+}
+/**
+ * World lock types
+ */
+export type LockStatus = 'unlocked' | 'locked' | 'stale';
+export interface WorldLock {
+    world: string;
+    status: LockStatus;
+    holder?: string;
+    timestamp?: Date;
+    age?: string;
+}
+/**
+ * Backup types
+ */
+export interface BackupInfo {
+    commit: string;
+    message: string;
+    date: Date;
+    author: string;
+}
+export interface BackupStatus {
+    configured: boolean;
+    repo?: string;
+    branch?: string;
+    lastBackup?: BackupInfo;
+}
+/**
+ * Player types
+ */
+export interface PlayerInfo {
+    username: string;
+    uuid: string;
+    offlineUuid?: string;
+    avatar?: string;
+}
+/**
+ * Command result types
+ */
+export interface CommandResult<T = void> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    code?: number;
+}
+/**
+ * Container stats types
+ */
+export interface ContainerStats {
+    memoryUsage: number;
+    memoryLimit: number;
+    memoryPercent: number;
+    cpuPercent: number;
+}
+export interface PlayerListResult {
+    online: number;
+    max: number;
+    players: string[];
+}
+/**
+ * Detailed server info
+ */
+export interface DetailedServerInfo extends ServerInfo {
+    type?: string;
+    version?: string;
+    memory?: string;
+    uptime?: string;
+    uptimeSeconds?: number;
+    players?: PlayerListResult;
+    stats?: ContainerStats;
+    worldName?: string;
+    worldSize?: string;
+}
+/**
+ * Router detail info
+ */
+export interface RouterDetailInfo extends RouterInfo {
+    uptime?: string;
+    uptimeSeconds?: number;
+    routes: RouteInfo[];
+    mode?: string;
+}
+export interface RouteInfo {
+    hostname: string;
+    target: string;
+    serverStatus: ContainerStatus;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,81 @@
+import type { McctlConfig, EnvConfig } from '../types/index.js';
+/**
+ * Get the package root directory
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Path resolution utilities
+ */
+export declare class Paths {
+    private readonly dataDir;
+    private readonly packageRoot;
+    constructor(dataDir?: string);
+    /** User data directory (~/.minecraft-servers) */
+    get root(): string;
+    /** Platform directory within data */
+    get platform(): string;
+    /** Scripts directory (from package or local) */
+    get scripts(): string;
+    /** Templates directory (from package) */
+    get templates(): string;
+    /** Servers directory */
+    get servers(): string;
+    /** Worlds directory */
+    get worlds(): string;
+    /** Locks directory */
+    get locks(): string;
+    /** Shared plugins directory */
+    get plugins(): string;
+    /** Shared mods directory */
+    get mods(): string;
+    /** Backups directory */
+    get backups(): string;
+    /** .env file path */
+    get envFile(): string;
+    /** docker-compose.yml path */
+    get composeFile(): string;
+    /** Server template directory */
+    get serverTemplate(): string;
+    /** Config file path */
+    get configFile(): string;
+    /** Check if platform is initialized */
+    isInitialized(): boolean;
+    /** Get server directory */
+    serverDir(name: string): string;
+    /** Get world directory */
+    worldDir(name: string): string;
+    /** Get lock file path */
+    lockFile(world: string): string;
+}
+/**
+ * Configuration utilities
+ */
+export declare class Config {
+    private readonly paths;
+    constructor(paths?: Paths);
+    /** Load mcctl config */
+    load(): McctlConfig | null;
+    /** Save mcctl config */
+    save(config: McctlConfig): void;
+    /** Load .env file */
+    loadEnv(): EnvConfig;
+}
+/**
+ * Console output utilities with colors
+ */
+export declare const colors: {
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    cyan: (s: string) => string;
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+};
+export declare const log: {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug: (msg: string) => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAsBvC;AAED;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,CAAC,EAAE,MAAM;IAK5B,iDAAiD;IACjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gDAAgD;IAChD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,yCAAyC;IACzC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,uBAAuB;IACvB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sBAAsB;IACtB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,+BAA+B;IAC/B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,4BAA4B;IAC5B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,qBAAqB;IACrB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8BAA8B;IAC9B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gCAAgC;IAChC,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,uBAAuB;IACvB,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,uCAAuC;IACvC,aAAa,IAAI,OAAO;IAIxB,2BAA2B;IAC3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGhC;AAED;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,KAAK,CAAC,EAAE,KAAK;IAIzB,wBAAwB;IACxB,IAAI,IAAI,WAAW,GAAG,IAAI;IAc1B,wBAAwB;IACxB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAW/B,qBAAqB;IACrB,OAAO,IAAI,SAAS;CAqCrB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;aACR,MAAM;eACJ,MAAM;gBACL,MAAM;cACR,MAAM;cACN,MAAM;cACN,MAAM;aACP,MAAM;CAChB,CAAC;AAEF,eAAO,MAAM,GAAG;gBACF,MAAM;gBACN,MAAM;iBACL,MAAM;iBACN,MAAM;CAKpB,CAAC"}