@plandesk/api 0.17.0 → 0.19.0

package/dist/services/projects.d.ts

@@ -28,7 +28,10 @@ export type ScaffoldDocumentInput = {
     linkTo?: string;
 };
 export type ScaffoldPlanInput = {
-    name: string;
+    /** Target an existing project; when set, the plan is added to it. Omit to create a new project. */
+    projectId?: string;
+    /** Name for a new project. Required when projectId is omitted; ignored when it is set. */
+    name?: string;
     description?: string | null;
     tasks: ScaffoldTaskInput[];
     edges?: ScaffoldEdgeInput[];

package/dist/services/projects.js

@@ -112,17 +112,37 @@ export function createProjectService(deps) {
             const keyToId = new Map();
             let projectId = '';
             db.transaction((tx) => {
-                const project = dbCreateProject(tx, {
-                    name: input.name,
-                    description: input.description,
-                });
-                projectId = project.id;
-                const defaultGoal = getOrCreateDefaultGoal(tx, project.id);
+                // Row offset so tasks scaffolded INTO a non-empty project are laid out
+                // below its existing nodes instead of stacking on top of them.
+                let startRow = 0;
+                if (input.projectId !== undefined) {
+                    const existing = dbGetProject(tx, input.projectId);
+                    if (!existing) {
+                        throw new InvalidScaffoldError(`project not found: ${input.projectId}`);
+                    }
+                    projectId = existing.id;
+                    const existingTasks = listTasks(tx, existing.id);
+                    if (existingTasks.length > 0) {
+                        const maxY = existingTasks.reduce((m, t) => Math.max(m, t.y ?? 0), 0);
+                        startRow = Math.floor(maxY / 160) + 1;
+                    }
+                }
+                else {
+                    if (input.name === undefined || input.name.trim() === '') {
+                        throw new InvalidScaffoldError('name is required to create a new project (or pass projectId to add to an existing one)');
+                    }
+                    const project = dbCreateProject(tx, {
+                        name: input.name,
+                        description: input.description,
+                    });
+                    projectId = project.id;
+                }
+                const defaultGoal = getOrCreateDefaultGoal(tx, projectId);
                 input.tasks.forEach((taskInput, i) => {
                     const x = taskInput.x ?? (i % 4) * 240;
-                    const y = taskInput.y ?? Math.floor(i / 4) * 160;
+                    const y = taskInput.y ?? (startRow + Math.floor(i / 4)) * 160;
                     const task = createTask(tx, {
-                        projectId: project.id,
+                        projectId,
                         goalId: defaultGoal.id,
                         label: taskInput.label,
                         status: taskInput.status,
@@ -140,7 +160,7 @@ export function createProjectService(deps) {
                         throw new InvalidScaffoldError('edge references unknown task key');
                     }
                     const edge = createEdge(tx, {
-                        projectId: project.id,
+                        projectId,
                         fromTaskId,
                         toTaskId,
                         label: edgeInput.label ?? null,
@@ -151,7 +171,7 @@ export function createProjectService(deps) {
                 for (const docInput of input.documents ?? []) {
                     const linkedTaskId = docInput.linkTo !== undefined ? keyToId.get(docInput.linkTo) : undefined;
                     const document = createDocument(tx, {
-                        projectId: project.id,
+                        projectId,
                         title: docInput.title,
                         body: docInput.body,
                         statusLine: docInput.statusLine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plandesk/api",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "type": "module",
   "exports": {
     ".": {
@@ -18,8 +18,8 @@
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^3.2.6",
-    "@plandesk/db": "0.17.0",
-    "@plandesk/sync-server": "0.17.0"
+    "@plandesk/db": "0.19.0",
+    "@plandesk/sync-server": "0.19.0"
   },
   "dependencies": {
     "@hono/node-server": "^2.0.4",