@finos/legend-cube-builder 0.0.0-stage → 0.0.3

package/lib/graph-manager/protocol/pure/v1/V1_LegendCubeEngine.js

@@ -0,0 +1,171 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { EmitRole, lambda, storeAccessor, } from '@finos/legend-cube';
+import { V1_EngineServerClient, V1_RenderStyle } from '@finos/legend-graph';
+import { stringifyLosslessJSON, } from '@finos/legend-shared';
+import { CubeEngineError, CubeEngineErrorKind, } from '../../../CubeEngine.js';
+import { V1_buildCubeEngineError, V1_toCubeEngineError, } from './V1_CubeEngineErrors.js';
+import { V1_CubeUnreadableResultError, V1_readCubeExecutionResult, } from './V1_CubeExecutionResultReader.js';
+import { V1_serializeCubeLambda } from './V1_CubeLambdaSerializer.js';
+import { V1_buildCubeModelOutline } from './V1_CubeModelOutlineBuilder.js';
+import { V1_buildCubeSchema } from './V1_CubeRelationTypeAdapter.js';
+/** The only model kind the slice runs: Pure text (PLAN §6.2.2) */
+const TEXT_MODEL_TYPE = 'text';
+const EXECUTION_CLIENT_VERSION = 'vX_X_X';
+/**
+ * The node an execution lambda runs: the one its `from` call is stamped with
+ * (`{| <relation>->limit(…)->from(runtime)}`), where errors without a stamp go
+ */
+const captureNodeOf = (executionLambda) => {
+    const from = executionLambda.k === 'lambda' ? executionLambda.body[0] : undefined;
+    return from?.k === 'func' ? from.origin?.nodeId : undefined;
+};
+/** The message for a model of a kind this version can't run (PLAN §8.7) */
+export const V1_unsupportedModelMessage = (type) => `This cube's model kind "${type}" isn't supported yet.`;
+/**
+ * The Legend engine behind the Cube engine port (PLAN §8.7). It sends the
+ * cube's saved model context as it is, lambdas as protocol JSON with lossless
+ * numbers, and reads every response itself: the graph manager's wrappers drop
+ * type parameters and read numbers lossily (D8).
+ */
+export class V1_LegendCubeEngine {
+    client;
+    constructor(config, tracerService) {
+        this.client = new V1_EngineServerClient(config);
+        // every call throws without one
+        this.client.setTracerService(tracerService);
+    }
+    /** The model's Pure text, or an unsupported-model error for any other kind */
+    textOf(model, nodeId) {
+        if (model._type !== TEXT_MODEL_TYPE || typeof model.code !== 'string') {
+            throw new CubeEngineError(CubeEngineErrorKind.UNSUPPORTED_MODEL, V1_unsupportedModelMessage(model._type), nodeId);
+        }
+        return model.code;
+    }
+    async loadModel(model) {
+        const code = this.textOf(model);
+        try {
+            return V1_buildCubeModelOutline(await this.client.grammarToJSON_model(code));
+        }
+        catch (error) {
+            throw V1_toCubeEngineError(error, undefined, CubeEngineErrorKind.COMPILE);
+        }
+    }
+    resolveSchemas(model, accessors) {
+        return this.typeAll(model, new Map([...accessors].map(([nodeId, path]) => [
+            nodeId,
+            lambda([], [storeAccessor(path, { nodeId, role: EmitRole.ACCESSOR })]),
+        ])));
+    }
+    typeLambdas(model, lambdas) {
+        return this.typeAll(model, lambdas);
+    }
+    /** Types every lambda in one batch call: one entry per key, whatever fails */
+    async typeAll(model, lambdas) {
+        const typed = new Map();
+        if (!lambdas.size) {
+            return typed;
+        }
+        const failAll = (error) => new Map([...lambdas.keys()].map((nodeId) => [
+            nodeId,
+            V1_toCubeEngineError(error, nodeId, CubeEngineErrorKind.COMPILE),
+        ]));
+        let response;
+        try {
+            this.textOf(model);
+            const body = stringifyLosslessJSON({
+                model,
+                lambdas: Object.fromEntries([...lambdas].map(([nodeId, ir]) => [
+                    nodeId,
+                    V1_serializeCubeLambda(ir),
+                ])),
+            });
+            // sent as text, so numbers keep every digit; the client sends a string body as it is
+            response = (await this.client.batchLambdasRelationType(body));
+        }
+        catch (error) {
+            return failAll(error);
+        }
+        // the engine answers `result`; legend-graph's response type says `results` (LG-1)
+        const results = (response.result ?? response.results ?? {});
+        const errors = (response.errors ?? {});
+        // own keys only: a node id like `__proto__` mustn't read Object.prototype
+        lambdas.forEach((_, nodeId) => {
+            const relationType = Object.hasOwn(results, nodeId)
+                ? results[nodeId]
+                : undefined;
+            if (relationType) {
+                try {
+                    typed.set(nodeId, V1_buildCubeSchema(relationType));
+                }
+                catch (error) {
+                    typed.set(nodeId, new CubeEngineError(CubeEngineErrorKind.COMPILE, error.message, nodeId));
+                }
+                return;
+            }
+            typed.set(nodeId, V1_buildCubeEngineError(Object.hasOwn(errors, nodeId) ? errors[nodeId] : undefined, nodeId, CubeEngineErrorKind.COMPILE) ??
+                new CubeEngineError(CubeEngineErrorKind.NETWORK, `The engine gave no type for this node`, nodeId));
+        });
+        return typed;
+    }
+    async execute(model, executionLambda, options) {
+        const captureId = captureNodeOf(executionLambda);
+        const startedAt = Date.now();
+        let text;
+        try {
+            this.textOf(model);
+            const body = stringifyLosslessJSON({
+                clientVersion: EXECUTION_CLIENT_VERSION,
+                function: V1_serializeCubeLambda(executionLambda),
+                model,
+                context: { _type: 'BaseExecutionContext' },
+                parameterValues: [],
+            });
+            // `returnAsResponse` leaves the body unread, so it can be read losslessly
+            const response = (await this.client.runQuery(body, {
+                returnAsResponse: true,
+                abortController: options?.abortController,
+            }));
+            text = await response.text();
+        }
+        catch (error) {
+            throw V1_toCubeEngineError(error, captureId, CubeEngineErrorKind.EXECUTION);
+        }
+        try {
+            return {
+                ...V1_readCubeExecutionResult(text),
+                durationMs: Date.now() - startedAt,
+            };
+        }
+        catch (error) {
+            if (error instanceof V1_CubeUnreadableResultError) {
+                throw new CubeEngineError(CubeEngineErrorKind.EXECUTION, error.message, captureId);
+            }
+            throw error;
+        }
+    }
+    async renderPure(lambdaIR) {
+        try {
+            // sent as text, as typing and execution are: the serialized lambda holds
+            // lossless numbers, which plain JSON.stringify would write as objects
+            return await this.client.JSONToGrammar_lambda(stringifyLosslessJSON(V1_serializeCubeLambda(lambdaIR)), V1_RenderStyle.PRETTY);
+        }
+        catch (error) {
+            throw V1_toCubeEngineError(error, undefined, CubeEngineErrorKind.COMPILE);
+        }
+    }
+}
+//# sourceMappingURL=V1_LegendCubeEngine.js.map

