@minecraft-docker/mcctl 1.6.0 → 1.6.2

package/dist/lib/admin-config.d.ts

@@ -0,0 +1,66 @@
+/**
+ * API Access Mode
+ * Determines how the Admin API can be accessed
+ */
+export type ApiAccessMode = 'internal' | 'api-key' | 'ip-whitelist' | 'api-key-ip' | 'open';
+/**
+ * Admin Configuration structure stored in YAML
+ */
+export interface AdminConfig {
+    version: string;
+    api: {
+        access_mode: ApiAccessMode;
+        port: number;
+        api_key: string | null;
+        allowed_ips: string[];
+    };
+    console: {
+        enabled: boolean;
+        port: number;
+    };
+    initialized_at: string;
+}
+/**
+ * AdminConfigManager
+ * Manages .mcctl-admin.yml configuration file
+ */
+export declare class AdminConfigManager {
+    private readonly configPath;
+    constructor(rootDir?: string);
+    /**
+     * Get the configuration file path
+     */
+    get path(): string;
+    /**
+     * Check if admin service is already initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Load existing configuration
+     */
+    load(): Promise<AdminConfig | null>;
+    /**
+     * Save configuration to file
+     */
+    save(config: AdminConfig): Promise<void>;
+    /**
+     * Create a new configuration with specified options
+     */
+    create(options: {
+        accessMode: ApiAccessMode;
+        apiKey?: string | null;
+        allowedIps?: string[];
+        apiPort?: number;
+        consolePort?: number;
+        consoleEnabled?: boolean;
+    }): Promise<AdminConfig>;
+    /**
+     * Generate a new API key with mctk_ prefix
+     */
+    static generateApiKey(): string;
+    /**
+     * Validate an API key format
+     */
+    static isValidApiKey(key: string): boolean;
+}
+//# sourceMappingURL=admin-config.d.ts.map

package/dist/lib/admin-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-config.d.ts","sourceRoot":"","sources":["../../src/lib/admin-config.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,SAAS,GACT,cAAc,GACd,YAAY,GACZ,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE;QACH,WAAW,EAAE,aAAa,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;CACxB;AAoBD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,CAAC,EAAE,MAAM;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAazC;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B9C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE;QACpB,UAAU,EAAE,aAAa,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBxB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAS/B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG3C"}

package/dist/lib/admin-config.js

