emdash 0.0.0-a → 0.0.1

package/src/astro/routes/api/admin/plugins/marketplace/[id]/install.ts

@@ -0,0 +1,62 @@
+/**
+ * Marketplace plugin install endpoint
+ *
+ * POST /_emdash/api/admin/plugins/marketplace/:id/install - Install a marketplace plugin
+ */
+
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, handleError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceInstall } from "#api/index.js";
+import { isParseError, parseOptionalBody } from "#api/parse.js";
+
+export const prerender = false;
+
+const installBodySchema = z.object({
+	version: z.string().min(1).optional(),
+});
+
+export const POST: APIRoute = async ({ params, request, locals }) => {
+	try {
+		const { emdash, user } = locals;
+		const { id } = params;
+
+		if (!emdash?.db) {
+			return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+		}
+
+		const denied = requirePerm(user, "plugins:manage");
+		if (denied) return denied;
+
+		if (!id) {
+			return apiError("INVALID_REQUEST", "Plugin ID required", 400);
+		}
+
+		const body = await parseOptionalBody(request, installBodySchema, {});
+		if (isParseError(body)) return body;
+
+		const configuredPluginIds = new Set<string>(
+			emdash.configuredPlugins.map((p: { id: string }) => p.id),
+		);
+
+		const result = await handleMarketplaceInstall(
+			emdash.db,
+			emdash.storage,
+			emdash.getSandboxRunner(),
+			emdash.config.marketplace,
+			id,
+			{ version: body.version, configuredPluginIds },
+		);
+
+		if (!result.success) return unwrapResult(result);
+
+		await emdash.syncMarketplacePlugins();
+
+		return unwrapResult(result, 201);
+	} catch (error) {
+		console.error("[marketplace-install] Unhandled error:", error);
+		return handleError(error, "Failed to install plugin from marketplace", "INSTALL_FAILED");
+	}
+};

package/src/astro/routes/api/admin/plugins/marketplace/index.ts