package/lib/graph-manager/protocol/pure/v1/V1_LegendCubeEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_LegendCubeEngine.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_LegendCubeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,QAAQ,EAER,MAAM,EAGN,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAEL,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,eAAe,EACf,mBAAmB,GAIpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAOrE,kEAAkE;AAClE,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAE1C;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,eAAmB,EAAsB,EAAE;IAChE,MAAM,IAAI,GACR,eAAe,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,OAAO,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,IAAY,EAAU,EAAE,CACjE,2BAA2B,IAAI,wBAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACrB,MAAM,CAAwB;IAEvC,YAAY,MAA2B,EAAE,aAA4B;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAChD,gCAAgC;QAChC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,8EAA8E;IACtE,MAAM,CAAC,KAAmB,EAAE,MAAe;QACjD,IAAI,KAAK,CAAC,KAAK,KAAK,eAAe,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,iBAAiB,EACrC,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,EACvC,MAAM,CACP,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAmB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,wBAAwB,CAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAC5C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,cAAc,CACZ,KAAmB,EACnB,SAA4C;QAE5C,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,IAAI,GAAG,CACL,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM;YACN,MAAM,CACJ,EAAE,EACF,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAC3D;SACF,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAED,WAAW,CACT,KAAmB,EACnB,OAAgC;QAEhC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,8EAA8E;IACtE,KAAK,CAAC,OAAO,CACnB,KAAmB,EACnB,OAAgC;QAEhC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAgC,EAAE,CAC/D,IAAI,GAAG,CACL,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAClC,MAAM;YACN,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC;SACjE,CAAC,CACH,CAAC;QACJ,IAAI,QAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,qBAAqB,CAAC;gBACjC,KAAK;gBACL,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;oBACjC,MAAM;oBACN,sBAAsB,CAAC,EAAE,CAAC;iBAC3B,CAAC,CACH;aACF,CAAC,CAAC;YACH,qFAAqF;YACrF,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,wBAAwB,CACpD,IAA8B,CAC/B,CAA2B,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,kFAAkF;QAClF,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAgB,CAAC;QAC3E,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAgB,CAAC;QACtD,0EAA0E;QAC1E,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;gBACjD,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBACjB,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,YAA2B,CAAC,CAAC,CAAC;gBACrE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,KAAK,CAAC,GAAG,CACP,MAAM,EACN,IAAI,eAAe,CACjB,mBAAmB,CAAC,OAAO,EAC1B,KAAe,CAAC,OAAO,EACxB,MAAM,CACP,CACF,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;YACD,KAAK,CAAC,GAAG,CACP,MAAM,EACN,uBAAuB,CACrB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAC1D,MAAM,EACN,mBAAmB,CAAC,OAAO,CAC5B;gBACC,IAAI,eAAe,CACjB,mBAAmB,CAAC,OAAO,EAC3B,uCAAuC,EACvC,MAAM,CACP,CACJ,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAmB,EACnB,eAAmB,EACnB,OAA2D;QAE3D,MAAM,SAAS,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,qBAAqB,CAAC;gBACjC,aAAa,EAAE,wBAAwB;gBACvC,QAAQ,EAAE,sBAAsB,CAAC,eAAe,CAAC;gBACjD,KAAK;gBACL,OAAO,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;gBAC1C,eAAe,EAAE,EAAE;aACpB,CAAC,CAAC;YACH,0EAA0E;YAC1E,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAC1C,IAA8B,EAC9B;gBACE,gBAAgB,EAAE,IAAI;gBACtB,eAAe,EAAE,OAAO,EAAE,eAAe;aAC1C,CACF,CAAa,CAAC;YACf,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,oBAAoB,CACxB,KAAK,EACL,SAAS,EACT,mBAAmB,CAAC,SAAS,CAC9B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO;gBACL,GAAG,0BAA0B,CAAC,IAAI,CAAC;gBACnC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,4BAA4B,EAAE,CAAC;gBAClD,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,SAAS,EAC7B,KAAK,CAAC,OAAO,EACb,SAAS,CACV,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAY;QAC3B,IAAI,CAAC;YACH,yEAAyE;YACzE,sEAAsE;YACtE,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAC3C,qBAAqB,CACnB,sBAAsB,CAAC,QAAQ,CAAC,CACP,EAC3B,cAAc,CAAC,MAAM,CACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { jest } from '@jest/globals';
+import { V1_LegendCubeEngine } from '../V1_LegendCubeEngine.js';
+export declare const V1_createEngineBackedCubeEngine: () => {
+    engine: V1_LegendCubeEngine;
+    calls: Record<"grammarToJSON_model" | "batchLambdasRelationType" | "runQuery", jest.Mock>;
+};
+//# sourceMappingURL=V1_CubeEngineTestUtils.d.ts.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeEngineTestUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAgBrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAuChE,eAAO,MAAM,+BAA+B,QAAO;IACjD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CACX,qBAAqB,GAAG,0BAA0B,GAAG,UAAU,EAC/D,IAAI,CAAC,IAAI,CACV,CAAC;CAkDH,CAAC"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.js

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { jest } from '@jest/globals';
+import { ENGINE_TEST_SUPPORT__grammarToJSON_model, ENGINE_TEST_SUPPORT_API_URL, } from '@finos/legend-graph/test';
+import { NetworkClientError, TracerService, } from '@finos/legend-shared';
+import { AxiosError } from 'axios';
+import { CUBE_ENGINE_TEST__execute, CUBE_ENGINE_TEST__jsonToGrammar_lambda, CUBE_ENGINE_TEST__lambdaRelationTypeBatch, } from '../../../../../__test-utils__/CubeEngineTestSupport.js';
+import { V1_LegendCubeEngine } from '../V1_LegendCubeEngine.js';
+// The real Cube engine, its client's calls routed to the engine on :6300 by
+// Cube's own test helpers (PLAN §3.4): the test environment refuses network
+// calls, and the execute helper hands back the body unread, so the lossless
+// reader runs as in the browser. Every helper fails as the client does.
+/** A failed call, as the engine client throws it: a `NetworkClientError` with the engine's payload */
+const clientError = (status, payload) => new NetworkClientError({
+    status,
+    statusText: String(status),
+    url: ENGINE_TEST_SUPPORT_API_URL,
+}, payload);
+/** The payload of a failed call, as the client reads it: JSON when it parses, else its text */
+const parseOrText = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+};
+/** A helper's non-2xx response, rethrown as the client throws it */
+const rethrowAsClientError = (error) => {
+    if (error instanceof AxiosError && error.response) {
+        const data = error.response.data;
+        throw clientError(error.response.status, typeof data === 'string' ? parseOrText(data) : data);
+    }
+    throw error;
+};
+export const V1_createEngineBackedCubeEngine = () => {
+    const engine = new V1_LegendCubeEngine({ baseUrl: ENGINE_TEST_SUPPORT_API_URL }, new TracerService());
+    const { client } = engine;
+    const grammarToJSON_model = jest
+        .spyOn(client, 'grammarToJSON_model')
+        .mockImplementation(async (code) => (await ENGINE_TEST_SUPPORT__grammarToJSON_model(code).catch(rethrowAsClientError)));
+    const batchLambdasRelationType = jest
+        .spyOn(client, 'batchLambdasRelationType')
+        .mockImplementation(async (input) => (await CUBE_ENGINE_TEST__lambdaRelationTypeBatch(input).catch(rethrowAsClientError)));
+    const runQuery = jest
+        .spyOn(client, 'runQuery')
+        .mockImplementation(async (input) => {
+        const response = await CUBE_ENGINE_TEST__execute(input);
+        if (!response.ok) {
+            throw clientError(response.status, parseOrText(await response.text()));
+        }
+        return response;
+    });
+    jest
+        .spyOn(client, 'JSONToGrammar_lambda')
+        .mockImplementation(async (lambda, renderStyle) => CUBE_ENGINE_TEST__jsonToGrammar_lambda(lambda, renderStyle).catch(rethrowAsClientError));
+    return {
+        engine,
+        calls: {
+            grammarToJSON_model: grammarToJSON_model,
+            batchLambdasRelationType: batchLambdasRelationType,
+            runQuery: runQuery,
+        },
+    };
+};
+//# sourceMappingURL=V1_CubeEngineTestUtils.js.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeEngineTestUtils.js","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeEngineTestUtils.ts"],"names":[],"mappings":"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"}

