@uipath/maestro-builder-sdk 6.56.0 → 6.58.0

package/dist/core/library.js

@@ -14,6 +14,7 @@ import { lookupSpecOf } from './lookups.js';
 import { loadByoaLedger, loadInvariantCollections, loadLookupResolutions } from './lookup-store.js';
 import { ownEntry } from './own-entry.js';
 import { ConnectorResolveError } from './connector-resolve-error.js';
+import { CompileRefusal } from './compile-refusal.js';
 export { ConnectorResolveError } from './connector-resolve-error.js';
 export class Library {
     layers = [];
@@ -59,7 +60,7 @@ export class Library {
         const idx = libraryPath(dir, 'index.json');
         const entries = libraryEntries(read, idx);
         if (entries === undefined)
-            throw new Error(`connector library not found at ${idx}. `
+            throw new CompileRefusal('LIBRARY_NOT_FOUND', `connector library not found at ${idx}. `
                 + (read === readTextFromDisk
                     ? `Run \`${PULL_COMMAND}\`, or point --library / $FLOW_SDK_LIBRARY_JSON at a library-json dir.`
                     : 'The reader passed to Library has no such file.'));
@@ -292,7 +293,7 @@ export class Library {
                 };
             }
         }
-        throw new Error(`connector activity not found in library: ${wire.connectorKey} ${wire.httpMethod ?? '?'} ${wire.endpoint ?? '?'}`);
+        throw new CompileRefusal('CONNECTOR_NOT_IN_LIBRARY', `connector activity not found in library: ${wire.connectorKey} ${wire.httpMethod ?? '?'} ${wire.endpoint ?? '?'}`);
     }
     /**
      * Resolve a connector EVENT: the START trigger
@@ -393,7 +394,7 @@ export class Library {
                 };
             }
         }
-        throw new Error(`connector ${kind} event not found in library: ${wire.connectorKey} `
+        throw new CompileRefusal('EVENT_UNKNOWN', `connector ${kind} event not found in library: ${wire.connectorKey} `
             + `${wire.eventOperation ?? '?'} ${wire.objectName ?? '?'}`);
     }
     /**

package/dist/core/lookups.js

@@ -28,6 +28,7 @@
  * make the surface worse rather than more complete.
  */
 import { prepareCommand, resolveFlagArg } from './cli-spelling.js';