@@ -0,0 +1,38 @@
+/**
+ * Marketplace search proxy endpoint
+ *
+ * GET /_emdash/api/admin/plugins/marketplace - Search marketplace plugins
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceSearch } from "#api/index.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ url, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "plugins:read");
+	if (denied) return denied;
+
+	const query = url.searchParams.get("q") ?? undefined;
+	const category = url.searchParams.get("category") ?? undefined;
+	const cursor = url.searchParams.get("cursor") ?? undefined;
+	const limitParam = url.searchParams.get("limit");
+	const limit = limitParam ? Math.min(Math.max(1, parseInt(limitParam, 10) || 50), 100) : undefined;
+
+	const result = await handleMarketplaceSearch(emdash.config.marketplace, query, {
+		category,
+		cursor,
+		limit,
+	});
+
+	return unwrapResult(result);
+};

package/src/astro/routes/api/admin/plugins/updates.ts

@@ -0,0 +1,28 @@
+/**
+ * Marketplace update check endpoint
+ *
+ * GET /_emdash/api/admin/plugins/updates - Check for marketplace plugin updates
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceUpdateCheck } from "#api/index.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "plugins:read");
+	if (denied) return denied;
+
+	const result = await handleMarketplaceUpdateCheck(emdash.db, emdash.config.marketplace);
+
+	return unwrapResult(result);
+};

package/src/astro/routes/api/admin/themes/marketplace/[id]/index.ts

@@ -0,0 +1,33 @@
+/**
+ * Theme marketplace detail proxy endpoint
+ *
+ * GET /_emdash/api/admin/themes/marketplace/:id - Get theme details
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleThemeGetDetail } from "#api/index.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ params, locals }) => {
+	const { emdash, user } = locals;
+	const { id } = params;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "plugins:read");
+	if (denied) return denied;
+
+	if (!id) {
+		return apiError("INVALID_REQUEST", "Theme ID required", 400);
+	}
+
+	const result = await handleThemeGetDetail(emdash.config.marketplace, id);
+
+	return unwrapResult(result);
+};

package/src/astro/routes/api/admin/themes/marketplace/[id]/thumbnail.ts

@@ -0,0 +1,61 @@
+/**
+ * Theme marketplace thumbnail proxy
+ *
+ * GET /_emdash/api/admin/themes/marketplace/:id/thumbnail - Proxy thumbnail from marketplace
+ *
+ * Avoids CORS/auth issues when the marketplace Worker is behind Cloudflare Access
+ * or on a different origin. The admin UI uses this instead of linking directly.
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError } from "#api/error.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ params, url, locals }) => {
+	const { emdash, user } = locals;
+	const { id } = params;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "plugins:read");
+	if (denied) return denied;
+
+	const marketplaceUrl = emdash.config.marketplace;
+	if (!marketplaceUrl || !id) {
+		return apiError("NOT_CONFIGURED", "Marketplace not configured", 400);
+	}
+
+	const width = url.searchParams.get("w");
+	const target = new URL(`/api/v1/themes/${encodeURIComponent(id)}/thumbnail`, marketplaceUrl);
+	if (width) target.searchParams.set("w", width);
+
+	try {
+		const resp = await fetch(target.href);
+		if (!resp.ok) {
+			// Allowlist: only forward Content-Type from upstream.
+			// Never copy all upstream headers (denylist approach leaks
+			// headers we haven't anticipated).
+			return new Response(resp.body, {
+				status: resp.status,
+				headers: {
+					"Content-Type": resp.headers.get("Content-Type") ?? "application/octet-stream",
+					"Cache-Control": "private, no-store",
+				},
+			});
+		}
+
+		return new Response(resp.body, {
+			headers: {
+				"Content-Type": resp.headers.get("Content-Type") ?? "image/png",
+				"Cache-Control": "private, no-store",
+			},
+		});
+	} catch {
+		return apiError("PROXY_ERROR", "Failed to fetch thumbnail", 502);
+	}
+};

package/src/astro/routes/api/admin/themes/marketplace/index.ts

@@ -0,0 +1,45 @@
+/**
+ * Theme marketplace search proxy endpoint
+ *
+ * GET /_emdash/api/admin/themes/marketplace - Search marketplace themes
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleThemeSearch } from "#api/index.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ url, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "plugins:read");
+	if (denied) return denied;
+
+	const query = url.searchParams.get("q") ?? undefined;
+	const keyword = url.searchParams.get("keyword") ?? undefined;
+	const sortParam = url.searchParams.get("sort");
+	const validSorts = new Set(["name", "created", "updated"]);
+	let sort: "name" | "created" | "updated" | undefined;
+	if (sortParam && validSorts.has(sortParam)) {
+		sort = sortParam as "name" | "created" | "updated"; // eslint-disable-line typescript-eslint(no-unsafe-type-assertion) -- validated by Set.has()
+	}
+	const cursor = url.searchParams.get("cursor") ?? undefined;
+	const limitParam = url.searchParams.get("limit");
+	const limit = limitParam ? Math.min(Math.max(1, parseInt(limitParam, 10) || 50), 100) : undefined;
+
+	const result = await handleThemeSearch(emdash.config.marketplace, query, {
+		keyword,
+		sort,
+		cursor,
+		limit,
+	});
+
+	return unwrapResult(result);
+};

package/src/astro/routes/api/admin/users/[id]/disable.ts

@@ -0,0 +1,69 @@
+/**
+ * User disable endpoint
+ *
+ * POST /_emdash/api/admin/users/:id/disable - Soft-disable a user
+ */
+
+import { Role } from "@emdash-cms/auth";
+import { createKyselyAdapter } from "@emdash-cms/auth/adapters/kysely";
+import type { APIRoute } from "astro";
+
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+
+export const prerender = false;
+
+export const POST: APIRoute = async ({ params, locals }) => {
+	const { emdash, user: currentUser } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "Database not configured", 500);
+	}
+
+	if (!currentUser || currentUser.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const adapter = createKyselyAdapter(emdash.db);
+
+	const { id } = params;
+
+	if (!id) {
+		return apiError("VALIDATION_ERROR", "User ID required", 400);
+	}
+
+	// Prevent disabling self
+	if (id === currentUser.id) {
+		return apiError("VALIDATION_ERROR", "Cannot disable your own account", 400);
+	}
+
+	try {
+		// Get target user
+		const targetUser = await adapter.getUserById(id);
+		if (!targetUser) {
+			return apiError("NOT_FOUND", "User not found", 404);
+		}
+
+		// Check if this would leave no active admins
+		if (targetUser.role === Role.ADMIN) {
+			const adminCount = await adapter.countAdmins();
+			if (adminCount <= 1) {
+				return apiError(
+					"VALIDATION_ERROR",
+					"Cannot disable the last admin. Promote another user first.",
+					400,
+				);
+			}
+		}
+
+		// Disable user
+		await adapter.updateUser(id, { disabled: true });
+
+		// SEC-43: Revoke all OAuth tokens for the disabled user.
+		// Without this, existing refresh tokens remain valid for up to 90 days.
+		await emdash.db.deleteFrom("_emdash_oauth_tokens").where("user_id", "=", id).execute();
+
+		return apiSuccess({ success: true });
+	} catch (error) {
+		return handleError(error, "Failed to disable user", "USER_DISABLE_ERROR");
+	}
+};

package/src/astro/routes/api/admin/users/[id]/enable.ts

