@uipath/maestro-builder-sdk 6.18.1 → 6.18.2

package/dist/case/check.d.ts

@@ -9,7 +9,7 @@
  */
 import type { BuiltCase } from './case-sdk.js';
 import { type ConnectorCheckOpts } from '../core/connector-checks.js';
-import type { EventCheckOpts } from '../core/event-checks.js';
+import type { EventSubscription } from '../core/actions.js';
 export interface Diagnostic {
     level: 'error' | 'warning';
     code: string;
@@ -31,7 +31,18 @@ export interface Diagnostic {
  * Every hook fails open: without a library, `check` stays a pure function of the
  * built model.
  */
-export type CaseCheckOpts = Pick<ConnectorCheckOpts, 'connectorResolveError' | 'schemaReadiness'> & Pick<EventCheckOpts, 'eventResolveError'>;
+export type CaseCheckOpts = Pick<ConnectorCheckOpts, 'connectorResolveError' | 'schemaReadiness'> & {
+    /**
+     * What Case `compile` would refuse an event subscription with, or `undefined`
+     * when it resolves: `EVENT_UNKNOWN` (the event is not in the library, or
+     * refuses the `object`) or `EVENT_GENERIC_NO_OBJECT` (a GENERIC event with no
+     * `object`). Built on `resolveCaseSubscription`, the call compile makes.
+     */
+    subscriptionError?: (kind: 'trigger' | 'event', subscription: EventSubscription) => {
+        code: string;
+        message: string;
+    } | undefined;
+};
 /**
  * Validate a built case.
  *

package/dist/case/check.js

@@ -271,7 +271,8 @@ export function check(built, opts = {}) {
  *   their operation (`library.resolve`): CONNECTOR_NOT_IN_LIBRARY,
  *   CONNECTOR_OBJECT_REQUIRED, CONNECTOR_OBJECT_NOT_GENERIC;
  * - an event trigger, a wait-for-connector task and a wait-for-connector rule
- *   resolve their subscription (`library.resolveEvent`): EVENT_UNKNOWN.
+ *   resolve their subscription (`resolveCaseSubscription`): EVENT_UNKNOWN,
+ *   EVENT_GENERIC_NO_OBJECT.
  *
  * A connector task also gets the schema-readiness warnings, because the
  * `connectors-local` overlay `registry prepare` writes is what Case compile
@@ -282,16 +283,11 @@ function checkLibraryConnectors(built, opts, diags) {
         diags.push({ level: d.level, code: d.code, message: d.message, where: at, ...(d.suggestion ? { suggestion: d.suggestion } : {}) });
     };
     const subscription = (kind, sub, where, at) => {
-        // Exactly the arguments `resolvedSubscriptionBag` passes to `resolveEvent`.
-        // It passes no `object` (a Case compile gap, tracked separately), so neither
-        // does this: check must refuse what compile refuses, no more.
-        const unresolved = opts.eventResolveError?.(kind, {
-            connector: sub.connector,
-            event: sub.event,
-            ...(sub.version !== undefined ? { version: sub.version } : {}),
-        });
-        if (unresolved !== undefined)
-            diags.push({ level: 'error', code: 'EVENT_UNKNOWN', message: `${where}: ${unresolved}`, where: at });
+        // The call `resolvedSubscriptionBag` makes (`resolveCaseSubscription`), so
+        // check refuses exactly what compile refuses, with the same text.
+        const refused = opts.subscriptionError?.(kind, sub);
+        if (refused !== undefined)
+            diags.push({ level: 'error', code: refused.code, message: `${where}: ${refused.message}`, where: at });
     };
     const rules = (conditions, where) => {
         for (const c of conditions)

package/dist/case/cli-library.d.ts

@@ -4,7 +4,8 @@ import type { CaseCheckOpts } from './check.js';
  * Case's check options from a library the CLI already opened, or `{}` without one.
  *
  * Only the hooks for refusals Case `compile` makes (see {@link CaseCheckOpts}):
- * the operation and event resolution, and the schema-readiness warnings. The
+ * the operation and event resolution (the event through `resolveCaseSubscription`,
+ * compile's own call), and the schema-readiness warnings. The
  * field-contract, binding-label and BYOA hooks of the shared bag are left out,
  * because Case `serialize` does not enforce them.
  *

package/dist/case/cli-library.js

@@ -8,11 +8,13 @@
  * both `case check` and `case compile`'s check pass call.
  */
 import { connectorCheckOpts } from '../core/cli-library.js';
+import { EVENT_GENERIC_NO_OBJECT, GenericEventNoObjectError, resolveCaseSubscription } from './subscription.js';
 /**
  * Case's check options from a library the CLI already opened, or `{}` without one.
  *
  * Only the hooks for refusals Case `compile` makes (see {@link CaseCheckOpts}):
- * the operation and event resolution, and the schema-readiness warnings. The
+ * the operation and event resolution (the event through `resolveCaseSubscription`,
+ * compile's own call), and the schema-readiness warnings. The
  * field-contract, binding-label and BYOA hooks of the shared bag are left out,
  * because Case `serialize` does not enforce them.
  *
@@ -26,6 +28,17 @@ export function caseCheckOpts(library) {
     return {
         connectorResolveError: shared.connectorResolveError,
         schemaReadiness: shared.schemaReadiness,
-        eventResolveError: shared.eventResolveError,
+        subscriptionError: (kind, sub) => {
+            try {
+                resolveCaseSubscription(library, kind, sub);
+                return undefined;
+            }
+            catch (error) {
+                return {
+                    code: error instanceof GenericEventNoObjectError ? EVENT_GENERIC_NO_OBJECT : 'EVENT_UNKNOWN',
+                    message: error instanceof Error ? error.message : String(error),
+                };
+            }
+        },
     };
 }

package/dist/case/decompile.js

@@ -190,6 +190,8 @@ function resolvedSubscriptionSource(bag, owner, kind, refs) {
     return opts([
         ['connector', tsLiteral(identity.key)],
         ['event', tsLiteral(identity.event)],
+        // A GENERIC event's object is the author's choice, so it comes back as `object`.
+        ['object', identity.object !== undefined ? tsLiteral(identity.object) : undefined],
         ['where', where !== undefined ? tsLiteral(where) : undefined],
         ['filters', filters !== undefined ? tsLiteral(filters) : undefined],
         ['connection', connection !== undefined ? tsLiteral(connection) : undefined],

package/dist/case/serialize.js

@@ -11,6 +11,7 @@
 import { IdGen } from './ids.js';
 import { transportHttpMethod } from '../core/connector-inputs.js';
 import { refuseLookupToken } 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';
 import { caseJsonPreservation, caseJsonPreservationErrors, } from './preserve.js';
@@ -885,7 +886,7 @@ function resolvedSubscriptionBag(kind, spec, resolver, elementId) {
     if (!resolver.library)
         throw new Error(`${kind === 'trigger' ? 'event trigger' : 'wait-for-connector'} needs the connector library — `
             + `pass { library } to serialize or use uip maestro case compile --library.`);
-    const rc = resolver.library.resolveEvent(kind, spec.connector, spec.event, spec.version);
+    const rc = resolveCaseSubscription(resolver.library, kind, spec);
     const op = rc.entry.operation ?? {};
     const context = [io('connectorKey', 'string', { value: rc.connectorKey })];
     const connection = bindingRef(resolver, spec.connection, 'Connection', 'ConnectionId', `${rc.connectorKey} connection`);

package/dist/case/subscription.d.ts

@@ -0,0 +1,30 @@
+/**
+ * case/subscription — how Case resolves a connector event subscription against
+ * the library, shared by `serialize` (which throws) and `check` (which reports).
+ *
+ * One function, so the two cannot drift: the event trigger, the
+ * wait-for-connector task and the wait-for-connector rule all resolve here, with
+ * the author's `object` (#1033), and a GENERIC event that names no object is
+ * refused here with the text Flow's compile uses too
+ * (`genericEventObjectRefusal`).
+ */
+import type { EventSubscription } from '../core/actions.js';
+import type { Library, ResolvedConnector } from '../core/library.js';
+/** Check's code for {@link GenericEventNoObjectError}; Flow and BPMN `check` use the same one. */
+export declare const EVENT_GENERIC_NO_OBJECT = "EVENT_GENERIC_NO_OBJECT";
+/** A GENERIC event subscription that names no object. */
+export declare class GenericEventNoObjectError extends Error {
+    readonly code = "EVENT_GENERIC_NO_OBJECT";
+}
+/**
+ * Resolve a Case event subscription: `library.resolveEvent` with the
+ * subscription's own `version` and `object`, then refuse a GENERIC event the
+ * author named no object for.
+ *
+ * @param library - The connector library.
+ * @param kind - `trigger` for an event trigger, `event` for a wait-for-connector task or rule.
+ * @param sub - The authored subscription.
+ * @returns The resolved event.
+ * @throws What `resolveEvent` throws, or {@link GenericEventNoObjectError}.
+ */
+export declare function resolveCaseSubscription(library: Library, kind: 'trigger' | 'event', sub: EventSubscription): ResolvedConnector;

package/dist/case/subscription.js

@@ -0,0 +1,29 @@
+import { genericEventObjectRefusal } from '../core/event-checks.js';
+/** Check's code for {@link GenericEventNoObjectError}; Flow and BPMN `check` use the same one. */
+export const EVENT_GENERIC_NO_OBJECT = 'EVENT_GENERIC_NO_OBJECT';
+/** A GENERIC event subscription that names no object. */
+export class GenericEventNoObjectError extends Error {
+    code = EVENT_GENERIC_NO_OBJECT;
+}
+/** How a Case subscription spells the `object` of a GENERIC event, for the refusal text. */
+function caseObjectOption(object) {
+    return `{ connector, event, object: '${object}', … } in the subscription`;
+}
+/**
+ * Resolve a Case event subscription: `library.resolveEvent` with the
+ * subscription's own `version` and `object`, then refuse a GENERIC event the
+ * author named no object for.
+ *
+ * @param library - The connector library.
+ * @param kind - `trigger` for an event trigger, `event` for a wait-for-connector task or rule.
+ * @param sub - The authored subscription.
+ * @returns The resolved event.
+ * @throws What `resolveEvent` throws, or {@link GenericEventNoObjectError}.
+ */
+export function resolveCaseSubscription(library, kind, sub) {
+    const rc = library.resolveEvent(kind, sub.connector, sub.event, sub.version, sub.object);
+    const noObject = genericEventObjectRefusal(rc, sub, caseObjectOption);
+    if (noObject)
+        throw new GenericEventNoObjectError(noObject);
+    return rc;
+}

package/dist/core/event-checks.d.ts

@@ -136,4 +136,35 @@ export declare function eventParamsFor(subscription: unknown, opts: EventCheckOp
  * under the event-form node type — the form `prepare` stores.
  */
 export declare function checkEventResolution(subscription: unknown, where: string, kind: 'trigger' | 'event', opts: EventCheckOpts, error: (code: string, message: string, suggestion?: string) => void, warn: (code: string, message: string, suggestion?: string) => void, eventParams?: EventParamFields): void;
+/**
+ * The compile-time refusal of a GENERIC event subscription that names no object,
+ * or `undefined` when the resolved event is fine.
+ *
+ * A GENERIC event (`activityType: GenericTrigger` — Data Fabric, Salesforce,
+ * ServiceNow, Jira, … `record-created`/`record-updated`) fires for ONE object of
+ * the connection, and its library entry names none: the author's `object` is the
+ * only source. `Library.resolveEvent` stamps that object into the resolved
+ * operation's `objectName`; without it the operation's `objectName` stays `''`,
+ * and a node built from it validates and is refused by the platform's dispatcher
+ * ("missing objectName"), or watches nothing.
+ *
+ * Every family's serializer that emits a connector event calls this on the
+ * connector `resolveEvent` returned, so the refusal has one text. Case `check`
+ * calls it on the same resolution, so it reports exactly what Case `compile`
+ * throws.
+ *
+ * @param rc - What `library.resolveEvent(kind, connector, event, version, object)` returned.
+ * @param sub - The authored subscription (only `where` is read, for the hint).
+ * @param objectOption - How this family spells the `object` option, given the object.
+ * @returns The refusal message (no site prefix), or `undefined`.
+ */
+export declare function genericEventObjectRefusal(rc: {
+    nodeType: string;
+    connectorKey: string;
+    entry?: {
+        operation?: Record<string, unknown>;
+    };
+}, sub: {
+    where?: unknown;
+}, objectOption: (object: string) => string): string | undefined;
 export declare function checkEventSubscription(subscription: unknown, where: string, at: (code: string, message: string, suggestion?: string) => void, warn?: (code: string, message: string, suggestion?: string) => void, eventParams?: EventParamFields): void;

package/dist/core/event-checks.js

@@ -204,6 +204,44 @@ export function checkEventResolution(subscription, where, kind, opts, error, war
         });
     }
 }
