The admin router provides endpoints for system administration. All endpoints require the admin role.
Get system stats
Retrieve system-wide statistics.
const stats = await client.admin.getSystemStats();
Response
Total number of books in the system
Total number of libraries
Total number of organizations
List users
Get all users in the system.
const users = await client.admin.listUsers();
Response
Array of user objects:
Whether email is verified
Ban user
Ban a user from the system.
await client.admin.banUser({
userId: "user-id",
});
Response
Unban user
Remove a ban from a user.
await client.admin.unbanUser({
userId: "user-id",
});
Response
Set user role
Change a user’s role.
await client.admin.setUserRole({
userId: "user-id",
role: "admin",
});
Response
List organizations
Get all organizations in the system.
const orgs = await client.admin.listOrganizations();
Response
Array of organization objects:
Organization slug (unique identifier)
Create organization
Create a new organization.
const org = await client.admin.createOrganization({
name: "Acme Corp",
slug: "acme-corp",
});
Organization name (minimum 1 character)
Organization slug (minimum 1 character, must be unique)
Response
Created organization object.
Delete organization
Delete an organization and all its data.
await client.admin.deleteOrganization({
orgId: "org-id",
});
Response
Get organization with members
Retrieve detailed organization information including all members.
const org = await client.admin.getOrgWithMembers({
orgId: "org-id",
});
Response
Array of member objectsMember role in organization
Remove member
Remove a member from an organization.
await client.admin.removeMember({
memberId: "member-id",
});
Response
Update member role
Change a member’s role within an organization.
await client.admin.updateMemberRole({
memberId: "member-id",
role: "admin",
});
New role (organization-specific role)
Response
Backfill cover colors
Trigger a background job to extract dominant colors from book covers that are missing color information.
const result = await client.admin.backfillCoverColors();
console.log(`Enqueued ${result.enqueued} books`);
Response
Number of books queued for color extraction
Admin authorization
All admin endpoints use adminProcedure, which requires:
- An authenticated session (
UNAUTHORIZED if missing)
- The
admin role (FORBIDDEN if not admin)
const requireAdmin = o.middleware(async ({ context, next }) => {
if (!context.session?.user) {
throw new ORPCError("UNAUTHORIZED");
}
if (context.session.user.role !== "admin") {
throw new ORPCError("FORBIDDEN");
}
return next({
context: {
session: context.session,
},
});
});
export const adminProcedure = publicProcedure.use(requireAdmin);
Example: Admin dashboard
import { orpc } from "@/utils/orpc";
function AdminDashboard() {
const { data: stats } = orpc.admin.getSystemStats.useQuery();
const { data: users } = orpc.admin.listUsers.useQuery();
const { data: orgs } = orpc.admin.listOrganizations.useQuery();
const banUser = orpc.admin.banUser.useMutation();
const setRole = orpc.admin.setUserRole.useMutation();
return (
<div>
<h1>System stats</h1>
<div>
<p>Users: {stats?.totalUsers}</p>
<p>Books: {stats?.totalBooks}</p>
<p>Libraries: {stats?.totalLibraries}</p>
<p>Organizations: {stats?.totalOrganizations}</p>
</div>
<h2>Users</h2>
<table>
<thead>
<tr>
<th>Email</th>
<th>Role</th>
<th>Banned</th>
<th>Actions</th>
</tr>
</thead>
<tbody>
{users?.map((user) => (
<tr key={user.id}>
<td>{user.email}</td>
<td>{user.role}</td>
<td>{user.banned ? "Yes" : "No"}</td>
<td>
<button onClick={() => banUser.mutate({ userId: user.id })}>
{user.banned ? "Unban" : "Ban"}
</button>
<button onClick={() => setRole.mutate({
userId: user.id,
role: user.role === "admin" ? "user" : "admin",
})}>
Toggle admin
</button>
</td>
</tr>
))}
</tbody>
</table>
</div>
);
}
