@uipath/maestro-builder-sdk 6.32.4 → 6.32.6

package/dist/case/case-sdk.d.ts

@@ -204,6 +204,8 @@ export interface BuiltTrigger {
     eventOutputs?: TaskOutputBinding[];
     /** Event only: a library-resolved Integration Service subscription. */
     eventSubscription?: EventSubscription;
+    /** Event placeholder only: the source object the event watches (see {@link EventTriggerOpts.object}). */
+    eventObject?: string;
 }
 export interface ManualTriggerOpts {
     name?: string;
@@ -241,10 +243,25 @@ export interface EventTriggerOpts {
     description?: string;
     /**
      * Stringly resolved subscription. Prefer the descriptor overload when a
-     * prepared connector module is available. Omit this for the legacy
-     * `serviceType`-only placeholder.
+     * prepared connector module is available. Omit this for a **placeholder**
+     * trigger, whose bag carries `serviceType` (plus `context[objectName]` when
+     * `object` is set).
      */
     subscription?: EventSubscription;
+    /**
+     * The source OBJECT the event watches — a Data Fabric entity, a Salesforce or
+     * ServiceNow object, a database table — for a **placeholder** trigger whose
+     * connector and connection are not resolved yet. It is emitted as the
+     * trigger's `context[objectName]` row, the same row `uip maestro case sdd
+     * convert` writes for an SDD's `| T02 | Intsvc.EventTrigger | <object> | … |`
+     * Case Triggers row, so the requested source survives in the plan as data,
+     * not only in a label. For example
+     * `eventTrigger({ name: 'Invoice created', object: 'aged_invoice_cases' })`.
+     *
+     * A resolved subscription names its object in `subscription.object` instead;
+     * passing both is refused.
+     */
+    object?: string;
     /**
      * Optional event-payload extractions. Each key is a case-variable name read
      * downstream as `=vars.<name>`; each value is the payload field expression
@@ -253,7 +270,8 @@ export interface EventTriggerOpts {
      *
      * @remarks
      * With **no** outputs the event trigger is a **placeholder** (`data.inputs`
-     * carries only `serviceType`) — the offline shape for an event on a connector
+     * carries `serviceType`, plus `context[objectName]` when `object` is set) —
+     * the offline shape for an event on a connector
      * not yet registered; attach the real connection after registering it.
      */
     outputs?: Record<string, string | {

package/dist/case/case-sdk.js

@@ -112,11 +112,21 @@ export function eventTrigger(descriptorOrOpts = {}, descriptorOpts = {}) {
         const type = (typeof v === 'string' ? 'string' : (v.type ?? 'string'));
         eventOutputs.push({ var: name, source, type });
     }
+    const object = descriptor ? undefined : opts.object;
+    if (object !== undefined) {
+        if (opts.subscription)
+            throw new Error('eventTrigger: pass the watched object as `subscription.object` on a resolved subscription, not as `object`.');
+        // Refuse padding rather than trim it: the value must match the SDD's
+        // source object exactly, and a silent trim would hide the typo.
+        if (typeof object !== 'string' || !object.trim() || object !== object.trim())
+            throw new Error('eventTrigger: `object` must be a non-empty string with no surrounding whitespace.');
+    }
     return {
         kind: 'event',
         name: opts.name,
         description: opts.description,
         eventOutputs: eventOutputs.length ? eventOutputs : undefined,
+        eventObject: object,
         eventSubscription: descriptor
             ? subscriptionFrom(descriptor, descriptorOpts)
             : opts.subscription,

package/dist/case/decompile.js

@@ -814,7 +814,9 @@ function triggerSource(node, index, plan, refs) {
     }
     if (bag.serviceType === 'Intsvc.EventTrigger') {
         const bridges = bridgeRows(plan, node.id ?? '', bag);
-        const resolved = bag.context !== undefined || bag.inputs !== undefined || bag.bindings !== undefined;
+        const object = placeholderEventObject(bag);
+        const resolved = object === undefined
+            && (bag.context !== undefined || bag.inputs !== undefined || bag.bindings !== undefined);
         const outputs = (bag.outputs ?? []).filter((row) => !bridges.has(row) && !isResolvedConnectorOutput(row, node.id ?? '', resolved));
         const subscription = resolved
             ? resolvedSubscriptionSource(bag, `event trigger "${label ?? node.id ?? index}"`, 'trigger', refs)
@@ -832,11 +834,28 @@ function triggerSource(node, index, plan, refs) {
             ['name', name],
             ['description', description ? tsLiteral(description) : undefined],
             ['subscription', subscription],
+            ['object', object !== undefined ? tsLiteral(object) : undefined],
             ['outputs', outputShape],
         ])})`;
     }
     throw new Error(`trigger "${label ?? node.id ?? index}" has unsupported serviceType "${bag.serviceType}".`);
 }
+/**
+ * The source object of an unresolved event trigger, when its bag is the
+ * placeholder plus one `context[objectName]` row — the shape `eventTrigger({
+ * object })` compiles to and `uip maestro case sdd convert` writes. Anything
+ * richer (connector key, inputs, bindings) is a resolved subscription.
+ */
+function placeholderEventObject(bag) {
+    const context = bag.context;
+    if (!Array.isArray(context) || context.length !== 1)
+        return undefined;
+    const row = context[0];
+    if (row?.name !== 'objectName' || typeof row.value !== 'string' || !row.value.trim())
+        return undefined;
+    const empty = (value) => value === undefined || (Array.isArray(value) && value.length === 0);
+    return empty(bag.inputs) && empty(bag.bindings) ? row.value : undefined;
+}
 function caseAppSource(config) {
     if (typeof config.caseSummary !== 'string')
         throw new Error('caseAppConfig.caseSummary must be a string.');

package/dist/case/serialize.js

@@ -700,7 +700,12 @@ function emitTriggers(triggers, ids, resolver) {
             // machinery as connector tasks and wait-for-connector bags.
             const bag = t.eventSubscription
                 ? resolvedSubscriptionBag('trigger', t.eventSubscription, resolver, triggerId, `Event trigger "${label}"`)
-                : { serviceType: CASE_FORMAT_PROFILE.eventServiceType };
+                : {
+                    serviceType: CASE_FORMAT_PROFILE.eventServiceType,
+                    // A placeholder that names its source object carries it the way
+                    // `case sdd convert` does: one `context[objectName]` row.
+                    ...(t.eventObject ? { context: [io('objectName', 'string', { value: t.eventObject })] } : {}),
+                };
             if (t.eventOutputs?.length) {
                 const outputs = t.eventOutputs.map((o) => {
                     const field = o.source.replace(/^=/, '').split('.').pop() || o.source;

package/dist/core/form-field-type.d.ts

@@ -80,8 +80,9 @@ export declare function canonicalFormFieldType(type: unknown): CanonicalFormFiel
 /**
  * The spelling decompile writes into source for a wire field type: a canonical
  * type or an SDK alias stays as written, so a canvas form (`"integer"`,
- * `"date"`) and a classic-CLI form (`"text"`) both compile back to the bytes
- * they came from; a product alias the SDK does not accept in source
+ * `"date"`) compiles back to the bytes it came from and a classic-CLI form's
+ * `"text"` stays a type `check` accepts (compile writes it as `"string"`);
+ * a product alias the SDK does not accept in source
  * (`"System.Int32"`, `"string[]"`) becomes its canonical type; anything else
  * stays verbatim for `check` to report.
  *
@@ -158,3 +159,17 @@ export declare function formFieldOptionsProblem(type: unknown, options: unknown)
  * that starts "… the field "<id>" …".
  */
 export declare function formFieldOptionsWhy(problem: 'malformed' | 'missing' | 'ignored', type: unknown): string;
+/**
+ * The spelling a form field's type is written in on the wire: the product's
+ * canonical one for the SDK's legacy spellings (`text` is written `string`,
+ * `date-time` is written `datetime`). `@uipath/hitl-schema-types` resolves
+ * those two only as legacy aliases, and the designer saves the canonical value,
+ * so an SDK-authored form says what a canvas-built one says (#1185). Every
+ * other type passes through unchanged.
+ *
+ * @example
+ * wireFormFieldType('text')      // 'string'
+ * wireFormFieldType('date-time') // 'datetime'
+ * wireFormFieldType('number')    // 'number'
+ */
+export declare function wireFormFieldType(type: unknown): unknown;

package/dist/core/form-field-type.js

@@ -22,9 +22,10 @@ const CANONICAL_JSON_SCHEMA = {
 /** The product's 11 canonical quick-form field types, in its own order. */
 export const CANONICAL_FORM_FIELD_TYPES = Object.keys(CANONICAL_JSON_SCHEMA);
 /**
- * The SDK's own legacy spellings, accepted in source: `text` (what the SDK,
- * flow-v1's serializer and `uip maestro flow hitl add` have always written) and
- * `date-time`. The product resolves both.
+ * The SDK's own legacy spellings, accepted in source: `text` (what flow-v1's
+ * serializer and `uip maestro flow hitl add` write) and `date-time`. The
+ * product resolves both. The SDK writes their canonical value on the wire
+ * (`wireFormFieldType`).
  */
 const SDK_ALIASES = {
     text: 'string',
@@ -172,8 +173,9 @@ export function canonicalFormFieldType(type) {
 /**
  * The spelling decompile writes into source for a wire field type: a canonical
  * type or an SDK alias stays as written, so a canvas form (`"integer"`,
- * `"date"`) and a classic-CLI form (`"text"`) both compile back to the bytes
- * they came from; a product alias the SDK does not accept in source
+ * `"date"`) compiles back to the bytes it came from and a classic-CLI form's
+ * `"text"` stays a type `check` accepts (compile writes it as `"string"`);
+ * a product alias the SDK does not accept in source
  * (`"System.Int32"`, `"string[]"`) becomes its canonical type; anything else
  * stays verbatim for `check` to report.
  *
@@ -299,3 +301,21 @@ export function formFieldOptionsWhy(problem, type) {
                 + `plain input and never shows them. Use 'singleSelect' or 'enum' (a dropdown) or 'multiSelect'`;
     }
 }
+/**
+ * The spelling a form field's type is written in on the wire: the product's
+ * canonical one for the SDK's legacy spellings (`text` is written `string`,
+ * `date-time` is written `datetime`). `@uipath/hitl-schema-types` resolves
+ * those two only as legacy aliases, and the designer saves the canonical value,
+ * so an SDK-authored form says what a canvas-built one says (#1185). Every
+ * other type passes through unchanged.
+ *
+ * @example
+ * wireFormFieldType('text')      // 'string'
+ * wireFormFieldType('date-time') // 'datetime'
+ * wireFormFieldType('number')    // 'number'
+ */
+export function wireFormFieldType(type) {
+    return typeof type === 'string' && Object.hasOwn(SDK_ALIASES, type)
+        ? SDK_ALIASES[type]
+        : type;
+}

package/dist/nodes/hitl/flow/node-type.js

@@ -13,7 +13,7 @@
  * every edge out of an outcome-handle node to.
  */
 import { Expr, toExpr } from '../../../core/expr.js';
-import { formFieldJsonSchema, formFieldOptionsWire, liftFormFieldOptions, sourceFormFieldType } from '../../../core/form-field-type.js';
+import { formFieldJsonSchema, formFieldOptionsWire, liftFormFieldOptions, sourceFormFieldType, wireFormFieldType } from '../../../core/form-field-type.js';
 import { isAnswerField } from '../../../core/hitl-answers.js';
 import { OUTCOME_HANDLE_NODE_TYPES, hitlExitModel, outcomeIdOf, outcomeSlug } from '../../../core/hitl-routing.js';
 import { jsonClone } from '../../../core/json-clone.js';
@@ -61,7 +61,7 @@ function hitlInputs(inputs, nodeType, ctx) {
         const base = {
             id: f.id,
             label: f.label ?? f.id,
-            type: f.type,
+            type: wireFormFieldType(f.type),
             direction: f.direction,
         };
         if (f.direction === 'input') {

package/dist/serialize.js

@@ -20,7 +20,7 @@ import { FLOW_NODE_TYPES } from './flow-node-registry.js';
 import { stepExits } from './flow-step-exits.js';
 import { resolveVersionCarried } from './core/nodes/versioned.js';
 import { indexCarriedDefinitions } from './core/carried-definitions.js';
-import { formFieldJsonSchema, formFieldOptionsWire } from './core/form-field-type.js';
+import { formFieldJsonSchema, formFieldOptionsWire, wireFormFieldType } from './core/form-field-type.js';
 import { ConnectorResolveError } from './core/connector-resolve-error.js';
 import { connectionConnectors } from './bindings-v2.js';
 import { BindingRefusal, GUID_RE, bindingLabelRefusal, bindingMissingMessage, missingBindingLabels } from './core/binding-messages.js';
@@ -5720,7 +5720,7 @@ export function serialize(built, opts = {}) {
                         return {
                             id: f.id,
                             label: f.label ?? f.id,
-                            type: f.type,
+                            type: wireFormFieldType(f.type),
                             direction: f.direction,
                             // A picker's choices, as the human task's rows carry them (#1235).
                             ...(options !== undefined ? { options } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.32.4",
+  "version": "6.32.6",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -93,5 +93,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "9a7e5f98ca054b05f74ac655b8725bf4e3b50e89"
+  "gitref": "0b27856ab8b25ffc834013f559a14946f61cb89a"
 }