@uipath/maestro-tool 1.202.2 → 1.203.0-preview.180

package/dist/packager-tool-2q1mffef.js

@@ -0,0 +1,261 @@
+import {
+  validateIntSvcNode
+} from "./packager-tool-fq7wtkd3.js";
+import {
+  catchError
+} from "./packager-tool-z6nkdv48.js";
+
+// ../flow-tool/src/services/connector-node-types.ts
+function isConnectorTriggerType(nodeType) {
+  return nodeType.startsWith("uipath.connector.trigger");
+}
+function isConnectorWaitForEventType(nodeType) {
+  return nodeType.startsWith("uipath.connector.event");
+}
+function isEventDrivenConnectorType(nodeType) {
+  return isConnectorTriggerType(nodeType) || isConnectorWaitForEventType(nodeType);
+}
+
+// ../flow-tool/src/services/node-validators/connector-validator.ts
+var connectorNodeValidator = {
+  id: "uipath-connector",
+  appliesTo: (node) => node.type?.startsWith("uipath.connector") ?? false,
+  validate: (node) => {
+    const rawDetail = node.inputs?.detail;
+    const emptyDetailWarning = {
+      path: `nodes[${node.id}].inputs.detail`,
+      severity: "warning",
+      message: "Connector is not configured, no detail found. " + "Run `uip maestro flow node configure <file> <node-id> " + `--detail '{"connectionId":"<id>","folderKey":"<key>",...}'\` ` + "to bind an Integration Service connection."
+    };
+    if (!rawDetail || typeof rawDetail !== "object" || Array.isArray(rawDetail)) {
+      return [emptyDetailWarning];
+    }
+    const detail = rawDetail;
+    if (Object.keys(detail).length === 0)
+      return [emptyDetailWarning];
+    const isEventDriven = isEventDrivenConnectorType(node.type);
+    const context = {
+      nodeId: node.id,
+      nodeKind: isEventDriven ? "trigger" : "activity",
+      connectionId: detail.connectionId,
+      folderKey: detail.connectionFolderKey,
+      objectName: detail.objectName ?? detail.connector,
+      httpMethod: detail.method,
+      endpoint: detail.endpoint,
+      eventMode: detail.eventMode,
+      eventType: detail.eventType,
+      bodyParameters: detail.bodyParameters,
+      queryParameters: detail.queryParameters,
+      pathParameters: detail.pathParameters,
+      eventParameters: detail.eventParameters,
+      configuration: detail.configuration
+    };
+    const issues = validateIntSvcNode(context).map((issue) => ({
+      path: `nodes[${node.id}].inputs.detail`,
+      message: issue.title,
+      severity: issue.type === "Error" ? "error" : "warning"
+    }));
+    issues.push(...validateCeqlFilterShape(node.id, detail));
+    if (!isEventDriven) {
+      issues.push(...validateEndpointMatchesActivityPath(node.id, detail));
+    }
+    return issues;
+  }
+};
+function staticSegments(path, substitutedValues) {
+  const cut = path.search(/[?#]/);
+  return (cut === -1 ? path : path.slice(0, cut)).split("/").filter((seg) => seg.length > 0).filter((seg) => !(seg.startsWith("{") && seg.endsWith("}"))).filter((seg) => !substitutedValues.has(seg));
+}
+function endpointNamesActivity(endpointSegments, activitySegments) {
+  const extra = endpointSegments.length - activitySegments.length;
+  if (extra < 0 || extra > 1)
+    return false;
+  return activitySegments.every((seg, i) => seg === endpointSegments[i]);
+}
+function readEssentialConfiguration(detail) {
+  const configuration = detail.configuration;
+  if (typeof configuration !== "string")
+    return;
+  const [, parsed] = catchError(() => JSON.parse(configuration.replace(/^=jsonString:/, "")));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return;
+  }
+  return readObjectField(parsed, "essentialConfiguration");
+}
+function readEssentialPath(detail) {
+  const path = readEssentialConfiguration(detail)?.path;
+  return typeof path === "string" && path.length > 0 ? path : undefined;
+}
+function validateEndpointMatchesActivityPath(nodeId, detail) {
+  const endpoint = detail.endpoint;
+  if (typeof endpoint !== "string" || endpoint.length === 0)
+    return [];
+  const activityPath = readEssentialPath(detail);
+  if (!activityPath)
+    return [];
+  const substituted = new Set;
+  const pathParameters = detail.pathParameters;
+  if (pathParameters && typeof pathParameters === "object") {
+    for (const v of Object.values(pathParameters)) {
+      if (typeof v === "string" || typeof v === "number") {
+        substituted.add(String(v));
+      }
+    }
+  }
+  if (endpointNamesActivity(staticSegments(endpoint, substituted), staticSegments(activityPath, substituted))) {
+    return [];
+  }
+  return [
+    {
+      path: `nodes[${nodeId}].inputs.detail.endpoint`,
+      severity: "warning",
+      message: `endpoint "${endpoint}" does not name the activity this node is configured for — its path is "${activityPath}" ` + "(essentialConfiguration.path). The runtime calls the endpoint verbatim, so the request reaches a different operation and fails at debug " + "with the provider's words for a missing or unknown field (e.g. Slack [102003] no_text when the v1 endpoint receives the v2 body). " + `Re-run node configure with --detail.endpoint "${activityPath}" (keep {param} segments; values go in pathParameters).`
+    }
+  ];
+}
+function validateCeqlFilterShape(nodeId, detail) {
+  const issues = [];
+  const queryParameters = readObjectField(detail, "queryParameters");
+  if (queryParameters && Object.hasOwn(queryParameters, "$where")) {
+    issues.push({
+      path: `nodes[${nodeId}].inputs.detail.queryParameters["$where"]`,
+      severity: "error",
+      message: 'Connector node uses OData-style `"$where"` (with leading `$`) ' + "in queryParameters. CEQL uses bare `where` — rename the key " + 'from `"$where"` to `"where"`. The leading `$` is the OData ' + "system-query-option prefix and is not recognized by " + "uipath.connector.* nodes. See uipath-maestro-flow skill — " + 'plugins/connector/impl.md, "Hand-authored CEQL strings" ' + "(MST-9265)."
+    });
+  }
+  const queryWhere = queryParameters?.where;
+  const queryWhereAuthored = isNonEmptyString(queryWhere);
+  const queryWhereIsWholeValueExpression = typeof queryWhere === "string" && queryWhere.startsWith("=js:");
+  const savedTrees = readObjectField(detail, "savedFilterTrees") ?? readEssentialSavedFilterTrees(detail);
+  const savedWhereAuthored = savedTrees !== undefined && isNonEmptyObject(savedTrees.where);
+  if (queryWhereAuthored && !queryWhereIsWholeValueExpression && !savedWhereAuthored) {
+    issues.push({
+      path: `nodes[${nodeId}].inputs.detail.savedFilterTrees.where`,
+      severity: "error",
+      message: "Connector node has `queryParameters.where` set but no " + "matching `savedFilterTrees.where` AST — neither at " + "`inputs.detail.savedFilterTrees.where` nor as " + "`essentialConfiguration.savedFilterTrees.where` inside " + "`inputs.detail.configuration`. CEQL filters must be authored " + "as both the raw filter expression (`queryParameters.where`) " + "AND a parallel canonical AST (`filters[].id` / `.operator` / " + "`.value.value`). The Studio Web canvas needs the AST to " + "render the filter UI; the runtime needs the expression. " + "Re-run `uip maestro flow node configure --detail.filter` to " + "author both. See uipath-maestro-flow skill — " + 'plugins/connector/impl.md, "Hand-authored CEQL strings" ' + "(MST-9265)."
+    });
+  }
+  if (savedWhereAuthored && !queryWhereAuthored) {
+    issues.push({
+      path: `nodes[${nodeId}].inputs.detail.queryParameters.where`,
+      severity: "error",
+      message: "Connector node has `savedFilterTrees.where` AST but no " + "matching `queryParameters.where` expression. CEQL filters " + "must be authored on both keys in parallel — the runtime " + "evaluates `queryParameters.where`, not the AST. See " + 'uipath-maestro-flow skill — plugins/connector/impl.md, "Hand-authored ' + 'CEQL strings" (MST-9265).'
+    });
+  }
+  return issues;
+}
+function readEssentialSavedFilterTrees(detail) {
+  const essentialConfiguration = readEssentialConfiguration(detail);
+  if (!essentialConfiguration)
+    return;
+  return readObjectField(essentialConfiguration, "savedFilterTrees");
+}
+function readObjectField(parent, key) {
+  const value = parent[key];
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  return value;
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isNonEmptyObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length > 0;
+}
+
+// ../flow-tool/src/services/node-validators/cross-node-binding-validator.ts
+var IDENTIFIER_ROOT_RE = /(?<![.\w$])([A-Za-z_$][\w$]*)\.(?!\.)/g;
+function findCrossNodeBindingReferences(value, nodeIds) {
+  if (nodeIds.size === 0)
+    return [];
+  const trimmed = value.trimStart();
+  if (!trimmed.startsWith("=js:"))
+    return [];
+  const body = trimmed.slice(4);
+  const referenced = new Set;
+  const fixedBody = body.replace(IDENTIFIER_ROOT_RE, (match, identifier) => {
+    if (!nodeIds.has(identifier))
+      return match;
+    referenced.add(identifier);
+    return `$vars.${match}`;
+  });
+  if (referenced.size === 0)
+    return [];
+  const fixedValue = `=js:${fixedBody}`;
+  return [...referenced].map((nodeId) => ({ nodeId, fixedValue }));
+}
+function crossNodeBindingMessage(originalValue, ref) {
+  return `Expression "${originalValue}" references node "${ref.nodeId}" without the "$vars." prefix — ` + `cross-node outputs resolve to undefined at runtime (the bare identifier reads as an ` + `undeclared local, not the runtime variable). Use "${ref.fixedValue}" instead. ` + "See uipath-maestro-flow skill — node-output-wiring.md (FPD-538).";
+}
+function scanContainerForCrossNodeBindings(obj, path, nodeIds, severity, issues) {
+  if (typeof obj === "string") {
+    for (const ref of findCrossNodeBindingReferences(obj, nodeIds)) {
+      issues.push({
+        path,
+        severity,
+        message: crossNodeBindingMessage(obj, ref)
+      });
+    }
+    return;
+  }
+  if (Array.isArray(obj)) {
+    for (let i = 0;i < obj.length; i++) {
+      scanContainerForCrossNodeBindings(obj[i], `${path}[${i}]`, nodeIds, severity, issues);
+    }
+    return;
+  }
+  if (obj && typeof obj === "object") {
+    for (const [key, value] of Object.entries(obj)) {
+      scanContainerForCrossNodeBindings(value, `${path}.${key}`, nodeIds, severity, issues);
+    }
+  }
+}
+var PARAMETER_CONTAINER_KEYS = [
+  "bodyParameters",
+  "queryParameters",
+  "pathParameters"
+];
+function scanDetailForCrossNodeBindings(detail, nodeIds, severity = "warning") {
+  if (!detail || nodeIds.size === 0)
+    return [];
+  const issues = [];
+  for (const containerKey of PARAMETER_CONTAINER_KEYS) {
+    const container = detail[containerKey];
+    if (!container || typeof container !== "object" || Array.isArray(container)) {
+      continue;
+    }
+    scanContainerForCrossNodeBindings(container, `detail.${containerKey}`, nodeIds, severity, issues);
+  }
+  return issues;
+}
+var crossNodeBindingValidator = {
+  id: "cross-node-binding",
+  appliesTo: (node) => {
+    const t = node.type;
+    if (!t)
+      return false;
+    if (isEventDrivenConnectorType(t))
+      return false;
+    return t.startsWith("uipath.connector.") || t === "core.action.http" || t === "core.action.http.v2";
+  },
+  validate: (node, context) => {
+    const nodeIds = context.nodeIds ?? new Set;
+    if (nodeIds.size === 0)
+      return [];
+    const rawDetail = node.inputs?.detail;
+    if (!rawDetail || typeof rawDetail !== "object" || Array.isArray(rawDetail)) {
+      return [];
+    }
+    const severity = context.strictBindings ? "error" : "warning";
+    const issues = scanDetailForCrossNodeBindings(rawDetail, nodeIds, severity);
+    return issues.map((issue) => ({
+      ...issue,
+      path: `nodes[${node.id}].inputs.${issue.path}`
+    }));
+  }
+};
+
+export { isConnectorTriggerType, isConnectorWaitForEventType, isEventDrivenConnectorType, connectorNodeValidator, readEssentialConfiguration, scanDetailForCrossNodeBindings, crossNodeBindingValidator };
+
+//# debugId=23993EE2502BD84764756E2164756E21