@uipath/maestro-builder-sdk 6.65.0 → 6.66.1

package/dist/bpmn/intsvc.js

@@ -1,7 +1,8 @@
 import { createTypedNode, typedNodeOutputVar } from './typed-node.js';
 import { connectorBindingRef } from './connector.js';
-import { eventFilterJmes, eventFilterProblem, jmesString, jmesStringProblem, readEventFilter } from '../core/event-filters.js';
+import { eventFilterJmes, jmesString, jmesStringProblem, readEventFilterLeaf } from '../core/event-filters.js';
 import { resolveEventWhere } from '../core/lookups.js';
+import { CompileRefusal } from '../core/compile-refusal.js';
 /**
  * Which extension type an external invocation lowers to.
  *
@@ -57,14 +58,14 @@ export function intsvcOutputVar(n) {
  */
 export function createConnectorEvent(ctx, n) {
     if (!ctx.library)
-        throw new Error(`connector event "${n.id}" needs the connector library — pass { library } to serialize ` +
+        throw new CompileRefusal('LIBRARY_REQUIRED', `connector event "${n.id}" needs the connector library — pass { library } to serialize ` +
             `or use uip maestro bpmn compile --library.`);
     const rc = ctx.library.resolveEvent(n.subscribe, n.key, n.eventName, n.version, n.object);
     const op = (rc.entry.operation ?? {});
     const runtime = rc.entry.runtime ?? {};
     const type = runtime.serviceType;
     if (!type) {
-        throw new Error(`connector event ${n.key}/${n.eventName} has no runtime.serviceType in the library; ` +
+        throw new CompileRefusal('BPMN_EVENT_NO_SERVICE_TYPE', `connector event ${n.key}/${n.eventName} has no runtime.serviceType in the library; ` +
             `it cannot be authored as a BPMN node.`);
     }
     // The PLACEMENT decides the extension type — `.eventTrigger()` starts the
@@ -79,13 +80,13 @@ export function createConnectorEvent(ctx, n) {
     // .eventTrigger() instead", while the unprepared same node compiled.
     const expected = intsvcServiceType(n);
     if (type !== 'Intsvc.EventTrigger' && type !== 'Intsvc.WaitForEvent') {
-        throw new Error(`connector event "${n.id}" was authored as a ${n.subscribe} (${expected}), but the library ` +
+        throw new CompileRefusal('BPMN_EVENT_KIND_MISMATCH', `connector event "${n.id}" was authored as a ${n.subscribe} (${expected}), but the library ` +
             `describes ${n.key}/${n.eventName} as ${type}, which is not a connector event.`);
     }
     const conn = connectorBindingRef(ctx, n.connection, 'Connection', 'ConnectionId', `${rc.connectorKey} connection`);
     const folder = connectorBindingRef(ctx, n.folder, 'Connection', 'folderKey', 'FolderKey', conn?.resourceKey);
     if (!conn || !folder) {
-        throw new Error(`connector event "${n.id}" needs both a connection and a folder binding name — ` +
+        throw new CompileRefusal('BPMN_EVENT_BINDINGS_MISSING', `connector event "${n.id}" needs both a connection and a folder binding name — ` +
             `the type declares connectionId, folderId, folderPath and folderKey all required.`);
     }
     // The registry marks `operation` and `objectName` required AND hidden, so an
@@ -144,20 +145,20 @@ export function eventFilterBody(nodeId, scope, filters) {
     const scopeClauses = scopeEntries.map(([k, v]) => {
         const problem = jmesStringProblem(String(v));
         if (problem)
-            throw new Error(`connector event "${nodeId}": \`filter.${k}\`: ${problem}`);
+            throw new CompileRefusal('EVENT_FILTER_BACKSLASH', `connector event "${nodeId}": \`filter.${k}\`: ${problem}`);
         return `(${k} == ${jmesString(String(v))})`;
     });
     const conditions = (filters ?? []).map((leaf, i) => {
-        const { read } = readEventFilter(leaf);
-        if (!read) {
-            throw new Error(`connector event "${nodeId}": filters[${i}] must carry a field and exactly ONE operator ` +
-                `(contains, startsWith, endsWith, equals, notEquals, lessThan, lessThanOrEqual, greaterThan, ` +
-                `greaterThanOrEqual) — got ${JSON.stringify(leaf)}.`);
+        // The code `check` gives the same leaf (`core/event-checks.ts`).
+        const judged = readEventFilterLeaf(leaf);
+        if (judged.code !== undefined) {
+            throw new CompileRefusal(judged.code, judged.problem !== undefined
+                ? `connector event "${nodeId}": filters[${i}] on \`${judged.read?.field}\`: ${judged.problem}`
+                : `connector event "${nodeId}": filters[${i}] must carry a field and exactly ONE operator ` +
+                    `(contains, startsWith, endsWith, equals, notEquals, lessThan, lessThanOrEqual, greaterThan, ` +
+                    `greaterThanOrEqual) — got ${JSON.stringify(leaf)}.`);
         }
-        const problem = eventFilterProblem(read);
-        if (problem)
-            throw new Error(`connector event "${nodeId}": filters[${i}] on \`${read.field}\`: ${problem}`);
-        return `(${eventFilterJmes(read)})`;
+        return `(${eventFilterJmes(judged.read)})`;
     });
     const expression = [...scopeClauses, ...conditions].join(' && ');
     const body = {};
@@ -176,7 +177,7 @@ export function eventFilterBody(nodeId, scope, filters) {
  */
 export function createExternalTask(ctx, n) {
     if (!ctx.library)
-        throw new Error(`external ${n.family} "${n.id}" needs the connector library — pass { library } to serialize ` +
+        throw new CompileRefusal('LIBRARY_REQUIRED', `external ${n.family} "${n.id}" needs the connector library — pass { library } to serialize ` +
             `or use uip maestro bpmn compile --library.`);
     const rc = ctx.library.resolve(n.key, n.action, n.version);
     const op = (rc.entry.operation ?? {});
@@ -186,14 +187,14 @@ export function createExternalTask(ctx, n) {
     // validator accepts and the runtime dispatches to the wrong handler family —
     // the Case SDK records the same trap in its Phase 4.4 notes.
     if (op.subType !== wanted) {
-        throw new Error(`external ${n.family} "${n.id}" needs ${wanted === 'AgentExecution' ? 'an' : 'a'} ${wanted} descriptor, but ` +
+        throw new CompileRefusal('EXTERNAL_TASK_DESCRIPTOR_CONTRACT', `external ${n.family} "${n.id}" needs ${wanted === 'AgentExecution' ? 'an' : 'a'} ${wanted} descriptor, but ` +
             `${n.key}/${n.action} is "${String(op.subType ?? 'untyped')}". ` +
             `The shipped library has very few of these — ${wanted === 'AgentExecution' ? '2' : '1'} operation(s).`);
     }
     const conn = connectorBindingRef(ctx, n.connection, 'Connection', 'ConnectionId', `${rc.connectorKey} connection`);
     const folder = connectorBindingRef(ctx, n.folder, 'Connection', 'folderKey', 'FolderKey', conn?.resourceKey);
     if (!conn || !folder) {
-        throw new Error(`external ${n.family} "${n.id}" needs both a connection and a folder binding name.`);
+        throw new CompileRefusal(conn ? 'EXTERNAL_TASK_FOLDER' : 'EXTERNAL_TASK_CONNECTION', `external ${n.family} "${n.id}" needs both a connection and a folder binding name.`);
     }
     return createTypedNode(ctx.m, n.id, EXTERNAL_SERVICE_TYPE[n.family][n.mode], {
         name: n.name ?? rc.entry.display?.label ?? n.action,

package/dist/bpmn/load.js

@@ -3,22 +3,23 @@ import { pathToFileURL } from 'node:url';
 import { resolve } from 'node:path';
 import { existsSync } from 'node:fs';
 import { useThisSdkForAuthoredSource } from '../sdk-resolve.js';
+import { CompileRefusal } from '../core/compile-refusal.js';
 /** Resolve a user argument (a `.ts` path or a BaseName) to a bpmn source file. */
 export function resolveBpmnFile(arg) {
     const candidates = [arg, `${arg}.bpmn.ts`, `${arg}.ts`];
     for (const c of candidates)
         if (existsSync(resolve(c)))
             return resolve(c);
-    throw new Error(`bpmn source not found: tried ${candidates.join(', ')}`);
+    throw new CompileRefusal('BPMN_SOURCE_NOT_FOUND', `bpmn source not found: tried ${candidates.join(', ')}`);
 }
 export async function loadBuiltBpmn(file) {
     useThisSdkForAuthoredSource();
     const mod = await import(pathToFileURL(file).href);
     const exp = mod.default ?? mod.bpmn;
     if (!exp)
-        throw new Error(`${file} has no default export. Add: export default bpmn('id')...build();`);
+        throw new CompileRefusal('BPMN_NO_DEFAULT_EXPORT', `${file} has no default export. Add: export default bpmn('id')...build();`);
     const built = typeof exp.build === 'function' ? exp.build() : exp;
     if (!built || !Array.isArray(built.nodes))
-        throw new Error(`${file} default export is not a built bpmn. Did you call .build()?`);
+        throw new CompileRefusal('BPMN_EXPORT_NOT_BUILT', `${file} default export is not a built bpmn. Did you call .build()?`);
     return built;
 }