@pxp-nd/flow 1.1.29 → 1.1.31

package/README.md

@@ -1 +1,437 @@
-# flow-nd
+# Tempo Flows (Workflow Engine)
+
+This document describes how automation **flows** work in Tempo: database structure, runtime pipeline, and how to trigger or assemble them.
+
+Flows are a **node-graph automation engine**. Definitions and runtime state live in MySQL tables prefixed `twf_*`. Core entities and graph execution come from **`@pxp-nd/flow`**. Tempo adds business orchestration via `EventHq`, `FlowHQ`, and an SQS worker.
+
+---
+
+## High-level architecture
+
+```text
+Business code (controllers / PHP jobs)
+        │
+        ▼
+EventHq.add({ actionId, descJobName, dataId })
+        │
+        ├─► twf_event (status: pending)
+        └─► SQS FIFO (FLOW_QUEUE_URL)
+                │
+                ▼
+        worker.ts  →  EventHq.processSingleEvent({ eventId })
+                │
+                ├─► Find active twf_node rows for actionId
+                ├─► Query origin view (origin_name + origin_key = dataId)
+                ├─► Vendor match + event_config conditions
+                ├─► Create twf_flow_instance
+                └─► NodeInstanceController.RecursiveInstance() walks the DAG
+```
+
+### Key Tempo files
+
+| File | Role |
+|------|------|
+| `src/modules/hq-nd/controllers/EventHq.ts` | Enqueue events to SQS; process a single event into flow instances |
+| `src/modules/hq-nd/controllers/Flow.ts` (`FlowHQ`) | Duplicate templates, chained flows, funnel lists/statistics |
+| `src/worker.ts` | SQS consumer (started when `INIT_FLOW_WORKER=Y`) |
+| `src/config.ts` / `ormconfig.js` | Registers `flow-nd` module and merges flow entities |
+
+Entities such as `Flow`, `Node`, `Action`, `Event`, `FlowInstance`, `NodeInstance` are **not** redefined in Tempo; they come from `@pxp-nd/flow`.
+
+---
+
+## How execution works (summary)
+
+1. **Fire an event**  
+   Application code looks up `twf_action` by stable `code`, then calls `EventHq.add` with:
+   - `actionId` — PK of the action  
+   - `dataId` — PK value in the action’s origin view (`origin_key`)  
+   - `descJobName` — caller context for debugging  
+
+2. **Enqueue**  
+   `EventHq.add` inserts a `twf_event` (`status = pending`) and sends a message to SQS containing `eventId`.
+
+3. **Worker**  
+   `pollQueue()` in `src/worker.ts` receives the message, deletes it from the queue, then calls `processSingleEvent` with retries (1s / 5s / 10s / 20s). Failures after retries go to Slack (`SLACK_TEMPO_ERROR`).
+
+4. **Match flows**  
+   For every active `twf_node` with that `action_id`:
+   - Load one row: `SELECT * FROM {origin_name} WHERE {origin_key} = {dataId}`
+   - Load parent `twf_flow` — must be `is_active = 1` and **`status = 'on'`**
+   - Vendor filter: `flow.vendor_id === view.vendor_id` **OR** `flow.vendor_id === 55` (global Qorus flows)
+   - Optional `event_config` filters on the action/node
+
+5. **Run the graph**  
+   Create `twf_flow_instance`, then walk `twf_node` / `twf_node_connection` via `RecursiveInstance()`. Each step creates `twf_node_instance` rows. Errors are stored in `twf_flow_log`.
+
+---
+
+## Database ER diagram
+
+```mermaid
+erDiagram
+    twf_action_type ||--o{ twf_action : "categorizes"
+    twf_action ||--o{ twf_node : "used by"
+    twf_action ||--o{ twf_event : "triggered as"
+    twf_action ||--o{ twf_flow_instance : "started by"
+    twf_flow ||--o{ twf_node : "contains"
+    twf_flow ||--o{ twf_flow_instance : "instantiates"
+    twf_node ||--o{ twf_node_connection : "master"
+    twf_node ||--o{ twf_node_connection : "child"
+    twf_node ||--o{ twf_node_instance : "executes as"
+    twf_flow_instance ||--o{ twf_node_instance : "has steps"
+    twf_origin_name ||--o{ twf_field_map : "maps fields"
+
+    twf_action_type {
+        int action_type_id PK
+        varchar name
+        varchar schema_json
+        varchar is_start
+        varchar is_delay
+        varchar controller
+        varchar on_duplicate
+        tinyint is_active
+    }
+
+    twf_action {
+        int action_id PK
+        int action_type_id FK
+        varchar code "stable contract"
+        varchar name
+        varchar origin_name "DB view"
+        varchar origin_key "PK column in view"
+        varchar controller_function
+        varchar schema_json
+        varchar event_config
+        varchar config_json_template
+        tinyint is_active
+    }
+
+    twf_flow {
+        int flow_id PK
+        int vendor_id "0/55 template or vendor"
+        varchar code
+        varchar name
+        varchar type "template|custom"
+        varchar template_type "funnel|flow|null"
+        varchar status "must be on to run"
+        varchar enabled
+        tinyint is_active
+        varchar publish
+        varchar flow_type
+    }
+
+    twf_node {
+        int node_id PK
+        int flow_id FK
+        int action_id FK
+        varchar is_init "Y = entry/trigger"
+        varchar is_end
+        varchar action_config_json "runtime values"
+        varchar approval_config
+        tinyint is_active
+    }
+
+    twf_node_connection {
+        int node_connection_id PK
+        int node_id_master "NULL = init edge"
+        int node_id_child FK
+        varchar condition
+        tinyint is_active
+    }
+
+    twf_event {
+        int event_id PK
+        int action_id FK
+        int data_id "origin PK value"
+        varchar desc_job_name
+        varchar status "pending|processed"
+        tinyint is_active
+    }
+
+    twf_flow_instance {
+        int flow_instance_id PK
+        int flow_id FK
+        int data_id
+        int action_id
+        varchar origin_name
+        varchar origin_key
+        varchar status
+        varchar flag_name
+        int flag_value
+        tinyint is_active
+    }
+
+    twf_node_instance {
+        int node_instance_id PK
+        int node_id FK
+        int flow_instance_id FK
+        timestamp run_time
+        timestamp schedule
+        varchar status
+        json extra_args
+        tinyint is_active
+    }
+
+    twf_origin_name {
+        int origin_name_id PK
+        varchar name "view name"
+        varchar originKey
+        tinyint is_active
+    }
+
+    twf_field_map {
+        int field_map_id PK
+        int origin_name_id FK
+        varchar name
+        varchar alias
+        varchar type
+        tinyint is_active
+    }
+
+    twf_flow_log {
+        int flow_log_id PK
+        varchar error_custom_message
+        varchar error_message
+        text stack_trace
+        tinyint is_active
+    }
+```
+
+> Note: Some FK relationships are logical (enforced in application / TypeORM) rather than hard MySQL foreign keys on every column.
+
+---
+
+## Runtime pipeline diagram
+
+```mermaid
+flowchart LR
+    A[Business code] -->|Action.findOne by code| B[EventHq.add]
+    B --> C[(twf_event pending)]
+    B --> D[SQS FLOW_QUEUE_URL]
+    D --> E[worker.ts pollQueue]
+    E --> F[EventHq.processSingleEvent]
+    F --> G{Active nodes for actionId}
+    G --> H[Query origin view by dataId]
+    H --> I{flow status=on<br/>vendor match or vendor 55}
+    I -->|yes| J[(twf_flow_instance)]
+    J --> K[RecursiveInstance DAG walk]
+    K --> L[(twf_node_instance)]
+    I -->|no| M[Skip node]
+    F -.->|errors| N[(twf_flow_log)]
+```
+
+---
+
+## Table reference
+
+| Table | Role |
+|-------|------|
+| `twf_action_type` | Category of step (EVENT, EMAIL, DELAY, PAGE, CHAINED FLOW, CONTROLLER EXECUTION, …) |
+| `twf_action` | Reusable action / event definition; stable API via `code` |
+| `twf_flow` | Flow definition (template or vendor custom instance) |
+| `twf_node` | One step in a flow; points at one action; holds `action_config_json` |
+| `twf_node_connection` | Directed edges (DAG). Init connection uses `node_id_master = NULL` |
+| `twf_event` | Async event queue row |
+| `twf_flow_instance` | One execution of a flow for a given `dataId` |
+| `twf_node_instance` | Per-step execution record |
+| `twf_origin_name` | Registry of DB views used as event data sources |
+| `twf_field_map` | Column aliases for Harmony builder / templating |
+| `twf_flow_log` | Execution / processing errors |
+
+### Important `twf_flow` fields
+
+| Field | Meaning |
+|-------|---------|
+| `type` | `template` (blueprint) or `custom` (vendor instance) |
+| `template_type` | `funnel`, `flow`, or null |
+| `status` | Must be **`on`** for `EventHq` to execute the flow |
+| `vendor_id` | `0` / `55` for global templates; vendor id for instances. **Vendor 55** matches any vendor’s events |
+| `code` | Optional stable identifier (e.g. `NEW_EMAIL_LIST`) |
+
+### Important `twf_action` fields
+
+| Field | Meaning |
+|-------|---------|
+| `code` | Unique string — always resolve with `Action.findOne({ code })` |
+| `origin_name` / `origin_key` | View + PK used when resolving `dataId` |
+| `schema_json` | UI form for Harmony flow builder |
+| `event_config` | Optional filters: `{ "filters": [{ "originField", "nodeField" }] }` |
+| `controller_function` | Tempo controller path for CONTROLLER EXECUTION (e.g. `hq-nd/BusinessTypeSF/sendApprovalNotification`) |
+
+### Common `action_type_id` values (active)
+
+| ID | Name | Notes |
+|----|------|--------|
+| 9 | EVENT | Trigger / listener node |
+| 10 | EMAIL NOTIFICATION | Send email |
+| 11 | DELAY | Wait step |
+| 16 | PAGE | Opt-in / bridge pages |
+| 24 | CHAINED FLOW | Invoke another flow |
+| 26 | PUSH NOTIFICATION | Mobile push |
+| 28 | CONTROLLER EXECUTION | Call a Tempo controller method |
+
+`on_duplicate` on the action type drives post-processing when duplicating a flow (`duplicateEmailTemplate`, `duplicatePageTemplate`, `duplicateChainedFlow`).
+
+---
+
+## JSON configuration layers
+
+1. **`twf_action_type.schema_json`** — shared UI schema for the type  
+2. **`twf_action.schema_json`** — per-action UI overrides  
+3. **`twf_node.action_config_json`** — **actual values at runtime** for that node  
+
+Examples of `action_config_json`:
+
+| Type | Typical keys |
+|------|----------------|
+| PAGE | `templateBuilderId`, `emailListId`, `smsListId`, `title` |
+| EMAIL | `to`, `subject`, `templateId` |
+| DELAY | `quantity`, `type` (`hours` / `minutes` / `days`) |
+| CHAINED / EMAIL_JOURNEY | `flowId` |
+| CONTROLLER / push (SF) | `subject`, `message`, `mobileActionId`, `notificationType` |
+
+Templates may use `{{ FIELD }}` placeholders resolved from the origin view row (`config_json_template` / node config).
+
+---
+
+## Triggering a flow from TypeScript
+
+```typescript
+import { Action, Event } from '@pxp-nd/flow';
+import EventHq from './EventHq';
+
+const action = await Action.findOne({ code: 'ADD EMAIL LIST ADDRESS' });
+if (action) {
+  const eventInstance = new EventHq('hq-nd/EventHq', Event);
+  await eventInstance.add({
+    actionId: action.actionId,
+    descJobName: 'formLegato',           // caller context
+    dataId: resInsert.emailListAddrId,   // PK in action.origin_name
+  }, manager);
+}
+```
+
+Rules:
+
+- Prefer **`EventHq.add()`** in Tempo (enqueues SQS). Do not bypass the queue for production event firing.
+- Never hardcode `action_id`; always look up by `code`.
+- `dataId` must exist in the action’s origin view.
+- Flow must be `status = 'on'` and `is_active = 1`.
+
+Events may also be fired from legacy PHP (e.g. billing jobs calling `hq-nd/EventHq/add`).
+
+---
+
+## Assembling / creating flows
+
+### A. Duplicate a template (preferred for vendor instances)
+
+```typescript
+const flowHq = new FlowHQ('hq-nd/FlowHQ');
+const result = await flowHq.duplicateFlow(
+  { flowId: templateFlowId, vendorId, name: 'Bridge Funnel' },
+  manager
+);
+// Activate if needed:
+await manager.createQueryBuilder().update('twf_flow')
+  .set({ status: 'on' })
+  .where('flowId = :flowId', { flowId })
+  .execute();
+```
+
+Template IDs often come from env:
+
+- `TEMPLATE_BRIDGE_FUNNEL_FLOW_ID` (default `149`)
+- `TEMPLATE_QORD_BRIDGE_FUNNEL_FLOW_ID` (default `3419`)
+
+### B. Patch init node after duplicate
+
+```typescript
+await manager.createQueryBuilder().update('twf_node')
+  .set({ actionConfigJson: JSON.stringify({ emailListId }) })
+  .where('flowId = :flowId AND isInit = :isInit', { flowId, isInit: 'Y' })
+  .execute();
+```
+
+### C. Chained funnel → email journey
+
+Use `FlowHQ.addChainedFlow()` (duplicates child flow, copies `emailListId`, activates).
+
+### D. SQL registration
+
+Typical order:
+
+1. Optional `twf_action_type`
+2. `twf_action` (EVENT + step actions) with `WHERE NOT EXISTS (... code ...)`
+3. If new origin: `twf_origin_name` + `twf_field_map`
+4. Optional full graph: `twf_flow` → init `twf_node` → connections → step nodes
+5. Register in `src/modules/hq-nd/database/jaime-scripts.ts` as `JRR-HQ-[STORY]-[SEQ]`
+
+Modern SF-style DML often registers **actions only** and lets the Harmony UI assemble the graph.
+
+---
+
+## Vendor matching (important)
+
+When processing an event, Tempo runs a flow if:
+
+```text
+flow.vendorId === viewVendorId  OR  flow.vendorId === 55
+```
+
+So:
+
+- A **vendor-specific** flow only runs for that vendor’s data.
+- A **vendor 55 (Qorus)** flow runs for **any** vendor that fires the matching event (global notifications).
+
+---
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `FLOW_QUEUE_URL` | SQS FIFO queue for async events |
+| `INIT_FLOW_WORKER` | `Y` starts `pollQueue()` from `server.ts` |
+| `TEMPLATE_BRIDGE_FUNNEL_FLOW_ID` | Default bridge funnel template |
+| `TEMPLATE_QORD_BRIDGE_FUNNEL_FLOW_ID` | Qord bridge funnel template |
+| `SLACK_TEMPO_ERROR` | Channel for worker failures after retries |
+
+---
+
+## Naming conventions
+
+- Action `code`: UPPER CASE with spaces — e.g. `NEW POSTED NEED`, `BILLING NOT PROCESSED`, `SF SEND COS PUSH`
+- Funnel templates: `type = 'template'`, `template_type = 'funnel'`
+- Email / automation templates: `type = 'template'`, `template_type = 'flow'` (or null)
+- Vendor copies after `duplicateFlow`: `type = 'custom'`
+
+---
+
+## Do / Don’t
+
+**Do**
+
+- Find actions by `code`
+- Duplicate templates for vendor flows; keep them `status = 'on'` when they should run
+- Register new origins in `twf_origin_name` (+ field maps) before using them in actions
+- Use `EventHq.add` so processing goes through SQS
+
+**Don’t**
+
+- Hardcode `action_id`
+- Auto-sync `twf_*` schema (`synchronize` stays false)
+- Skip SQS for production event firing
+- Hand-build full vendor graphs in TypeScript when a template + `duplicateFlow` exists
+
+---
+
+## Controllers that commonly fire events
+
+Examples in Tempo: `Site`, `Vendor`, `Member`, `Package`, `MemberAccounts`, `EmailList`, `PageTemplate`, `Extra`, `CloudFrontFlow`, mobile `Subscriptions`, `helpers/Site.ts`. Legacy Harmony PHP jobs may also call `EventHq/add` (e.g. billing).
+
+---
+
+## Related Cursor rules
+
+Project conventions for flows are also summarized in `.cursorrules` under **Flows (Workflow Engine)**. Keep this document and those rules aligned when changing the event pipeline or `twf_*` contracts.

