emdash 0.0.0-b → 0.0.1

package/src/astro/routes/api/admin/hooks/exclusive/[hookName].ts

@@ -0,0 +1,91 @@
+/**
+ * Exclusive hook selection endpoint
+ *
+ * PUT /_emdash/api/admin/hooks/exclusive/:hookName
+ *
+ * Sets or clears the selected provider for an exclusive hook.
+ * Body: { pluginId: string | null }
+ * Requires settings:manage permission.
+ */
+
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+import { isParseError, parseBody } from "#api/parse.js";
+import { OptionsRepository } from "#db/repositories/options.js";
+
+export const prerender = false;
+
+/** Hook name format: namespace:action (e.g., "content:beforeSave") */
+const HOOK_NAME_RE = /^[a-z]+:[a-zA-Z]+$/;
+
+const setSelectionSchema = z.object({
+	pluginId: z.string().min(1).nullable(),
+});
+
+export const PUT: APIRoute = async ({ params, request, locals }) => {
+	const { emdash, user } = locals;
+
+	if (!emdash?.db) {
+		return apiError("NOT_CONFIGURED", "EmDash is not initialized", 500);
+	}
+
+	const denied = requirePerm(user, "settings:manage");
+	if (denied) return denied;
+
+	const hookName = params.hookName;
+	if (!hookName) {
+		return apiError("VALIDATION_ERROR", "Hook name is required", 400);
+	}
+
+	// Validate hook name format: must be namespace:action (e.g., "content:beforeSave")
+	if (!HOOK_NAME_RE.test(hookName)) {
+		return apiError("VALIDATION_ERROR", "Invalid hook name format", 400);
+	}
+
+	try {
+		const pipeline = emdash.hooks;
+
+		// Verify this is actually an exclusive hook
+		if (!pipeline.isExclusiveHook(hookName)) {
+			return apiError("NOT_FOUND", `Hook '${hookName}' is not a registered exclusive hook`, 404);
+		}
+
+		const body = await parseBody(request, setSelectionSchema);
+		if (isParseError(body)) return body;
+
+		const optionsRepo = new OptionsRepository(emdash.db);
+		const optionKey = `emdash:exclusive_hook:${hookName}`;
+
+		if (body.pluginId === null) {
+			// Clear the selection
+			await optionsRepo.delete(optionKey);
+			pipeline.clearExclusiveSelection(hookName);
+		} else {
+			// Validate that the pluginId is an actual provider for this hook
+			const providers = pipeline.getExclusiveHookProviders(hookName);
+			const isValidProvider = providers.some(
+				(p: { pluginId: string }) => p.pluginId === body.pluginId,
+			);
+			if (!isValidProvider) {
+				return apiError(
+					"VALIDATION_ERROR",
+					`Plugin '${body.pluginId}' is not a provider for hook '${hookName}'`,
+					400,
+				);
+			}
+
+			await optionsRepo.set(optionKey, body.pluginId);
+			pipeline.setExclusiveSelection(hookName, body.pluginId);
+		}
+
+		return apiSuccess({
+			hookName,
+			selectedPluginId: body.pluginId,
+		});
+	} catch (error) {
+		return handleError(error, "Failed to set exclusive hook selection", "EXCLUSIVE_HOOK_SET_ERROR");
+	}
+};

package/src/astro/routes/api/admin/hooks/exclusive/index.ts

