@uipath/maestro-builder-sdk 6.41.2 → 6.43.0

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

@@ -0,0 +1,26 @@
+/**
+ * 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. `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 file's text, or `undefined` when there is none. */
+export type ReadText = (path: string) => string | undefined;
+export declare function readTextFromDisk(path: string): string | undefined;
+/** `dir/rel`. Index paths are relative and `/`-separated. */
+export declare function libraryPath(dir: string, rel: string): string;
+/** The parsed file. A missing one throws an error that names the path. */
+export declare function readJson(read: ReadText, path: string): unknown;
+/** One reader's cache. Two readers can serve different files at the same path. */
+export declare function cacheFor<T>(caches: WeakMap<ReadText, Map<string, T>>, read: ReadText): Map<string, T>;

package/dist/core/read-text.js

@@ -0,0 +1,43 @@
+/**
+ * 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. `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`.
+ */
+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`);
+    }
+    const fs = getBuiltinModule('node:fs');
+    return fs.existsSync(path) ? fs.readFileSync(path, 'utf8') : undefined;
+}
+/** `dir/rel`. Index paths are relative and `/`-separated. */
+export function libraryPath(dir, rel) {
+    return dir.endsWith('/') ? `${dir}${rel}` : `${dir}/${rel}`;
+}
+/** The parsed file. A missing one throws an error that names the path. */
+export function readJson(read, path) {
+    const text = read(path);
+    if (text === undefined)
+        throw new Error(`no such file: ${path}`);
+    return JSON.parse(text);
+}
+/** One reader's cache. Two readers can serve different files at the same path. */
+export function cacheFor(caches, read) {
+    let cache = caches.get(read);
+    if (cache === undefined)
+        caches.set(read, (cache = new Map()));
+    return cache;
+}

package/dist/core/ts-literal.d.ts

@@ -20,3 +20,9 @@ export declare function tsLiteral(value: unknown): string;
 export declare function tsText(value: unknown): string;
 /** `value` as a TS number literal: `Number(value)`, refused unless finite — a caseplan or `.flow` number is untrusted text until checked. */
 export declare function tsNumber(value: unknown): string;
+/** An object key as source: a bare identifier when legal, otherwise a quoted string. */
+export declare function tsKey(k: string): string;
+/** An options object `{ k: <src>, … }` from the entries present; '' when none is. */
+export declare function tsOptions(entries: ReadonlyArray<readonly [string, string | undefined]>): string;
+/** An object literal `{ k: <src>, … }` from pre-rendered value sources; '' when empty. */
+export declare function tsObject(entries: ReadonlyArray<readonly [string, string]>): string;

package/dist/core/ts-literal.js

@@ -35,3 +35,18 @@ export function tsNumber(value) {
         throw new Error(`decompile: expected a number, got ${JSON.stringify(value)}.`);
     return String(n);
 }
+/** An object key as source: a bare identifier when legal, otherwise a quoted string. */
+export function tsKey(k) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(k) ? k : tsLiteral(k);
+}
+/** An options object `{ k: <src>, … }` from the entries present; '' when none is. */
+export function tsOptions(entries) {
+    const parts = entries.filter(([, v]) => v !== undefined).map(([k, v]) => `${tsKey(k)}: ${v}`);
+    return parts.length ? `{ ${parts.join(', ')} }` : '';
+}
+/** An object literal `{ k: <src>, … }` from pre-rendered value sources; '' when empty. */
+export function tsObject(entries) {
+    if (entries.length === 0)
+        return '';
+    return `{ ${entries.map(([k, v]) => `${tsKey(k)}: ${v}`).join(', ')} }`;
+}

package/dist/core/typed-raw-node.js

@@ -29,11 +29,6 @@ export const TYPED_FACTORIES = {
     'core.logic.switch': { factory: '.switch()' },
     'core.logic.terminate': { factory: '.terminate()' },
     'core.subflow': { factory: 'subflow(child, inputs)' },
-    'uipath.agent.autonomous': { factory: 'inlineAgent()' },
-    'uipath.agent.conversational': { factory: 'conversationalAgent()' },
-    'uipath.agent.voice': { factory: 'voiceAgent()' },
-    'uipath.conversational.voice.create-outgoing-call': { factory: 'createOutgoingCall()' },
-    'uipath.conversational.voice.end-call': { factory: 'endCall()' },
 };
 /**
  * A reminder, as a `warning`, that a `rawNode` stands in for a typed factory,