+/**
+ * The compile-time refusal of a GENERIC event subscription that names no object,
+ * or `undefined` when the resolved event is fine.
+ *
+ * A GENERIC event (`activityType: GenericTrigger` — Data Fabric, Salesforce,
+ * ServiceNow, Jira, … `record-created`/`record-updated`) fires for ONE object of
+ * the connection, and its library entry names none: the author's `object` is the
+ * only source. `Library.resolveEvent` stamps that object into the resolved
+ * operation's `objectName`; without it the operation's `objectName` stays `''`,
+ * and a node built from it validates and is refused by the platform's dispatcher
+ * ("missing objectName"), or watches nothing.
+ *
+ * Every family's serializer that emits a connector event calls this on the
+ * connector `resolveEvent` returned, so the refusal has one text. Case `check`
+ * calls it on the same resolution, so it reports exactly what Case `compile`
+ * throws.
+ *
+ * @param rc - What `library.resolveEvent(kind, connector, event, version, object)` returned.
+ * @param sub - The authored subscription (only `where` is read, for the hint).
+ * @param objectOption - How this family spells the `object` option, given the object.
+ * @returns The refusal message (no site prefix), or `undefined`.
+ */
+export function genericEventObjectRefusal(rc, sub, objectOption) {
+    const op = (rc.entry?.operation ?? {});
+    if (op.activityType !== 'GenericTrigger' || String(op.objectName ?? '') !== '')
+        return undefined;
+    const scopeObject = sub.where && typeof sub.where === 'object'
+        ? Object.entries(sub.where)
+            .find(([k]) => /^(objectName|entityName|object)$/i.test(k))?.[1]
+        : undefined;
+    return `${rc.nodeType} is a GENERIC event — it watches ONE object of the connection `
+        + `(an entity, a table, a custom object) and its library entry carries no default. Name it with the `
+        + `\`object\` option: ${objectOption(scopeObject !== undefined ? String(scopeObject) : '<Object>')}. `
+        + (scopeObject !== undefined
+            ? `\`where: { objectName }\` is not it — \`where\` holds event PARAMETERS, and this operation has none. `
+            : '')
+        + `\`uip is triggers objects ${rc.connectorKey} ${String(op.eventOperation ?? '<EVENT>')} --connection-id <id>\` lists the objects.`;
+}
 export function checkEventSubscription(subscription, where, at, warn, eventParams) {
     const sub = subscription;
     if (!sub || typeof sub !== 'object') {

package/dist/serialize.js

@@ -20,6 +20,7 @@ import { isAnswerField } from './core/hitl-answers.js';
 import { connectionConnectors } from './bindings-v2.js';
 import { BindingRefusal, GUID_RE, bindingMissingMessage, bindingSelfNameMessage, bindingUndeclaredMessage, missingBindingLabels, undeclaredBinding } from './core/binding-messages.js';
 import { ByoaRefusal, byoaUnverified } from './core/byoa.js';
+import { genericEventObjectRefusal } from './core/event-checks.js';
 import { OUTCOME_HANDLE_NODE_TYPES, assertHitlExitInvariant, hitlExitModel, hitlExitViolation, outcomeSlug } from './core/hitl-routing.js';
 import { declaredExits, hasExits } from './core/step-ports.js';
 import { stopsAtEnd } from './flow-step-tree.js';
@@ -4115,25 +4116,13 @@ function eventDetail(rc, sub, nodeId, opts, site) {
     const folder = resolveBinding(opts, sub.folder, 'folder', `event node "${nodeId}"`, eventTarget(sub));
     const op = (rc.entry?.operation ?? {});
     const filters = sub.filters ?? [];
-    // A GENERIC event (`activityType: GenericTrigger` — Data Fabric, Salesforce,
-    // ServiceNow, Jira, … `record-created`/`record-updated`) fires for ONE object of
-    // the connection, and the library entry names none: the author's `object` is
-    // the only source. Without it the node would carry `objectName: ""` — it
-    // validates, and the platform's dispatcher refuses it ("missing objectName") or
-    // the designer shows a trigger bound to nothing. Refused here, at the layer
-    // that would otherwise emit it.
+    // A GENERIC event with no `object` would carry `objectName: ""`: it validates
+    // and the platform's dispatcher refuses it. Refused here, at the layer that
+    // would otherwise emit it, with the text every family's compile shares.
     const objectName = String(op.objectName ?? '');
-    if (op.activityType === 'GenericTrigger' && objectName === '') {
-        const scopeObject = Object.entries(sub.where ?? {})
-            .find(([k]) => /^(objectName|entityName|object)$/i.test(k))?.[1];
-        throw new Error(`event node "${nodeId}": ${rc.nodeType} is a GENERIC event — it watches ONE object of the connection `
-            + `(an entity, a table, a custom object) and its library entry carries no default. Name it with the `
-            + `\`object\` option: onEvent(…, { object: '${scopeObject ?? '<Object>'}' }). `
-            + (scopeObject !== undefined
-                ? `\`where: { objectName }\` is not it — \`where\` holds event PARAMETERS, and this operation has none. `
-                : '')
-            + `\`uip is triggers objects ${rc.connectorKey} ${String(op.eventOperation ?? '<EVENT>')} --connection-id <id>\` lists the objects.`);
-    }
+    const noObject = genericEventObjectRefusal(rc, sub, (o) => `onEvent(…, { object: '${o}' })`);
+    if (noObject)
+        throw new Error(`event node "${nodeId}": ${noObject}`);
     // An unresolved `where` lookup is swapped for its recorded id — the id
     // `prepare --resolve` stored under the EVENT-form node type — or refused.
     // Same rule as connector inputs: emitting a placeholder for a value nobody

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.18.1",
+  "version": "6.18.2",
   "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": "6598e64a2bc931298fcb9938dc4868d5760243e6"
+  "gitref": "a1a9df938c60a4e31cc9025ec9664d34f41aa799"
 }