@@ -0,0 +1,51 @@
+/**
+ * Exclusive hooks list endpoint
+ *
+ * GET /_emdash/api/admin/hooks/exclusive
+ *
+ * Lists all exclusive hooks with their providers and current selections.
+ * Requires admin role.
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, apiSuccess, handleError } from "#api/error.js";
+import { OptionsRepository } from "#db/repositories/options.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, "settings:manage");
+	if (denied) return denied;
+
+	try {
+		const pipeline = emdash.hooks;
+		const exclusiveHookNames = pipeline.getRegisteredExclusiveHooks();
+		const optionsRepo = new OptionsRepository(emdash.db);
+
+		const hooks = [];
+		for (const hookName of exclusiveHookNames) {
+			const providers = pipeline.getExclusiveHookProviders(hookName);
+			const selection = await optionsRepo.get<string>(`emdash:exclusive_hook:${hookName}`);
+
+			hooks.push({
+				hookName,
+				providers: providers.map((provider: { pluginId: string }) => ({
+					pluginId: provider.pluginId,
+				})),
+				selectedPluginId: selection,
+			});
+		}
+
+		return apiSuccess({ items: hooks });
+	} catch (error) {
+		return handleError(error, "Failed to list exclusive hooks", "EXCLUSIVE_HOOKS_LIST_ERROR");
+	}
+};

package/src/astro/routes/api/admin/oauth-clients/[id].ts

@@ -0,0 +1,110 @@
+/**
+ * Single OAuth client endpoints
+ *
+ * GET    /_emdash/api/admin/oauth-clients/:id — Get a client
+ * PUT    /_emdash/api/admin/oauth-clients/:id — Update a client
+ * DELETE /_emdash/api/admin/oauth-clients/:id — Delete a client
+ */
+
+import { Role } from "@emdash-cms/auth";
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { apiError, handleError, unwrapResult } from "#api/error.js";
+import {
+	handleOAuthClientDelete,
+	handleOAuthClientGet,
+	handleOAuthClientUpdate,
+} from "#api/handlers/oauth-clients.js";
+import { isParseError, parseBody } from "#api/parse.js";
+
+export const prerender = false;
+
+const updateClientSchema = z.object({
+	name: z.string().min(1).max(255).optional(),
+	redirectUris: z
+		.array(z.string().url("Each redirect URI must be a valid URL"))
+		.min(1, "At least one redirect URI is required")
+		.optional(),
+	scopes: z.array(z.string()).nullable().optional(),
+});
+
+/**
+ * Get a single OAuth client.
+ */
+export const GET: APIRoute = async ({ params, 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 clientId = params.id;
+	if (!clientId) {
+		return apiError("VALIDATION_ERROR", "Client ID is required", 400);
+	}
+
+	const result = await handleOAuthClientGet(emdash.db, clientId);
+	return unwrapResult(result);
+};
+
+/**
+ * Update an OAuth client.
+ */
+export const PUT: APIRoute = async ({ params, request, 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 clientId = params.id;
+	if (!clientId) {
+		return apiError("VALIDATION_ERROR", "Client ID is required", 400);
+	}
+
+	try {
+		const body = await parseBody(request, updateClientSchema);
+		if (isParseError(body)) return body;
+
+		const result = await handleOAuthClientUpdate(emdash.db, clientId, body);
+		return unwrapResult(result);
+	} catch (error) {
+		return handleError(error, "Failed to update OAuth client", "CLIENT_UPDATE_ERROR");
+	}
+};
+
+/**
+ * Delete an OAuth client.
+ */
+export const DELETE: APIRoute = async ({ params, 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 clientId = params.id;
+	if (!clientId) {
+		return apiError("VALIDATION_ERROR", "Client ID is required", 400);
+	}
+
+	try {
+		const result = await handleOAuthClientDelete(emdash.db, clientId);
+		return unwrapResult(result);
+	} catch (error) {
+		return handleError(error, "Failed to delete OAuth client", "CLIENT_DELETE_ERROR");
+	}
+};

package/src/astro/routes/api/admin/oauth-clients/index.ts

@@ -0,0 +1,71 @@
+/**
+ * OAuth client management endpoints
+ *
+ * GET  /_emdash/api/admin/oauth-clients — List all registered OAuth clients
+ * POST /_emdash/api/admin/oauth-clients — Register a new OAuth client
+ */
+
+import { Role } from "@emdash-cms/auth";
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { apiError, handleError, unwrapResult } from "#api/error.js";
+import { handleOAuthClientCreate, handleOAuthClientList } from "#api/handlers/oauth-clients.js";
+import { isParseError, parseBody } from "#api/parse.js";
+
+export const prerender = false;
+
+const createClientSchema = z.object({
+	id: z
+		.string()
+		.min(1, "Client ID is required")
+		.max(255, "Client ID must be at most 255 characters"),
+	name: z.string().min(1, "Name is required").max(255, "Name must be at most 255 characters"),
+	redirectUris: z
+		.array(z.string().url("Each redirect URI must be a valid URL"))
+		.min(1, "At least one redirect URI is required"),
+	scopes: z.array(z.string()).optional(),
+});
+
+/**
+ * List all registered OAuth clients.
+ */
+export const GET: APIRoute = async ({ 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 result = await handleOAuthClientList(emdash.db);
+	return unwrapResult(result);
+};
+
+/**
+ * Register a new OAuth client.
+ */
+export const POST: APIRoute = async ({ request, 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);
+	}
+
+	try {
+		const body = await parseBody(request, createClientSchema);
+		if (isParseError(body)) return body;
+
+		const result = await handleOAuthClientCreate(emdash.db, body);
+		return unwrapResult(result, 201);
+	} catch (error) {
+		return handleError(error, "Failed to create OAuth client", "CLIENT_CREATE_ERROR");
+	}
+};

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

@@ -0,0 +1,39 @@
+/**
+ * Plugin disable endpoint
+ *
+ * POST /_emdash/api/admin/plugins/:id/disable - Disable a plugin
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handlePluginDisable } from "#api/index.js";
+import { setCronTasksEnabled } from "#plugins/cron.js";
+
+export const prerender = false;
+
+export const POST: 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:manage");
+	if (denied) return denied;
+
+	if (!id) {
+		return apiError("INVALID_REQUEST", "Plugin ID required", 400);
+	}
+
+	const result = await handlePluginDisable(emdash.db, emdash.configuredPlugins, id);
+
+	if (!result.success) return unwrapResult(result);
+
+	await emdash.setPluginStatus(id, "inactive");
+	await setCronTasksEnabled(emdash.db, id, false);
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,39 @@
+/**
+ * Plugin enable endpoint
+ *
+ * POST /_emdash/api/admin/plugins/:id/enable - Enable a plugin
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handlePluginEnable } from "#api/index.js";
+import { setCronTasksEnabled } from "#plugins/cron.js";
+
+export const prerender = false;
+
+export const POST: 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:manage");
+	if (denied) return denied;
+
+	if (!id) {
+		return apiError("INVALID_REQUEST", "Plugin ID required", 400);
+	}
+
+	const result = await handlePluginEnable(emdash.db, emdash.configuredPlugins, id);
+
+	if (!result.success) return unwrapResult(result);
+
+	await emdash.setPluginStatus(id, "active");
+	await setCronTasksEnabled(emdash.db, id, true);
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,38 @@
+/**
+ * Plugin management single plugin endpoint
+ *
+ * GET /_emdash/api/admin/plugins/:id - Get plugin details
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handlePluginGet } 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", "Plugin ID required", 400);
+	}
+
+	const result = await handlePluginGet(
+		emdash.db,
+		emdash.configuredPlugins,
+		id,
+		emdash.config.marketplace,
+	);
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,48 @@
+/**
+ * Marketplace plugin uninstall endpoint
+ *
+ * POST /_emdash/api/admin/plugins/:id/uninstall - Uninstall a marketplace plugin
+ */
+
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceUninstall } from "#api/index.js";
+import { isParseError, parseOptionalBody } from "#api/parse.js";
+
+export const prerender = false;
+
+const uninstallBodySchema = z.object({
+	deleteData: z.boolean().optional(),
+});
+
+export const POST: APIRoute = async ({ params, request, 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:manage");
+	if (denied) return denied;
+
+	if (!id) {
+		return apiError("INVALID_REQUEST", "Plugin ID required", 400);
+	}
+
+	const body = await parseOptionalBody(request, uninstallBodySchema, {});
+	if (isParseError(body)) return body;
+
+	const result = await handleMarketplaceUninstall(emdash.db, emdash.storage, id, {
+		deleteData: body.deleteData ?? false,
+	});
+
+	if (!result.success) return unwrapResult(result);
+
+	await emdash.syncMarketplacePlugins();
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,59 @@
+/**
+ * Marketplace plugin update endpoint
+ *
+ * POST /_emdash/api/admin/plugins/:id/update - Update a marketplace plugin
+ */
+
+import type { APIRoute } from "astro";
+import { z } from "zod";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceUpdate } from "#api/index.js";
+import { isParseError, parseOptionalBody } from "#api/parse.js";
+
+export const prerender = false;
+
+const updateBodySchema = z.object({
+	version: z.string().min(1).optional(),
+	confirmCapabilityChanges: z.boolean().optional(),
+	confirmRouteVisibilityChanges: z.boolean().optional(),
+});
+
+export const POST: APIRoute = async ({ params, request, 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:manage");
+	if (denied) return denied;
+
+	if (!id) {
+		return apiError("INVALID_REQUEST", "Plugin ID required", 400);
+	}
+
+	const body = await parseOptionalBody(request, updateBodySchema, {});
+	if (isParseError(body)) return body;
+
+	const result = await handleMarketplaceUpdate(
+		emdash.db,
+		emdash.storage,
+		emdash.getSandboxRunner(),
+		emdash.config.marketplace,
+		id,
+		{
+			version: body.version,
+			confirmCapabilityChanges: body.confirmCapabilityChanges,
+			confirmRouteVisibilityChanges: body.confirmRouteVisibilityChanges,
+		},
+	);
+
+	if (!result.success) return unwrapResult(result);
+
+	await emdash.syncMarketplacePlugins();
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,32 @@
+/**
+ * Plugin management list endpoint
+ *
+ * GET /_emdash/api/admin/plugins - List all configured plugins with state
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handlePluginList } 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 handlePluginList(
+		emdash.db,
+		emdash.configuredPlugins,
+		emdash.config.marketplace,
+	);
+
+	return unwrapResult(result);
+};

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

@@ -0,0 +1,61 @@
+/**
+ * Marketplace plugin icon proxy
+ *
+ * GET /_emdash/api/admin/plugins/marketplace/:id/icon - Proxy icon 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/plugins/${encodeURIComponent(id)}/icon`, 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 icon", 502);
+	}
+};

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

@@ -0,0 +1,33 @@
+/**
+ * Marketplace plugin detail proxy endpoint
+ *
+ * GET /_emdash/api/admin/plugins/marketplace/:id - Get plugin details
+ */
+
+import type { APIRoute } from "astro";
+
+import { requirePerm } from "#api/authorize.js";
+import { apiError, unwrapResult } from "#api/error.js";
+import { handleMarketplaceGetPlugin } 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", "Plugin ID required", 400);
+	}
+
+	const result = await handleMarketplaceGetPlugin(emdash.config.marketplace, id);
+
+	return unwrapResult(result);
+};