A local-first multi-agent app development platform, built on PenguinHarness
/**
* Admin user-backend routes: only the built-in admin can use these (403 for non-admins),
* and desktop mode rejects the whole surface (single-user; 403 `desktop_single_user`).
* GET|POST /api/admin/users, POST /api/admin/users/:userId/password, DELETE /api/admin/users/:userId.
* The other admin surfaces are their own route groups contributed from this component: the
* server settings, the settings groups plugins declare, and the read-only storage ledger.
*/
import { Hono } from "hono";
import type { AdminUserCreateResponse, AdminUsersResponse } from "../../api/types.js";
import { HttpError } from "../errors.js";
import { rejectInDesktopMode } from "./desktop.js";
import type { DesktopService } from "../../services/desktop-service.js";
import type { AppEnv } from "../../auth/middleware.js";
import { pathParam, readJson, requireString } from "../validate.js";
import { Bind, Component, Use } from "@adelie/core/kernel";
import type { Desktop, Proxy } from "../../hmr/capabilities.js";
import { adminSettingsRoutes } from "./admin-settings.js";
import { adminStorageRoutes } from "./admin-storage.js";
import { adminPluginConfigRoutes } from "./admin-plugin-config.js";
import { PluginConfigAdmin } from "../../plugin/config-page.js";
import type { Admin } from "../../mechanisms/identity.js";
import type { Settings } from "../../mechanisms/settings.js";
import type { StorageAdmin } from "../../services/storage-service.js";
/** What this route group reaches — bound by its module (src/modules). */
export interface AdminRouteDeps {
desktop: DesktopService | null;
adminService: Admin;
}
export function adminUsersRoutes(deps: AdminRouteDeps): Hono<AppEnv> {
const app = new Hono<AppEnv>();
app.use("*", rejectInDesktopMode(deps));
app.use("*", async (c, next) => {
if (!c.var.user.isAdmin) {
throw new HttpError(403, "admin_required", "Only an admin can perform this operation.");
}
await next();
});
app.get("/", async (c) => {
return c.json({ users: await deps.adminService.listUsers() } satisfies AdminUsersResponse);
});
app.post("/", async (c) => {
const body = await readJson(c);
const userId = requireString(body, "userId", { label: "userId" });
const password = requireString(body, "password", { label: "password" });
const user = await deps.adminService.createUser(userId, password);
return c.json({ user } satisfies AdminUserCreateResponse, 201);
});
app.post("/:userId/password", async (c) => {
const body = await readJson(c);
const password = requireString(body, "password", { label: "password" });
await deps.adminService.resetPassword(pathParam(c, "userId"), password);
return c.body(null, 204);
});
app.delete("/:userId", async (c) => {
await deps.adminService.deleteUser(pathParam(c, "userId"));
return c.body(null, 204);
});
return app;
}
@Component({
contributes: {
"HttpModule.routes": [
{
id: "admin-api.users",
prefix: "/api/admin/users",
auth: "user",
order: 30,
},
{
id: "admin-api.settings",
prefix: "/api/admin/settings",
auth: "user",
order: 40,
},
{
id: "admin-api.plugin-config",
prefix: "/api/admin/plugin-config",
auth: "user",
order: 45,
},
{
id: "admin-api.storage",
prefix: "/api/admin/storage",
auth: "user",
order: 50,
},
],
},
})
export class AdminRoutes {
@Use() private readonly admin!: Admin;
@Use() private readonly desktop!: Desktop;
@Use() private readonly proxy!: Proxy;
@Use() private readonly settings!: Settings;
@Use() private readonly pluginConfigAdmin!: PluginConfigAdmin;
@Use() private readonly storage!: StorageAdmin;
@Bind("admin-api.users") usersRoutes!: Hono<AppEnv>;
@Bind("admin-api.settings") settingsRoutes!: Hono<AppEnv>;
@Bind("admin-api.plugin-config") pluginConfigRoutes!: Hono<AppEnv>;
@Bind("admin-api.storage") storageRoutes!: Hono<AppEnv>;
setup() {
this.pluginConfigRoutes = adminPluginConfigRoutes(this.pluginConfigAdmin);
this.usersRoutes = adminUsersRoutes({
adminService: this.admin,
desktop: this.desktop.current() as DesktopService | null,
});
this.settingsRoutes = adminSettingsRoutes({
proxyControl: (settings) => this.proxy.apply(settings),
serverSettingsRepo: this.settings,
});
this.storageRoutes = adminStorageRoutes({ storage: this.storage });
}
}