tekton/server/nakama/tekton_admin.js

/**
 * Tekton Nakama Server Runtime Module
 * 
 * This module provides secure admin operations via RPC calls.
 * Deploy this to your Nakama server's runtime directory.
 */

// Initialize RPC endpoints
function InitModule(ctx, logger, nk, initializer) {
    // Admin RPCs
    initializer.registerRpc("admin_kick_player", rpcAdminKickPlayer);
    initializer.registerRpc("admin_ban_player", rpcAdminBanPlayer);
    initializer.registerRpc("admin_unban_player", rpcAdminUnbanPlayer);
    initializer.registerRpc("admin_get_ban_list", rpcAdminGetBanList);
    initializer.registerRpc("admin_get_server_stats", rpcAdminGetServerStats);
    initializer.registerRpc("admin_get_player_list", rpcAdminGetPlayerList);
    initializer.registerRpc("admin_end_match", rpcAdminEndMatch);
    initializer.registerRpc("admin_set_user_role", rpcAdminSetUserRole);

    // User management RPCs
    initializer.registerRpc("get_user_profile", rpcGetUserProfile);
    initializer.registerRpc("update_user_profile", rpcUpdateUserProfile);
    
    // Leaderboard RPCs
    initializer.registerRpc("get_leaderboard_stats", rpcGetLeaderboardStats);

    logger.info("Tekton admin module loaded");
}

// =============================================================================
// Authorization Helpers
// =============================================================================

var ADMIN_ROLES = ["admin", "moderator", "owner"];

function isAdmin(ctx, nk) {
    if (!ctx.userId) return false;

    try {
        var account = nk.accountGetId(ctx.userId);
        var metadata = JSON.parse(account.user.metadata || "{}");
        return ADMIN_ROLES.indexOf(metadata.role || "") !== -1;
    } catch (e) {
        return false;
    }
}

function isMatchHost(ctx, nk, matchId) {
    if (!ctx.userId || !matchId) return false;

    try {
        // Get match state to check host
        var match = nk.matchGet(matchId);
        if (!match) return false;

        // The first user to join (presence) is typically the host
        // This logic may need adjustment based on your match handler
        var state = JSON.parse(match.state || "{}");
        return state.hostUserId === ctx.userId;
    } catch (e) {
        return false;
    }
}

function requireAdmin(ctx, nk) {
    if (!isAdmin(ctx, nk)) {
        throw new Error("Admin privileges required");
    }
}

function requireAdminOrHost(ctx, nk, matchId) {
    if (!isAdmin(ctx, nk) && !isMatchHost(ctx, nk, matchId)) {
        throw new Error("Admin or host privileges required");
    }
}

// =============================================================================
// Admin RPCs
// =============================================================================

function rpcAdminKickPlayer(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    requireAdminOrHost(ctx, nk, request.match_id);

    // Can't kick yourself
    if (request.user_id === ctx.userId) {
        throw new Error("Cannot kick yourself");
    }

    try {
        // Signal the match to kick the player
        nk.matchSignal(request.match_id, JSON.stringify({
            action: "kick",
            user_id: request.user_id,
            reason: request.reason || "Kicked by admin"
        }));

        logger.info("Player " + request.user_id + " kicked from match " + request.match_id + " by " + ctx.userId);

        return JSON.stringify({ success: true });
    } catch (e) {
        logger.error("Failed to kick player: " + e);
        throw new Error("Failed to kick player");
    }
}

function rpcAdminBanPlayer(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    // Only full admins can ban (not just match hosts)
    requireAdmin(ctx, nk);

    if (request.user_id === ctx.userId) {
        throw new Error("Cannot ban yourself");
    }

    try {
        // Get target user's account
        var targetAccount = nk.accountGetId(request.user_id);
        var metadata = JSON.parse(targetAccount.user.metadata || "{}");

        // Don't allow banning other admins
        if (ADMIN_ROLES.indexOf(metadata.role || "") !== -1) {
            throw new Error("Cannot ban an admin");
        }

        // Set ban in metadata
        var banExpires = request.duration_hours && request.duration_hours > 0
            ? new Date(Date.now() + request.duration_hours * 60 * 60 * 1000).toISOString()
            : null;

        metadata.banned = true;
        metadata.ban_reason = request.reason || "Banned by admin";
        if (banExpires) {
            metadata.ban_expires = banExpires;
        }

        nk.accountUpdateId(request.user_id, null, null, null, null, null, null, JSON.stringify(metadata));

        // Also kick from current match if specified
        if (request.match_id) {
            nk.matchSignal(request.match_id, JSON.stringify({
                action: "kick",
                user_id: request.user_id,
                reason: "Banned: " + (request.reason || "")
            }));
        }

        // Store in ban list (for quick lookup)
        var banRecord = {
            user_id: request.user_id,
            username: targetAccount.user.username,
            banned_by: ctx.userId,
            banned_at: new Date().toISOString(),
            reason: request.reason,
            expires: banExpires
        };

        nk.storageWrite([{
            collection: "bans",
            key: request.user_id,
            userId: "00000000-0000-0000-0000-000000000000", // System-owned
            value: banRecord,
            permissionRead: 2, // Public read
            permissionWrite: 0 // No one can write (except server)
        }]);

        logger.warn("Player " + request.user_id + " banned by " + ctx.userId + ". Reason: " + request.reason);

        return JSON.stringify({ success: true, ban: banRecord });
    } catch (e) {
        logger.error("Failed to ban player: " + e);
        throw new Error("Failed to ban player: " + e);
    }
}

