@uipath/maestro-builder-sdk 6.18.6 → 6.18.7

package/dist/case/check.d.ts

@@ -10,6 +10,7 @@
 import type { BuiltCase } from './case-sdk.js';
 import { type ConnectorCheckOpts } from '../core/connector-checks.js';
 import type { EventSubscription } from '../core/actions.js';
+import { type EventCheckOpts } from '../core/event-checks.js';
 export interface Diagnostic {
     level: 'error' | 'warning';
     code: string;
@@ -26,13 +27,13 @@ export interface Diagnostic {
  * the event, and validates a connector task's inputs and resolves its lookups
  * through the shared `buildConnectorInputs` (`connectorInputs`, `lookups`,
  * `resolutions`), and refuses a connection/folder label bindings.json cannot
- * turn into a resource key (`bindings`, `bindingLabelRefusal`). It does not
- * check BYOA, so that hook stays off until Case compile enforces it.
+ * turn into a resource key (`bindings`, `bindingLabelRefusal`), and refuses an
+ * event on an unverified BYOA connection (`eventFacts`, `byoa`).
  *
  * Every hook fails open: without a library, `check` stays a pure function of the
  * built model.
  */
-export type CaseCheckOpts = Pick<ConnectorCheckOpts, 'connectorResolveError' | 'connectorInputs' | 'lookups' | 'resolutions' | 'schemaReadiness' | 'bindings'> & {
+export type CaseCheckOpts = Pick<ConnectorCheckOpts, 'connectorResolveError' | 'connectorInputs' | 'lookups' | 'resolutions' | 'schemaReadiness' | 'bindings'> & Pick<EventCheckOpts, 'eventFacts' | 'byoa'> & {
     /**
      * What Case `compile` would refuse an event subscription with, or `undefined`
      * when it resolves: `EVENT_UNKNOWN` (the event is not in the library, or

package/dist/case/check.js

@@ -298,10 +298,17 @@ 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.
         checkBindingLabels(where, sub, opts, (code, message) => diags.push({ level: 'error', code, message, where: at }), { key: sub.connector, action: sub.event });
-        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 }));
+        // From the shared event rules, the two Case compile enforces: a `where` lookup
+        // nobody recorded (LOOKUP_UNRESOLVED, a warning) and an unverified BYOA
+        // connection (EVENT_BYOA_UNVERIFIED). Only their hooks are passed, so nothing
+        // else in them fires.
+        checkEventResolution(sub, where, kind, {
+            resolutions: opts.resolutions ?? {},
+            ...(opts.eventFacts ? { eventFacts: opts.eventFacts } : {}),
+            ...(opts.byoa ? { byoa: opts.byoa } : {}),
+            ...(opts.bindings ? { bindings: opts.bindings } : {}),
+        }, (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/cli-library.d.ts

@@ -9,9 +9,8 @@ import type { CaseCheckOpts } from './check.js';
  * compile's own call), a connector task's field contract and lookups (the
  * `=`-expression validator Case compile runs), and the schema-readiness warnings.
  * With `bindings`, the binding-label rules (BINDING_SELF_NAME, BINDING_UNDECLARED),
- * which Case `serialize` enforces through the same `bindingLabelRefusal`. The
- * BYOA hooks of the shared bag are left out, because Case `serialize` does not
- * enforce them.
+ * which Case `serialize` enforces through the same `bindingLabelRefusal`, and the
+ * BYOA facts and ledger, for the refusal `resolveCaseSubscription` makes.
  *
  * @param library - The library `openCliLibrary` returned, or `undefined`.
  * @param bindings - The project's bindings.json, as compile reads it.

package/dist/case/cli-library.js

@@ -18,9 +18,8 @@ import { EVENT_GENERIC_NO_OBJECT, GenericEventNoObjectError, resolveCaseSubscrip
  * compile's own call), a connector task's field contract and lookups (the
  * `=`-expression validator Case compile runs), and the schema-readiness warnings.
  * With `bindings`, the binding-label rules (BINDING_SELF_NAME, BINDING_UNDECLARED),
- * which Case `serialize` enforces through the same `bindingLabelRefusal`. The
- * BYOA hooks of the shared bag are left out, because Case `serialize` does not
- * enforce them.
+ * which Case `serialize` enforces through the same `bindingLabelRefusal`, and the
+ * BYOA facts and ledger, for the refusal `resolveCaseSubscription` makes.
  *
  * @param library - The library `openCliLibrary` returned, or `undefined`.
  * @param bindings - The project's bindings.json, as compile reads it.
@@ -36,6 +35,8 @@ export function caseCheckOpts(library, bindings) {
         connectorInputs: shared.connectorInputs,
         lookups: shared.lookups,
         resolutions: shared.resolutions,
+        eventFacts: shared.eventFacts,
+        byoa: shared.byoa,
         schemaReadiness: shared.schemaReadiness,
         externalDescriptorError: (kind, d) => {
             let rc;

package/dist/case/serialize.js

@@ -890,7 +890,7 @@ function resolvedSubscriptionBag(kind, spec, resolver, elementId, where) {
     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 = resolveCaseSubscription(resolver.library, kind, spec);
+    const rc = resolveCaseSubscription(resolver.library, kind, spec, { where, bindings: resolver.bindings });
     const op = rc.entry.operation ?? {};
     const context = [io('connectorKey', 'string', { value: rc.connectorKey })];
     const target = { key: spec.connector, action: spec.event };

package/dist/case/subscription.d.ts

@@ -10,6 +10,7 @@
  */
 import type { EventSubscription } from '../core/actions.js';
 import type { Library, ResolvedConnector } from '../core/library.js';
+import type { BindingsView } from '../core/binding-messages.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. */
@@ -24,7 +25,13 @@ export declare class GenericEventNoObjectError extends Error {
  * @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.
+ * @param byoa - Where the subscription is and the bindings, to refuse an
+ *   unverified BYOA connection; compile passes it, `check` does not (it reports
+ *   that rule from the shared event rules).
  * @returns The resolved event.
- * @throws What `resolveEvent` throws, or {@link GenericEventNoObjectError}.
+ * @throws What `resolveEvent` throws, {@link GenericEventNoObjectError}, or a `ByoaRefusal`.
  */
-export declare function resolveCaseSubscription(library: Library, kind: 'trigger' | 'event', sub: EventSubscription): ResolvedConnector;
+export declare function resolveCaseSubscription(library: Library, kind: 'trigger' | 'event', sub: EventSubscription, byoa?: {
+    where: string;
+    bindings?: BindingsView;
+}): ResolvedConnector;

package/dist/case/subscription.js

@@ -1,4 +1,5 @@
 import { genericEventObjectRefusal } from '../core/event-checks.js';
+import { ByoaRefusal, byoaUnverified } from '../core/byoa.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. */
@@ -17,13 +18,25 @@ function caseObjectOption(object) {
  * @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.
+ * @param byoa - Where the subscription is and the bindings, to refuse an
+ *   unverified BYOA connection; compile passes it, `check` does not (it reports
+ *   that rule from the shared event rules).
  * @returns The resolved event.
- * @throws What `resolveEvent` throws, or {@link GenericEventNoObjectError}.
+ * @throws What `resolveEvent` throws, {@link GenericEventNoObjectError}, or a `ByoaRefusal`.
  */
-export function resolveCaseSubscription(library, kind, sub) {
+export function resolveCaseSubscription(library, kind, sub, byoa) {
     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);
+    // A BYOA-only event on a connection `prepare` never checked deploys and never
+    // fires (#848). Flow's `refuseUnverifiedByoa` rule and text (`byoaUnverified`);
+    // Case `check` reports it from the shared event rules (`eventFacts` / `byoa`).
+    if (byoa && typeof library.eventFacts === 'function') {
+        const object = typeof sub.object === 'string' && sub.object !== '' ? sub.object : undefined;
+        const message = byoaUnverified(byoa.where, { connector: sub.connector, event: sub.event, ...(object ? { object } : {}), connection: sub.connection }, library.eventFacts(sub.connector, sub.event, object), library.byoaVerifications, byoa.bindings);
+        if (message)
+            throw new ByoaRefusal(message);
+    }
     return rc;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.18.6",
+  "version": "6.18.7",
   "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": "27768f00ecc6986a54deba3c8f327d01ace642f8"
+  "gitref": "7dffe3f9de6568ee2673c38faa5046eb7c86eb54"
 }