Add portable project transfer API

src/server/composition/project-transfer-store.ts

@@ -0,0 +1,4 @@
+import { db } from "../../db/client.js";
+import { ProjectTransferRepository } from "../../db/repositories/project-transfer.repository.js";
+
+export const projectTransferStore = new ProjectTransferRepository(db);

src/server/controllers/project-transfer.controller.ts

@@ -0,0 +1,100 @@
+import type { NextFunction, Request, Response } from "express";
+import { ProjectRevisionConflictError } from "../../domain/errors/project-revision-conflict.error.js";
+import { ProjectStateConflictError } from "../../domain/errors/project-state-conflict.error.js";
+import { importProjectTransferSchema } from "../../shared/validation/project-transfer.schemas.js";
+import { projectCommandService } from "../composition/project-command-stores.js";
+import { projectTransferStore } from "../composition/project-transfer-store.js";
+
+export function exportProjectTransfer(req: Request, res: Response) {
+  const projectId = getProjectId(req, res);
+  if (!projectId) {
+    return;
+  }
+  const transfer = projectTransferStore.exportProject(projectId);
+  if (!transfer) {
+    return res.status(404).json({ error: "Project not found" });
+  }
+  const filename = safeFilename(transfer.projectState.project.name);
+  res.setHeader(
+    "Content-Disposition",
+    `attachment; filename="${filename}.leistungsbilanz.json"`
+  );
+  return res.json(transfer);
+}
+
+export function importProjectTransfer(
+  req: Request,
+  res: Response,
+  next: NextFunction
+) {
+  const projectId = getProjectId(req, res);
+  if (!projectId) {
+    return;
+  }
+  const parsed = importProjectTransferSchema.safeParse(req.body);
+  if (!parsed.success) {
+    return res.status(400).json({ error: parsed.error.flatten() });
+  }
+  try {
+    if (parsed.data.mode === "duplicate") {
+      return res
+        .status(201)
+        .json(projectTransferStore.importDuplicate(parsed.data.transfer));
+    }
+    const prepared = projectTransferStore.prepareReplace(
+      projectId,
+      parsed.data.transfer
+    );
+    if (!prepared) {
+      return res.status(404).json({ error: "Project not found" });
+    }
+    const result = projectCommandService.executeRestore({
+      projectId,
+      expectedRevision: parsed.data.expectedRevision,
+      description: "Projektimport wiederherstellen",
+      command: prepared.command,
+    });
+    return res.json(result);
+  } catch (error) {
+    if (error instanceof ProjectRevisionConflictError) {
+      return res.status(409).json({
+        error: error.message,
+        code: "PROJECT_REVISION_CONFLICT",
+        expectedRevision: error.expectedRevision,
+        currentRevision: error.actualRevision,
+      });
+    }
+    if (error instanceof ProjectStateConflictError) {
+      return res
+        .status(409)
+        .json({ error: error.message, code: "PROJECT_STATE_CONFLICT" });
+    }
+    if (
+      error instanceof Error &&
+      (error.message.startsWith("Project transfer") ||
+        error.message.startsWith("Snapshot"))
+    ) {
+      return res.status(400).json({ error: error.message });
+    }
+    return next(error);
+  }
+}
+
+function getProjectId(req: Request, res: Response) {
+  const { projectId } = req.params;
+  if (typeof projectId !== "string" || !projectId.trim()) {
+    res.status(400).json({ error: "Invalid projectId" });
+    return null;
+  }
+  return projectId;
+}
+
+function safeFilename(name: string) {
+  return (
+    name
+      .normalize("NFKD")
+      .replace(/[^a-zA-Z0-9_-]+/g, "-")
+      .replace(/^-+|-+$/g, "")
+      .slice(0, 80) || "projekt"
+  );
+}

src/server/index.ts

@@ -8,7 +8,7 @@ import { errorMiddleware } from "./middleware/error.middleware.js";
 const app = express();
 const port = Number(process.env.PORT || 3000);
 
-app.use(express.json());
+app.use(express.json({ limit: "25mb" }));
 
 app.get("/health", (_req, res) => {
   res.json({ ok: true });

src/server/routes/project.routes.ts

@@ -27,12 +27,18 @@ import {
   listProjectSnapshots,
   restoreProjectSnapshot,
 } from "../controllers/project-snapshot.controller.js";
+import {
+  exportProjectTransfer,
+  importProjectTransfer,
+} from "../controllers/project-transfer.controller.js";
 
 export const projectRouter = Router();
 
 projectRouter.get("/", listProjects);
 projectRouter.post("/", createProject);
 projectRouter.get("/:projectId", getProject);
+projectRouter.get("/:projectId/export", exportProjectTransfer);
+projectRouter.post("/:projectId/import", importProjectTransfer);
 projectRouter.get("/:projectId/history", getProjectHistory);
 projectRouter.get("/:projectId/history/revisions", listProjectRevisions);
 projectRouter.post("/:projectId/commands", executeProjectCommand);