@minecraft-docker/shared 1.6.0 → 1.6.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/factories/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/infrastructure/factories/index.js

@@ -0,0 +1,5 @@
+/**
+ * Infrastructure Factories
+ */
+export { ModSourceFactory } from './ModSourceFactory.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/factories/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Infrastructure Layer
+ * Adapters for external systems (shell, repositories, docs)
+ */
+export * from './adapters/index.js';
+export * from './config/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;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,7 @@
+/**
+ * Infrastructure Layer
+ * Adapters for external systems (shell, repositories, docs)
+ */
+export * from './adapters/index.js';
+export * from './config/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;AACpC,cAAc,mBAAmB,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"}

package/dist/utils/index.js

@@ -0,0 +1,200 @@
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/**
+ * Get the package root directory
+ */
+export function getPackageRoot() {
+    // When running from npm package, find the package root
+    const currentFile = fileURLToPath(import.meta.url);
+    let dir = dirname(currentFile);
+    // Walk up until we find package.json with @minecraft-docker
+    while (dir !== '/') {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name?.startsWith('@minecraft-docker/')) {
+                    return dir;
+                }
+            }
+            catch {
+                // Continue searching
+            }
+        }
+        dir = dirname(dir);
+    }
+    return dirname(currentFile);
+}
+/**
+ * Path resolution utilities
+ */
+export class Paths {
+    dataDir;
+    packageRoot;
+    constructor(dataDir) {
+        this.packageRoot = getPackageRoot();
+        this.dataDir = dataDir ?? process.env['MCCTL_ROOT'] ?? join(homedir(), 'minecraft-servers');
+    }
+    /** User data directory (~/.minecraft-servers) */
+    get root() {
+        return this.dataDir;
+    }
+    /** Platform directory within data */
+    get platform() {
+        return this.dataDir;
+    }
+    /** Scripts directory (from package or local) */
+    get scripts() {
+        return process.env['MCCTL_SCRIPTS'] ?? join(this.packageRoot, '..', '..', 'scripts');
+    }
+    /** Templates directory (from package) */
+    get templates() {
+        return process.env['MCCTL_TEMPLATES'] ?? join(this.packageRoot, '..', '..', '..', 'templates');
+    }
+    /** Servers directory */
+    get servers() {
+        return join(this.dataDir, 'servers');
+    }
+    /** Worlds directory */
+    get worlds() {
+        return join(this.dataDir, 'worlds');
+    }
+    /** Locks directory */
+    get locks() {
+        return join(this.dataDir, 'worlds', '.locks');
+    }
+    /** Shared plugins directory */
+    get plugins() {
+        return join(this.dataDir, 'shared', 'plugins');
+    }
+    /** Shared mods directory */
+    get mods() {
+        return join(this.dataDir, 'shared', 'mods');
+    }
+    /** Backups directory */
+    get backups() {
+        return join(this.dataDir, 'backups');
+    }
+    /** .env file path */
+    get envFile() {
+        return join(this.dataDir, '.env');
+    }
+    /** docker-compose.yml path */
+    get composeFile() {
+        return join(this.dataDir, 'docker-compose.yml');
+    }
+    /** Server template directory */
+    get serverTemplate() {
+        return join(this.servers, '_template');
+    }
+    /** Config file path */
+    get configFile() {
+        return join(this.dataDir, '.mcctl.json');
+    }
+    /** Check if platform is initialized */
+    isInitialized() {
+        return existsSync(this.composeFile);
+    }
+    /** Get server directory */
+    serverDir(name) {
+        return join(this.servers, name);
+    }
+    /** Get world directory */
+    worldDir(name) {
+        return join(this.worlds, name);
+    }
+    /** Get lock file path */
+    lockFile(world) {
+        return join(this.locks, `${world}.lock`);
+    }
+}
+/**
+ * Configuration utilities
+ */
+export class Config {
+    paths;
+    constructor(paths) {
+        this.paths = paths ?? new Paths();
+    }
+    /** Load mcctl config */
+    load() {
+        const configPath = this.paths.configFile;
+        if (!existsSync(configPath)) {
+            return null;
+        }
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Save mcctl config */
+    save(config) {
+        const configPath = this.paths.configFile;
+        const dir = dirname(configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    /** Load .env file */
+    loadEnv() {
+        const envPath = this.paths.envFile;
+        const config = {};
+        if (!existsSync(envPath)) {
+            return config;
+        }
+        try {
+            const content = readFileSync(envPath, 'utf-8');
+            const lines = content.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                const eqIndex = trimmed.indexOf('=');
+                if (eqIndex === -1)
+                    continue;
+                const key = trimmed.slice(0, eqIndex).trim();
+                let value = trimmed.slice(eqIndex + 1).trim();
+                // Remove quotes
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                config[key] =
+                    value === 'true' ? true : value === 'false' ? false : value;
+            }
+        }
+        catch {
+            // Return empty config on error
+        }
+        return config;
+    }
+}
+/**
+ * Console output utilities with colors
+ */
+export const colors = {
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    blue: (s) => `\x1b[34m${s}\x1b[0m`,
+    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+};
+export const log = {
+    info: (msg) => console.log(`${colors.green('[INFO]')} ${msg}`),
+    warn: (msg) => console.error(`${colors.yellow('[WARN]')} ${msg}`),
+    error: (msg) => console.error(`${colors.red('[ERROR]')} ${msg}`),
+    debug: (msg) => {
+        if (process.env['DEBUG'] === 'true') {
+            console.error(`${colors.blue('[DEBUG]')} ${msg}`);
+        }
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft-docker/shared",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Shared utilities and types for Minecraft Docker platform",
   "type": "module",
   "main": "dist/index.js",
@@ -46,7 +46,7 @@
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "lint": "eslint src --ext .ts",
-    "test": "node --test"
+    "test": "npx tsx --test tests/*.test.ts"
   },
   "keywords": [
     "minecraft",
@@ -61,8 +61,16 @@
     "directory": "platform/services/shared"
   },
   "homepage": "https://minecraft-server-manager.readthedocs.io/",
+  "dependencies": {
+    "bcryptjs": "^3.0.3",
+    "better-sqlite3": "^12.6.2",
+    "js-yaml": "^4.1.1"
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.3.0"
   }
 }