@uipath/maestro-builder-sdk 6.44.4 → 6.45.0

package/dist/core/cli-library.js

@@ -14,9 +14,9 @@
  * beside it (`eventResolveErrorFor`, `byoaCheckOpts`) stay in `../cli-library.ts`
  * until the BPMN check rung needs them too.
  */
-import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { ConnectorResolveError, Library } from './library.js';
+import { defaultReadText } from './read-text.js';
 import { resolveLibraryDir } from './library-cache.js';
 import { flagValue } from '../cli-run.js';
 import { defaultOverlayDir } from '../workdir.js';
@@ -32,7 +32,8 @@ import { connectorInputErrors } from './connector-inputs.js';
  */
 export function openCliLibrary(argv) {
     const libDir = resolveLibraryDir(flagValue(argv, '--library'));
-    if (!libDir || !existsSync(join(libDir, 'index.json')))
+    // Through the reader, not `existsSync`: a host's reader serves a library that is on no disk.
+    if (!libDir || defaultReadText()(join(libDir, 'index.json')) === undefined)
         return undefined;
     const overlayDir = flagValue(argv, '--connectors-local') ?? defaultOverlayDir();
     return new Library(libDir, { overlayDir });

package/dist/core/library.js

@@ -6,7 +6,7 @@
  *   <key>/<action>@<ver>.json        the entry (connector key, HTTP method, endpoint)
  *   <key>/<action>@<ver>.v1def.json  the Flow `definitions[]` shape (model, ports, …)
  */
-import { cacheFor, libraryPath, readJson, readTextFromDisk } from './read-text.js';
+import { cacheFor, defaultReadText, libraryPath, readJson, readTextFromDisk } from './read-text.js';
 import { PULL_COMMAND, prepareCommand } from './cli-spelling.js';
 import { editDistance } from './edit-distance.js';
 import { loadListEnvelopes, lookupListEnvelope } from './list-envelope.js';
@@ -38,7 +38,7 @@ export class Library {
     read;
     warn;
     constructor(dir, opts = {}) {
-        const read = (this.read = opts.readText ?? readTextFromDisk);
+        const read = (this.read = opts.readText ?? defaultReadText());
         this.warn = opts.warn ?? ((message) => { globalThis.process?.stderr?.write(message); });
         // A new identity per Library, so the per-reader caches never keep an overlay file: `prepare` rewrites them.
         const readOverlay = (path) => read(path);

package/dist/core/list-envelope.js

@@ -32,14 +32,14 @@
  * cheaper half. The LEDGER is the single source of truth — the readers are
  * interchangeable.
  */
-import { cacheFor, libraryPath, readTextFromDisk } from './read-text.js';
+import { cacheFor, defaultReadText, libraryPath } from './read-text.js';
 const CACHE = new WeakMap();
 /**
  * Every declared row, from `<libraryDir>/list-envelopes.json`. An absent file is
  * an empty ledger — every operation undeclared — which is what a library built
  * before this card, or a bare fixture library, looks like.
  */
-export function loadListEnvelopes(libraryDir, read = readTextFromDisk) {
+export function loadListEnvelopes(libraryDir, read = defaultReadText()) {
     if (!libraryDir)
         return [];
     const cache = cacheFor(CACHE, read);

package/dist/core/lookup-store.js

@@ -1,4 +1,4 @@
-import { cacheFor, libraryPath, readTextFromDisk } from './read-text.js';
+import { cacheFor, defaultReadText, libraryPath } from './read-text.js';
 /**
  * core/lookup-store — the two on-disk side-tables the lookup surface reads.
  *
@@ -22,7 +22,7 @@ const RESOLUTION_CACHE = new WeakMap();
  * — it is a compile error naming the `prepare` command to run, which is the
  * behaviour an author wants from a missing resolution anyway.
  */
-export function loadLookupResolutions(overlayDir, read = readTextFromDisk) {
+export function loadLookupResolutions(overlayDir, read = defaultReadText()) {
     if (!overlayDir)
         return {};
     const cache = cacheFor(RESOLUTION_CACHE, read);
@@ -60,7 +60,7 @@ export function loadLookupResolutions(overlayDir, read = readTextFromDisk) {
  * call rather than cached: `prepare` rewrites this file, and a stale "never
  * checked" answer would refuse a flow that was just verified.
  */
-export function loadByoaLedger(overlayDir, read = readTextFromDisk) {
+export function loadByoaLedger(overlayDir, read = defaultReadText()) {
     if (!overlayDir)
         return {};
     try {
@@ -83,7 +83,7 @@ export function loadByoaLedger(overlayDir, read = readTextFromDisk) {
  * @param libraryDir - A `library-json` directory, or the local overlay.
  * @returns Every `objectName` declared connector-invariant.
  */
-export function loadInvariantCollections(libraryDir, read = readTextFromDisk) {
+export function loadInvariantCollections(libraryDir, read = defaultReadText()) {
     if (!libraryDir)
         return new Set();
     const cache = cacheFor(INVARIANT_CACHE, read);

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

@@ -11,12 +11,21 @@
  * 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 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 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. */
+export declare function defaultReadText(): ReadText;
 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;

package/dist/core/read-text.js

@@ -11,14 +11,27 @@
  * 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 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`.
  */
+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() {
+    return globalThis[HOST_READ_TEXT] ?? readTextFromDisk;
+}
 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 Error(`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');
     return fs.existsSync(path) ? fs.readFileSync(path, 'utf8') : undefined;

package/dist/registry/library-reader.js

@@ -7,7 +7,7 @@
  * with `.json` swapped for `.v1def.json`, and a sidecar that is a one-element
  * list is unwrapped.
  */
-import { libraryPath, readTextFromDisk } from "../core/read-text.js";
+import { defaultReadText, libraryPath } from "../core/read-text.js";
 import { loadInvariantCollections } from "./lookup-specs.js";
 /** `<path minus .json>.v1def.json`, the sidecar beside an entry. */
 export function sidecarPath(entryRelativePath) {
@@ -22,7 +22,7 @@ export function unwrapV1Def(raw) {
     return undefined;
 }
 /** `read` defaults to the disk; a host without one passes its own (`core/read-text.ts`). */
-export function loadLibrary(dir, read = readTextFromDisk) {
+export function loadLibrary(dir, read = defaultReadText()) {
     const indexPath = libraryPath(dir, "index.json");
     const indexText = read(indexPath);
     if (indexText === undefined) {

package/dist/registry/lookup-specs.js

@@ -13,7 +13,7 @@
  * `generate_connectors_ts.py`. `core/lookups.ts` keeps `check` and `compile`
  * agreeing with this by importing it.
  */
-import { libraryPath, readTextFromDisk } from "../core/read-text.js";
+import { defaultReadText, libraryPath } from "../core/read-text.js";
 import { pyTruthy } from "./generators/type-tree.js";
 import { byAliases } from "./naming.js";
 export const LEDGER_FILENAME = "invariant-collections.json";
@@ -22,7 +22,7 @@ export const LEDGER_FILENAME = "invariant-collections.json";
  * ledger reads as empty rather than raising: the permissive path is the
  * pre-ledger behaviour, so a bad edit loses exactness, never a build.
  */
-export function loadInvariantCollections(libraryDir, read = readTextFromDisk) {
+export function loadInvariantCollections(libraryDir, read = defaultReadText()) {
     if (!libraryDir)
         return new Set();
     let parsed;

package/dist/registry/search-cli.js

@@ -1,7 +1,8 @@
 import { printResult, reportResult } from '../cli-result.js';
-import { readFile, stat } from "node:fs/promises";
+import { stat } from "node:fs/promises";
 import { PULL_COMMAND } from "../core/cli-spelling.js";
 import { resolveLibraryDir } from "../core/library-cache.js";
+import { defaultReadText } from "../core/read-text.js";
 import { dirname, join } from "node:path";
 export const DEFAULT_SEARCH_LIMIT = 20;
 const USAGE = "Usage: flow-sdk registry search [query] [--library <dir>] [--library-md <dir>] [--connector <key>] [--limit <n>]";
@@ -50,9 +51,12 @@ export async function searchRegistryOperations(options) {
     const indexPath = join(options.libraryPath, "index.json");
     let content;
     try {
-        content = await readFile(indexPath, "utf-8");
+        content = defaultReadText()(indexPath);
     }
     catch {
+        content = undefined;
+    }
+    if (content === undefined) {
         throw new Error(`Could not read ${indexPath}. Run \`${PULL_COMMAND}\`, or point` +
             " --library at an extracted connector library.");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.44.4",
+  "version": "6.45.0",
   "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": "cbc51e1db2b0ffabe85f841dee73f5a6301192d2"
+  "gitref": "618bc7abd8705bcc85c85d6414dd29be5e9c3ec0"
 }