@pxp-nd/flow 1.1.29 → 1.1.31

package/dist/controllers/FlowInstance.js

@@ -14,6 +14,7 @@
  * Last modified  :
  *   ISSUE        DATE        NAME                DESCRIPTION
  *  9141239986   16-May-2025  Mercedes Zambrana   Save flagName and FlagValue
+ *  EF-23        08-Oct-2026  Favio Figueroa      GET_LOCK instead of flag, skipped=200, axios timeout
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -39,16 +40,11 @@ const Event_1 = __importDefault(require("../entity/Event"));
 const Flow_1 = __importDefault(require("../entity/Flow"));
 const Action_1 = __importDefault(require("../entity/Action"));
 const FlowLog_1 = __importDefault(require("../entity/FlowLog"));
+const dbLock_1 = require("../helpers/dbLock");
 class FlowInstance extends core_1.Controller {
     async processPending(params, manager) {
-        const flag = await common_1.GlobalData.findOne({ data: 'wf_processing_pending_flows_flag' });
-        if (flag) {
-            if (flag.value == 'true') {
-                throw new core_1.PxpError(400, 'Already processing pending flows');
-            }
-            flag.value = 'true';
-            let flowInstanceIdProcessing = -1;
-            await (0, typeorm_1.getManager)().save(flag);
+        let flowInstanceIdProcessing = -1;
+        const { acquired } = await (0, dbLock_1.withDbLock)('wf_process_pending', async () => {
             try {
                 await this.eventProcesss(manager);
                 const maxFlows = await common_1.GlobalData.findOne({ data: 'wf_max_concurrent_flows_process' });
@@ -69,17 +65,17 @@ class FlowInstance extends core_1.Controller {
                 }
             }
             catch (error) {
-                flag.value = 'false';
-                await (0, typeorm_1.getManager)().save(flag);
+                // The lock is released by withDbLock's finally block
                 const log = new FlowLog_1.default();
                 log.errorCustomMessage = `Error executing ${flowInstanceIdProcessing} in FlowInstance-> processPending `;
                 log.errorMessage = error.message;
                 log.stackTrace = error.stack || '';
-                (0, typeorm_1.getManager)().save(log);
+                await (0, typeorm_1.getManager)().save(log).catch(e => console.error('[flow] FlowLog save failed', e.message));
                 throw new core_1.PxpError(400, 'Error processing flow: ' + flowInstanceIdProcessing);
             }
-            flag.value = 'false';
-            await (0, typeorm_1.getManager)().save(flag);
+        });
+        if (!acquired) {
+            return { success: true, skipped: true, reason: 'already running' };
         }
         return { success: true };
     }
@@ -115,7 +111,7 @@ class FlowInstance extends core_1.Controller {
                 log.errorCustomMessage = `Error processing event ${newEvent.eventId} in FlowInstance-> eventProcesss `;
                 log.errorMessage = error.message;
                 log.stackTrace = error.stack || '';
-                (0, typeorm_1.getManager)().save(log);
+                await (0, typeorm_1.getManager)().save(log).catch(e => console.error('[flow] FlowLog save failed', e.message));
             }
         }
     }

package/dist/controllers/Node.d.ts

@@ -10,6 +10,7 @@
  * 04-Sep-2023    SP08SEP23     Rensi Arteaga           add modifiedAt for flows
  * 29-Sep-2023    SP06OCT23     Mercedes Zambrana       Add validation when flow is on
  * 19-Jan-2025    8201489097    Favio Figueroa          Add Controller Validation
+ * 06-Nov-2026                     Rensi Arteaga         @ApiDoc for OpenAPI (spec 04)
  * ******************************************************************************
  */
 import { EntityManager } from 'typeorm';

package/dist/controllers/Node.js

@@ -11,6 +11,7 @@
  * 04-Sep-2023    SP08SEP23     Rensi Arteaga           add modifiedAt for flows
  * 29-Sep-2023    SP06OCT23     Mercedes Zambrana       Add validation when flow is on
  * 19-Jan-2025    8201489097    Favio Figueroa          Add Controller Validation
+ * 06-Nov-2026                     Rensi Arteaga         @ApiDoc for OpenAPI (spec 04)
  * ******************************************************************************
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
@@ -35,6 +36,7 @@ const FieldMap_1 = __importDefault(require("../entity/FieldMap"));
 const OriginName_1 = __importDefault(require("../entity/OriginName"));
 const axios_1 = __importDefault(require("axios"));
 const Flow_1 = __importDefault(require("../entity/Flow"));