function rpcAdminUnbanPlayer(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    requireAdmin(ctx, nk);

    try {
        // Get target user's account
        var targetAccount = nk.accountGetId(request.user_id);
        var metadata = JSON.parse(targetAccount.user.metadata || "{}");

        // Remove ban
        delete metadata.banned;
        delete metadata.ban_reason;
        delete metadata.ban_expires;

        nk.accountUpdateId(request.user_id, null, null, null, null, null, null, JSON.stringify(metadata));

        // Remove from ban list
        nk.storageDelete([{
            collection: "bans",
            key: request.user_id,
            userId: "00000000-0000-0000-0000-000000000000"
        }]);

        logger.info("Player " + request.user_id + " unbanned by " + ctx.userId);

        return JSON.stringify({ success: true });
    } catch (e) {
        logger.error("Failed to unban player: " + e);
        throw new Error("Failed to unban player");
    }
}

function rpcAdminGetBanList(ctx, logger, nk, payload) {
    requireAdmin(ctx, nk);

    try {
        var result = nk.storageList(
            "00000000-0000-0000-0000-000000000000",
            "bans",
            100,
            ""
        );

        var bans = result.objects ? result.objects.map(function(obj) { return obj.value; }) : [];

        return JSON.stringify({ bans: bans });
    } catch (e) {
        logger.error("Failed to get ban list: " + e);
        return JSON.stringify({ bans: [] });
    }
}

function rpcAdminGetServerStats(ctx, logger, nk, payload) {
    var request = JSON.parse(payload || "{}");

    if (request.match_id) {
        requireAdminOrHost(ctx, nk, request.match_id);
    } else {
        requireAdmin(ctx, nk);
    }

    try {
        // Get server-wide stats
        var matches = nk.matchList(100, true, null, null, null, null);
        var activeMatchCount = matches ? matches.length : 0;

        var totalPlayers = 0;
        if (matches) {
            for (var i = 0; i < matches.length; i++) {
                totalPlayers += matches[i].size || 0;
            }
        }

        var stats = {
            active_matches: activeMatchCount,
            total_players: totalPlayers,
            server_time: new Date().toISOString()
        };

        // If specific match requested, include match details
        if (request.match_id) {
            try {
                var match = nk.matchGet(request.match_id);
                if (match) {
                    stats.match = {
                        id: match.matchId,
                        size: match.size,
                        tick_rate: match.tickRate,
                        authoritative: match.authoritative
                    };
                }
            } catch (e) {
                // Match not found
            }
        }

        return JSON.stringify(stats);
    } catch (e) {
        logger.error("Failed to get server stats: " + e);
        throw new Error("Failed to get server stats");
    }
}

function rpcAdminGetPlayerList(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    requireAdminOrHost(ctx, nk, request.match_id);

    try {
        var match = nk.matchGet(request.match_id);
        if (!match) {
            throw new Error("Match not found");
        }

        // Get player details
        var players = [];

        // Note: In actual implementation, you'd need to track presences
        // This is a simplified version - adjust based on your match handler

        return JSON.stringify({ players: players });
    } catch (e) {
        logger.error("Failed to get player list: " + e);
        throw new Error("Failed to get player list");
    }
}

function rpcAdminEndMatch(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    requireAdminOrHost(ctx, nk, request.match_id);

    try {
        // Signal match to end
        nk.matchSignal(request.match_id, JSON.stringify({
            action: "end_match",
            reason: request.reason || "Ended by admin"
        }));

        logger.info("Match " + request.match_id + " ended by " + ctx.userId);

        return JSON.stringify({ success: true });
    } catch (e) {
        logger.error("Failed to end match: " + e);
        throw new Error("Failed to end match");
    }
}

