@contractspec/example.workflow-system 1.57.0 → 1.58.0

package/dist/browser/handlers/workflow.handlers.js

@@ -0,0 +1,253 @@
+// src/handlers/workflow.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToDefinition(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    name: row.name,
+    description: row.description ?? undefined,
+    type: row.type,
+    status: row.status,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToStep(row) {
+  return {
+    id: row.id,
+    definitionId: row.definitionId,
+    name: row.name,
+    description: row.description ?? undefined,
+    stepOrder: row.stepOrder,
+    type: row.type,
+    requiredRoles: row.requiredRoles ? JSON.parse(row.requiredRoles) : [],
+    autoApproveCondition: row.autoApproveCondition ?? undefined,
+    timeoutHours: row.timeoutHours ?? undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function rowToInstance(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    definitionId: row.definitionId,
+    status: row.status,
+    currentStepId: row.currentStepId ?? undefined,
+    data: row.data ? JSON.parse(row.data) : undefined,
+    requestedBy: row.requestedBy,
+    startedAt: new Date(row.startedAt),
+    completedAt: row.completedAt ? new Date(row.completedAt) : undefined
+  };
+}
+function rowToApproval(row) {
+  return {
+    id: row.id,
+    instanceId: row.instanceId,
+    stepId: row.stepId,
+    status: row.status,
+    actorId: row.actorId ?? undefined,
+    comment: row.comment ?? undefined,
+    decidedAt: row.decidedAt ? new Date(row.decidedAt) : undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function createWorkflowHandlers(db) {
+  async function listDefinitions(input) {
+    const { projectId, status, search, limit = 20, offset = 0 } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM workflow_definition ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM workflow_definition ${whereClause} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      definitions: rows.map(rowToDefinition),
+      total
+    };
+  }
+  async function createDefinition(input, context) {
+    const id = generateId("wfdef");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO workflow_definition (id, projectId, organizationId, name, description, type, status, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      context.organizationId,
+      input.name,
+      input.description ?? null,
+      input.type ?? "APPROVAL",
+      "DRAFT",
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM workflow_definition WHERE id = ?`, [id])).rows;
+    return rowToDefinition(rows[0]);
+  }
+  async function addStep(input) {
+    const id = generateId("wfstep");
+    const now = new Date().toISOString();
+    const maxOrderResult = (await db.query(`SELECT MAX(stepOrder) as maxOrder FROM workflow_step WHERE definitionId = ?`, [input.definitionId])).rows;
+    const nextOrder = (maxOrderResult[0]?.maxOrder ?? 0) + 1;
+    await db.execute(`INSERT INTO workflow_step (id, definitionId, name, description, stepOrder, type, requiredRoles, autoApproveCondition, timeoutHours, createdAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      input.definitionId,
+      input.name,
+      input.description ?? null,
+      nextOrder,
+      input.type ?? "APPROVAL",
+      JSON.stringify(input.requiredRoles),
+      input.autoApproveCondition ?? null,
+      input.timeoutHours ?? null,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM workflow_step WHERE id = ?`, [id])).rows;
+    return rowToStep(rows[0]);
+  }
+  async function getSteps(definitionId) {
+    const rows = (await db.query(`SELECT * FROM workflow_step WHERE definitionId = ? ORDER BY stepOrder`, [definitionId])).rows;
+    return rows.map(rowToStep);
+  }
+  async function listInstances(input) {
+    const {
+      projectId,
+      definitionId,
+      status,
+      requestedBy,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (definitionId) {
+      whereClause += " AND definitionId = ?";
+      params.push(definitionId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (requestedBy) {
+      whereClause += " AND requestedBy = ?";
+      params.push(requestedBy);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM workflow_instance ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM workflow_instance ${whereClause} ORDER BY startedAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      instances: rows.map(rowToInstance),
+      total
+    };
+  }
+  async function startInstance(input, context) {
+    const id = generateId("wfinst");
+    const now = new Date().toISOString();
+    const steps = (await db.query(`SELECT * FROM workflow_step WHERE definitionId = ? ORDER BY stepOrder LIMIT 1`, [input.definitionId])).rows;
+    const firstStepId = steps[0]?.id ?? null;
+    await db.execute(`INSERT INTO workflow_instance (id, projectId, definitionId, status, currentStepId, data, requestedBy, startedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      input.definitionId,
+      firstStepId ? "IN_PROGRESS" : "PENDING",
+      firstStepId,
+      input.data ? JSON.stringify(input.data) : null,
+      context.requestedBy,
+      now
+    ]);
+    if (firstStepId) {
+      await db.execute(`INSERT INTO workflow_approval (id, instanceId, stepId, status, createdAt)
+         VALUES (?, ?, ?, ?, ?)`, [generateId("wfappr"), id, firstStepId, "PENDING", now]);
+    }
+    const rows = (await db.query(`SELECT * FROM workflow_instance WHERE id = ?`, [id])).rows;
+    return rowToInstance(rows[0]);
+  }
+  async function approveStep(input, context) {
+    const now = new Date().toISOString();
+    const instances = (await db.query(`SELECT * FROM workflow_instance WHERE id = ?`, [
+      input.instanceId
+    ])).rows;
+    if (!instances[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    const instance = instances[0];
+    await db.execute(`UPDATE workflow_approval SET status = 'APPROVED', actorId = ?, comment = ?, decidedAt = ? 
+       WHERE instanceId = ? AND stepId = ? AND status = 'PENDING'`, [
+      context.actorId,
+      input.comment ?? null,
+      now,
+      input.instanceId,
+      instance.currentStepId
+    ]);
+    const currentStep = (await db.query(`SELECT * FROM workflow_step WHERE id = ?`, [
+      instance.currentStepId
+    ])).rows;
+    const nextSteps = (await db.query(`SELECT * FROM workflow_step WHERE definitionId = ? AND stepOrder > ? ORDER BY stepOrder LIMIT 1`, [instance.definitionId, currentStep[0]?.stepOrder ?? 0])).rows;
+    if (nextSteps[0]) {
+      await db.execute(`UPDATE workflow_instance SET currentStepId = ? WHERE id = ?`, [nextSteps[0].id, input.instanceId]);
+      await db.execute(`INSERT INTO workflow_approval (id, instanceId, stepId, status, createdAt)
+         VALUES (?, ?, ?, ?, ?)`, [
+        generateId("wfappr"),
+        input.instanceId,
+        nextSteps[0].id,
+        "PENDING",
+        now
+      ]);
+    } else {
+      await db.execute(`UPDATE workflow_instance SET status = 'COMPLETED', currentStepId = NULL, completedAt = ? WHERE id = ?`, [now, input.instanceId]);
+    }
+    const updated = (await db.query(`SELECT * FROM workflow_instance WHERE id = ?`, [
+      input.instanceId
+    ])).rows;
+    return rowToInstance(updated[0]);
+  }
+  async function rejectStep(input, context) {
+    const now = new Date().toISOString();
+    const instances = (await db.query(`SELECT * FROM workflow_instance WHERE id = ?`, [
+      input.instanceId
+    ])).rows;
+    if (!instances[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    await db.execute(`UPDATE workflow_approval SET status = 'REJECTED', actorId = ?, comment = ?, decidedAt = ? 
+       WHERE instanceId = ? AND stepId = ? AND status = 'PENDING'`, [
+      context.actorId,
+      input.reason,
+      now,
+      input.instanceId,
+      instances[0].currentStepId
+    ]);
+    await db.execute(`UPDATE workflow_instance SET status = 'REJECTED', completedAt = ? WHERE id = ?`, [now, input.instanceId]);
+    const updated = (await db.query(`SELECT * FROM workflow_instance WHERE id = ?`, [
+      input.instanceId
+    ])).rows;
+    return rowToInstance(updated[0]);
+  }
+  async function getApprovals(instanceId) {
+    const rows = (await db.query(`SELECT * FROM workflow_approval WHERE instanceId = ? ORDER BY createdAt`, [instanceId])).rows;
+    return rows.map(rowToApproval);
+  }
+  return {
+    listDefinitions,
+    createDefinition,
+    addStep,
+    getSteps,
+    listInstances,
+    startInstance,
+    approveStep,
+    rejectStep,
+    getApprovals
+  };
+}
+export {
+  createWorkflowHandlers
+};