+ {/* Top Header */}
+
+
+ User Directory & Moderation
+
+ View registered users, promote administrator roles, block or unblock accounts, and revoke active sessions.
+
+
+
+
+
+ ) : (
+
+ );
+}
diff --git a/src/features/admin/components/block-user-dialog.tsx b/src/features/admin/components/block-user-dialog.tsx
new file mode 100644
index 0000000..550e2b5
--- /dev/null
+++ b/src/features/admin/components/block-user-dialog.tsx
@@ -0,0 +1,197 @@
+"use client";
+
+import { useState } from "react";
+import { AlertTriangle, Ban, CheckCircle2, Loader2 } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import {
+ Dialog,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import {
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+} from "@/components/ui/select";
+import {
+ banUser,
+ unbanUser,
+ type AdminUser,
+} from "@/features/admin/lib/admin-users-client";
+
+interface BlockUserDialogProps {
+ user: AdminUser | null;
+ mode: "block" | "unblock";
+ open: boolean;
+ onOpenChange: (open: boolean) => void;
+ onSuccess: (updatedUser: AdminUser) => void;
+}
+
+const BAN_DURATIONS = [
+ { label: "Permanent", seconds: 0 },
+ { label: "24 Hours", seconds: 86400 },
+ { label: "7 Days", seconds: 604800 },
+ { label: "30 Days", seconds: 2592000 },
+];
+
+export function BlockUserDialog({
+ user,
+ mode,
+ open,
+ onOpenChange,
+ onSuccess,
+}: Readonly
+
+
+ {/* Main Tab Content */}
+ {activeTab === "users" ? (
+
+
+
+
+
+
+ {/* Tab switcher */}
+
+
+
+
+ + Admin Console +
++ Manage users, account access, security moderation, and delivery tools +
+
+
+
+
+
+
+ )}
+
+
+
+
+
+ {userItem.image ? (
+
+
+ {userItem.name?.slice(0, 2).toUpperCase() || "U"}
+
+ )}
+
+
+
+ {userItem.name}
+ {isSelf ? (
+
+ You
+
+ ) : null}
+
+
+ {userItem.email}
+
+
+ {/* Search & Filter Bar */}
+
+ );
+}
diff --git a/src/features/admin/lib/admin-users-client.ts b/src/features/admin/lib/admin-users-client.ts
new file mode 100644
index 0000000..90c50d9
--- /dev/null
+++ b/src/features/admin/lib/admin-users-client.ts
@@ -0,0 +1,111 @@
+"use client";
+
+import { authClient } from "@/lib/auth-client";
+
+export interface AdminUser {
+ id: string;
+ name: string;
+ email: string;
+ emailVerified: boolean;
+ image?: string | null;
+ role?: string;
+ banned: boolean;
+ banReason?: string | null;
+ banExpires?: Date | string | null;
+ createdAt: Date | string;
+ updatedAt: Date | string;
+}
+
+export interface ListUsersParams {
+ searchValue?: string;
+ searchField?: "email" | "name";
+ limit?: number;
+ offset?: number;
+ sortBy?: string;
+ sortDirection?: "asc" | "desc";
+ filterField?: string;
+ filterValue?: string | number | boolean;
+ filterOperator?: "eq" | "ne" | "contains";
+}
+
+export async function listAdminUsers(params: ListUsersParams = {}) {
+ const response = await authClient.admin.listUsers({
+ query: {
+ searchValue: params.searchValue?.trim() || undefined,
+ searchField: params.searchField || undefined,
+ limit: params.limit ?? 20,
+ offset: params.offset ?? 0,
+ sortBy: params.sortBy ?? "createdAt",
+ sortDirection: params.sortDirection ?? "desc",
+ filterField: params.filterField || undefined,
+ filterValue: params.filterValue ?? undefined,
+ filterOperator: params.filterOperator || undefined,
+ },
+ });
+
+ if (response.error) {
+ throw new Error(response.error.message ?? "Failed to list users.");
+ }
+
+ return {
+ users: ((response.data?.users ?? []) as unknown) as AdminUser[],
+ total: response.data?.total ?? 0,
+ };
+}
+
+export async function banUser(input: {
+ userId: string;
+ banReason?: string;
+ banExpiresIn?: number;
+}) {
+ const response = await authClient.admin.banUser({
+ userId: input.userId,
+ banReason: input.banReason?.trim() || undefined,
+ banExpiresIn: input.banExpiresIn,
+ });
+
+ if (response.error) {
+ throw new Error(response.error.message ?? "Failed to ban user.");
+ }
+
+ return response.data;
+}
+
+export async function unbanUser(userId: string) {
+ const response = await authClient.admin.unbanUser({
+ userId,
+ });
+
+ if (response.error) {
+ throw new Error(response.error.message ?? "Failed to unban user.");
+ }
+
+ return response.data;
+}
+
+export type AdminRole = "user" | "admin";
+
+export async function setUserRole(userId: string, role: AdminRole) {
+ const response = await authClient.admin.setRole({
+ userId,
+ role,
+ });
+
+ if (response.error) {
+ throw new Error(response.error.message ?? "Failed to update user role.");
+ }
+
+ return response.data;
+}
+
+export async function revokeUserSessions(userId: string) {
+ const response = await authClient.admin.revokeUserSessions({
+ userId,
+ });
+
+ if (response.error) {
+ throw new Error(response.error.message ?? "Failed to revoke user sessions.");
+ }
+
+ return response.data;
+}
diff --git a/src/features/admin/server/admin-guard.ts b/src/features/admin/server/admin-guard.ts
new file mode 100644
index 0000000..10c8a61
--- /dev/null
+++ b/src/features/admin/server/admin-guard.ts
@@ -0,0 +1,38 @@
+import "server-only";
+
+import { eq } from "drizzle-orm";
+import { auth } from "@/lib/auth";
+import { admin, user } from "@/lib/auth-schema";
+import { getDatabase } from "@/lib/db";
+
+export async function checkIsAdmin(userId: string): Promise
+
+
+ {/* Notification banner */}
+ {actionMessage ? (
+
+
+
+
+
+
+
+
+
+
+
+ {actionMessage.type === "success" ? (
+
+ ) : null}
+
+ {/* Table Container */}
+
+
+
+
+
+
+ {/* Pagination Controls */}
+ | + User + | ++ Role + | ++ Status + | ++ Joined + | ++ Actions + | +
|---|
+
+
+ {/* Block/Unblock Confirmation Dialog */}
+
+ Showing {users.length > 0 ? offset + 1 : 0} to{" "}
+ {Math.min(offset + users.length, total)} of {total} users
+
+
+
+
+
+
+ Page {currentPage} of {totalPages}
+
+
+
+
+
-
-
-
-
-
-
- GitHub Search API
-
-
-
+
+
+
+
+
+
+
+ GitHub Search API
+
+
+
+
+
-
+
+
-
+
-
+
+ Find active open-source issues by tech. +
++ Search contributor-friendly GitHub issues with labels like + help wanted, good first issue, up-for-grabs, and + documentation. +
-
- - Find active open-source issues by tech. -
-- Search contributor-friendly GitHub issues with labels like - help wanted, good first issue, up-for-grabs, and - documentation. -
-
-
-
-
+
-
-
-
+
+
+
+ GitHub Search API
-
-
+
+
+
Find issues by organization.
-
+
Discover issues across top open-source organizations filtered by your preferred technology.
-
+
) => (
+ // eslint-disable-next-line @next/next/no-img-element
+ ![{alt}]()
+ ),
+}));
+
+vi.mock("@/components/ui/dropdown-menu", () => ({
+ DropdownMenu: ({ children }: any) => {children},
+ DropdownMenuTrigger: ({ children }: any) => {children},
+ DropdownMenuContent: ({ children }: any) => {children},
+ DropdownMenuItem: ({ children, onClick, disabled, className }: any) => (
+
+ ),
+ DropdownMenuLabel: ({ children }: any) => {children},
+ DropdownMenuSeparator: () =>
,
+}));
+
+vi.mock("@/components/ui/select", () => ({
+ Select: ({ value, onValueChange, children }: any) => (
+
+
+
+ ),
+ SelectTrigger: ({ children }: any) => <>{children},
+ SelectValue: () => null,
+ SelectContent: ({ children }: any) => <>{children},
+ SelectItem: ({ children, value }: any) => (
+
+ ),
+}));
+
+vi.mock("@/features/admin/components/block-user-dialog", () => ({
+ BlockUserDialog: ({ user, mode, open, onSuccess, onOpenChange }: any) =>
+ open && user ? (
+
+ Dialog mode: {mode}
+
+
+
+ ) : null,
+}));
+
+import { UserManagementTable } from "@/features/admin/components/user-management-table";
+
+const mockUsers = [
+ {
+ id: "user-1",
+ name: "Arnab Nandy",
+ email: "arnab@example.com",
+ emailVerified: true,
+ role: "admin",
+ banned: false,
+ image: "https://example.com/avatar1.png",
+ createdAt: "2026-01-01T00:00:00.000Z",
+ updatedAt: "2026-01-01T00:00:00.000Z",
+ },
+ {
+ id: "user-2",
+ name: "Bad Actor",
+ email: "bad@example.com",
+ emailVerified: false,
+ role: "user",
+ banned: true,
+ banReason: "Spamming",
+ image: null,
+ createdAt: "2026-02-01T00:00:00.000Z",
+ updatedAt: "2026-02-01T00:00:00.000Z",
+ },
+ {
+ id: "user-3",
+ name: "Good Contributor",
+ email: "good@example.com",
+ emailVerified: true,
+ role: "user",
+ banned: false,
+ image: "https://example.com/avatar3.png",
+ createdAt: "2026-02-05T00:00:00.000Z",
+ updatedAt: "2026-02-05T00:00:00.000Z",
+ },
+ {
+ id: "user-4",
+ name: "Colleague Admin",
+ email: "colleague@example.com",
+ emailVerified: true,
+ role: "admin",
+ banned: false,
+ image: null,
+ createdAt: "2026-02-10T00:00:00.000Z",
+ updatedAt: "2026-02-10T00:00:00.000Z",
+ },
+];
+
+describe("UserManagementTable", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ listAdminUsers.mockResolvedValue({
+ users: mockUsers,
+ total: 25,
+ });
+ });
+
+ afterEach(cleanup);
+
+ it("renders user table with user records, roles, and status badges", async () => {
+ render(();
+ const database = {
+ select: vi.fn().mockReturnValue({
+ from: (table: unknown) => ({
+ where: () => {
+ const rows = rowsByTable.get(table) ?? [];
+ const promise = Promise.resolve(rows);
+ return {
+ limit: async () => rows,
+ then: promise.then.bind(promise),
+ };
+ },
+ }),
+ }),
+ };
+ return {
+ getSession: vi.fn(),
+ database,
+ rowsByTable,
+ };
+});
+
+vi.mock("server-only", () => ({}));
+vi.mock("@/lib/auth", () => ({ auth: { api: { getSession } } }));
+vi.mock("@/lib/db", () => ({ getDatabase: () => database }));
+
+import { admin, user } from "@/lib/auth-schema";
+import { checkIsAdmin, getAdminSession } from "@/features/admin/server/admin-guard";
+
+describe("admin guard server helper", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ rowsByTable.clear();
+ });
+
+ it("returns true when user has role = 'admin'", async () => {
+ rowsByTable.set(user, [{ role: "admin" }]);
+
+ const isAdmin = await checkIsAdmin("user-1");
+ expect(isAdmin).toBe(true);
+ });
+
+ it("falls back to admin table when user role is not admin", async () => {
+ rowsByTable.set(user, [{ role: "user" }]);
+ rowsByTable.set(admin, [{ userId: "user-2" }]);
+
+ const isAdmin = await checkIsAdmin("user-2");
+ expect(isAdmin).toBe(true);
+ });
+
+ it("returns false when user is neither admin role nor in admin table", async () => {
+ rowsByTable.set(user, [{ role: "user" }]);
+ rowsByTable.set(admin, []);
+
+ const isAdmin = await checkIsAdmin("user-3");
+ expect(isAdmin).toBe(false);
+ });
+
+ it("returns session and isAdmin status from getAdminSession", async () => {
+ getSession.mockResolvedValue({
+ user: { id: "admin-1", email: "admin@example.com" },
+ });
+ rowsByTable.set(user, [{ role: "admin" }]);
+
+ const headers = new Headers();
+ const result = await getAdminSession(headers);
+
+ expect(result.session).toBeDefined();
+ expect(result.isAdmin).toBe(true);
+ });
+
+ it("returns null session when unauthenticated", async () => {
+ getSession.mockResolvedValue(null);
+
+ const headers = new Headers();
+ const result = await getAdminSession(headers);
+
+ expect(result.session).toBeNull();
+ expect(result.isAdmin).toBe(false);
+ });
+});
diff --git a/tests/features/organizations/dashboard.test.tsx b/tests/features/organizations/dashboard.test.tsx
index 27be687..f93d238 100644
--- a/tests/features/organizations/dashboard.test.tsx
+++ b/tests/features/organizations/dashboard.test.tsx
@@ -1,7 +1,6 @@
// @vitest-environment jsdom
import * as React from "react";
import {
- act,
cleanup,
fireEvent,
render,
@@ -21,7 +20,7 @@ vi.mock("@/components/theme-toggle", () => ({ ThemeToggle: () => null }));
vi.mock("@/components/ui/select", () => ({
Select: ({ value, onValueChange, children }: any) => {
let selectTrigger: any = null;
- let selectItems: any[] = [];
+ const selectItems: any[] = [];
React.Children.forEach(children, (child: any) => {
if (!child) return;
if (child.type?.name === "SelectTrigger" || child.props?.["aria-label"]) {
diff --git a/vitest.config.ts b/vitest.config.ts
index 01a5e23..dc0ae08 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -21,6 +21,7 @@ export default defineConfig({
"src/app/page.tsx",
"src/app/organizations/page.tsx",
"src/app/pull-requests/page.tsx",
+ "src/app/admin/page.tsx",
"src/components/theme-provider.tsx",
"src/app/api/auth/**",
"src/lib/auth-schema.ts",
+
-
+ Find issues by organization.
-+
Discover issues across top open-source organizations filtered by your preferred technology.
User Table: {currentUserId}
+ ),
+}));
+
+vi.mock("@/features/issues/components/admin-email-card", () => ({
+ AdminEmailCard: ({ defaultEmail }: { defaultEmail: string }) => (
+ Email Card: {defaultEmail}
+ ),
+}));
+
+import { AdminDashboard } from "@/features/admin/components/admin-dashboard";
+
+describe("AdminDashboard", () => {
+ afterEach(cleanup);
+
+ it("renders with user management tab active by default", () => {
+ render(
+
+
+ {children}
+
+ ),
+ SelectTrigger: ({ children }: any) => {children}
,
+ SelectValue: ({ children }: any) => {children}
,
+ SelectContent: ({ children }: any) => {children}
,
+ SelectItem: ({ children, value }: any) => (
+
+ ),
+}));
+
+import { BlockUserDialog } from "@/features/admin/components/block-user-dialog";
+import type { AdminUser } from "@/features/admin/lib/admin-users-client";
+
+const mockUser: AdminUser = {
+ id: "user-1",
+ name: "Jane Doe",
+ email: "jane@example.com",
+ emailVerified: true,
+ role: "user",
+ banned: false,
+ createdAt: "2026-01-01T00:00:00.000Z",
+ updatedAt: "2026-01-01T00:00:00.000Z",
+};
+
+describe("BlockUserDialog", () => {
+ const onOpenChange = vi.fn();
+ const onSuccess = vi.fn();
+
+ beforeEach(() => {
+ vi.clearAllMocks();
+ });
+
+ afterEach(cleanup);
+
+ it("renders nothing when user is null", () => {
+ const { container } = render(
+ {children}
,
+ DropdownMenuTrigger: ({ children }: any) => {children}
,
+ DropdownMenuContent: ({ children }: any) => {children}
,
+ DropdownMenuItem: ({ children, onClick, disabled, className }: any) => (
+
+ ),
+ DropdownMenuLabel: ({ children }: any) => {children}
,
+ DropdownMenuSeparator: () => , +})); + +vi.mock("@/components/ui/select", () => ({ + Select: ({ value, onValueChange, children }: any) => ( +
+
+
+ ),
+ SelectTrigger: ({ children }: any) => <>{children},
+ SelectValue: () => null,
+ SelectContent: ({ children }: any) => <>{children},
+ SelectItem: ({ children, value }: any) => (
+
+ ),
+}));
+
+vi.mock("@/features/admin/components/block-user-dialog", () => ({
+ BlockUserDialog: ({ user, mode, open, onSuccess, onOpenChange }: any) =>
+ open && user ? (
+
+ Dialog mode: {mode}
+
+
+
+ ) : null,
+}));
+
+import { UserManagementTable } from "@/features/admin/components/user-management-table";
+
+const mockUsers = [
+ {
+ id: "user-1",
+ name: "Arnab Nandy",
+ email: "arnab@example.com",
+ emailVerified: true,
+ role: "admin",
+ banned: false,
+ image: "https://example.com/avatar1.png",
+ createdAt: "2026-01-01T00:00:00.000Z",
+ updatedAt: "2026-01-01T00:00:00.000Z",
+ },
+ {
+ id: "user-2",
+ name: "Bad Actor",
+ email: "bad@example.com",
+ emailVerified: false,
+ role: "user",
+ banned: true,
+ banReason: "Spamming",
+ image: null,
+ createdAt: "2026-02-01T00:00:00.000Z",
+ updatedAt: "2026-02-01T00:00:00.000Z",
+ },
+ {
+ id: "user-3",
+ name: "Good Contributor",
+ email: "good@example.com",
+ emailVerified: true,
+ role: "user",
+ banned: false,
+ image: "https://example.com/avatar3.png",
+ createdAt: "2026-02-05T00:00:00.000Z",
+ updatedAt: "2026-02-05T00:00:00.000Z",
+ },
+ {
+ id: "user-4",
+ name: "Colleague Admin",
+ email: "colleague@example.com",
+ emailVerified: true,
+ role: "admin",
+ banned: false,
+ image: null,
+ createdAt: "2026-02-10T00:00:00.000Z",
+ updatedAt: "2026-02-10T00:00:00.000Z",
+ },
+];
+
+describe("UserManagementTable", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ listAdminUsers.mockResolvedValue({
+ users: mockUsers,
+ total: 25,
+ });
+ });
+
+ afterEach(cleanup);
+
+ it("renders user table with user records, roles, and status badges", async () => {
+ render(