function rpcAdminSetUserRole(ctx, logger, nk, payload) {
    var request = JSON.parse(payload);

    // Only owner/super-admin can set roles
    var callerAccount = nk.accountGetId(ctx.userId);
    var callerMetadata = JSON.parse(callerAccount.user.metadata || "{}");

    if (callerMetadata.role !== "owner") {
        throw new Error("Only owners can modify user roles");
    }

    var validRoles = ["player", "moderator", "admin"];
    if (validRoles.indexOf(request.role) === -1) {
        throw new Error("Invalid role");
    }

    try {
        var targetAccount = nk.accountGetId(request.user_id);
        var metadata = JSON.parse(targetAccount.user.metadata || "{}");

        metadata.role = request.role;

        nk.accountUpdateId(request.user_id, null, null, null, null, null, null, JSON.stringify(metadata));

        logger.info("User " + request.user_id + " role set to " + request.role + " by " + ctx.userId);

        return JSON.stringify({ success: true, role: request.role });
    } catch (e) {
        logger.error("Failed to set user role: " + e);
        throw new Error("Failed to set user role");
    }
}

// =============================================================================
// User Profile RPCs
// =============================================================================

function rpcGetUserProfile(ctx, logger, nk, payload) {
    var request = JSON.parse(payload || "{}");
    var targetUserId = request.user_id || ctx.userId;

    try {
        var account = nk.accountGetId(targetUserId);
        var metadata = JSON.parse(account.user.metadata || "{}");

        // Check if banned
        if (metadata.banned && targetUserId === ctx.userId) {
            // Check if ban expired
            if (metadata.ban_expires) {
                var expiresAt = new Date(metadata.ban_expires);
                if (expiresAt <= new Date()) {
                    // Ban expired, remove it
                    delete metadata.banned;
                    delete metadata.ban_reason;
                    delete metadata.ban_expires;
                    nk.accountUpdateId(targetUserId, null, null, null, null, null, null, JSON.stringify(metadata));
                } else {
                    throw new Error("Account banned until " + metadata.ban_expires + ". Reason: " + metadata.ban_reason);
                }
            } else {
                throw new Error("Account permanently banned. Reason: " + metadata.ban_reason);
            }
        }

        return JSON.stringify({
            user_id: account.user.id,
            username: account.user.username,
            display_name: account.user.displayName,
            avatar_url: account.user.avatarUrl,
            create_time: account.user.createTime,
            role: metadata.role || "player"
        });
    } catch (e) {
        throw e;
    }
}

function rpcUpdateUserProfile(ctx, logger, nk, payload) {
    if (!ctx.userId) {
        throw new Error("Not authenticated");
    }

    var request = JSON.parse(payload);

    try {
        nk.accountUpdateId(
            ctx.userId,
            null, // username
            request.display_name || null,
            null, // timezone
            null, // location
            null, // lang
            request.avatar_url || null,
            null // metadata
        );

        return JSON.stringify({ success: true });
    } catch (e) {
        logger.error("Failed to update profile: " + e);
        throw new Error("Failed to update profile");
    }
}

// =============================================================================
// Leaderboard RPCs
// =============================================================================

function rpcGetLeaderboardStats(ctx, logger, nk, payload) {
    try {
        // Query the "stats" collection to get all user stats
        // Warning: For a large production game this should be indexed using Nakama's actual Leaderboard system, 
        // but this works for listing all users' custom storage stats.
        var limit = 100;
        var result = nk.storageList(null, "stats", limit, "");
        
        var statsObjects = result.objects || [];
        var leaderboardData = [];
        
        for (var i = 0; i < statsObjects.length; i++) {
            var obj = statsObjects[i];
            try {
                var stats = JSON.parse(obj.value);
                var userId = obj.userId;
                
                // Get the user's profile to retrieve their display name
                var displayName = "Unknown";
                var avatarUrl = "";
                try {
                    var account = nk.accountGetId(userId);
                    displayName = account.user.displayName || account.user.username;
                    avatarUrl = account.user.avatarUrl;
                } catch (e) {
                    // Ignore if account fetch fails
                }
                
                leaderboardData.push({
                    user_id: userId,
                    display_name: displayName,
                    avatar_url: avatarUrl,
                    games_played: stats.games_played || 0,
                    games_won: stats.games_won || 0,
                    high_score: stats.high_score || 0
                });
            } catch (e) {
                logger.error("Error parsing stats for object: " + obj.key);
            }
        }
        
        return JSON.stringify({ leaderboard: leaderboardData });
    } catch (e) {
        logger.error("Failed to get leaderboard stats: " + e);
        throw new Error("Failed to get leaderboard stats");
    }
}

// Before login hook to check ban status
function beforeAuthenticateEmail(ctx, logger, nk, data) {
    // Can't check ban before auth, so we check in afterAuthenticate
    return data;
}