@haiiro/docuflow 0.0.16 → 0.0.18

package/src/logic-functions/hand-out-form-step.logic-function.ts

@@ -1,6 +1,7 @@
 import { defineLogicFunction } from 'twenty-sdk/define';
 
 import { handOutFormStep } from 'src/server/process-tasks';
+import { logDocflow } from 'src/shared/log.util';
 import { HAND_OUT_FORM_STEP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 const handler = async (payload: {
@@ -18,7 +19,11 @@ const handler = async (payload: {
     return { status: 'INVALID_PAYLOAD' };
   }
 
-  return { status: await handOutFormStep({ workflowRunId, stepId, threadId }) };
+  const status = await handOutFormStep({ workflowRunId, stepId, waitKey: threadId });
+
+  logDocflow('hand out', { workflowRunId, stepId, status });
+
+  return { status };
 };
 
 export default defineLogicFunction({

package/src/logic-functions/launch-process.logic-function.mjs

@@ -1691,12 +1691,16 @@ var readUserMessage = (value) => {
   }
   return void 0;
 };
+var isMissingGraphqlField = (error) => error instanceof CoreGraphqlError && /Cannot query field|Unknown type/i.test(error.message);
 var callCoreGraphql = async ({
   query,
-  variables
+  variables,
+  runAs = "person"
 }) => {
   const apiUrl = process.env.TWENTY_API_URL;
-  const token = process.env.TWENTY_APP_ACCESS_TOKEN;
+  const personToken = process.env.TWENTY_APP_ACCESS_TOKEN;
+  const applicationToken = process.env.TWENTY_APP_APPLICATION_ACCESS_TOKEN;
+  const token = runAs === "person" ? personToken ?? applicationToken : applicationToken ?? personToken;
   if (apiUrl === void 0 || token === void 0) {
     throw new CoreGraphqlError(
       "TWENTY_API_URL or TWENTY_APP_ACCESS_TOKEN is not set",
@@ -1724,6 +1728,27 @@ var callCoreGraphql = async ({
 var RUN_WORKFLOW_VERSION_MUTATION = `mutation RunWorkflowVersion($input: RunWorkflowVersionInput!) {
   runWorkflowVersion(input: $input) { workflowRunId }
 }`;
+var CORE_WORKFLOWS_QUERY = `query CoreWorkflows($first: Int!, $after: String) {
+  coreWorkflows(first: $first, after: $after) {
+    pageInfo { hasNextPage endCursor }
+    edges { node { id name updatedAt workspaceWorkflowId lastPublishedCoreWorkflowVersionId statuses } }
+  }
+}`;
+var CORE_WORKFLOWS_WITH_CURRENT_VERSIONS_QUERY = `query CoreWorkflowsWithCurrentVersions($input: CoreWorkflowsWithCurrentVersionsInput!) {
+  coreWorkflowsWithCurrentVersions(input: $input) {
+    workflow { id }
+    currentVersion { id status createdAt trigger steps workspaceWorkflowVersionId }
+    versions { id status createdAt workspaceWorkflowVersionId }
+  }
+}`;
+var CORE_WORKFLOW_VERSION_BY_ID_QUERY = `query CoreWorkflowVersionById($coreWorkflowVersionId: UUID!) {
+  coreWorkflowVersionById(coreWorkflowVersionId: $coreWorkflowVersionId) {
+    id status createdAt trigger steps workspaceWorkflowVersionId
+  }
+}`;
+var RUN_CORE_WORKFLOW_VERSION_MUTATION = `mutation RunCoreWorkflowVersion($input: RunCoreWorkflowVersionInput!) {
+  runCoreWorkflowVersion(input: $input) { workflowRunId }
+}`;
 
 // src/shared/api/object-summaries.ts
 import { MetadataApiClient } from "twenty-client-sdk/metadata";
@@ -1774,6 +1799,14 @@ var readDataValue = (response) => {
   }
   return Object.values(data)[0];
 };
+var readRestList = (response) => {
+  const value = readDataValue(response);
+  return {
+    records: Array.isArray(value) ? value : [],
+    pageInfo: response?.pageInfo ?? {},
+    totalCount: response?.totalCount
+  };
+};
 var readRestRecord = (response) => {
   const value = readDataValue(response);
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
@@ -1785,6 +1818,7 @@ var DOCFLOW_LAUNCH_PARAMETERS_KEY = "smbDocflowParameters";
 var LAUNCH_PARAMETERS_STEP_INPUT = `{{trigger.${DOCFLOW_LAUNCH_PARAMETERS_KEY}}}`;
 var LAUNCH_TRIGGER_NAME = "\u0417\u0430\u043F\u0443\u0441\u043A \u0441 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u0430\u043C\u0438";
 var LAUNCH_RECORD_KEY = "record";
+var DOCFLOW_LAUNCHED_BY_KEY = "smbDocflowLaunchedBy";
 var LAUNCH_RECORDS_LIMIT = 50;
 var FORM_FIELD_REQUIRED_SETTING = "smbIsRequired";
 var FORM_FIELD_ROLE_SETTING = "smbRole";
@@ -1823,7 +1857,17 @@ var parseFormFields = (value) => Array.isArray(value) ? value.filter(
 ) : [];
 
 // src/shared/workflow/launch-step.util.ts
+var isPlainRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isLaunchTrigger = (trigger) => trigger?.type === "WEBHOOK" && trigger.name === LAUNCH_TRIGGER_NAME;
+var parseExpectedBodyFields = (trigger) => {
+  const expectedBody = trigger?.type === "WEBHOOK" ? trigger.settings?.expectedBody : void 0;
+  if (!isPlainRecord(expectedBody)) {
+    return [];
+  }
+  return Object.entries(expectedBody).flatMap(
+    ([name, sample]) => name === LAUNCH_RECORD_KEY || name.startsWith("smbDocflow") || isPlainRecord(sample) || Array.isArray(sample) ? [] : [{ id: `body-${name}`, name, label: name, type: typeof sample === "number" ? "NUMBER" : "TEXT" }]
+  );
+};
 var parseLaunchFields = (value) => getFillableFormFields(parseFormFields(value));
 var parseLaunchObject = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 var buildLaunchParameters = ({
@@ -119313,6 +119357,8 @@ var VI2 = /* @__PURE__ */ (function(e3) {
   return e3.OK = "OK", e3.SUCCESS = "SUCCESS", e3.INFO = "INFO", e3.WARNING = "WARNING", e3.ERROR = "ERROR", e3.NEUTRAL = "NEUTRAL", e3.UNKNOWN = "UNKNOWN", e3;
 })({});
 Object.values(VI2).filter((e3) => e3 !== VI2.OK && e3 !== VI2.UNKNOWN), W2.TEXT, W2.ARRAY, W2.BOOLEAN, W2.DATE, W2.DATE_TIME, W2.NUMBER, W2.NUMERIC, W2.RAW_JSON, W2.RICH_TEXT, W2.SELECT, W2.MULTI_SELECT, kF2.SEND_EMAIL, kF2.DRAFT_EMAIL, kF2.CREATE_CALENDAR_EVENT;
+var HI2 = "TWENTY_API_URL";
+var UI2 = "TWENTY_APP_APPLICATION_ACCESS_TOKEN";
 hp2.map((e3) => mp2[e3]);
 var WI2 = {
   universalIdentifier: Wl2(),
@@ -119445,6 +119491,27 @@ fd2({
     message: e4.message
   });
 });
+var XI2 = () => process.env.TWENTY_APP_APPLICATION_ACCESS_TOKEN ?? process.env.TWENTY_APP_ACCESS_TOKEN;
+var ZI = async ({ query: e3, variables: t4, caller: n4 }) => {
+  let r4 = process.env[HI2], i5 = XI2();
+  if (!r4 || !i5) throw Error(`${n4}() requires the app runtime env vars ${HI2} and ${UI2}.`);
+  let a5 = await fetch(`${r4}/metadata`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${i5}`
+    },
+    body: JSON.stringify({
+      query: e3,
+      variables: t4
+    })
+  });
+  if (!a5.ok) throw Error(`${n4}() failed: HTTP ${a5.status} ${a5.statusText}`);
+  let o5 = await a5.json();
+  if (o5.errors && o5.errors.length > 0) throw Error(`${n4}() failed: ${o5.errors.map((e4) => e4.message).join(", ")}`);
+  if (!o5.data) throw Error(`${n4}() failed: response contained no data.`);
+  return o5.data;
+};
 var aL = "\n  id\n  handle\n  displayName\n  visibility\n  connectedAccountId\n  isSyncEnabled\n";
 var oL = `
   mutation CreateAppMessageChannel($input: CreateAppMessageChannelInput!) {
@@ -119474,6 +119541,45 @@ var fL = `
     }
   }
 `;
+var TL = "\n  query GetAppKeyValue($key: String!, $scope: AppKeyValueScope) {\n    appKeyValue(key: $key, scope: $scope) {\n      key\n      value\n      scope\n    }\n  }\n";
+var EL = "\n  mutation SetAppKeyValue($input: SetAppKeyValueInput!) {\n    setAppKeyValue(input: $input) {\n      key\n      value\n      scope\n    }\n  }\n";
+var DL = "\n  mutation DeleteAppKeyValue($key: String!, $scope: AppKeyValueScope) {\n    deleteAppKeyValue(key: $key, scope: $scope)\n  }\n";
+var OL = "WORKSPACE";
+var kL = {
+  async get(e3, t4) {
+    let { appKeyValue: n4 } = await ZI({
+      query: TL,
+      variables: {
+        key: e3,
+        scope: t4?.scope ?? OL
+      },
+      caller: "kv.get"
+    });
+    return n4?.value ?? null;
+  },
+  async set(e3, t4, n4) {
+    await ZI({
+      query: EL,
+      variables: { input: {
+        key: e3,
+        value: t4,
+        scope: n4?.scope ?? OL
+      } },
+      caller: "kv.set"
+    });
+  },
+  async delete(e3, t4) {
+    let { deleteAppKeyValue: n4 } = await ZI({
+      query: DL,
+      variables: {
+        key: e3,
+        scope: t4?.scope ?? OL
+      },
+      caller: "kv.delete"
+    });
+    return n4;
+  }
+};
 var AL = class {
   constructor(e3, t4) {
     this.__twentyHttpResponse = true, this.body = e3, this.status = t4?.status, this.headers = t4?.headers;
@@ -119509,33 +119615,158 @@ var withRouteErrors = (name, handler2) => async (...args) => {
   }
 };
 
+// src/shared/api/rest-filter.util.ts
+var UNSAFE_FILTER_CHARACTERS = /[()[\]'",]/g;
+var sanitizeFilterText = (text) => text.replace(UNSAFE_FILTER_CHARACTERS, " ").trim();
+var quote = (value) => `'${sanitizeFilterText(value)}'`;
+var restEq = (field, value) => `${field}[eq]:${quote(value)}`;
+
 // src/server/records.ts
 var clients = {
   person: new u2(),
   application: new u2({ runAs: "application" })
 };
 var restClient = (runAs) => clients[runAs];
-var getWorkflow = async (runAs, workflowId) => readRestRecord(
-  await restClient(runAs).get(`/rest/workflows/${workflowId}`)
-);
-var getWorkflowVersion = async (runAs, workflowVersionId) => readRestRecord(
-  await restClient(runAs).get(`/rest/workflowVersions/${workflowVersionId}`)
+
+// src/server/process-catalog.ts
+var MEMBERSHIP_KEY = "docflow-processes";
+var PAGE_SIZE = 200;
+var VERSIONS_BATCH_SIZE = 50;
+var readStringList = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+var readMembership = async () => {
+  const stored = await kL.get(MEMBERSHIP_KEY);
+  return { included: readStringList(stored?.included), excluded: readStringList(stored?.excluded) };
+};
+var readLegacyWorkflows = async (runAs) => {
+  try {
+    const { records } = readRestList(
+      await restClient(runAs).get("/rest/workflows", {
+        query: { filter: restEq("smbSection", DOCFLOW_SECTION), limit: PAGE_SIZE }
+      })
+    );
+    return new Map(records.map((record) => [record.id, record]));
+  } catch {
+    return /* @__PURE__ */ new Map();
+  }
+};
+var listCoreWorkflows = async (runAs) => {
+  const nodes = [];
+  let after;
+  do {
+    const { coreWorkflows } = await callCoreGraphql({ query: CORE_WORKFLOWS_QUERY, variables: { first: PAGE_SIZE, after }, runAs });
+    nodes.push(...coreWorkflows.edges.map(({ node }) => node));
+    after = coreWorkflows.pageInfo.hasNextPage ? coreWorkflows.pageInfo.endCursor ?? void 0 : void 0;
+  } while (after !== void 0);
+  return nodes;
+};
+var isDocflowNode = (node, membership, legacy) => !membership.excluded.includes(node.id) && (membership.included.includes(node.id) || typeof node.workspaceWorkflowId === "string" && legacy.has(node.workspaceWorkflowId));
+var byNewest = (first, second) => new Date(second.createdAt ?? 0).getTime() - new Date(first.createdAt ?? 0).getTime();
+var getVersion = async (id3, runAs) => (await callCoreGraphql({
+  query: CORE_WORKFLOW_VERSION_BY_ID_QUERY,
+  variables: { coreWorkflowVersionId: id3 },
+  runAs
+})).coreWorkflowVersionById ?? void 0;
+var readVersions = async (workflowIds, runAs) => {
+  const result = /* @__PURE__ */ new Map();
+  for (let start = 0; start < workflowIds.length; start += VERSIONS_BATCH_SIZE) {
+    const { coreWorkflowsWithCurrentVersions } = await callCoreGraphql({
+      query: CORE_WORKFLOWS_WITH_CURRENT_VERSIONS_QUERY,
+      variables: { input: { coreWorkflowIds: workflowIds.slice(start, start + VERSIONS_BATCH_SIZE) } },
+      runAs
+    });
+    for (const { workflow, currentVersion, versions } of coreWorkflowsWithCurrentVersions) {
+      const sorted = [...versions].sort(byNewest);
+      const current = currentVersion ?? void 0;
+      const activeId = sorted.find(({ status }) => status === "ACTIVE")?.id;
+      const draft = current?.status === "DRAFT" ? current : void 0;
+      const active = activeId === void 0 ? void 0 : current?.id === activeId ? current : await getVersion(activeId, runAs);
+      const deactivatedId = sorted.find(({ status }) => status === "DEACTIVATED")?.id;
+      const deactivated = deactivatedId === void 0 || active !== void 0 || draft !== void 0 ? void 0 : current?.id === deactivatedId ? current : await getVersion(deactivatedId, runAs);
+      result.set(workflow.id, { active, draft, deactivated });
+    }
+  }
+  return result;
+};
+var toProcess = (node, versions, legacy) => {
+  const savedFields = parseLaunchFields(legacy?.smbLaunchFields);
+  const active = versions?.active;
+  return {
+    workflowId: node.id,
+    workspaceWorkflowId: node.workspaceWorkflowId ?? null,
+    name: node.name?.trim() || "\u0411\u0435\u0437 \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u044F",
+    updatedAt: node.updatedAt ?? null,
+    ...versions,
+    // Fields saved by docflow, or for a webhook set up in the Twenty editor
+    // the values its body expects
+    launchFields: savedFields.length > 0 ? savedFields : parseExpectedBodyFields(active?.trigger),
+    launchObject: isLaunchTrigger(active?.trigger) ? parseLaunchObject(legacy?.smbLaunchObject) : void 0
+  };
+};
+var listDocflowProcesses = async (runAs = "person") => {
+  const [nodes, membership, legacy] = await Promise.all([
+    listCoreWorkflows(runAs),
+    readMembership(),
+    readLegacyWorkflows(runAs)
+  ]);
+  const docflowNodes = nodes.filter((node) => isDocflowNode(node, membership, legacy));
+  const versions = await readVersions(
+    docflowNodes.map(({ id: id3 }) => id3),
+    runAs
+  );
+  return docflowNodes.map(
+    (node) => toProcess(node, versions.get(node.id), node.workspaceWorkflowId ? legacy.get(node.workspaceWorkflowId) : void 0)
+  );
+};
+var findDocflowProcess = async (workflowId, runAs = "person") => (await listDocflowProcesses(runAs)).find(
+  (process2) => process2.workflowId === workflowId || process2.workspaceWorkflowId === workflowId
 );
 
 // src/shared/workflow/workflow-run.util.ts
 var DAY_IN_MS = 24 * 60 * 60 * 1e3;
 
 // src/server/workflow-engine.ts
-var runWorkflowVersion = async ({
-  workflowVersionId,
+var runManualProcess = async ({
+  workspaceWorkflowVersionId,
+  coreWorkflowVersionId,
   workflowRunId,
   payload
 }) => {
+  if (typeof workspaceWorkflowVersionId === "string") {
+    try {
+      const data2 = await callCoreGraphql({
+        query: RUN_WORKFLOW_VERSION_MUTATION,
+        variables: { input: { workflowVersionId: workspaceWorkflowVersionId, workflowRunId, payload } }
+      });
+      return data2.runWorkflowVersion.workflowRunId;
+    } catch (error) {
+      if (!isMissingGraphqlField(error)) {
+        throw error;
+      }
+    }
+  }
   const data = await callCoreGraphql({
-    query: RUN_WORKFLOW_VERSION_MUTATION,
-    variables: { input: { workflowVersionId, workflowRunId, payload } }
+    query: RUN_CORE_WORKFLOW_VERSION_MUTATION,
+    variables: { input: { coreWorkflowVersionId, workflowRunId, payload } }
+  });
+  return data.runCoreWorkflowVersion.workflowRunId;
+};
+var runWebhookProcess = async ({
+  workspaceId,
+  workflowId,
+  payload
+}) => {
+  const apiUrl = (process.env.TWENTY_API_URL ?? "").replace(/\/$/, "");
+  const response = await fetch(`${apiUrl}/webhooks/workflows/${workspaceId}/${workflowId}`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(payload)
   });
-  return data.runWorkflowVersion.workflowRunId;
+  const body = await response.json().catch(() => ({}));
+  if (!response.ok || typeof body.workflowRunId !== "string") {
+    const reason = Array.isArray(body.messages) ? body.messages.join("; ") : body.message;
+    throw new Error(`\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u043D\u0435 \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u043B\u0441\u044F: ${typeof reason === "string" ? reason : `HTTP ${response.status}`}`);
+  }
+  return body.workflowRunId;
 };
 
 // src/universal-identifiers.ts
@@ -119548,21 +119779,21 @@ var handler = async (event, context) => {
     return jsonResponse(401, { message: "\u0417\u0430\u043F\u0443\u0441\u043A\u0430\u0442\u044C \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u044B \u043C\u043E\u0436\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u0441\u043E\u0442\u0440\u0443\u0434\u043D\u0438\u043A" });
   }
   const body = readJsonBody(event.body);
-  const workflowVersionId = body.workflowVersionId;
+  const workflowId = body.workflowId;
   const values = readJsonBody(body.values);
   const recordIds = readRecordIds(body.recordIds);
-  if (typeof workflowVersionId !== "string" || workflowVersionId.length === 0) {
+  if (typeof workflowId !== "string" || workflowId.length === 0) {
     return jsonResponse(400, { message: "\u041D\u0435 \u0443\u043A\u0430\u0437\u0430\u043D \u043F\u0440\u043E\u0446\u0435\u0441\u0441" });
   }
-  const version = await getWorkflowVersion("person", workflowVersionId);
-  if (version === void 0 || version.status !== "ACTIVE") {
-    return jsonResponse(404, { message: "\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D \u0438\u043B\u0438 \u043D\u0435 \u043E\u043F\u0443\u0431\u043B\u0438\u043A\u043E\u0432\u0430\u043D" });
+  const docflowProcess = await findDocflowProcess(workflowId, "person");
+  const version = docflowProcess?.active;
+  if (docflowProcess === void 0) {
+    return jsonResponse(404, { message: "\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u043E\u0431\u043E\u0440\u043E\u0442\u0430 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D" });
   }
-  const workflow = typeof version.workflowId === "string" ? await getWorkflow("person", version.workflowId) : void 0;
-  if (workflow?.smbSection !== DOCFLOW_SECTION) {
-    return jsonResponse(403, { message: "\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u043D\u0435 \u043E\u0442\u043D\u043E\u0441\u0438\u0442\u0441\u044F \u043A \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u043E\u0431\u043E\u0440\u043E\u0442\u0443" });
+  if (version === void 0) {
+    return jsonResponse(404, { message: "\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u043D\u0435 \u043E\u043F\u0443\u0431\u043B\u0438\u043A\u043E\u0432\u0430\u043D" });
   }
-  const fields = parseLaunchFields(workflow.smbLaunchFields);
+  const fields = docflowProcess.launchFields;
   const parameters = buildLaunchParameters({ fields, values });
   const missingFields = findMissingRequiredFields({ fields, values: parameters });
   if (missingFields.length > 0) {
@@ -119571,8 +119802,8 @@ var handler = async (event, context) => {
       missingFieldNames: missingFields.map(({ name }) => name)
     });
   }
-  const launchObjectName = parseLaunchObject(workflow.smbLaunchObject);
-  const isLaunchedOnRecords = launchObjectName !== void 0 && isLaunchTrigger(version.trigger);
+  const launchObjectName = docflowProcess.launchObject;
+  const isLaunchedOnRecords = launchObjectName !== void 0;
   let records = [void 0];
   if (isLaunchedOnRecords) {
     if (recordIds.length === 0) {
@@ -119603,23 +119834,28 @@ var handler = async (event, context) => {
   }
   const workflowRunIds = [];
   for (const record of records) {
-    const workflowRunId = crypto.randomUUID();
+    const payload = {
+      ...fields.length > 0 || record !== void 0 ? buildLaunchPayload(parameters, record) : {},
+      [DOCFLOW_LAUNCHED_BY_KEY]: context.workspaceMemberId
+    };
     try {
-      await runWorkflowVersion({
-        workflowVersionId,
-        workflowRunId,
-        payload: fields.length > 0 || record !== void 0 ? buildLaunchPayload(parameters, record) : {}
-      });
+      workflowRunIds.push(
+        version.trigger?.type === "WEBHOOK" ? await runWebhookProcess({ workspaceId: context.workspaceId, workflowId: docflowProcess.workflowId, payload }) : await runManualProcess({
+          workspaceWorkflowVersionId: version.workspaceWorkflowVersionId,
+          coreWorkflowVersionId: version.id,
+          workflowRunId: crypto.randomUUID(),
+          payload
+        })
+      );
     } catch (error) {
-      logDocflowError("launch: run failed", error, { workflowVersionId, recordId: record?.id });
+      logDocflowError("launch: run failed", error, { workflowId: docflowProcess.workflowId, recordId: record?.id });
       return jsonResponse(403, {
-        message: error instanceof CoreGraphqlError && error.userMessage !== void 0 ? error.userMessage : "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u0442\u044C \u043F\u0440\u043E\u0446\u0435\u0441\u0441",
+        message: error instanceof CoreGraphqlError && error.userMessage !== void 0 ? /only start its own/i.test(`${error.message} ${error.userMessage}`) ? "\u0412 \u044D\u0442\u043E\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 Twenty \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u044B \u0441 \u0442\u0440\u0438\u0433\u0433\u0435\u0440\u043E\u043C \xABWebhook\xBB. \u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u0441 \u0440\u0443\u0447\u043D\u044B\u043C \u0437\u0430\u043F\u0443\u0441\u043A\u043E\u043C \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F \u0438\u0437 \u0441\u0430\u043C\u043E\u0439 Twenty, \u0438\u043B\u0438 \u043F\u043E\u043C\u0435\u043D\u044F\u0439\u0442\u0435 \u0435\u043C\u0443 \u0442\u0440\u0438\u0433\u0433\u0435\u0440 \u0432 \u0440\u0435\u0434\u0430\u043A\u0442\u043E\u0440\u0435." : error.userMessage : error instanceof Error ? error.message : "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u0442\u044C \u043F\u0440\u043E\u0446\u0435\u0441\u0441",
         workflowRunIds
       });
     }
-    workflowRunIds.push(workflowRunId);
   }
-  logDocflow("launch: started", { workflowVersionId, workflowRunIds, parameters, recordIds });
+  logDocflow("launch: started", { workflowId: docflowProcess.workflowId, workflowRunIds, parameters, recordIds });
   return { workflowRunId: workflowRunIds[0], workflowRunIds };
 };
 var launch_process_logic_function_default = defineLogicFunction({

package/src/logic-functions/launch-process.logic-function.ts

@@ -7,18 +7,16 @@ import {
 import { CoreGraphqlError } from 'src/shared/api/core-graphql.util';
 import { getObjectSummaries } from 'src/shared/api/object-summaries';
 import { readRestRecord } from 'src/shared/api/rest-response.util';
-import { DOCFLOW_SECTION, LAUNCH_RECORDS_LIMIT } from 'src/shared/docflow.constants';
+import { DOCFLOW_LAUNCHED_BY_KEY, LAUNCH_RECORDS_LIMIT } from 'src/shared/docflow.constants';
 import { findMissingRequiredFields } from 'src/shared/form/form-fields.util';
 import {
   buildLaunchParameters,
   buildLaunchPayload,
-  isLaunchTrigger,
-  parseLaunchFields,
-  parseLaunchObject,
 } from 'src/shared/workflow/launch-step.util';
 import { readJsonBody, jsonResponse, withRouteErrors } from 'src/server/http-response';
-import { getWorkflow, getWorkflowVersion, restClient } from 'src/server/records';
-import { runWorkflowVersion } from 'src/server/workflow-engine';
+import { findDocflowProcess } from 'src/server/process-catalog';
+import { restClient } from 'src/server/records';
+import { runManualProcess, runWebhookProcess } from 'src/server/workflow-engine';
 import { logDocflow, logDocflowError } from 'src/shared/log.util';
 import { LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
@@ -31,7 +29,9 @@ const readRecordIds = (value: unknown): string[] =>
 // so they stay in the run as its trigger output ({{trigger.<field>}}). A
 // process launched on records runs once per record, the record read as the
 // person and put into its run as {{trigger.record}}, like the standard manual
-// launch on a selection does.
+// launch on a selection does. A webhook process starts through its webhook
+// (Twenty 2.45 and 2.50 alike); the webhook knows no person, so the one who
+// launched rides in the payload too.
 const handler = async (
   event: RoutePayload,
   context: LogicFunctionExecutionContext,
@@ -41,30 +41,28 @@ const handler = async (
   }
 
   const body = readJsonBody(event.body);
-  const workflowVersionId = body.workflowVersionId;
+  const workflowId = body.workflowId;
   const values = readJsonBody(body.values);
   const recordIds = readRecordIds(body.recordIds);
 
-  if (typeof workflowVersionId !== 'string' || workflowVersionId.length === 0) {
+  if (typeof workflowId !== 'string' || workflowId.length === 0) {
     return jsonResponse(400, { message: 'Не указан процесс' });
   }
 
-  const version = await getWorkflowVersion('person', workflowVersionId);
+  // Read as the person: without the "Workflows" permission the engine does
+  // not show processes, and then they cannot be launched either
+  const docflowProcess = await findDocflowProcess(workflowId, 'person');
+  const version = docflowProcess?.active;
 
-  if (version === undefined || version.status !== 'ACTIVE') {
-    return jsonResponse(404, { message: 'Процесс не найден или не опубликован' });
+  if (docflowProcess === undefined) {
+    return jsonResponse(404, { message: 'Процесс документооборота не найден' });
   }
 
-  const workflow =
-    typeof version.workflowId === 'string'
-      ? await getWorkflow('person', version.workflowId)
-      : undefined;
-
-  if (workflow?.smbSection !== DOCFLOW_SECTION) {
-    return jsonResponse(403, { message: 'Процесс не относится к документообороту' });
+  if (version === undefined) {
+    return jsonResponse(404, { message: 'Процесс не опубликован' });
   }
 
-  const fields = parseLaunchFields(workflow.smbLaunchFields);
+  const fields = docflowProcess.launchFields;
   const parameters = buildLaunchParameters({ fields, values });
   const missingFields = findMissingRequiredFields({ fields, values: parameters });
 
@@ -75,10 +73,8 @@ const handler = async (
     });
   }
 
-  const launchObjectName = parseLaunchObject(workflow.smbLaunchObject);
-  // The record's object comes from the published trigger: the field may
-  // already hold the object of a draft not published yet.
-  const isLaunchedOnRecords = launchObjectName !== undefined && isLaunchTrigger(version.trigger);
+  const launchObjectName = docflowProcess.launchObject;
+  const isLaunchedOnRecords = launchObjectName !== undefined;
   let records: (Record<string, unknown> | undefined)[] = [undefined];
 
   if (isLaunchedOnRecords) {
@@ -119,31 +115,40 @@ const handler = async (
   const workflowRunIds: string[] = [];
 
   for (const record of records) {
-    const workflowRunId = crypto.randomUUID();
+    const payload = {
+      ...(fields.length > 0 || record !== undefined ? buildLaunchPayload(parameters, record) : {}),
+      [DOCFLOW_LAUNCHED_BY_KEY]: context.workspaceMemberId,
+    };
 
     try {
-      await runWorkflowVersion({
-        workflowVersionId,
-        workflowRunId,
-        payload:
-          fields.length > 0 || record !== undefined ? buildLaunchPayload(parameters, record) : {},
-      });
+      workflowRunIds.push(
+        version.trigger?.type === 'WEBHOOK'
+          ? await runWebhookProcess({ workspaceId: context.workspaceId, workflowId: docflowProcess.workflowId, payload })
+          : await runManualProcess({
+              workspaceWorkflowVersionId: version.workspaceWorkflowVersionId,
+              coreWorkflowVersionId: version.id,
+              workflowRunId: crypto.randomUUID(),
+              payload,
+            }),
+      );
     } catch (error) {
-      logDocflowError('launch: run failed', error, { workflowVersionId, recordId: record?.id });
+      logDocflowError('launch: run failed', error, { workflowId: docflowProcess.workflowId, recordId: record?.id });
 
       return jsonResponse(403, {
         message:
           error instanceof CoreGraphqlError && error.userMessage !== undefined
-            ? error.userMessage
-            : 'Не удалось запустить процесс',
+            ? /only start its own/i.test(`${error.message} ${error.userMessage}`)
+              ? 'В этой версии Twenty приложение запускает только процессы с триггером «Webhook». Процесс с ручным запуском запускается из самой Twenty, или поменяйте ему триггер в редакторе.'
+              : error.userMessage
+            : error instanceof Error
+              ? error.message
+              : 'Не удалось запустить процесс',
         workflowRunIds,
       });
     }
-
-    workflowRunIds.push(workflowRunId);
   }
 
-  logDocflow('launch: started', { workflowVersionId, workflowRunIds, parameters, recordIds });
+  logDocflow('launch: started', { workflowId: docflowProcess.workflowId, workflowRunIds, parameters, recordIds });
 
   return { workflowRunId: workflowRunIds[0], workflowRunIds };
 };