@@ -0,0 +1,130 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import * as yaml from 'js-yaml';
+import { randomBytes } from 'node:crypto';
+import { Paths } from '@minecraft-docker/shared';
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    version: '1.0',
+    api: {
+        access_mode: 'internal',
+        port: 3001,
+        api_key: null,
+        allowed_ips: [],
+    },
+    console: {
+        enabled: true,
+        port: 3000,
+    },
+    initialized_at: new Date().toISOString(),
+};
+/**
+ * AdminConfigManager
+ * Manages .mcctl-admin.yml configuration file
+ */
+export class AdminConfigManager {
+    configPath;
+    constructor(rootDir) {
+        const paths = new Paths(rootDir);
+        this.configPath = join(paths.root, '.mcctl-admin.yml');
+    }
+    /**
+     * Get the configuration file path
+     */
+    get path() {
+        return this.configPath;
+    }
+    /**
+     * Check if admin service is already initialized
+     */
+    isInitialized() {
+        return existsSync(this.configPath);
+    }
+    /**
+     * Load existing configuration
+     */
+    async load() {
+        if (!this.isInitialized()) {
+            return null;
+        }
+        try {
+            const content = await readFile(this.configPath, 'utf-8');
+            return yaml.load(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save configuration to file
+     */
+    async save(config) {
+        // Ensure directory exists
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        const yamlContent = yaml.dump(config, {
+            indent: 2,
+            lineWidth: -1,
+            quotingType: '"',
+            forceQuotes: false,
+        });
+        // Add header comment
+        const header = `# mcctl Admin Service Configuration
+# Generated by: mcctl admin init
+# Do not edit this file manually unless you know what you are doing.
+#
+# API Access Modes:
+#   internal     - Docker network only (default, most secure)
+#   api-key      - External access with API key
+#   ip-whitelist - IP-based access control
+#   api-key-ip   - Requires both API key and IP match
+#   open         - No authentication (development only, NOT for production)
+#
+`;
+        await writeFile(this.configPath, header + yamlContent, 'utf-8');
+    }
+    /**
+     * Create a new configuration with specified options
+     */
+    async create(options) {
+        const config = {
+            ...DEFAULT_CONFIG,
+            api: {
+                access_mode: options.accessMode,
+                port: options.apiPort ?? DEFAULT_CONFIG.api.port,
+                api_key: options.apiKey ?? null,
+                allowed_ips: options.allowedIps ?? [],
+            },
+            console: {
+                enabled: options.consoleEnabled ?? DEFAULT_CONFIG.console.enabled,
+                port: options.consolePort ?? DEFAULT_CONFIG.console.port,
+            },
+            initialized_at: new Date().toISOString(),
+        };
+        await this.save(config);
+        return config;
+    }
+    /**
+     * Generate a new API key with mctk_ prefix
+     */
+    static generateApiKey() {
+        // Generate 32 bytes of random data and encode as base64url
+        const randomPart = randomBytes(32)
+            .toString('base64url')
+            .replace(/[^a-zA-Z0-9]/g, '')
+            .substring(0, 40);
+        return `mctk_${randomPart}`;
+    }
+    /**
+     * Validate an API key format
+     */
+    static isValidApiKey(key) {
+        return /^mctk_[a-zA-Z0-9]{20,}$/.test(key);
+    }
+}
+//# sourceMappingURL=admin-config.js.map

package/dist/lib/admin-config.js.map

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

package/dist/lib/mojang-api.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Mojang API Client
+ * Provides player lookup functionality via Mojang API
+ */
+export interface MojangProfile {
+    id: string;
+    name: string;
+}
+export interface PlayerInfo {
+    name: string;
+    uuid: string;
+    uuidNoDashes: string;
+    skinUrl?: string;
+    isOnline?: boolean;
+    server?: string;
+    source: 'mojang' | 'offline' | 'cache';
+}
+/**
+ * Mojang API client for player lookup
+ */
+export declare class MojangApiClient {
+    private static readonly API_BASE;
+    private static readonly SESSION_BASE;
+    /**
+     * Look up a player by username via Mojang API
+     * Returns null if player not found
+     */
+    lookupByUsername(username: string): Promise<PlayerInfo | null>;
+    /**
+     * Get detailed profile including skin URL
+     * Requires UUID (with or without dashes)
+     */
+    getProfile(uuid: string): Promise<PlayerInfo | null>;
+}
+/**
+ * Format UUID with dashes
+ * Input: 8667ba71b85a4004af54457a9734eed7
+ * Output: 8667ba71-b85a-4004-af54-457a9734eed7
+ */
+export declare function formatUuid(uuid: string): string;
+/**
+ * Calculate offline UUID from username
+ * Offline servers use a different UUID format based on "OfflinePlayer:" + username
+ */
+export declare function calculateOfflineUuid(username: string): string;
+/**
+ * Get player info for offline mode
+ */
+export declare function getOfflinePlayerInfo(username: string): PlayerInfo;
+export declare function getMojangApiClient(): MojangApiClient;
+//# sourceMappingURL=mojang-api.d.ts.map

package/dist/lib/mojang-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mojang-api.d.ts","sourceRoot":"","sources":["../../src/lib/mojang-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAsC;IAE1E;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA+BpE;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAkD3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQjE;AAKD,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD"}

package/dist/lib/mojang-api.js

@@ -0,0 +1,136 @@
+/**
+ * Mojang API Client
+ * Provides player lookup functionality via Mojang API
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Mojang API client for player lookup
+ */
+export class MojangApiClient {
+    static API_BASE = 'https://api.mojang.com';
+    static SESSION_BASE = 'https://sessionserver.mojang.com';
+    /**
+     * Look up a player by username via Mojang API
+     * Returns null if player not found
+     */
+    async lookupByUsername(username) {
+        try {
+            const response = await fetch(`${MojangApiClient.API_BASE}/users/profiles/minecraft/${encodeURIComponent(username)}`);
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`Mojang API error: ${response.status} ${response.statusText}`);
+            }
+            const profile = await response.json();
+            const uuid = formatUuid(profile.id);
+            return {
+                name: profile.name,
+                uuid,
+                uuidNoDashes: profile.id,
+                source: 'mojang',
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('fetch')) {
+                throw new Error(`Failed to connect to Mojang API: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get detailed profile including skin URL
+     * Requires UUID (with or without dashes)
+     */
+    async getProfile(uuid) {
+        try {
+            const uuidNoDashes = uuid.replace(/-/g, '');
+            const response = await fetch(`${MojangApiClient.SESSION_BASE}/session/minecraft/profile/${uuidNoDashes}`);
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`Mojang Session API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const formattedUuid = formatUuid(data.id);
+            // Extract skin URL from properties
+            let skinUrl;
+            if (data.properties) {
+                const texturesProp = data.properties.find((p) => p.name === 'textures');
+                if (texturesProp) {
+                    try {
+                        const textures = JSON.parse(Buffer.from(texturesProp.value, 'base64').toString('utf-8'));
+                        skinUrl = textures.textures?.SKIN?.url;
+                    }
+                    catch {
+                        // Ignore texture parsing errors
+                    }
+                }
+            }
+            return {
+                name: data.name,
+                uuid: formattedUuid,
+                uuidNoDashes: data.id,
+                skinUrl,
+                source: 'mojang',
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('fetch')) {
+                throw new Error(`Failed to connect to Mojang Session API: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Format UUID with dashes
+ * Input: 8667ba71b85a4004af54457a9734eed7
+ * Output: 8667ba71-b85a-4004-af54-457a9734eed7
+ */
+export function formatUuid(uuid) {
+    const clean = uuid.replace(/-/g, '');
+    if (clean.length !== 32) {
+        return uuid; // Return as-is if not a valid UUID
+    }
+    return `${clean.slice(0, 8)}-${clean.slice(8, 12)}-${clean.slice(12, 16)}-${clean.slice(16, 20)}-${clean.slice(20)}`;
+}
+/**
+ * Calculate offline UUID from username
+ * Offline servers use a different UUID format based on "OfflinePlayer:" + username
+ */
+export function calculateOfflineUuid(username) {
+    const hash = createHash('md5').update(`OfflinePlayer:${username}`).digest();
+    // Set version to 3 (name-based MD5)
+    const byte6 = hash[6];
+    const byte8 = hash[8];
+    if (byte6 !== undefined && byte8 !== undefined) {
+        hash[6] = (byte6 & 0x0f) | 0x30;
+        // Set variant to RFC 4122
+        hash[8] = (byte8 & 0x3f) | 0x80;
+    }
+    const hex = hash.toString('hex');
+    return formatUuid(hex);
+}
+/**
+ * Get player info for offline mode
+ */
+export function getOfflinePlayerInfo(username) {
+    const uuid = calculateOfflineUuid(username);
+    return {
+        name: username,
+        uuid,
+        uuidNoDashes: uuid.replace(/-/g, ''),
+        source: 'offline',
+    };
+}
+// Singleton instance
+let mojangApiClient = null;
+export function getMojangApiClient() {
+    if (!mojangApiClient) {
+        mojangApiClient = new MojangApiClient();
+    }
+    return mojangApiClient;
+}
+//# sourceMappingURL=mojang-api.js.map

package/dist/lib/mojang-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mojang-api.js","sourceRoot":"","sources":["../../src/lib/mojang-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiBzC;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,MAAM,CAAU,QAAQ,GAAG,wBAAwB,CAAC;IACpD,MAAM,CAAU,YAAY,GAAG,kCAAkC,CAAC;IAE1E;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,eAAe,CAAC,QAAQ,6BAA6B,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACvF,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAmB,CAAC;YACvD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAEpC,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI;gBACJ,YAAY,EAAE,OAAO,CAAC,EAAE;gBACxB,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,eAAe,CAAC,YAAY,8BAA8B,YAAY,EAAE,CAC5E,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAI/B,CAAC;YACF,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE1C,mCAAmC;YACnC,IAAI,OAA2B,CAAC;YAChC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;gBACxE,IAAI,YAAY,EAAE,CAAC;oBACjB,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;wBACzF,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC;oBACzC,CAAC;oBAAC,MAAM,CAAC;wBACP,gCAAgC;oBAClC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,aAAa;gBACnB,YAAY,EAAE,IAAI,CAAC,EAAE;gBACrB,OAAO;gBACP,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,KAAK,CAAC,4CAA4C,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;;AAGH;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAClD,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACvH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAE5E,oCAAoC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAChC,0BAA0B;QAC1B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED,qBAAqB;AACrB,IAAI,eAAe,GAA2B,IAAI,CAAC;AAEnD,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/lib/player-cache.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Player Cache System
+ * Encrypted local cache for Mojang API responses to minimize rate limiting
+ */
+import { type PlayerInfo } from './mojang-api.js';
+/**
+ * Player cache with AES-256-GCM encryption
+ */
+export declare class PlayerCache {
+    private readonly cachePath;
+    private cache;
+    private encryptionKey;
+    constructor(cacheDir?: string);
+    /**
+     * Look up a player by username
+     * First checks cache, then Mojang API
+     */
+    lookup(username: string, options?: {
+        forceRefresh?: boolean;
+        offline?: boolean;
+    }): Promise<PlayerInfo | null>;
+    /**
+     * Look up a player with full profile (including skin URL)
+     */
+    lookupWithProfile(username: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<PlayerInfo | null>;
+    /**
+     * Get player from cache if valid
+     */
+    private getFromCache;
+    /**
+     * Save player info to cache
+     */
+    private saveToCache;
+    /**
+     * Update skin URL in cache
+     */
+    private updateSkinInCache;
+    /**
+     * Load cache from encrypted file
+     */
+    private loadCache;
+    /**
+     * Persist cache to encrypted file
+     */
+    private persistCache;
+    /**
+     * Get or derive encryption key
+     */
+    private getEncryptionKey;
+    /**
+     * Get machine-specific identifier for key derivation
+     */
+    private getMachineIdentifier;
+    /**
+     * Encrypt data using AES-256-GCM
+     */
+    private encrypt;
+    /**
+     * Decrypt data using AES-256-GCM
+     */
+    private decrypt;
+    /**
+     * Clear all cached data
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getStats(): Promise<{
+        playerCount: number;
+        oldestEntry: number | null;
+        newestEntry: number | null;
+        cacheSize: number;
+    }>;
+}
+export declare function getPlayerCache(cacheDir?: string): PlayerCache;
+//# sourceMappingURL=player-cache.d.ts.map

package/dist/lib/player-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-cache.d.ts","sourceRoot":"","sources":["../../src/lib/player-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAoCzB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,QAAQ,CAAC,EAAE,MAAM;IAK7B;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkCvH;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqC/G;;OAEG;YACW,YAAY;IAsB1B;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,iBAAiB;IAY/B;;OAEG;YACW,SAAS;IAyBvB;;OAEG;YACW,YAAY;IAwB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;YACW,OAAO;IAoBrB;;OAEG;YACW,OAAO;IAkBrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CAsBH;AAKD,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAK7D"}