package/lib/index.css

@@ -0,0 +1,17 @@
+/** @license @finos/legend-cube-builder v0.0.3
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.legend-cube{height:100%;width:100%}/*# sourceMappingURL=index.css.map */

package/lib/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sourceRoot":"","sources":["../style/index.scss"],"names":[],"mappings":"AAmBA,aACE,YACA","file":"index.css"}

package/lib/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { LEGEND_CUBE_COMMAND_CONFIG, LEGEND_CUBE_COMMAND_KEY, } from './__lib__/LegendCubeCommand.js';
+export { LEGEND_CUBE_TEST_ID } from './__lib__/LegendCubeTesting.js';
+export { CubeEditor } from './components/CubeEditor.js';
+export * from './graph-manager/CubeEngine.js';
+export { getRuntimesForDatabase } from './graph-manager/CubeModelOutlineHelper.js';
+export { buildCubeEngine, type CubeEngineConfig, } from './graph-manager/protocol/pure/CubeEngineBuilder.js';
+export type { CubeHost } from './stores/CubeHost.js';
+export { BUNDLED_MODELS, type BundledModel, createTextModel, LocalModelCatalog, } from './stores/LocalModelCatalog.js';
+export { CUBE_NORTHWIND_DATABASE, CUBE_NORTHWIND_MODEL, CUBE_NORTHWIND_RUNTIME, } from './stores/fixtures/CubeNorthwindModel.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,oDAAoD,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}

