@haiiro/docuflow 0.0.11 → 0.0.13

package/src/logic-functions/docflow-app.logic-function.ts

@@ -0,0 +1,37 @@
+import { defineLogicFunction } from 'twenty-sdk/define';
+import {
+  type LogicFunctionExecutionContext,
+  type RoutePayload,
+} from 'twenty-sdk/logic-function';
+
+import { readDocflowAppSection } from 'src/shared/app/docflow-app.util';
+import { getCrmUrl } from 'src/server/crm-url';
+import { renderDocflowAppPage } from 'src/server/docflow-app-page';
+import { DOCFLOW_APP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
+
+// The standalone docflow page: tasks, processes and documents without the
+// rest of the CRM. It needs no sign-in to load: the page itself signs in with
+// the CRM session (see /docflow/app/session). `?connect=1` is the popup that
+// signs in the page framed in Bitrix24.
+const handler = async (event: RoutePayload, context: LogicFunctionExecutionContext) =>
+  renderDocflowAppPage({
+    workspaceId: context.workspaceId,
+    config: {
+      mode: event.queryStringParameters.connect === '1' ? 'connect' : 'crm',
+      crmUrl: getCrmUrl() ?? '',
+      section: readDocflowAppSection(event.queryStringParameters.section),
+    },
+  });
+
+export default defineLogicFunction({
+  universalIdentifier: DOCFLOW_APP_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
+  name: 'docflow-app',
+  description: 'Отдельная страница документооборота без остальной CRM',
+  timeoutSeconds: 10,
+  handler,
+  httpRouteTriggerSettings: {
+    path: '/docflow/app',
+    httpMethod: 'GET',
+    isAuthRequired: false,
+  },
+});

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

@@ -59551,7 +59551,8 @@ var readRestList = (response) => {
   const value = readDataValue(response);
   return {
     records: Array.isArray(value) ? value : [],
-    pageInfo: response?.pageInfo ?? {}
+    pageInfo: response?.pageInfo ?? {},
+    totalCount: response?.totalCount
   };
 };
 var readRestRecord = (response) => {

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

@@ -1725,10 +1725,67 @@ var RUN_WORKFLOW_VERSION_MUTATION = `mutation RunWorkflowVersion($input: RunWork
   runWorkflowVersion(input: $input) { workflowRunId }
 }`;
 
+// src/shared/api/object-summaries.ts
+import { MetadataApiClient } from "twenty-client-sdk/metadata";
+var OBJECTS_PAGE_SIZE = 100;
+var getObjectSummaries = async () => {
+  const client = new MetadataApiClient();
+  const summaries = /* @__PURE__ */ new Map();
+  let after;
+  do {
+    const { objects } = await client.query({
+      objects: {
+        __args: {
+          paging: { first: OBJECTS_PAGE_SIZE, ...after !== void 0 ? { after } : {} },
+          filter: {}
+        },
+        pageInfo: { hasNextPage: true, endCursor: true },
+        edges: {
+          node: {
+            nameSingular: true,
+            namePlural: true,
+            labelSingular: true,
+            labelIdentifierFieldMetadataId: true,
+            fieldsList: { id: true, name: true }
+          }
+        }
+      }
+    });
+    for (const { node } of objects.edges) {
+      summaries.set(node.nameSingular, {
+        nameSingular: node.nameSingular,
+        namePlural: node.namePlural,
+        labelSingular: node.labelSingular,
+        labelFieldName: node.fieldsList?.find(
+          (field) => field.id === node.labelIdentifierFieldMetadataId
+        )?.name
+      });
+    }
+    after = objects.pageInfo.hasNextPage === true ? objects.pageInfo.endCursor ?? void 0 : void 0;
+  } while (after !== void 0);
+  return summaries;
+};
+
+// src/shared/api/rest-response.util.ts
+var readDataValue = (response) => {
+  const data = response?.data;
+  if (typeof data !== "object" || data === null) {
+    return void 0;
+  }
+  return Object.values(data)[0];
+};
+var readRestRecord = (response) => {
+  const value = readDataValue(response);
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+};
+
 // src/shared/docflow.constants.ts
 var DOCFLOW_SECTION = "DOCFLOW";
 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 LAUNCH_RECORDS_LIMIT = 50;
 var FORM_FIELD_REQUIRED_SETTING = "smbIsRequired";
 var FORM_FIELD_ROLE_SETTING = "smbRole";
 
@@ -1766,7 +1823,9 @@ var parseFormFields = (value) => Array.isArray(value) ? value.filter(
 ) : [];
 
 // src/shared/workflow/launch-step.util.ts
+var isLaunchTrigger = (trigger) => trigger?.type === "WEBHOOK" && trigger.name === LAUNCH_TRIGGER_NAME;
 var parseLaunchFields = (value) => getFillableFormFields(parseFormFields(value));
+var parseLaunchObject = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 var buildLaunchParameters = ({
   fields,
   values
@@ -1776,9 +1835,10 @@ var buildLaunchParameters = ({
     return [field.name, value === void 0 || value === "" ? null : value];
   })
 );
-var buildLaunchPayload = (parameters) => ({
+var buildLaunchPayload = (parameters, record) => ({
   ...parameters,
-  [DOCFLOW_LAUNCH_PARAMETERS_KEY]: parameters
+  [DOCFLOW_LAUNCH_PARAMETERS_KEY]: parameters,
+  ...record !== void 0 ? { [LAUNCH_RECORD_KEY]: record } : {}
 });
 
 // node_modules/twenty-sdk/dist/logic-function/isDefined-Dtu5EYqP-CMNeFg4z.mjs
@@ -119427,19 +119487,6 @@ var jsonResponse = (status, body) => new AL(JSON.stringify(body), {
 });
 var readJsonBody = (body) => typeof body === "object" && body !== null && !Array.isArray(body) ? body : {};
 
-// src/shared/api/rest-response.util.ts
-var readDataValue = (response) => {
-  const data = response?.data;
-  if (typeof data !== "object" || data === null) {
-    return void 0;
-  }
-  return Object.values(data)[0];
-};
-var readRestRecord = (response) => {
-  const value = readDataValue(response);
-  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
-};
-
 // src/server/records.ts
 var clients = {
   person: new u2(),
@@ -119485,6 +119532,7 @@ var logDocflowError = (event, error, details) => console.error(PREFIX, event, de
 var LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "de04e9c8-7ebe-4ac2-b4b3-4ca256eb94db";
 
 // src/logic-functions/launch-process.logic-function.ts
+var readRecordIds = (value) => Array.isArray(value) ? [...new Set(value.filter((id3) => typeof id3 === "string" && id3.length > 0))] : [];
 var handler = async (event, context) => {
   if (context.workspaceMemberId === null) {
     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" });
@@ -119492,6 +119540,7 @@ var handler = async (event, context) => {
   const body = readJsonBody(event.body);
   const workflowVersionId = body.workflowVersionId;
   const values = readJsonBody(body.values);
+  const recordIds = readRecordIds(body.recordIds);
   if (typeof workflowVersionId !== "string" || workflowVersionId.length === 0) {
     return jsonResponse(400, { message: "\u041D\u0435 \u0443\u043A\u0430\u0437\u0430\u043D \u043F\u0440\u043E\u0446\u0435\u0441\u0441" });
   }
@@ -119512,21 +119561,56 @@ var handler = async (event, context) => {
       missingFieldNames: missingFields.map(({ name }) => name)
     });
   }
-  const workflowRunId = crypto.randomUUID();
-  try {
-    await runWorkflowVersion({
-      workflowVersionId,
-      workflowRunId,
-      payload: fields.length > 0 ? buildLaunchPayload(parameters) : {}
-    });
-  } catch (error) {
-    logDocflowError("launch: run failed", error, { workflowVersionId });
-    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"
-    });
+  const launchObjectName = parseLaunchObject(workflow.smbLaunchObject);
+  const isLaunchedOnRecords = launchObjectName !== void 0 && isLaunchTrigger(version.trigger);
+  let records = [void 0];
+  if (isLaunchedOnRecords) {
+    if (recordIds.length === 0) {
+      return jsonResponse(422, { message: "\u041F\u0440\u043E\u0446\u0435\u0441\u0441 \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F \u043D\u0430 \u0437\u0430\u043F\u0438\u0441\u0438: \u0432\u044B\u0431\u0435\u0440\u0438\u0442\u0435 \u0437\u0430\u043F\u0438\u0441\u044C" });
+    }
+    if (recordIds.length > LAUNCH_RECORDS_LIMIT) {
+      return jsonResponse(422, { message: `\u0417\u0430 \u043E\u0434\u0438\u043D \u0440\u0430\u0437 \u2014 \u043D\u0435 \u0431\u043E\u043B\u044C\u0448\u0435 ${LAUNCH_RECORDS_LIMIT} \u0437\u0430\u043F\u0438\u0441\u0435\u0439` });
+    }
+    const namePlural = (await getObjectSummaries()).get(launchObjectName)?.namePlural;
+    if (namePlural === void 0) {
+      return jsonResponse(404, { message: "\u041E\u0431\u044A\u0435\u043A\u0442, \u043D\u0430 \u043A\u043E\u0442\u043E\u0440\u043E\u043C \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F \u043F\u0440\u043E\u0446\u0435\u0441\u0441, \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D" });
+    }
+    records = await Promise.all(
+      recordIds.map(async (recordId) => {
+        try {
+          return readRestRecord(
+            await restClient("person").get(`/rest/${namePlural}/${recordId}`, { query: { depth: 0 } })
+          );
+        } catch (error) {
+          logDocflowError("launch: record not read", error, { namePlural, recordId });
+          return void 0;
+        }
+      })
+    );
+    if (records.some((record) => record === void 0)) {
+      return jsonResponse(404, { message: "\u0417\u0430\u043F\u0438\u0441\u044C \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430" });
+    }
+  }
+  const workflowRunIds = [];
+  for (const record of records) {
+    const workflowRunId = crypto.randomUUID();
+    try {
+      await runWorkflowVersion({
+        workflowVersionId,
+        workflowRunId,
+        payload: fields.length > 0 || record !== void 0 ? buildLaunchPayload(parameters, record) : {}
+      });
+    } catch (error) {
+      logDocflowError("launch: run failed", error, { workflowVersionId, 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",
+        workflowRunIds
+      });
+    }
+    workflowRunIds.push(workflowRunId);
   }
-  logDocflow("launch: started", { workflowVersionId, workflowRunId, parameters });
-  return { workflowRunId };
+  logDocflow("launch: started", { workflowVersionId, workflowRunIds, parameters, recordIds });
+  return { workflowRunId: workflowRunIds[0], workflowRunIds };
 };
 var launch_process_logic_function_default = defineLogicFunction({
   universalIdentifier: LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,

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

@@ -5,22 +5,33 @@ import {
 } from 'twenty-sdk/logic-function';
 
 import { CoreGraphqlError } from 'src/shared/api/core-graphql.util';
-import { DOCFLOW_SECTION } from 'src/shared/docflow.constants';
+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 { findMissingRequiredFields } from 'src/shared/form/form-fields.util';
 import {
   buildLaunchParameters,
   buildLaunchPayload,
+  isLaunchTrigger,
   parseLaunchFields,
+  parseLaunchObject,
 } from 'src/shared/workflow/launch-step.util';
 import { readJsonBody, jsonResponse } from 'src/server/http-response';
-import { getWorkflow, getWorkflowVersion } from 'src/server/records';
+import { getWorkflow, getWorkflowVersion, restClient } from 'src/server/records';
 import { runWorkflowVersion } from 'src/server/workflow-engine';
 import { logDocflow, logDocflowError } from 'src/shared/log.util';
 import { LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
+const readRecordIds = (value: unknown): string[] =>
+  Array.isArray(value)
+    ? [...new Set(value.filter((id): id is string => typeof id === 'string' && id.length > 0))]
+    : [];
+
 // Launch with parameters: they are checked here and ride in the run payload,
-// so they stay in the run as its trigger output and reach later steps through
-// the "Launch with parameters" step.
+// 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.
 const handler = async (
   event: RoutePayload,
   context: LogicFunctionExecutionContext,
@@ -32,6 +43,7 @@ const handler = async (
   const body = readJsonBody(event.body);
   const workflowVersionId = body.workflowVersionId;
   const values = readJsonBody(body.values);
+  const recordIds = readRecordIds(body.recordIds);
 
   if (typeof workflowVersionId !== 'string' || workflowVersionId.length === 0) {
     return jsonResponse(400, { message: 'Не указан процесс' });
@@ -63,28 +75,77 @@ const handler = async (
     });
   }
 
-  const workflowRunId = crypto.randomUUID();
+  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);
+  let records: (Record<string, unknown> | undefined)[] = [undefined];
+
+  if (isLaunchedOnRecords) {
+    if (recordIds.length === 0) {
+      return jsonResponse(422, { message: 'Процесс запускается на записи: выберите запись' });
+    }
+
+    if (recordIds.length > LAUNCH_RECORDS_LIMIT) {
+      return jsonResponse(422, { message: `За один раз — не больше ${LAUNCH_RECORDS_LIMIT} записей` });
+    }
+
+    const namePlural = (await getObjectSummaries()).get(launchObjectName)?.namePlural;
+
+    if (namePlural === undefined) {
+      return jsonResponse(404, { message: 'Объект, на котором запускается процесс, не найден' });
+    }
+
+    // Read as the person: a record they cannot see does not start the process
+    records = await Promise.all(
+      recordIds.map(async (recordId) => {
+        try {
+          return readRestRecord<Record<string, unknown>>(
+            await restClient('person').get(`/rest/${namePlural}/${recordId}`, { query: { depth: 0 } }),
+          );
+        } catch (error) {
+          logDocflowError('launch: record not read', error, { namePlural, recordId });
+
+          return undefined;
+        }
+      }),
+    );
+
+    if (records.some((record) => record === undefined)) {
+      return jsonResponse(404, { message: 'Запись не найдена' });
+    }
+  }
 
-  try {
-    await runWorkflowVersion({
-      workflowVersionId,
-      workflowRunId,
-      payload: fields.length > 0 ? buildLaunchPayload(parameters) : {},
-    });
-  } catch (error) {
-    logDocflowError('launch: run failed', error, { workflowVersionId });
-
-    return jsonResponse(403, {
-      message:
-        error instanceof CoreGraphqlError && error.userMessage !== undefined
-          ? error.userMessage
-          : 'Не удалось запустить процесс',
-    });
+  const workflowRunIds: string[] = [];
+
+  for (const record of records) {
+    const workflowRunId = crypto.randomUUID();
+
+    try {
+      await runWorkflowVersion({
+        workflowVersionId,
+        workflowRunId,
+        payload:
+          fields.length > 0 || record !== undefined ? buildLaunchPayload(parameters, record) : {},
+      });
+    } catch (error) {
+      logDocflowError('launch: run failed', error, { workflowVersionId, recordId: record?.id });
+
+      return jsonResponse(403, {
+        message:
+          error instanceof CoreGraphqlError && error.userMessage !== undefined
+            ? error.userMessage
+            : 'Не удалось запустить процесс',
+        workflowRunIds,
+      });
+    }
+
+    workflowRunIds.push(workflowRunId);
   }
 
-  logDocflow('launch: started', { workflowVersionId, workflowRunId, parameters });
+  logDocflow('launch: started', { workflowVersionId, workflowRunIds, parameters, recordIds });
 
-  return { workflowRunId };
+  return { workflowRunId: workflowRunIds[0], workflowRunIds };
 };
 
 export default defineLogicFunction({

package/src/logic-functions/on-workflow-run-updated.logic-function.mjs

@@ -119461,7 +119461,8 @@ var readRestList = (response) => {
   const value = readDataValue(response);
   return {
     records: Array.isArray(value) ? value : [],
-    pageInfo: response?.pageInfo ?? {}
+    pageInfo: response?.pageInfo ?? {},
+    totalCount: response?.totalCount
   };
 };
 var readRestRecord = (response) => {