+const FlowNdApiDocs_1 = require("../helpers/FlowNdApiDocs");
 let Node = class Node extends core_1.Controller {
     async getNodeData(node, dataId, manager) {
         const { action: { originName, originKey } } = node;
@@ -113,6 +115,10 @@ let Node = class Node extends core_1.Controller {
     }
     async getParameterizedNode(params, manager) {
         lodash_1.default.templateSettings.interpolate = /{{([\s\S]+?)}}/g;
+        const nid = Number(params.nodeId);
+        if (!Number.isInteger(nid) || nid < 1) {
+            throw new core_1.PxpError(400, 'nodeId is required and must be a positive integer');
+        }
         const { nodeId, flowId, substitutionsSchemaJson = {} } = params;
         const tNodeData = (0, core_1.__)(Node_1.default.findOne(nodeId));
         const nodeData = await tNodeData;
@@ -298,6 +304,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.nodeAddDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -307,6 +314,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.nodeAddActionConfigJsonDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -316,6 +324,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.nodeGetParameterizedNodeDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)

package/dist/controllers/NodeInstance.d.ts

@@ -13,6 +13,7 @@
  * Last modified  :
  *  ISSUE         DATE           AUTHOR              DESCRIPTION
  *  25-Apr-2025   8914754251     Mercedes Zambrana   Validate and use node?.action?.controllerFunction
+ *  08-Oct-2026   EF-23          Favio Figueroa      GET_LOCK instead of flag, skipped=200, axios timeout
  */
 import { EntityManager } from "typeorm";
 import { Controller } from "@pxp-nd/core";

package/dist/controllers/NodeInstance.js

@@ -14,6 +14,7 @@
  * Last modified  :
  *  ISSUE         DATE           AUTHOR              DESCRIPTION
  *  25-Apr-2025   8914754251     Mercedes Zambrana   Validate and use node?.action?.controllerFunction
+ *  08-Oct-2026   EF-23          Favio Figueroa      GET_LOCK instead of flag, skipped=200, axios timeout
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -40,6 +41,7 @@ const ActionType_1 = __importDefault(require("../entity/ActionType"));
 const Action_1 = __importDefault(require("../entity/Action"));
 const lodash_1 = __importDefault(require("lodash"));
 const FlowInstance_1 = __importDefault(require("../entity/FlowInstance"));
+const dbLock_1 = require("../helpers/dbLock");
 //TODO replace this flow-nd need tobe independent library
 const common_1 = require("@pxp-nd/common");
 let NodeInstance = class NodeInstance extends core_1.Controller {
@@ -101,6 +103,7 @@ let NodeInstance = class NodeInstance extends core_1.Controller {
                                 "Content-Type": "application/json",
                             },
                             data: mergeJson,
+                            timeout: Number(process.env.FLOW_ACTION_TIMEOUT_MS || 30000),
                         };
                         const resControllerAxios = await (0, core_1.__)((0, axios_1.default)(config));
                         if ('data' in resControllerAxios && resControllerAxios.data) {
@@ -120,6 +123,7 @@ let NodeInstance = class NodeInstance extends core_1.Controller {
                                 "Content-Type": "application/json",
                             },
                             data: mergeJson,
+                            timeout: Number(process.env.FLOW_ACTION_TIMEOUT_MS || 30000),
                         };
                         const resControllerAxios = await (0, core_1.__)((0, axios_1.default)(config));
                         if ('data' in resControllerAxios && resControllerAxios.data) {
@@ -152,21 +156,13 @@ let NodeInstance = class NodeInstance extends core_1.Controller {
             log.errorCustomMessage = `Error executing ${flowInstance.flowInstanceId} in NodeInstance-> RecursiveInstance `;
             log.errorMessage = error.message;
             log.stackTrace = error.stack || '';
-            (0, typeorm_1.getManager)().save(log);
+            await (0, typeorm_1.getManager)().save(log).catch(e => console.error('[flow] FlowLog save failed', e.message));
         }
         return {};
     }
     async ProcessDelay(params, manager) {
-        const flag = await common_1.GlobalData.findOne({
-            data: "wf_processing_delay_nodes_flag",
-        });
-        if (flag) {
-            if (flag.value == "true") {
-                throw new core_1.PxpError(400, "Already processing pending flows");
-            }
-            flag.value = "true";
-            await (0, typeorm_1.getManager)().save(flag);
-            let nodeInstanceIdProcessing = -1;
+        let nodeInstanceIdProcessing = -1;
+        const { acquired } = await (0, dbLock_1.withDbLock)("wf_process_delay", async () => {
             try {
                 const maxNodes = await common_1.GlobalData.findOne({
                     data: "wf_max_concurrent_delay_process",
@@ -216,12 +212,12 @@ let NodeInstance = class NodeInstance extends core_1.Controller {
                 }
             }
             catch (error) {
-                flag.value = "false";
-                await (0, typeorm_1.getManager)().save(flag);
+                // The lock is released by withDbLock's finally block
                 throw new core_1.PxpError(400, "Error processing node: " + nodeInstanceIdProcessing);
             }
-            flag.value = "false";
-            await (0, typeorm_1.getManager)().save(flag);
+        });
+        if (!acquired) {
+            return { success: true, skipped: true, reason: "already running" };
         }
         return { success: true };
     }

package/dist/helpers/FlowNdApiDocs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @pxp-nd/flow — OpenAPI (@ApiDoc) payloads for flow-nd controllers (spec tempo-04).
+ * Vendor is session-scoped; do not document vendorId / _vendorId as inputs.
+ */
+import { ApiDocSpec } from '@pxp-nd/core';
+export declare const flowListTemplatesDoc: ApiDocSpec;
+export declare const flowGetDoc: ApiDocSpec;
+export declare const flowGetFlowRenderDoc: ApiDocSpec;
+export declare const flowAddDoc: ApiDocSpec;
+export declare const flowSaveFlowDoc: ApiDocSpec;
+export declare const flowSaveFlowNameDoc: ApiDocSpec;
+export declare const flowInsertEventFlowDoc: ApiDocSpec;
+export declare const flowChangeStatusFlowDoc: ApiDocSpec;
+export declare const flowDeleteFlowDoc: ApiDocSpec;
+export declare const nodeAddDoc: ApiDocSpec;
+export declare const nodeAddActionConfigJsonDoc: ApiDocSpec;
+export declare const nodeGetParameterizedNodeDoc: ApiDocSpec;
+export declare const actionGetActionsDoc: ApiDocSpec;
+export declare const actionGetFieldMapByActionDoc: ApiDocSpec;

package/dist/helpers/FlowNdApiDocs.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * @pxp-nd/flow — OpenAPI (@ApiDoc) payloads for flow-nd controllers (spec tempo-04).
+ * Vendor is session-scoped; do not document vendorId / _vendorId as inputs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionGetFieldMapByActionDoc = exports.actionGetActionsDoc = exports.nodeGetParameterizedNodeDoc = exports.nodeAddActionConfigJsonDoc = exports.nodeAddDoc = exports.flowDeleteFlowDoc = exports.flowChangeStatusFlowDoc = exports.flowInsertEventFlowDoc = exports.flowSaveFlowNameDoc = exports.flowSaveFlowDoc = exports.flowAddDoc = exports.flowGetFlowRenderDoc = exports.flowGetDoc = exports.flowListTemplatesDoc = void 0;
+exports.flowListTemplatesDoc = {
+    operationId: 'flow-nd.Flow.listTemplates',
+    summary: 'List templates',
+    description: 'Lists templates the session vendor can use: its own and the shared ones. Returns { data, count }. Defaults: _type \'template\', sort \'flowId\', dir \'ASC\', limit 50.',
+    params: {
+        type: 'object',
+        properties: {
+            _templateType: { type: 'string', enum: ['flow', 'funnel'] },
+            _type: { type: 'string', enum: ['template'] },
+            _publish: { type: 'string', enum: ['Y', 'N'], description: 'Y = only published templates.' },
+            _isActive: { type: 'integer', enum: [0, 1] },
+            genericFilterFields: { type: 'string', enum: ['name', 'description'] },
+            genericFilterValue: { type: 'string' },
+            filter: { type: 'string', description: 'JSON string { items, logicOperator }, as for the flow list.' },
+            start: { type: 'integer', minimum: 0 },
+            limit: { type: 'integer', minimum: 1 },
+            sort: { type: 'string', enum: ['flowId', 'name', 'createdAt', 'modifiedAt'] },
+            dir: { type: 'string', enum: ['ASC', 'DESC'] },
+        },
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};
+exports.flowGetDoc = {
+    operationId: 'flow-nd.Flow.get',
+    summary: 'Nodes of a flow',
+    description: 'Returns the nodes of one flow as an array of { node, connections }: connections are the IDs of child nodes, node.valuesForShowingInNode holds the main configured values.',
+    params: {
+        type: 'object',
+        properties: { flowId: { type: 'integer', minimum: 1 } },
+        required: ['flowId'],
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};
+exports.flowGetFlowRenderDoc = {
+    operationId: 'flow-nd.Flow.getFlowRender',
+    summary: 'Editor board of a flow',
+    description: 'Returns { flow, board } as used by the flow editor. board.columns[\'2-column-nodes-configured\'].taskIds is the current node order (\'node-<nodeId>\'); board.columns[\'1-column-config-nodes\'].taskIds are the steps that can be added next. Same behaviour for GET and POST.',
+    params: {
+        type: 'object',
+        properties: { flowId: { type: 'integer', minimum: 1 } },
+        required: ['flowId'],
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};
+exports.flowAddDoc = {
+    operationId: 'flow-nd.Flow.add',
+    summary: 'Create a flow',
+    description: 'Creates a flow for the session vendor. This is the default create route of the Flow model: it saves the fields it receives. Returns the saved flow row, including flowId.',
+    params: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', minLength: 1, maxLength: 255 },
+            description: { type: 'string' },
+            templateType: { type: 'string', enum: ['flow', 'funnel'] },
+            type: { type: 'string', enum: ['custom', 'template'] },
+            status: { type: 'string', enum: ['off', 'on'] },
+        },
+        required: ['name', 'templateType', 'type'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.flowSaveFlowDoc = {
+    operationId: 'flow-nd.Flow.saveFlow',
+    summary: 'Add or remove a step',
+    description: 'Adds or removes a step in a flow, as the flow editor does. The flow must be off, otherwise 400 \'Please turn off the flow before make a change\'. To add a step (origin \'cloneTask\'): taskIds is the full new order with \'new\' at the position of the new step, and tasks.new holds the flow ID and the action code. To remove a step (origin \'deleteTask\'): taskIds is the order without that node and deleteId is its ID. Other keys of tasks are ignored. Returns { success: true, nodeId } (the new node ID, or null).',
+    params: {
+        type: 'object',
+        properties: {
+            board: {
+                type: 'object',
+                properties: {
+                    origin: { type: 'string', enum: ['cloneTask', 'deleteTask'] },
+                    deleteId: { type: 'string', pattern: '^node-[0-9]+$', description: 'Only for deleteTask.' },
+                    columns: {
+                        type: 'object',
+                        properties: {
+                            '2-column-nodes-configured': {
+                                type: 'object',
+                                properties: {
+                                    taskIds: {
+                                        type: 'array',
+                                        items: { type: 'string', pattern: '^(new|node-[0-9]+)$' },
+                                        description: 'Node order. Existing nodes are \'node-<nodeId>\'; for cloneTask \'new\' once.',
+                                    },
+                                },
+                                required: ['taskIds'],
+                            },
+                        },
+                        required: ['2-column-nodes-configured'],
+                    },
+                    tasks: {
+                        type: 'object',
+                        properties: {
+                            new: {
+                                type: 'object',
+                                properties: {
+                                    flowId: { type: 'integer', minimum: 1 },
+                                    action: {
+                                        type: 'object',
+                                        properties: { code: { type: 'string', description: 'Action code from Action/getActions.' } },
+                                        required: ['code'],
+                                    },
+                                },
+                                required: ['flowId', 'action'],
+                            },
+                        },
+                    },
+                },
+                required: ['origin', 'columns'],
+            },
+        },
+        required: ['board'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.flowSaveFlowNameDoc = {
+    operationId: 'flow-nd.Flow.saveFlowName',
+    summary: 'Rename a flow',
+    description: 'Renames a flow. The flow must be off (400 otherwise). For a template it also saves code, description, icon and flowType. Returns { success: true } or { success: false }.',
+    params: {
+        type: 'object',
+        properties: {
+            flowId: { type: 'integer', minimum: 1 },
+            name: { type: 'string', minLength: 1, maxLength: 255 },
+            code: { type: 'string', description: 'Templates only.' },
+            description: { type: 'string', description: 'Templates only.' },
+            icon: { type: 'string', description: 'Templates only.' },
+            flowType: { type: 'string', description: 'Templates only.' },
+        },
+        required: ['flowId', 'name'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.flowInsertEventFlowDoc = {
+    operationId: 'flow-nd.Flow.insertEventFlow',
+    summary: 'Add the trigger of a flow',
+    description: 'Creates the first node (isInit = \'Y\') of a flow from an EVENT action. Returns { success: true, nodeId } or { success: false, msg }.',
+    params: {
+        type: 'object',
+        properties: {
+            flowId: { type: 'integer', minimum: 1 },
+            actionId: { type: 'integer', minimum: 1, description: 'An active EVENT action (Action/getActions with actionTypeName \'EVENT\').' },
+        },
+        required: ['flowId', 'actionId'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.flowChangeStatusFlowDoc = {
+    operationId: 'flow-nd.Flow.changeStatusFlow',
+    summary: 'Turn a flow on or off',
+    description: 'Toggles the flow status between \'off\' and \'on\'. A flow that is on runs for real contacts (sends emails and messages). Turning on needs at least 2 active steps (400 otherwise). Returns { success: true } or { success: false }.',
+    params: {
+        type: 'object',
+        properties: { flowId: { type: 'integer', minimum: 1 } },
+        required: ['flowId'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.flowDeleteFlowDoc = {
+    operationId: 'flow-nd.Flow.deleteFlow',
+    summary: 'Delete a flow',
+    description: 'Soft-deletes a flow: the flow, its instances, nodes and connections become inactive. The flow must be off (400 otherwise). Returns { success: true } or { success: false }.',
+    params: {
+        type: 'object',
+        properties: { flowId: { type: 'integer', minimum: 1 } },
+        required: ['flowId'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.nodeAddDoc = {
+    operationId: 'flow-nd.Node.add',
+    summary: 'Create a node with parent connections',
+    description: 'Creates a node in a flow. For each parent, the parent\'s existing child connections are moved to the new node and a connection parent → new node is added. Every parentId must be a node of the same flow. The flow editor uses Flow/saveFlow instead. Returns the saved node row, including nodeId.',
+    params: {
+        type: 'object',
+        properties: {
+            flowId: { type: 'integer', minimum: 1 },
+            actionId: { type: 'integer', minimum: 1 },
+            isInit: { type: 'string', enum: ['Y', 'N'] },
+            isEnd: { type: 'string', enum: ['Y', 'N'] },
+            parents: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        parentId: { type: 'integer', minimum: 1 },
+                        condition: { type: 'string' },
+                    },
+                    required: ['parentId'],
+                    additionalProperties: false,
+                },
+            },
+        },
+        required: ['flowId', 'actionId', 'isInit', 'isEnd'],
+        additionalProperties: false,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.nodeAddActionConfigJsonDoc = {
+    operationId: 'flow-nd.Node.AddActionConfigJson',
+    summary: 'Save the configuration of a step',
+    description: 'Saves the configuration of one node. The flow must be off (400 otherwise). The step fields are sent as top-level keys next to nodeId. __metadata maps a field name to { name } for fields that hold a merge variable; such a field is stored as \'{{ <name> }}\'. The step\'s validation controller runs before saving. Returns { actionConfigJson, success: true, nodeId, msg }.',
+    params: {
+        type: 'object',
+        properties: {
+            nodeId: { type: 'integer', minimum: 1 },
+            __metadata: {
+                type: 'object',
+                additionalProperties: {
+                    type: 'object',
+                    properties: { name: { type: 'string' } },
+                    required: ['name'],
+                },
+            },
+        },
+        required: ['nodeId', '__metadata'],
+        additionalProperties: true,
+    },
+    readOnly: false,
+    permission: null,
+};
+exports.nodeGetParameterizedNodeDoc = {
+    operationId: 'flow-nd.Node.getParameterizedNode',
+    summary: 'Step with its field schema',
+    description: 'Returns a node with what is needed to configure it: the node, its merged current values, schemaJsonObject (the field schema of the step, with substitutions applied) and the merge fields available from the trigger of the flow. Does not change data.',
+    params: {
+        type: 'object',
+        properties: {
+            nodeId: { type: 'integer', minimum: 1 },
+            substitutionsSchemaJson: {
+                type: 'object',
+                description: 'Values substituted into the step\'s schema template.',
+                properties: {
+                    locationId: { type: 'integer', minimum: 1 },
+                    keyword: { type: 'string' },
+                },
+                additionalProperties: false,
+            },
+        },
+        required: ['nodeId'],
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};
+exports.actionGetActionsDoc = {
+    operationId: 'flow-nd.Action.getActions',
+    summary: 'Catalog of step types',
+    description: 'Returns { data: Action[] }; each action has actionId, code, name, schemaJson (field schema of the step), configJsonTemplate and actionType. Filter by actionTypeName, for example \'EVENT\' for triggers.',
+    params: {
+        type: 'object',
+        properties: {
+            actionTypeName: { type: 'string', description: 'For example EVENT, PAGE, CHAINED FLOW.' },
+            actionId: { type: 'integer', minimum: 1 },
+        },
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};
+exports.actionGetFieldMapByActionDoc = {
+    operationId: 'flow-nd.Action.getFieldMapByAction',
+    summary: 'Merge fields of an origin',
+    description: 'Returns the field-map rows (merge fields) of an origin, the data source of a trigger (Action.originName).',
+    params: {
+        type: 'object',
+        properties: { originName: { type: 'string', minLength: 1 } },
+        required: ['originName'],
+        additionalProperties: false,
+    },
+    readOnly: true,
+    permission: null,
+};

package/dist/helpers/dbLock.d.ts

@@ -0,0 +1,4 @@
+export declare function withDbLock<T>(name: string, fn: () => Promise<T>): Promise<{
+    acquired: boolean;
+    result?: T;
+}>;

package/dist/helpers/dbLock.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDbLock = void 0;
+/**
+ * Named MySQL lock helper (GET_LOCK / RELEASE_LOCK).
+ *
+ * GET_LOCK is bound to the MySQL session, so the lock is taken and released on the
+ * same dedicated QueryRunner. Never use a transaction manager or getManager() here:
+ * those may run on a different pooled connection.
+ *
+ *  ISSUE         DATE           AUTHOR              DESCRIPTION
+ *  EF-23         08-Oct-2026    Favio Figueroa      GET_LOCK instead of flag, skipped=200, axios timeout
+ */
+const typeorm_1 = require("typeorm");
+async function withDbLock(name, fn) {
+    var _a, _b, _c, _d;
+    const qr = (0, typeorm_1.getConnection)(process.env.DB_WRITE_CONNECTION_NAME).createQueryRunner();
+    await qr.connect();
+    let got = 0;
+    try {
+        // GET_LOCK names are server-wide; prefix with the schema so environments sharing a MySQL instance do not block each other
+        const rows = await qr.query("SELECT GET_LOCK(CONCAT(DATABASE(), ':', ?), 0) AS got", [name]);
+        got = Number((_b = (_a = rows === null || rows === void 0 ? void 0 : rows[0]) === null || _a === void 0 ? void 0 : _a.got) !== null && _b !== void 0 ? _b : 0);
+        if (got !== 1)
+            return { acquired: false };
+        const result = await fn();
+        return { acquired: true, result };
+    }
+    finally {
+        if (got === 1) {
+            const rel = await qr
+                .query("SELECT RELEASE_LOCK(CONCAT(DATABASE(), ':', ?)) AS rel", [name])
+                .catch(() => [{ rel: 0 }]);
+            if (Number((_d = (_c = rel === null || rel === void 0 ? void 0 : rel[0]) === null || _c === void 0 ? void 0 : _c.rel) !== null && _d !== void 0 ? _d : 0) !== 1) {
+                // Lock could not be released on this session: drop the physical connection
+                // so MySQL frees the lock instead of returning it to the pool still held.
+                const c = qr.databaseConnection;
+                if (c === null || c === void 0 ? void 0 : c.destroy)
+                    c.destroy();
+            }
+        }
+        await qr.release().catch(() => { });
+    }
+}
+exports.withDbLock = withDbLock;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pxp-nd/flow",
-  "version": "1.1.29",
+  "version": "1.1.31",
   "description": "Workflow module for pxp-nd framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@pxp-nd/common": "^1.1.4",
-    "@pxp-nd/core": "^1.1.13",
+    "@pxp-nd/core": "^1.2.94",
     "axios": "^0.21.1",
     "lodash": "^4.17.21",
     "typeorm": "^0.2.36"