package/dist/controllers/Action.d.ts

@@ -9,7 +9,7 @@
  * @author Favio Figueroa
  *
  * Created at     : 2021-07-08 12:55:38
- * Last modified  :
+ * Last modified  : 2026-11-06 — Rensi Arteaga — @ApiDoc for OpenAPI (spec 04)
  */
 import { EntityManager } from 'typeorm';
 import { Controller } from '@pxp-nd/core';

package/dist/controllers/Action.js

@@ -10,7 +10,7 @@
  * @author Favio Figueroa
  *
  * Created at     : 2021-07-08 12:55:38
- * Last modified  :
+ * Last modified  : 2026-11-06 — Rensi Arteaga — @ApiDoc for OpenAPI (spec 04)
  */
 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;
@@ -30,9 +30,13 @@ const core_1 = require("@pxp-nd/core");
 const Action_1 = __importDefault(require("../entity/Action"));
 const FieldMap_1 = __importDefault(require("../entity/FieldMap"));
 const OriginName_1 = __importDefault(require("../entity/OriginName"));
+const FlowNdApiDocs_1 = require("../helpers/FlowNdApiDocs");
 let Action = class Action extends core_1.Controller {
     async getFieldMapByAction(params, manager) {
         const { originName } = params;
+        if (originName == null || String(originName).trim() === '') {
+            throw new core_1.PxpError(400, 'originName is required');
+        }
         const fieldMapData = await (0, core_1.__)(manager.createQueryBuilder(FieldMap_1.default, 'fm')
             .innerJoin(OriginName_1.default, 'on', 'on.originNameId = fm.originNameId')
             .where("on.name = :n ", { n: originName })
@@ -61,8 +65,9 @@ let Action = class Action extends core_1.Controller {
 __decorate([
     (0, core_1.Get)(),
     (0, core_1.DbSettings)('Orm'),
-    (0, core_1.ReadOnly)(false),
+    (0, core_1.ReadOnly)(true),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.actionGetFieldMapByActionDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -72,6 +77,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(true),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.actionGetActionsDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)

package/dist/controllers/Flow.d.ts

@@ -19,6 +19,7 @@
  * 28-Sep-2023    SP06OCT23     Mercedes Zambrana      Add Validation when change off status (validateFlow, deleteflow, saveFlow, saveflowName)
  * 07-Feb-2025    8353064698    Mercedes Zambrana      Add validation for opt in page when flow si funnel change
  * 18-Feb-2025    8501163144    Mercedes Zambrana      Add publish filter
+ * 06-Nov-2026                     Rensi Arteaga         @ApiDoc for OpenAPI (spec 04)
  * ******************************************************************************
  */
 import { EntityManager } from 'typeorm';

package/dist/controllers/Flow.js

@@ -20,6 +20,7 @@
  * 28-Sep-2023    SP06OCT23     Mercedes Zambrana      Add Validation when change off status (validateFlow, deleteflow, saveFlow, saveflowName)
  * 07-Feb-2025    8353064698    Mercedes Zambrana      Add validation for opt in page when flow si funnel change
  * 18-Feb-2025    8501163144    Mercedes Zambrana      Add publish filter
+ * 06-Nov-2026                     Rensi Arteaga         @ApiDoc for OpenAPI (spec 04)
  * ******************************************************************************
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -69,8 +70,13 @@ const FlowInstance_1 = __importDefault(require("../entity/FlowInstance"));
 const Node_2 = __importDefault(require("./Node"));
 const axios_1 = __importDefault(require("axios"));
 //import {configFacebookStrategy} from "./passport-facebook";
+const FlowNdApiDocs_1 = require("../helpers/FlowNdApiDocs");
 let Flow = class Flow extends core_1.Controller {
     async get(params) {
+        const fid = Number(params.flowId);
+        if (!Number.isInteger(fid) || fid < 1) {
+            throw new core_1.PxpError(400, 'flowId is required and must be a positive integer');
+        }
         const nodes = await Node_1.default.find({ flowId: params.flowId });
         const restNodes = [];
         for (let node of nodes) {
@@ -477,6 +483,10 @@ let Flow = class Flow extends core_1.Controller {
     }
     async getFlowRender(params) {
         var _a;
+        const fid = Number(params.flowId);
+        if (!Number.isInteger(fid) || fid < 1) {
+            throw new core_1.PxpError(400, 'flowId is required and must be a positive integer');
+        }
         const flow = await (0, typeorm_1.getManager)().findOne(Flow_1.default, params.flowId);
         const totalNodes = await (0, typeorm_1.getManager)()
             .createQueryBuilder(Node_1.default, "n")
@@ -782,6 +792,15 @@ let Flow = class Flow extends core_1.Controller {
         const filter = (params === null || params === void 0 ? void 0 : params.filter) ? JSON.parse(params === null || params === void 0 ? void 0 : params.filter) : null;
         const filters = (filter === null || filter === void 0 ? void 0 : filter.items) || [];
         const logicOperator = ((_a = filter === null || filter === void 0 ? void 0 : filter.logicOperator) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || 'AND';
+        const allowedSort = ['flowId', 'name', 'createdAt', 'modifiedAt'];
+        const allowedDir = ['ASC', 'DESC'];
+        const sortCol = params.sort != null && params.sort !== '' ? String(params.sort) : 'flowId';
+        const dirVal = params.dir != null && params.dir !== ''
+            ? String(params.dir).toUpperCase()
+            : 'ASC';
+        if (!allowedSort.includes(sortCol) || !allowedDir.includes(dirVal)) {
+            throw new core_1.PxpError(400, 'sort and dir must be allowed values (whitelist for SQL orderBy)');
+        }
         const queryBuilder = await (0, typeorm_1.getManager)()
             .createQueryBuilder()
             .select([
@@ -888,7 +907,7 @@ let Flow = class Flow extends core_1.Controller {
         // Sorting and pagination
         //queryBuilder.orderBy(`f.${params.sort}`, params.dir).skip(params.start).take(params.limit);
         // Sorting and pagination
-        queryBuilder.orderBy(`f.${params.sort}`, params.dir);
+        queryBuilder.orderBy(`f.${sortCol}`, dirVal);
         // Agrega manualmente la cláusula LIMIT y OFFSET
         queryBuilder.limit(params.limit).offset(params.start);
         const data = await queryBuilder.getRawMany();
@@ -929,6 +948,15 @@ let Flow = class Flow extends core_1.Controller {
         const filters = (filter === null || filter === void 0 ? void 0 : filter.items) || [];
         const logicOperator = ((_a = filter === null || filter === void 0 ? void 0 : filter.logicOperator) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || "AND";
         const publish = params._publish;
+        const allowedSort = ["flowId", "name", "createdAt", "modifiedAt"];
+        const allowedDir = ["ASC", "DESC"];
+        const sortCol = params.sort != null && params.sort !== "" ? String(params.sort) : "flowId";
+        const dirVal = params.dir != null && params.dir !== ""
+            ? String(params.dir).toUpperCase()
+            : "ASC";
+        if (!allowedSort.includes(sortCol) || !allowedDir.includes(dirVal)) {
+            throw new core_1.PxpError(400, "sort and dir must be allowed values (whitelist for SQL orderBy)");
+        }
         const queryBuilder = await (0, typeorm_1.getManager)()
             .createQueryBuilder()
             .select([
@@ -1040,7 +1068,7 @@ let Flow = class Flow extends core_1.Controller {
             "f.status",
         ]);
         // Ordenamiento y paginación
-        queryBuilder.orderBy(`f.${params.sort || "flowId"}`, params.dir || "ASC");
+        queryBuilder.orderBy(`f.${sortCol}`, dirVal);
         queryBuilder.limit(params.limit || 50).offset(params.start || 0);
         // Obtener los datos
         const data = await queryBuilder.getRawMany();
@@ -1117,6 +1145,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(true),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowGetDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
@@ -1135,6 +1164,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowDeleteFlowDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -1144,6 +1174,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowSaveFlowNameDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -1162,6 +1193,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowSaveFlowDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -1172,6 +1204,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(true),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowGetFlowRenderDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
@@ -1181,6 +1214,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowInsertEventFlowDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -1199,6 +1233,7 @@ __decorate([
     (0, core_1.DbSettings)('Orm'),
     (0, core_1.ReadOnly)(false),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowChangeStatusFlowDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, typeorm_1.EntityManager]),
     __metadata("design:returntype", Promise)
@@ -1217,6 +1252,7 @@ __decorate([
     (0, core_1.DbSettings)("Orm"),
     (0, core_1.ReadOnly)(true),
     (0, core_1.Log)(true),
+    (0, core_1.ApiDoc)(FlowNdApiDocs_1.flowListTemplatesDoc),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
@@ -1231,6 +1267,7 @@ __decorate([
     __metadata("design:returntype", Promise)
 ], Flow.prototype, "changePublishTemplate", null);
 Flow = __decorate([
+    (0, core_1.ApiDocFor)('add', FlowNdApiDocs_1.flowAddDoc),
     (0, core_1.Model)('flow-nd/Flow')
 ], Flow);
 exports.default = Flow;

package/dist/controllers/FlowInstance.d.ts

@@ -13,6 +13,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
  */
 import { EntityManager } from 'typeorm';
 import { Controller } from '@pxp-nd/core';