@minecraft-docker/shared 1.6.0 → 1.6.2

package/dist/infrastructure/adapters/SqliteUserRepository.js

@@ -0,0 +1,149 @@
+import Database from 'better-sqlite3';
+import { mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import * as bcrypt from 'bcryptjs';
+import { User } from '../../domain/entities/User.js';
+/**
+ * SqliteUserRepository
+ * Implements IUserRepository using SQLite database storage with better-sqlite3
+ */
+export class SqliteUserRepository {
+    static SALT_ROUNDS = 10;
+    db;
+    /**
+     * Create a new SqliteUserRepository
+     * @param dbPath - Path to the SQLite database file
+     */
+    constructor(dbPath) {
+        // Ensure directory exists
+        const dir = dirname(dbPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Open database connection
+        this.db = new Database(dbPath);
+        // Enable WAL mode for better concurrency
+        this.db.pragma('journal_mode = WAL');
+        // Run migrations
+        this.migrate();
+    }
+    /**
+     * Run database migrations
+     * Creates tables and indexes if they don't exist
+     */
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS users (
+        id TEXT PRIMARY KEY,
+        username TEXT UNIQUE NOT NULL COLLATE NOCASE,
+        password_hash TEXT NOT NULL,
+        role TEXT NOT NULL CHECK(role IN ('admin', 'viewer')),
+        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+        updated_at TEXT DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+      CREATE INDEX IF NOT EXISTS idx_users_role ON users(role);
+    `);
+    }
+    /**
+     * Find a user by their unique ID
+     */
+    async findById(id) {
+        const stmt = this.db.prepare('SELECT * FROM users WHERE id = ?');
+        const row = stmt.get(id.value);
+        if (!row) {
+            return null;
+        }
+        return this.toUser(row);
+    }
+    /**
+     * Find a user by their username (case-insensitive)
+     */
+    async findByUsername(username) {
+        // SQLite COLLATE NOCASE handles case-insensitive comparison
+        const stmt = this.db.prepare('SELECT * FROM users WHERE username = ?');
+        const row = stmt.get(username.value);
+        if (!row) {
+            return null;
+        }
+        return this.toUser(row);
+    }
+    /**
+     * Get all users in the system
+     */
+    async findAll() {
+        const stmt = this.db.prepare('SELECT * FROM users ORDER BY created_at ASC');
+        const rows = stmt.all();
+        return rows.map((row) => this.toUser(row));
+    }
+    /**
+     * Save a user (create or update)
+     * Uses INSERT OR REPLACE for upsert behavior
+     */
+    async save(user) {
+        const stmt = this.db.prepare(`
+      INSERT INTO users (id, username, password_hash, role, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        username = excluded.username,
+        password_hash = excluded.password_hash,
+        role = excluded.role,
+        updated_at = excluded.updated_at
+    `);
+        stmt.run(user.id.value, user.username.value, user.passwordHash, user.role.value, user.createdAt.toISOString(), user.updatedAt.toISOString());
+    }
+    /**
+     * Delete a user by their ID
+     */
+    async delete(id) {
+        const stmt = this.db.prepare('DELETE FROM users WHERE id = ?');
+        stmt.run(id.value);
+    }
+    /**
+     * Get the total count of users
+     */
+    async count() {
+        const stmt = this.db.prepare('SELECT COUNT(*) as count FROM users');
+        const result = stmt.get();
+        return result?.count ?? 0;
+    }
+    /**
+     * Hash a password using bcrypt
+     * @param password - Plain text password to hash
+     * @returns Hashed password
+     */
+    async hashPassword(password) {
+        return bcrypt.hash(password, SqliteUserRepository.SALT_ROUNDS);
+    }
+    /**
+     * Verify a password against a hash
+     * @param password - Plain text password to verify
+     * @param hash - Password hash to verify against
+     * @returns True if password matches, false otherwise
+     */
+    async verifyPassword(password, hash) {
+        return bcrypt.compare(password, hash);
+    }
+    /**
+     * Close the database connection
+     * Should be called when the repository is no longer needed
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Convert a database row to a User entity
+     */
+    toUser(row) {
+        return User.fromRaw({
+            id: row.id,
+            username: row.username,
+            passwordHash: row.password_hash,
+            role: row.role,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        });
+    }
+}
+//# sourceMappingURL=SqliteUserRepository.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { Paths } from '../../utils/index.js';
+import { World } from '../../domain/index.js';
+import type { IWorldRepository, WorldLockData, WorldWithServerStatus } from '../../application/ports/outbound/IWorldRepository.js';
+/**
+ * WorldRepository
+ * Implements IWorldRepository for world data access
+ */
+export declare class WorldRepository implements IWorldRepository {
+    private readonly paths;
+    private readonly worldsDir;
+    private readonly locksDir;
+    constructor(paths?: Paths);
+    /**
+     * Get all worlds
+     */
+    findAll(): Promise<World[]>;
+    /**
+     * Find world by name
+     */
+    findByName(name: string): Promise<World | null>;
+    /**
+     * Check if world exists
+     */
+    exists(name: string): Promise<boolean>;
+    /**
+     * Get unlocked worlds
+     */
+    findUnlocked(): Promise<World[]>;
+    /**
+     * Get locked worlds
+     */
+    findLocked(): Promise<World[]>;
+    /**
+     * Get worlds locked by a specific server
+     */
+    findByServer(serverName: string): Promise<World[]>;
+    /**
+     * List world names
+     */
+    listNames(): Promise<string[]>;
+    /**
+     * Get lock status for a world
+     */
+    getLockStatus(name: string): Promise<WorldLockData | null>;
+    /**
+     * Get all worlds with their server status
+     * Returns worlds categorized by availability
+     */
+    findAllWithServerStatus(): Promise<WorldWithServerStatus[]>;
+    /**
+     * Delete a world directory and its lock file
+     */
+    delete(name: string): Promise<boolean>;
+    /**
+     * Get directory size recursively
+     */
+    private getDirectorySize;
+    /**
+     * Create a new world directory with optional seed
+     */
+    create(name: string, seed?: string): Promise<World>;
+    /**
+     * Get seed for a world from .meta file
+     */
+    getSeed(name: string): Promise<string | null>;
+}
+//# sourceMappingURL=WorldRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorldRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/adapters/WorldRepository.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EAGtB,MAAM,sDAAsD,CAAC;AAE9D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,KAAK,CAAC,EAAE,KAAK;IAMzB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAcjC;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA4BrD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpC;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAKxD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBpC;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA0BhE;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA0DjE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB5C;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAkCzD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAepD"}

package/dist/infrastructure/adapters/WorldRepository.js

@@ -0,0 +1,283 @@
+import { readdir, readFile, stat, rm, unlink, mkdir, writeFile } 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 and seed
+        try {
+            const worldStat = await stat(worldPath);
+            const size = await this.getDirectorySize(worldPath);
+            const seed = await this.getSeed(name);
+            world.setMetadata(size, worldStat.mtime, seed ?? undefined);
+        }
+        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);
+        });
+    }
+    /**
+     * Delete a world directory and its lock file
+     */
+    async delete(name) {
+        const worldPath = join(this.worldsDir, name);
+        const lockFile = join(this.locksDir, `${name}.lock`);
+        if (!existsSync(worldPath)) {
+            return false;
+        }
+        try {
+            // Delete lock file if exists
+            if (existsSync(lockFile)) {
+                await unlink(lockFile);
+            }
+            // Delete world directory
+            await rm(worldPath, { recursive: true, force: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 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;
+    }
+    /**
+     * Create a new world directory with optional seed
+     */
+    async create(name, seed) {
+        const worldPath = join(this.worldsDir, name);
+        // Check if already exists
+        if (existsSync(worldPath)) {
+            throw new Error(`World '${name}' already exists`);
+        }
+        // Ensure worlds directory exists
+        if (!existsSync(this.worldsDir)) {
+            await mkdir(this.worldsDir, { recursive: true });
+        }
+        // Create world directory
+        await mkdir(worldPath, { recursive: true });
+        // Create .meta file with seed if provided
+        const metaPath = join(worldPath, '.meta');
+        const metaContent = {
+            name,
+            seed: seed || null,
+            createdAt: new Date().toISOString(),
+        };
+        await writeFile(metaPath, JSON.stringify(metaContent, null, 2), 'utf-8');
+        // Create and return the World entity
+        const world = new World(name, worldPath);
+        if (seed) {
+            world.setSeed(seed);
+        }
+        return world;
+    }
+    /**
+     * Get seed for a world from .meta file
+     */
+    async getSeed(name) {
+        const metaPath = join(this.worldsDir, name, '.meta');
+        if (!existsSync(metaPath)) {
+            return null;
+        }
+        try {
+            const content = await readFile(metaPath, 'utf-8');
+            const meta = JSON.parse(content);
+            return meta.seed || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# 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/YamlUserRepository.d.ts

@@ -0,0 +1,67 @@
+import type { IUserRepository } from '../../application/ports/outbound/IUserRepository.js';
+import { User } from '../../domain/entities/User.js';
+import { UserId } from '../../domain/value-objects/UserId.js';
+import { Username } from '../../domain/value-objects/Username.js';
+/**
+ * YamlUserRepository
+ * Implements IUserRepository using YAML file storage
+ */
+export declare class YamlUserRepository implements IUserRepository {
+    private static readonly SALT_ROUNDS;
+    private readonly filePath;
+    /**
+     * Create a new YamlUserRepository
+     * @param filePath - Path to the YAML file for user storage
+     */
+    constructor(filePath: string);
+    /**
+     * Find a user by their unique ID
+     */
+    findById(id: UserId): Promise<User | null>;
+    /**
+     * Find a user by their username
+     */
+    findByUsername(username: Username): Promise<User | null>;
+    /**
+     * Get all users in the system
+     */
+    findAll(): Promise<User[]>;
+    /**
+     * Save a user (create or update)
+     */
+    save(user: User): Promise<void>;
+    /**
+     * Delete a user by their ID
+     */
+    delete(id: UserId): Promise<void>;
+    /**
+     * Get the total count of users
+     */
+    count(): Promise<number>;
+    /**
+     * Hash a password using bcrypt
+     * @param password - Plain text password to hash
+     * @returns Hashed password
+     */
+    hashPassword(password: string): Promise<string>;
+    /**
+     * Verify a password against a hash
+     * @param password - Plain text password to verify
+     * @param hash - Password hash to verify against
+     * @returns True if password matches, false otherwise
+     */
+    verifyPassword(password: string, hash: string): Promise<boolean>;
+    /**
+     * Load users from YAML file
+     */
+    private loadUsers;
+    /**
+     * Save users to YAML file
+     */
+    private saveUsers;
+    /**
+     * Convert YAML user data to User entity
+     */
+    private toUser;
+}
+//# sourceMappingURL=YamlUserRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"YamlUserRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/adapters/YamlUserRepository.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAkBlE;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;OAGG;gBACS,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAWhD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAc9D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKhC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItE;;OAEG;YACW,SAAS;IAoBvB;;OAEG;YACW,SAAS;IAkBvB;;OAEG;IACH,OAAO,CAAC,MAAM;CAUf"}