package/lib/index.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { LEGEND_CUBE_COMMAND_CONFIG, LEGEND_CUBE_COMMAND_KEY, } from './__lib__/LegendCubeCommand.js';
+export { LEGEND_CUBE_TEST_ID } from './__lib__/LegendCubeTesting.js';
+export { CubeEditor } from './components/CubeEditor.js';
+export * from './graph-manager/CubeEngine.js';
+export { getRuntimesForDatabase } from './graph-manager/CubeModelOutlineHelper.js';
+export { buildCubeEngine, } from './graph-manager/protocol/pure/CubeEngineBuilder.js';
+export { BUNDLED_MODELS, createTextModel, LocalModelCatalog, } from './stores/LocalModelCatalog.js';
+export { CUBE_NORTHWIND_DATABASE, CUBE_NORTHWIND_MODEL, CUBE_NORTHWIND_RUNTIME, } from './stores/fixtures/CubeNorthwindModel.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,eAAe,GAEhB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EACL,cAAc,EAEd,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}

package/lib/stores/CubeEditorState.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { CubeDocument, type ModelContext, type NodeRegistry, type Query, QueryEmitter, type QueryNode, RelationalTableSource, type SchemaInferenceResult } from '@finos/legend-cube';
+import type { CommandRegistrar } from '@finos/legend-application';
+import type { GeneratorFn } from '@finos/legend-shared';
+import { CubeEngineError, type CubeModelOutline } from '../graph-manager/CubeEngine.js';
+import { CubeExecutionState } from './CubeExecutionState.js';
+import type { CubeHost } from './CubeHost.js';
+import { CubeNodeEditorState } from './CubeNodeEditorState.js';
+import { CubeShowPureState } from './CubeShowPureState.js';
+import { CubeSourcePickerState } from './CubeSourcePickerState.js';
+import { CubeSpecTransferState } from './CubeSpecTransferState.js';
+/** An engine error placed on a node: its first line shows on the node, its detail in the grid */
+export interface CubeHostIssue {
+    readonly firstLine: string;
+    readonly detail: string;
+}
+/**
+ * The state of one Cube page (PLAN §7.8). The document is immutable: every
+ * edit makes a new one through `applyDocument`, which keeps the previous one
+ * for undo. Domain and port values are held by reference, never observed
+ * deeply.
+ */
+export declare class CubeEditorState implements CommandRegistrar {
+    readonly host: CubeHost;
+    /** One registry for inference, emission and the saved spec */
+    readonly registry: NodeRegistry;
+    readonly execution: CubeExecutionState;
+    readonly sourcePicker: CubeSourcePickerState;
+    readonly specTransfer: CubeSpecTransferState;
+    readonly showPure: CubeShowPureState;
+    readonly nodeEditor: CubeNodeEditorState;
+    document: CubeDocument;
+    /** Earlier documents, oldest first */
+    history: readonly CubeDocument[];
+    /** Engine errors by node id: shown with the node's own errors, never part of inference */
+    hostIssues: ReadonlyMap<string, CubeHostIssue>;
+    /**
+     * Warnings by node key, e.g. a table that changed since the cube was saved:
+     * shown on the node, never errors, and gone once the node is replaced
+     */
+    warnings: ReadonlyMap<number, readonly string[]>;
+    /**
+     * The outline of each model the cube used, loaded when an editor needs it,
+     * e.g. for the Join's 'type unknown' warning; by reference, never observed
+     * deeply
+     */
+    private modelOutlines;
+    /** Sources sent to the engine to be typed again, until it answers */
+    private pendingSources;
+    /** The rows a run returns; kept per user, never in the cube */
+    rowLimit: number;
+    /** The palette shows icons only; kept per user, never in the cube */
+    isPaletteCollapsed: boolean;
+    /**
+     * The cube was saved by a newer version of Cube: it can be viewed and run,
+     * but not changed, undone or exported (Settled before M1.8)
+     */
+    readOnly: boolean;
+    /** Documents in the undo history that were read-only, so undo restores the flag */
+    private readonly readOnlyDocuments;
+    /** Documents an import replaced: undoing back to one opens another cube again */
+    private readonly importedOver;
+    constructor(host: CubeHost, document?: CubeDocument);
+    /** Each node's schema and errors, query-level rules included, as the emitter sees them */
+    get analysis(): SchemaInferenceResult;
+    get emitter(): QueryEmitter;
+    /** The cube shown has tables being typed again, after an import */
+    get isResolvingSources(): boolean;
+    /** The source is being typed again by the engine, e.g. after an import */
+    isPendingSource(node: QueryNode): boolean;
+    /**
+     * Warnings worked out from the query, by node id: a Sort whose order is
+     * lost before it is used (PLAN §11.4). Never stored and never errors, so
+     * Execute stays enabled; they go as soon as the query no longer loses it.
+     * A partial loss names each node that removes some of the Sort's columns,
+     * then the columns that came after a removed one. A loss waits until the
+     * Sort and every node it names have no errors, e.g. a Restrict just added,
+     * with no column yet: their own errors come first.
+     */
+    get derivedWarnings(): ReadonlyMap<string, readonly string[]>;
+    /** A node's warnings: the stored ones (by key), then the derived ones (by id) */
+    getNodeWarnings(node: QueryNode): readonly string[];
+    /**
+     * The node's errors, each once: its own and those of the query rules, then
+     * the first line of the engine's error on it
+     */
+    getNodeErrors(nodeId: string): readonly string[];
+    /** The outline of the cube's model, once an editor has loaded it */
+    get modelOutline(): CubeModelOutline | undefined;
+    /** The outline of a model, once loaded */
+    getModelOutline(model: ModelContext): CubeModelOutline | undefined;
+    /**
+     * The database type a run of the query up to the node needs, with the
+     * model's runtime (PLAN §11.4), from the model's outline once it is loaded
+     * (`loadModelOutline`): the type of the runtime's connections to the
+     * databases the node reads. None without an outline, which writes every
+     * operation the native way.
+     */
+    getRunDatabaseType(query: Query, nodeId: string, model: ModelContext, runtime: string): string | undefined;
+    /**
+     * Loads the outline of a model, the cube's by default, once per model. It
+     * only adds warnings and database types, so a model that fails to load
+     * shows none and runs every operation the native way.
+     */
+    loadModelOutline(model?: ModelContext | undefined): GeneratorFn<void>;
+    /** One of Cube's dialogs is open: the source picker, Import or Export, Show Pure */
+    get isDialogOpen(): boolean;
+    /**
+     * The page's keyboard shortcuts, while it is open (spec §17.12). Each does
+     * nothing when its button can't be used, and nothing while a Cube dialog
+     * is open, since a dialog doesn't stop the app's shortcuts (user's choice,
+     * 2026-10-07). Undo leaves Ctrl+Z to a text field that has the focus.
+     */
+    registerCommands(): void;
+    deregisterCommands(): void;
+    get canUndo(): boolean;
+    /** The one way to change the cube; the document before goes to the undo history */
+    applyDocument(next: CubeDocument): void;
+    /**
+     * Opens another cube in place of this one, e.g. an imported spec: one undo
+     * step. Stops any run and any table being added, closes the node editor
+     * without applying its edits, and drops the last run's rows and errors,
+     * which belong to the cube before. Never runs the cube.
+     */
+    importDocument(next: CubeDocument, readOnly: boolean): void;
+    /**
+     * Types the cube's tables again, in one engine call, outside the undo
+     * history (PLAN §10.3, Settled before M1.8):
+     * - a table whose columns are the saved ones is left as it is;
+     * - a table that changed takes its new columns, with a warning listing the
+     *   changes;
+     * - a table with saved columns that can't be typed keeps them, with a
+     *   warning; one without them shows the engine's error.
+     *
+     * Then filter values saved as invalid text are read again against the
+     * columns. The answer goes to every document holding the very source
+     * objects that were typed: the cube shown and the undo snapshots taken
+     * meanwhile, so undoing an edit made while the tables were typed keeps
+     * them typed. A source the user changed meanwhile is a new object, and is
+     * left alone.
+     *
+     * `only` types just these sources of the cube shown, e.g. one Refresh. A
+     * table found unchanged loses any earlier warning.
+     */
+    reresolveSources(only?: readonly RelationalTableSource[]): GeneratorFn<void>;
+    /**
+     * Types a table again with the engine, from its Source panel (spec §17.6),
+     * as a re-check after an import does: no undo step, nothing changes when
+     * its columns are the same, and a warning lists any change.
+     */
+    refreshSource(nodeId: string): GeneratorFn<void>;
+    /**
+     * Restores the document before the last edit; does nothing when there is
+     * no history. A restored query is a new object (PLAN §4.3), so rows that
+     * ran before the edit show as stale. An edit that left the query alone,
+     * such as a rename, keeps it, with its rows and engine errors. Undoing an
+     * import closes the node editor and the picker, as the import did.
+     */
+    undo(): void;
+    private pushHistory;
+    /** Engine errors belong to the query they came from, so they are dropped when the query changes */
+    private replaceDocument;
+    applyQuery(next: Query): void;
+    /** Makes a node the capture node, the one Execute runs */
+    select(nodeId: string): void;
+    /**
+     * Feeds a node into another, on the port if given, else the first free one.
+     * Does nothing when the query doesn't allow it or the cube is read-only.
+     */
+    connect(sourceId: string, targetId: string, port?: string): void;
+    /**
+     * Whether a node of the type can be added: a transform, unconnected or
+     * spliced in after `afterId`, when the query allows it; a source only
+     * unconnected, through the source picker. Never while the cube is read-only.
+     */
+    canAddNode(type: string, afterId?: string): boolean;
+    /**
+     * Adds a node of the type, as the palette and the context menu do (spec
+     * §17.4): a transform with its default settings, unconnected or spliced in
+     * after `afterId`; a source opens the source picker, which adds it once
+     * the engine has typed it. Does nothing `canAddNode` refuses.
+     */
+    addNode(type: string, afterId?: string): void;
+    /**
+     * Adds a node made elsewhere, with its settings, as the grid's quick
+     * actions do (spec §12.4): spliced in after `afterId`, so it becomes the
+     * node that runs when that one did, as one undo step. Does nothing in a
+     * read-only cube, or when the query can't take it.
+     */
+    addConfiguredNode(node: QueryNode, afterId?: string): void;
+    /** Whether dropping a node on another does anything: connect it, or else move it after it */
+    canDropNode(nodeId: string, targetId: string): boolean;
+    /**
+     * Drops a node on another (spec §17.4): it feeds the target's first free
+     * port if it can, else it moves to after the target
+     */
+    dropNode(nodeId: string, targetId: string): void;
+    canRemoveNode(nodeId: string): boolean;
+    /**
+     * Removes a node, healing the chain around it. Removing the last node also
+     * clears the cube's model and runtime, in the same undo step, so the next
+     * table can come from any model (user's choice, 2026-10-07).
+     */
+    removeNode(nodeId: string): void;
+    canSwapInputs(nodeId: string): boolean;
+    /** Swaps a binary node's two inputs; its settings follow them, e.g. a Join's key columns */
+    swapInputs(nodeId: string): void;
+    /**
+     * Shows or hides the graph, which the cube saves (spec §17.1). An undoable
+     * edit that leaves the query, and so the rows, as they are (M1.8b).
+     */
+    setShowGraph(showGraph: boolean): void;
+    setHostIssue(nodeId: string, error: CubeEngineError): void;
+    clearHostIssues(): void;
+    /** Sets and remembers the row limit; a value that isn't a whole number of at least 1 is refused */
+    setRowLimit(value: number): boolean;
+    /** Collapses or expands the palette, and remembers it for the user */
+    setPaletteCollapsed(collapsed: boolean): void;
+    /** Stops any run; call when the page closes */
+    dispose(): void;
+}
+//# sourceMappingURL=CubeEditorState.d.ts.map

package/lib/stores/CubeEditorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeEditorState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeEditorState.ts"],"names":[],"mappings":"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"}