@uipath/maestro-builder-sdk 6.18.3 → 6.18.4

package/dist/api-index.md

@@ -204,9 +204,9 @@ could hand you spans for a version you do not have.
 | `ran` | function | `dist/core/expr.d.ts:95-141` | Expressions and types | Did this step run? |
 | `rawNode` | function | `dist/core/node-classes.d.ts:180-242` | Supporting types | Place a node this SDK has no factory for, carrying its definition verbatim (`uipath.exotic.thing@2.1` and the manifest… |
 | `RawReference` | type | `dist/core/lookups.d.ts:190-198` | Supporting types |  |
-| `refuseLookupToken` | function | `dist/core/lookups.d.ts:207-223` | Generated descriptors | Refuse a lookup token where the family cannot resolve one. |
 | `RemoteA2aToolRef` | interface | `dist/core/actions.d.ts:1745-1765` | Supporting types | A remote A2A (agent-to-agent) endpoint the agent may delegate to. |
 | `resolvedValue` | function | `dist/core/lookups.d.ts:172-179` | Generated descriptors | The recorded id for a token, or `undefined`. |
+| `resolveEventWhere` | function | `dist/core/lookups.d.ts:207-224` | Generated descriptors | An event subscription's `where` with every lookup token swapped for the id `registry prepare --resolve` recorded, or a… |
 | `ReturnFieldType` | type | `dist/core/actions.d.ts:1317-1334` | Supporting types | A JSON-schema-ish type for one field of a step's declared `returns`. |
 | `ReturnOptions` | interface | `dist/flow-sdk.d.ts:397-428` | Option shapes | `.return(...)`-specific options. |
 | `rpaWorkflow` | function | `dist/core/actions.d.ts:2841-2885` | Actions | Invoke a deployed RPA (robotic process automation) workflow — a classic UI-automation process, published to… |

package/dist/case/check.js

@@ -3,6 +3,7 @@ import { authoredCaseVersion, CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from '
 import { schemaVersionRefusal } from '../schema-version.js';
 import { caseJsonPreservation, caseJsonPreservationErrors } from './preserve.js';
 import { EQUALS_EXPR_DIALECT, checkConnectorContract, checkConnectorLookups, checkConnectorSchema, } from '../core/connector-checks.js';
+import { checkEventResolution } from '../core/event-checks.js';
 const TYPE_NAMES = new Set(Object.values(types));
 // audit-case-coverage: rule-slot table start
 // This runtime table must equal the committed matrix's rejected cells. The audit
@@ -288,6 +289,9 @@ function checkLibraryConnectors(built, opts, diags) {
         const refused = opts.subscriptionError?.(kind, sub);
         if (refused !== undefined)
             diags.push({ level: 'error', code: refused.code, message: `${where}: ${refused.message}`, where: at });
+        // A `where` lookup nobody recorded: Flow's LOOKUP_UNRESOLVED warning, from the
+        // shared event rules. Only `resolutions` is passed, so nothing else in them fires.
+        checkEventResolution(sub, where, kind, { resolutions: opts.resolutions ?? {} }, (code, message) => diags.push({ level: 'error', code, message, where: at }), (code, message) => diags.push({ level: 'warning', code, message, where: at }));
     };
     const rules = (conditions, where) => {
         for (const c of conditions)

package/dist/case/serialize.js

@@ -11,7 +11,7 @@
 import { IdGen } from './ids.js';
 import { buildConnectorInputs, nestConnectorBody, transportHttpMethod } from '../core/connector-inputs.js';
 import { EQUALS_EXPR_DIALECT } from '../core/connector-checks.js';
-import { refuseLookupToken } from '../core/lookups.js';
+import { resolveEventWhere } from '../core/lookups.js';
 import { resolveCaseSubscription } from './subscription.js';
 import { CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from './format-profile.js';
 import { resolveSchemaVersion } from '../schema-version.js';
@@ -902,16 +902,13 @@ function resolvedSubscriptionBag(kind, spec, resolver, elementId) {
     return {
         serviceType: kind === 'trigger' ? CASE_FORMAT_PROFILE.eventServiceType : CASE_FORMAT_PROFILE.waitConnectorServiceType,
         context,
-        inputs: [eventInput(spec.where ?? {}, elementId)],
+        inputs: [eventInput(resolveEventWhere(spec.where, resolver.library.lookupResolutions, `${kind === 'trigger' ? 'event trigger' : 'wait-for-connector'} "${elementId}"`), elementId)],
         outputs: connectorOutputs(rc, elementId, resolver),
         bindings: [],
     };
 }
+/** The subscription's `body` input; `where` has its lookups already resolved (`resolveEventWhere`). */
 function eventInput(where, elementId) {
-    // Case compile does not read resolutions.json (Flow does); a token here
-    // would be emitted raw where the connector expects an id.
-    for (const [field, value] of Object.entries(where))
-        refuseLookupToken(value, 'case', field);
     return Object.keys(where).length
         ? { name: 'body', type: 'json', target: 'body', body: { queryParams: where }, var: 'vbody', id: 'vbody', elementId }
         : { name: 'body', type: 'json', target: 'body', value: '', var: 'vbody', id: 'vbody', elementId };

package/dist/core/lookups.d.ts

@@ -205,20 +205,21 @@ type RawReference = {
  */
 export declare function lookupSpecOf(reference: RawReference, invariant?: ReadonlySet<string>): LookupSpec | undefined;
 /**
- * Refuse a lookup token where the family cannot resolve one.
- *
- * Connector-activity inputs resolve their lookups in every family through
- * `buildConnectorInputs` (`core/connector-inputs.ts`), which reads
- * `connectors-local/resolutions.json`. This guard is for the sites that do not
- * go through it yet: a Case event subscription's `where`, whose values Case
- * copies into its emitted payload verbatim. A token reaching one would be
- * embedded as `{"__lookup": {…}}` where the connector expects an id, which is
- * silent wrongness, so it is refused instead.
- *
- * @param value - A connector input value.
- * @param family - The authoring family, for the message.
- * @param field - The input name, for the message.
- * @throws If `value` is an unresolved {@link LookupToken}.
+ * An event subscription's `where` with every lookup token swapped for the id
+ * `registry prepare --resolve` recorded, or a throw naming the first one nobody
+ * recorded.
+ *
+ * The id is looked up under the token's own node type, which for an event
+ * lookup is the EVENT form `prepare` stores it under. Emitting a placeholder for
+ * a value nobody resolved would subscribe the trigger to the wrong folder,
+ * channel or queue, so an unrecorded token is refused, never passed through.
+ * Shared by Flow's and Case's serializers, so both resolve and refuse alike.
+ *
+ * @param where - The authored `where`.
+ * @param resolutions - The library's recorded resolutions (`library.lookupResolutions`).
+ * @param site - How the caller names the subscription, prefixed to the refusal.
+ * @returns The `where` with ids in place of tokens.
+ * @throws If a token has no recorded resolution.
  */
-export declare function refuseLookupToken(value: unknown, family: string, field: string): void;
+export declare function resolveEventWhere(where: Record<string, unknown> | undefined, resolutions: LookupResolutions, site: string): Record<string, unknown>;
 export {};

package/dist/core/lookups.js

@@ -259,30 +259,33 @@ function byAlias(lookupName) {
     return 'by' + words.map((w) => w[0].toUpperCase() + w.slice(1)).join('');
 }
 /**
- * Refuse a lookup token where the family cannot resolve one.
+ * An event subscription's `where` with every lookup token swapped for the id
+ * `registry prepare --resolve` recorded, or a throw naming the first one nobody
+ * recorded.
  *
- * Connector-activity inputs resolve their lookups in every family through
- * `buildConnectorInputs` (`core/connector-inputs.ts`), which reads
- * `connectors-local/resolutions.json`. This guard is for the sites that do not
- * go through it yet: a Case event subscription's `where`, whose values Case
- * copies into its emitted payload verbatim. A token reaching one would be
- * embedded as `{"__lookup": {…}}` where the connector expects an id, which is
- * silent wrongness, so it is refused instead.
+ * The id is looked up under the token's own node type, which for an event
+ * lookup is the EVENT form `prepare` stores it under. Emitting a placeholder for
+ * a value nobody resolved would subscribe the trigger to the wrong folder,
+ * channel or queue, so an unrecorded token is refused, never passed through.
+ * Shared by Flow's and Case's serializers, so both resolve and refuse alike.
  *
- * @param value - A connector input value.
- * @param family - The authoring family, for the message.
- * @param field - The input name, for the message.
- * @throws If `value` is an unresolved {@link LookupToken}.
+ * @param where - The authored `where`.
+ * @param resolutions - The library's recorded resolutions (`library.lookupResolutions`).
+ * @param site - How the caller names the subscription, prefixed to the refusal.
+ * @returns The `where` with ids in place of tokens.
+ * @throws If a token has no recorded resolution.
  */
-export function refuseLookupToken(value, family, field) {
-    if (!isLookupToken(value))
-        return;
-    const { nodeType, by, value: wanted } = value.__lookup;
-    throw new Error(`${family}: input "${field}" is a lookup(), which ${family} cannot resolve — ` +
-        `only Flow reads connectors-local/resolutions.json today, so this would be ` +
-        `emitted as a raw token where the connector expects an id.\n` +
-        `Resolve it first and pass the value:\n` +
-        `  ${prepareCommand()} ${nodeType.replace(/^uipath\.connector\.(?:trigger\.|event\.)?/, '').replace(/\.([^.]+)$/, ' --action $1')} \\\n` +
-        `    --resolve ${field}:${by}=${String(wanted)}\n` +
-        `then read the id out of connectors-local/resolutions.json.`);
+export function resolveEventWhere(where, resolutions, site) {
+    const out = {};
+    for (const [key, value] of Object.entries(where ?? {})) {
+        if (!isLookupToken(value)) {
+            out[key] = value;
+            continue;
+        }
+        const resolved = resolvedValue(value, resolutions);
+        if (resolved === undefined)
+            throw new Error(`${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
+        out[key] = resolved;
+    }
+    return out;
 }

package/dist/serialize.js

@@ -44,7 +44,7 @@ export function connectorInputErrors(rc, inputs, resolutions = {}, lookups = {})
         render: (value) => renderDeep(value, NO_RENAME),
     });
 }
-import { isLookupToken, resolvedValue, unresolvedLookupMessage, } from './core/lookups.js';
+import { isLookupToken, resolveEventWhere, } from './core/lookups.js';
 import { declaredScriptShape, inferScriptShape } from './core/script-return.js';
 import { migrateToSchemaVersion } from './migrate.js';
 import { FLOW_SCHEMA_VERSIONS } from './format-profile.js';
@@ -4127,19 +4127,7 @@ function eventDetail(rc, sub, nodeId, opts, site) {
     // `prepare --resolve` stored under the EVENT-form node type — or refused.
     // Same rule as connector inputs: emitting a placeholder for a value nobody
     // resolved would subscribe the trigger to the wrong folder/channel/queue.
-    const eventResolutions = opts.library?.lookupResolutions ?? {};
-    const where = {};
-    for (const [k, v] of Object.entries(sub.where ?? {})) {
-        if (!isLookupToken(v)) {
-            where[k] = v;
-            continue;
-        }
-        const resolved = resolvedValue(v, eventResolutions);
-        if (resolved === undefined) {
-            throw new Error(`event node "${nodeId}": \`where.${k}\` ` + unresolvedLookupMessage(v));
-        }
-        where[k] = resolved;
-    }
+    const where = resolveEventWhere(sub.where, opts.library?.lookupResolutions ?? {}, `event node "${nodeId}"`);
     // A subscription's parameters do not all travel in the same slot. The
     // connector declares which, and the library bakes it per field as `bucket`:
     // measured against designer-authored triggers, Jira's `project`/`issuetype`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.18.3",
+  "version": "6.18.4",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -92,5 +92,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "e2e0a41da39b08bb97a105483f436232f0e36c2e"
+  "gitref": "35ff6e86b7aecb0b5c76663b6650a0924a8b7f6e"
 }