+import { CompileRefusal } from './compile-refusal.js';
 /** True when `v` is an unresolved {@link LookupToken}. */
 export function isLookupToken(v) {
     return (typeof v === 'object' && v !== null &&
@@ -100,7 +101,7 @@ function makeBuilder(nodeType, field, spec, generic) {
             // at `prepare` time. The alternative is spending the network call to be
             // told the field does not exist, which is the expensive way to learn it.
             if (spec && !spec.by.includes(name)) {
-                throw new Error(`lookup(${nodeType}, '${field}'): cannot search by "${name}". ` +
+                throw new CompileRefusal('LOOKUP_UNKNOWN_MATCH_KEY', `lookup(${nodeType}, '${field}'): cannot search by "${name}". ` +
                     `This collection is searchable by ${spec.by.map((b) => `"${b}"`).join(', ')}.`);
             }
             return token(name, value);
@@ -116,7 +117,7 @@ function makeBuilder(nodeType, field, spec, generic) {
         get(target, prop, receiver) {
             if (typeof prop === 'string' && !(prop in target) && ALIAS_SHAPE.test(prop)) {
                 return () => {
-                    throw new Error(missingAliasMessage(nodeType, field, prop, spec, generic));
+                    throw new CompileRefusal('LOOKUP_UNKNOWN_ALIAS', missingAliasMessage(nodeType, field, prop, spec, generic));
                 };
             }
             return Reflect.get(target, prop, receiver);
@@ -126,7 +127,7 @@ function makeBuilder(nodeType, field, spec, generic) {
 export function lookup(a, b, c) {
     if (typeof a === 'string') {
         if (typeof c !== 'string') {
-            throw new Error("lookup(key, action, field) needs all three arguments; " +
+            throw new CompileRefusal('LOOKUP_ARGS', "lookup(key, action, field) needs all three arguments; " +
                 "did you mean lookup(descriptor, field)?");
         }
         return makeBuilder(`uipath.connector.${a}.${b}`, c, undefined, { key: a, action: b });
@@ -148,7 +149,7 @@ export function lookup(a, b, c) {
         // Naming the fields that DO have one matters: the commonest cause of this
         // is a field whose `reference` is degenerate, where the right answer is a
         // plain string and not a different helper call.
-        throw new Error(`lookup(${bearing.nodeType}, '${b}'): no lookup is generated for that field. ` +
+        throw new CompileRefusal('LOOKUP_UNKNOWN_FIELD', `lookup(${bearing.nodeType}, '${b}'): no lookup is generated for that field. ` +
             (known.length
                 ? `Fields with a lookup: ${known.map((k) => `"${k}"`).join(', ')}.`
                 : 'This operation has no lookup fields — author the value as a plain string.'));
@@ -317,7 +318,7 @@ export function resolveEventWhere(where, resolutions, site) {
         }
         const resolved = resolvedEventValue(value, resolutions);
         if (resolved === undefined)
-            throw new Error(`${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
+            throw new CompileRefusal('LOOKUP_UNRESOLVED', `${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
         out[key] = resolved;
     }
     return out;

package/dist/core/nodes/registry.js

@@ -1,5 +1,6 @@
 import { asVersioned } from './versioned.js';
 import { ownEntry } from '../own-entry.js';
+import { CompileRefusal } from '../compile-refusal.js';
 /** Whether a prefix entry owns `typeName`: under its prefix, and accepted by its narrowing, if it has one. */
 function owns(p, typeName) {
     return typeName.startsWith(p.prefix) && (p.matches?.(typeName) ?? true);
@@ -44,11 +45,11 @@ export class NodeTypeRegistry {
         if (this.#extensions.includes(family))
             return;
         if (family.package === undefined) {
-            throw new Error(`cannot register node family "${family.id}": a family registered at run time must name its package (NodeFamily.package).`);
+            throw new CompileRefusal('NODE_FAMILY_REGISTRATION', `cannot register node family "${family.id}": a family registered at run time must name its package (NodeFamily.package).`);
         }
         const { index, problems } = this.#build([...this.#builtIn, ...this.#extensions, family]);
         if (problems.length > 0) {
-            throw new Error(`cannot register node family "${family.id}" from ${family.package.name}:\n`
+            throw new CompileRefusal('NODE_FAMILY_REGISTRATION', `cannot register node family "${family.id}" from ${family.package.name}:\n`
                 + problems.map((p) => `  - ${p}`).join('\n'));
         }
         this.#extensions = [...this.#extensions, family];

package/dist/core/nodes/versioned.js

@@ -1,4 +1,5 @@
 import { ownEntry } from '../own-entry.js';
+import { CompileRefusal } from '../compile-refusal.js';
 /** True for a {@link VersionedNodeType}; a plain {@link NodeType} carries `version` instead. */
 export function isVersioned(t) {
     return 'versions' in t;
@@ -44,7 +45,7 @@ export function resolveVersion(t, spec, requested, where) {
             throw new Error(`internal SDK error: ${t.typeName}'s select() chose ${version} for ${where}, but the type registers only `
                 + `${known}. This is a bug in the node type, not in the flow; please report it.`);
         }
-        throw new Error(`${where} requests ${t.typeName}@${version}, but this SDK registers only ${known}. `
+        throw new CompileRefusal('NODE_VERSION_UNREGISTERED', `${where} requests ${t.typeName}@${version}, but this SDK registers only ${known}. `
             + 'Versions are exact — omit { version } to use the default, or request one listed here.');
     }
     return impl;
@@ -88,7 +89,7 @@ export function resolveVersionCarried(t, spec, requested, where, carried) {
             ? '. Versions are exact — omit { version } to use the default, or request one listed here.'
             : '. Versions are exact — omit { version } to use the default, request one listed here, or carry '
                 + "that version's definition (the .flow file's definitions[] entry) with .definitions([...]).";
-        throw new Error(`${where} requests ${t.typeName}@${requested}, but this SDK registers only ${registered}`
+        throw new CompileRefusal('NODE_VERSION_UNREGISTERED', `${where} requests ${t.typeName}@${requested}, but this SDK registers only ${registered}`
             + (carriedVersions.length > 0 ? ` and the flow carries only ${carriedVersions.join(', ')}` : '')
             + remedy);
     }

package/dist/core/process-resource-sort-order.js

@@ -39,6 +39,6 @@ export const DYNAMIC_NODE_SORT_OFFSET = 500;
 export function resourceNodeSortOrder(category) {
     const base = ownEntry(PROCESS_RESOURCE_CATEGORY_SORT_ORDERS, category);
     if (base === undefined)
-        throw new Error(`no sortOrder for process-resource category '${category}'`);
+        throw new Error(`internal SDK error: no sortOrder for process-resource category '${category}'`);
     return base + DYNAMIC_NODE_SORT_OFFSET;
 }

package/dist/core/read-text.d.ts

@@ -1,31 +1,3 @@
-/**
- * core/read-text — how the connector library reads its files.
- *
- * `Library` and `loadLibrary` read every library and overlay file through a
- * `ReadText`, so a host without a disk can serve them: Studio Web keeps the library
- * zip in memory and answers each read from it. A read is synchronous because QuickJS
- * cannot wait on one while it compiles.
- *
- * `Library` keeps what a host reader returns for library files (the index and the
- * ledgers) for as long as the reader lives, because a library build does not change:
- * pass a new reader for a new build. Overlay files are read afresh each time, because
- * `prepare` rewrites them.
- *
- * The default reads the disk. A host without one, which runs the SDK's CLI and so
- * cannot pass a reader in, hands one over before the run:
- * `globalThis[Symbol.for('uipath.maestro-builder-sdk.readText')] = read`, with
- * `$FLOW_SDK_LIBRARY_JSON` naming the folder it serves. That reader then answers every
- * default read, library and overlay alike, and its index is kept like any host reader's.
- * The default overlay folder is still looked up on the host's `fs`; pass
- * `--connectors-local` for an overlay only the reader serves. `node:fs` comes from
- * `process.getBuiltinModule`, not an `import`, so the library loads no `node:` builtin
- * (FB015 exempts this fallback), and `process` is read through `globalThis`, as in
- * `core/typescript-module.ts`.
- *
- * The tenant calls (`registry prepare`'s `uip` runs) have a sibling slot,
- * `globalThis[Symbol.for('uipath.maestro-builder-sdk.uip')]`, documented on
- * `defaultUipClient` in `registry/uip/client.ts`.
- */
 /** The file's text, or `undefined` when there is none. */
 export type ReadText = (path: string) => string | undefined;
 /** The reader a default read uses: the host's, when one is in the slot, else the disk. */

package/dist/core/read-text.js

@@ -26,6 +26,7 @@
  * `globalThis[Symbol.for('uipath.maestro-builder-sdk.uip')]`, documented on
  * `defaultUipClient` in `registry/uip/client.ts`.
  */
+import { CompileRefusal } from './compile-refusal.js';
 const HOST_READ_TEXT = Symbol.for('uipath.maestro-builder-sdk.readText');
 /** The reader a default read uses: the host's, when one is in the slot, else the disk. */
 export function defaultReadText() {
@@ -34,7 +35,7 @@ export function defaultReadText() {
 export function readTextFromDisk(path) {
     const getBuiltinModule = globalThis.process?.getBuiltinModule;
     if (getBuiltinModule === undefined) {
-        throw new Error(`cannot read ${path}: outside Node, pass a readText function to the connector library`
+        throw new CompileRefusal('READ_TEXT_UNAVAILABLE', `cannot read ${path}: outside Node, pass a readText function to the connector library`
             + ` or set globalThis[Symbol.for('uipath.maestro-builder-sdk.readText')]`);
     }
     const fs = getBuiltinModule('node:fs');
@@ -48,7 +49,7 @@ export function libraryPath(dir, rel) {
 export function readJson(read, path) {
     const text = read(path);
     if (text === undefined)
-        throw new Error(`no such file: ${path}`);
+        throw new CompileRefusal('FILE_NOT_FOUND', `no such file: ${path}`);
     return JSON.parse(text);
 }
 /** One reader's cache. Two readers can serve different files at the same path. */