Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

4.4 KB
Raw Blame
/**
 * 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 });
  }
}