@@ -0,0 +1,48 @@
+/**
+ * User enable endpoint
+ *
+ * POST /_emdash/api/admin/users/:id/enable - Re-enable a disabled user
+ */
+
+import { Role } from "@emdash-cms/auth";
+import { createKyselyAdapter } from "@emdash-cms/auth/adapters/kysely";
+import type { APIRoute } from "astro";
+
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+
+export const prerender = false;
+
+export const POST: APIRoute = async ({ params, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "Database not configured", 500);
+	}
+
+	if (!user || user.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const adapter = createKyselyAdapter(emdash.db);
+
+	const { id } = params;
+
+	if (!id) {
+		return apiError("VALIDATION_ERROR", "User ID required", 400);
+	}
+
+	try {
+		// Get target user
+		const targetUser = await adapter.getUserById(id);
+		if (!targetUser) {
+			return apiError("NOT_FOUND", "User not found", 404);
+		}
+
+		// Enable user
+		await adapter.updateUser(id, { disabled: false });
+
+		return apiSuccess({ success: true });
+	} catch (error) {
+		return handleError(error, "Failed to enable user", "USER_ENABLE_ERROR");
+	}
+};

package/src/astro/routes/api/admin/users/[id]/index.ts

@@ -0,0 +1,146 @@
+/**
+ * User management detail endpoint
+ *
+ * GET /_emdash/api/admin/users/:id - Get user details
+ * PUT /_emdash/api/admin/users/:id - Update user
+ */
+
+import { Role } from "@emdash-cms/auth";
+import { createKyselyAdapter } from "@emdash-cms/auth/adapters/kysely";
+import type { APIRoute } from "astro";
+
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+import { isParseError, parseBody } from "#api/parse.js";
+import { userUpdateBody } from "#api/schemas.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ params, locals }) => {
+	const { emdash, user: currentUser } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	if (!currentUser || currentUser.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const adapter = createKyselyAdapter(emdash.db);
+
+	const { id } = params;
+
+	if (!id) {
+		return apiError("MISSING_PARAM", "User ID required", 400);
+	}
+
+	try {
+		const result = await adapter.getUserWithDetails(id);
+
+		if (!result) {
+			return apiError("NOT_FOUND", "User not found", 404);
+		}
+
+		// Transform for JSON serialization
+		const item = {
+			id: result.user.id,
+			email: result.user.email,
+			name: result.user.name,
+			avatarUrl: result.user.avatarUrl,
+			role: result.user.role,
+			emailVerified: result.user.emailVerified,
+			disabled: result.user.disabled,
+			createdAt: result.user.createdAt.toISOString(),
+			updatedAt: result.user.updatedAt.toISOString(),
+			lastLogin: result.lastLogin?.toISOString() ?? null,
+			credentials: result.credentials.map((c) => ({
+				id: c.id,
+				name: c.name,
+				deviceType: c.deviceType,
+				createdAt: c.createdAt.toISOString(),
+				lastUsedAt: c.lastUsedAt.toISOString(),
+			})),
+			oauthAccounts: result.oauthAccounts.map((a) => ({
+				provider: a.provider,
+				createdAt: a.createdAt.toISOString(),
+			})),
+		};
+
+		return apiSuccess({ item });
+	} catch (error) {
+		return handleError(error, "Failed to get user details", "USER_DETAIL_ERROR");
+	}
+};
+
+export const PUT: APIRoute = async ({ params, request, locals }) => {
+	const { emdash, user: currentUser } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	if (!currentUser || currentUser.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const adapter = createKyselyAdapter(emdash.db);
+
+	const { id } = params;
+
+	if (!id) {
+		return apiError("MISSING_PARAM", "User ID required", 400);
+	}
+
+	try {
+		// Get target user
+		const targetUser = await adapter.getUserById(id);
+		if (!targetUser) {
+			return apiError("NOT_FOUND", "User not found", 404);
+		}
+
+		const body = await parseBody(request, userUpdateBody);
+		if (isParseError(body)) return body;
+
+		// Role is already validated as RoleLevel by Zod schema
+		const role = body.role;
+
+		// Prevent editing own role (security: prevents self-demotion/lockout)
+		if (role !== undefined && id === currentUser.id) {
+			return apiError("SELF_ROLE_CHANGE", "Cannot change your own role", 400);
+		}
+
+		// Check email uniqueness if changing email
+		if (body.email && body.email !== targetUser.email) {
+			const existing = await adapter.getUserByEmail(body.email);
+			if (existing) {
+				return apiError("EMAIL_IN_USE", "Email already in use", 409);
+			}
+		}
+
+		// Update user
+		await adapter.updateUser(id, {
+			name: body.name,
+			email: body.email,
+			role,
+		});
+
+		// Fetch updated user
+		const updated = await adapter.getUserById(id);
+
+		return apiSuccess({
+			item: {
+				id: updated!.id,
+				email: updated!.email,
+				name: updated!.name,
+				avatarUrl: updated!.avatarUrl,
+				role: updated!.role,
+				emailVerified: updated!.emailVerified,
+				disabled: updated!.disabled,
+				createdAt: updated!.createdAt.toISOString(),
+				updatedAt: updated!.updatedAt.toISOString(),
+			},
+		});
+	} catch (error) {
+		return handleError(error, "Failed to update user", "USER_UPDATE_ERROR");
+	}
+};

package/src/astro/routes/api/admin/users/[id]/send-recovery.ts

@@ -0,0 +1,72 @@
+/**
+ * Send recovery link endpoint
+ *
+ * POST /_emdash/api/admin/users/:id/send-recovery
+ *
+ * Admin-initiated account recovery — sends a recovery magic link to the user's email.
+ */
+
+import { Role, sendMagicLink, type MagicLinkConfig } from "@emdash-cms/auth";
+import { createKyselyAdapter } from "@emdash-cms/auth/adapters/kysely";
+import type { APIRoute } from "astro";
+
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+import { getSiteBaseUrl } from "#api/site-url.js";
+import { OptionsRepository } from "#db/repositories/options.js";
+
+export const prerender = false;
+
+export const POST: APIRoute = async ({ request, params, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "Database not configured", 500);
+	}
+
+	if (!user || user.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const { id } = params;
+
+	if (!id) {
+		return apiError("VALIDATION_ERROR", "User ID required", 400);
+	}
+
+	try {
+		const adapter = createKyselyAdapter(emdash.db);
+
+		// Verify target user exists
+		const targetUser = await adapter.getUserById(id);
+		if (!targetUser) {
+			return apiError("NOT_FOUND", "User not found", 404);
+		}
+
+		// Check if email pipeline is available
+		if (!emdash.email?.isAvailable()) {
+			return apiError(
+				"EMAIL_NOT_CONFIGURED",
+				"Email is not configured. Recovery links require an email provider.",
+				503,
+			);
+		}
+
+		// Build config using stored site URL (not request Host header)
+		const options = new OptionsRepository(emdash.db);
+		const baseUrl = await getSiteBaseUrl(emdash.db, request);
+		const siteName = (await options.get<string>("emdash:site_title")) ?? "EmDash";
+
+		const config: MagicLinkConfig = {
+			baseUrl,
+			siteName,
+			email: (message) => emdash.email!.send(message, "system"),
+		};
+
+		// Send recovery link
+		await sendMagicLink(config, adapter, targetUser.email, "recovery");
+
+		return apiSuccess({ success: true, message: "Recovery link sent" });
+	} catch (error) {
+		return handleError(error, "Failed to send recovery link", "RECOVERY_SEND_ERROR");
+	}
+};

package/src/astro/routes/api/admin/users/index.ts

@@ -0,0 +1,66 @@
+/**
+ * User management list endpoint
+ *
+ * GET /_emdash/api/admin/users - List users with search, filter, pagination
+ */
+
+import { Role } from "@emdash-cms/auth";
+import { createKyselyAdapter } from "@emdash-cms/auth/adapters/kysely";
+import type { APIRoute } from "astro";
+
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+import { isParseError, parseQuery } from "#api/parse.js";
+import { usersListQuery } from "#api/schemas.js";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ url, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	if (!user || user.role < Role.ADMIN) {
+		return apiError("FORBIDDEN", "Admin privileges required", 403);
+	}
+
+	const adapter = createKyselyAdapter(emdash.db);
+
+	try {
+		// Parse query parameters
+		const query = parseQuery(url, usersListQuery);
+		if (isParseError(query)) return query;
+
+		// Fetch users
+		const result = await adapter.getUsers({
+			search: query.search,
+			role: query.role ? parseInt(query.role, 10) : undefined,
+			cursor: query.cursor,
+			limit: query.limit,
+		});
+
+		// Transform dates to ISO strings for JSON serialization
+		const items = result.items.map((u) => ({
+			id: u.id,
+			email: u.email,
+			name: u.name,
+			avatarUrl: u.avatarUrl,
+			role: u.role,
+			emailVerified: u.emailVerified,
+			disabled: u.disabled,
+			createdAt: u.createdAt.toISOString(),
+			updatedAt: u.updatedAt.toISOString(),
+			lastLogin: u.lastLogin?.toISOString() ?? null,
+			credentialCount: u.credentialCount,
+			oauthProviders: u.oauthProviders,
+		}));
+
+		return apiSuccess({
+			items,
+			nextCursor: result.nextCursor,
+		});
+	} catch (error) {
+		return handleError(error, "Failed to list users", "USER_LIST_ERROR");
+	}
+};