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

package/lib/graph-manager/CubeEngine.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 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 type { IR, ModelContext, Schema } from '@finos/legend-cube';
+/** A query node's id */
+export type NodeId = string;
+/** A table's Database element path, schema name and table name, names as stored (quotes included) */
+export type AccessorPath = readonly [
+    database: string,
+    schema: string,
+    table: string
+];
+/** Why a table can't be picked as it is, read from its definition (PLAN §6.2.6) */
+export declare enum CubeTableFlag {
+    /** a binary column: the engine can't type the table */
+    UNAVAILABLE = "unavailable",
+    /** a CHAR(n) column: typed with a length of 1 */
+    LENGTH_UNKNOWN = "lengthUnknown",
+    /** an OTHER or ARRAY column: typed as a bare String */
+    TYPE_UNKNOWN = "typeUnknown"
+}
+export interface CubeOutlineTable {
+    /** As stored, quotes included */
+    readonly name: string;
+    /** Views are typed as text of length 0, so the picker hides them in v1 */
+    readonly isView: boolean;
+    readonly columnCount: number;
+    readonly flags: readonly CubeTableFlag[];
+    /**
+     * The columns typed as a bare String because Cube can't read their type
+     * (OTHER or ARRAY), unquoted as in the table's schema
+     */
+    readonly untypedColumns: readonly string[];
+}
+export interface CubeOutlineSchema {
+    readonly name: string;
+    readonly tables: readonly CubeOutlineTable[];
+}
+export interface CubeOutlineDatabase {
+    readonly path: string;
+    readonly schemas: readonly CubeOutlineSchema[];
+}
+/** A relational connection of a runtime, for the operations some databases take another way (PLAN §11.4) */
+export interface CubeOutlineConnection {
+    /** The store it is keyed by */
+    readonly storePath: string;
+    /** The engine's name for its database type, e.g. `H2` or `SqlServer` */
+    readonly databaseType: string;
+}
+export interface CubeOutlineRuntime {
+    readonly path: string;
+    /** The stores its connections are keyed by, exactly; includes are not followed (PLAN §6.2.5) */
+    readonly storePaths: readonly string[];
+    /**
+     * Its relational connections that name a database type, a list rather
+     * than a record keyed by a store path from the model; optional, as an
+     * outline from before M2 has none
+     */
+    readonly connections?: readonly CubeOutlineConnection[];
+}
+/** What a model offers the source picker: its databases and runtimes, as plain data */
+export interface CubeModelOutline {
+    readonly databases: readonly CubeOutlineDatabase[];
+    readonly runtimes: readonly CubeOutlineRuntime[];
+}
+export declare enum CubeEngineErrorKind {
+    /** the model or a lambda doesn't compile, or a table can't be typed */
+    COMPILE = "compile",
+    /** the query failed while running, or its result can't be read */
+    EXECUTION = "execution",
+    /** the cube's model is of a kind this version can't run */
+    UNSUPPORTED_MODEL = "unsupportedModel",
+    /** the engine couldn't be reached, or answered with no readable error */
+    NETWORK = "network"
+}
+/**
+ * An engine failure, placed on the node it concerns: the node a stamp in the
+ * error points to, else the source being typed or the node being run.
+ */
+export declare class CubeEngineError extends Error {
+    readonly kind: CubeEngineErrorKind;
+    readonly nodeId: NodeId | undefined;
+    /** The part of the node the error points to (an `EmitRole`), when it is located */
+    readonly role: string | undefined;
+    /** The first line of the engine's message, shown on the node */
+    readonly firstLine: string;
+    /** The engine's whole message, without its Java trace, shown in the panel */
+    readonly detail: string;
+    constructor(kind: CubeEngineErrorKind, detail: string, nodeId?: NodeId, role?: string);
+}
+/** A value of a result cell: Integer and Decimal values as their exact text, Float values as numbers (PLAN §8.7) */
+export type CubeResultValue = string | number | boolean | null;
+export interface CubeResult {
+    /** Column names, in order; rows match them by position */
+    readonly columns: readonly string[];
+    /** As many rows as the engine sent, up to the row limit + 1 */
+    readonly rows: readonly (readonly CubeResultValue[])[];
+    /** The SQL statements the engine ran */
+    readonly sql: readonly string[];
+    readonly durationMs: number;
+}
+export interface CubeEngine {
+    /** The databases and runtimes of a model, parsed once */
+    loadModel(model: ModelContext): Promise<CubeModelOutline>;
+    /** The schema of each table, in one engine call: one entry per key, failures included */
+    resolveSchemas(model: ModelContext, accessors: ReadonlyMap<NodeId, AccessorPath>): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    /** The schema of each lambda, in one engine call: one entry per key, failures included */
+    typeLambdas(model: ModelContext, lambdas: ReadonlyMap<NodeId, IR>): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    /** Runs an execution lambda; rejects with a `CubeEngineError` */
+    execute(model: ModelContext, lambda: IR, options?: {
+        abortController?: AbortController | undefined;
+    }): Promise<CubeResult>;
+    /** The Pure text of a lambda, for display only: never parsed back */
+    renderPure(lambda: IR): Promise<string>;
+}
+//# sourceMappingURL=CubeEngine.d.ts.map

package/lib/graph-manager/CubeEngine.d.ts.map

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

package/lib/graph-manager/CubeEngine.js

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+/** Why a table can't be picked as it is, read from its definition (PLAN §6.2.6) */
+export var CubeTableFlag;
+(function (CubeTableFlag) {
+    /** a binary column: the engine can't type the table */
+    CubeTableFlag["UNAVAILABLE"] = "unavailable";
+    /** a CHAR(n) column: typed with a length of 1 */
+    CubeTableFlag["LENGTH_UNKNOWN"] = "lengthUnknown";
+    /** an OTHER or ARRAY column: typed as a bare String */
+    CubeTableFlag["TYPE_UNKNOWN"] = "typeUnknown";
+})(CubeTableFlag || (CubeTableFlag = {}));
+export var CubeEngineErrorKind;
+(function (CubeEngineErrorKind) {
+    /** the model or a lambda doesn't compile, or a table can't be typed */
+    CubeEngineErrorKind["COMPILE"] = "compile";
+    /** the query failed while running, or its result can't be read */
+    CubeEngineErrorKind["EXECUTION"] = "execution";
+    /** the cube's model is of a kind this version can't run */
+    CubeEngineErrorKind["UNSUPPORTED_MODEL"] = "unsupportedModel";
+    /** the engine couldn't be reached, or answered with no readable error */
+    CubeEngineErrorKind["NETWORK"] = "network";
+})(CubeEngineErrorKind || (CubeEngineErrorKind = {}));
+/**
+ * An engine failure, placed on the node it concerns: the node a stamp in the
+ * error points to, else the source being typed or the node being run.
+ */
+export class CubeEngineError extends Error {
+    kind;
+    nodeId;
+    /** The part of the node the error points to (an `EmitRole`), when it is located */
+    role;
+    /** The first line of the engine's message, shown on the node */
+    firstLine;
+    /** The engine's whole message, without its Java trace, shown in the panel */
+    detail;
+    constructor(kind, detail, nodeId, role) {
+        const firstLine = detail.split('\n', 1)[0]?.trim() ?? '';
+        super(firstLine);
+        this.name = 'CubeEngineError';
+        this.kind = kind;
+        this.detail = detail;
+        this.firstLine = firstLine;
+        this.nodeId = nodeId;
+        this.role = role;
+    }
+}
+//# sourceMappingURL=CubeEngine.js.map

package/lib/graph-manager/CubeEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeEngine.js","sourceRoot":"","sources":["../../src/graph-manager/CubeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,mFAAmF;AACnF,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,uDAAuD;IACvD,4CAA2B,CAAA;IAC3B,iDAAiD;IACjD,iDAAgC,CAAA;IAChC,uDAAuD;IACvD,6CAA4B,CAAA;AAC9B,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAoDD,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,uEAAuE;IACvE,0CAAmB,CAAA;IACnB,kEAAkE;IAClE,8CAAuB,CAAA;IACvB,2DAA2D;IAC3D,6DAAsC,CAAA;IACtC,yEAAyE;IACzE,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAsB;IAC1B,MAAM,CAAqB;IACpC,mFAAmF;IAC1E,IAAI,CAAqB;IAClC,gEAAgE;IACvD,SAAS,CAAS;IAC3B,6EAA6E;IACpE,MAAM,CAAS;IAExB,YACE,IAAyB,EACzB,MAAc,EACd,MAAe,EACf,IAAa;QAEb,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzD,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/graph-manager/CubeModelOutlineHelper.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 type { CubeModelOutline, CubeOutlineRuntime } from './CubeEngine.js';
+/**
+ * The runtimes a query on the database can run with: those with a connection
+ * keyed by exactly that database. The engine matches stores by exact element
+ * and silently falls back to the first connection otherwise, so a runtime
+ * that only reaches the database through an include is not offered (PLAN
+ * §6.2.5).
+ */
+export declare const getRuntimesForDatabase: (outline: CubeModelOutline, databasePath: string) => CubeOutlineRuntime[];
+/**
+ * The database type a query on these databases runs on with the runtime, for
+ * the operations some databases take another way (PLAN §11.4): the type of
+ * the runtime's connections to them. None when the runtime isn't in the
+ * outline, a database has no typed connection, or the databases' types
+ * differ: the native forms are written then.
+ */
+export declare const getDatabaseType: (outline: CubeModelOutline, runtimePath: string, databasePaths: readonly string[]) => string | undefined;
+//# sourceMappingURL=CubeModelOutlineHelper.d.ts.map

package/lib/graph-manager/CubeModelOutlineHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeModelOutlineHelper.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,gBAAgB,EACzB,cAAc,MAAM,KACnB,kBAAkB,EAGlB,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,EACzB,aAAa,MAAM,EACnB,eAAe,SAAS,MAAM,EAAE,KAC/B,MAAM,GAAG,SAaX,CAAC"}

package/lib/graph-manager/CubeModelOutlineHelper.js

@@ -0,0 +1,45 @@
+/**
+ * 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.
+ */
+/**
+ * The runtimes a query on the database can run with: those with a connection
+ * keyed by exactly that database. The engine matches stores by exact element
+ * and silently falls back to the first connection otherwise, so a runtime
+ * that only reaches the database through an include is not offered (PLAN
+ * §6.2.5).
+ */
+export const getRuntimesForDatabase = (outline, databasePath) => outline.runtimes.filter((runtime) => runtime.storePaths.includes(databasePath));
+/**
+ * The database type a query on these databases runs on with the runtime, for
+ * the operations some databases take another way (PLAN §11.4): the type of
+ * the runtime's connections to them. None when the runtime isn't in the
+ * outline, a database has no typed connection, or the databases' types
+ * differ: the native forms are written then.
+ */
+export const getDatabaseType = (outline, runtimePath, databasePaths) => {
+    const runtime = outline.runtimes.find(({ path }) => path === runtimePath);
+    const types = new Set();
+    for (const databasePath of new Set(databasePaths)) {
+        const databaseTypes = (runtime?.connections ?? [])
+            .filter(({ storePath }) => storePath === databasePath)
+            .map(({ databaseType }) => databaseType);
+        if (!databaseTypes.length) {
+            return undefined;
+        }
+        databaseTypes.forEach((databaseType) => types.add(databaseType));
+    }
+    return types.size === 1 ? [...types][0] : undefined;
+};
+//# sourceMappingURL=CubeModelOutlineHelper.js.map

package/lib/graph-manager/CubeModelOutlineHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeModelOutlineHelper.js","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAyB,EACzB,YAAoB,EACE,EAAE,CACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC1C,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAyB,EACzB,WAAmB,EACnB,aAAgC,EACZ,EAAE;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,YAAY,IAAI,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;aAC/C,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC;aACrD,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,aAAa,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC"}

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 type { TracerService } from '@finos/legend-shared';
+import type { CubeEngine } from '../../CubeEngine.js';
+import { type V1_CubeEngineConfig } from './v1/V1_LegendCubeEngine.js';
+/** The engine client's configuration, as the host gives it (e.g. Legend Query's engine server URL) */
+export type CubeEngineConfig = V1_CubeEngineConfig;
+/**
+ * The Cube engine of a host (PLAN §3.2): the only place that builds the
+ * Legend implementation, so hosts never name a V1_* symbol
+ */
+export declare const buildCubeEngine: (config: CubeEngineConfig, tracerService: TracerService) => CubeEngine;
+//# sourceMappingURL=CubeEngineBuilder.d.ts.map

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeEngineBuilder.d.ts","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,gBAAgB,EACxB,eAAe,aAAa,KAC3B,UAA4D,CAAC"}

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.js

@@ -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 { V1_LegendCubeEngine, } from './v1/V1_LegendCubeEngine.js';
+/**
+ * The Cube engine of a host (PLAN §3.2): the only place that builds the
+ * Legend implementation, so hosts never name a V1_* symbol
+ */
+export const buildCubeEngine = (config, tracerService) => new V1_LegendCubeEngine(config, tracerService);
+//# sourceMappingURL=CubeEngineBuilder.js.map

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeEngineBuilder.js","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAEL,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAKrC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAwB,EACxB,aAA4B,EAChB,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC"}

package/lib/graph-manager/protocol/pure/v1/V1_CubeEngineErrors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { CubeEngineError, CubeEngineErrorKind, type NodeId } from '../../../CubeEngine.js';
+/**
+ * The error of an engine payload (a failed call's, or a batch key's), placed
+ * on the stamped node, or else on the fallback node. Its Java trace is dropped.
+ */
+export declare const V1_buildCubeEngineError: (payload: unknown, fallbackNodeId: NodeId | undefined, kind: CubeEngineErrorKind) => CubeEngineError | undefined;
+/**
+ * The error of a failed engine call: the engine's own message when it sent
+ * one, else a network error
+ */
+export declare const V1_toCubeEngineError: (error: unknown, fallbackNodeId: NodeId | undefined, kind: CubeEngineErrorKind) => CubeEngineError;
+//# sourceMappingURL=V1_CubeEngineErrors.d.ts.map

package/lib/graph-manager/protocol/pure/v1/V1_CubeEngineErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeEngineErrors.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeEngineErrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAgChC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,EAChB,gBAAgB,MAAM,GAAG,SAAS,EAClC,MAAM,mBAAmB,KACxB,eAAe,GAAG,SAcpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,EACd,gBAAgB,MAAM,GAAG,SAAS,EAClC,MAAM,mBAAmB,KACxB,eAuBF,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * 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 { NetworkClientError } from '@finos/legend-shared';
+import { CubeEngineError, CubeEngineErrorKind, } from '../../../CubeEngine.js';
+import { V1_parseCubeSourceId } from './V1_CubeLambdaSerializer.js';
+// Engine errors → `CubeEngineError`s on canvas nodes (PLAN §8.7). A compile
+// error echoes the stamp of the innermost failing protocol node, so it goes on
+// that node; plan-time, database and network errors carry no stamp, so they
+// go on the node being typed or run.
+const COMPILATION_ERROR_TYPES = new Set(['COMPILATION', 'PARSER']);
+/** The engine's error payload: `{message, errorType?, sourceInformation?, trace?}` */
+const readPayload = (payload) => {
+    if (!payload || typeof payload !== 'object') {
+        return undefined;
+    }
+    const { message, errorType, sourceInformation } = payload;
+    if (typeof message !== 'string' || !message.trim()) {
+        return undefined;
+    }
+    const sourceId = sourceInformation && typeof sourceInformation === 'object'
+        ? sourceInformation.sourceId
+        : undefined;
+    return {
+        message,
+        ...(typeof errorType === 'string' ? { errorType } : {}),
+        ...(typeof sourceId === 'string' ? { sourceId } : {}),
+    };
+};
+/**
+ * The error of an engine payload (a failed call's, or a batch key's), placed
+ * on the stamped node, or else on the fallback node. Its Java trace is dropped.
+ */
+export const V1_buildCubeEngineError = (payload, fallbackNodeId, kind) => {
+    const read = readPayload(payload);
+    if (!read) {
+        return undefined;
+    }
+    const origin = V1_parseCubeSourceId(read.sourceId);
+    return new CubeEngineError(read.errorType && COMPILATION_ERROR_TYPES.has(read.errorType)
+        ? CubeEngineErrorKind.COMPILE
+        : kind, read.message, origin?.nodeId ?? fallbackNodeId, origin?.role);
+};
+/**
+ * The error of a failed engine call: the engine's own message when it sent
+ * one, else a network error
+ */
+export const V1_toCubeEngineError = (error, fallbackNodeId, kind) => {
+    if (error instanceof CubeEngineError) {
+        return error.nodeId !== undefined || fallbackNodeId === undefined
+            ? error
+            : new CubeEngineError(error.kind, error.detail, fallbackNodeId);
+    }
+    if (error instanceof NetworkClientError) {
+        const fromPayload = V1_buildCubeEngineError(error.payload, fallbackNodeId, kind);
+        if (fromPayload) {
+            return fromPayload;
+        }
+    }
+    return new CubeEngineError(CubeEngineErrorKind.NETWORK, error instanceof Error && error.message
+        ? error.message
+        : `The engine couldn't be reached`, fallbackNodeId);
+};
+//# sourceMappingURL=V1_CubeEngineErrors.js.map

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

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

package/lib/graph-manager/protocol/pure/v1/V1_CubeExecutionResultReader.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 type { CubeResultValue } from '../../../CubeEngine.js';
+export interface V1_CubeExecutionResult {
+    readonly columns: readonly string[];
+    readonly rows: readonly (readonly CubeResultValue[])[];
+    readonly sql: readonly string[];
+}
+/** Thrown when the body can't be read, e.g. a stack trace streamed into a 200 */
+export declare class V1_CubeUnreadableResultError extends Error {
+}
+/** The columns, rows and SQL of an execution response's text */
+export declare const V1_readCubeExecutionResult: (text: string) => V1_CubeExecutionResult;
+//# sourceMappingURL=V1_CubeExecutionResultReader.d.ts.map

package/lib/graph-manager/protocol/pure/v1/V1_CubeExecutionResultReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeExecutionResultReader.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeExecutionResultReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAW9D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,iFAAiF;AACjF,qBAAa,4BAA6B,SAAQ,KAAK;CAAG;AA8B1D,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,KACX,sBA6CF,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * 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 { resolveCubeType, TypeFamily } from '@finos/legend-cube';
+import { parseLosslessJSON } from '@finos/legend-shared';
+// An execution response (DEFAULT format, relation result) read losslessly
+// (PLAN §8.7). Each column's values keep one JS type, decided by the type the
+// result builder gives it: Float values are numbers; any other number, an
+// Integer or Decimal value above all, is its exact text ("9007199254740993",
+// "12.30"). Nothing is inferred from the kind of JSON token, since a Float
+// column may hold 5124 and a String column 32.38.
+const RELATIONAL_ACTIVITY_TYPE = 'relational';
+/** Thrown when the body can't be read, e.g. a stack trace streamed into a 200 */
+export class V1_CubeUnreadableResultError extends Error {
+}
+const isLosslessNumber = (value) => typeof value === 'object' &&
+    value !== null &&
+    value.isLosslessNumber === true;
+const asObject = (value) => value && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : {};
+const readCell = (value, asNumber) => {
+    if (isLosslessNumber(value)) {
+        return asNumber ? Number(value.value) : value.value;
+    }
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean') {
+        return value;
+    }
+    throw new V1_CubeUnreadableResultError(`A result value is not a scalar: ${JSON.stringify(value)}`);
+};
+/** The columns, rows and SQL of an execution response's text */
+export const V1_readCubeExecutionResult = (text) => {
+    let json;
+    try {
+        json = asObject(parseLosslessJSON(text));
+    }
+    catch (error) {
+        throw new V1_CubeUnreadableResultError(`The engine's response can't be read: ${error.message}`);
+    }
+    const result = asObject(json.result);
+    if (!Array.isArray(result.columns) || !Array.isArray(result.rows)) {
+        throw new V1_CubeUnreadableResultError(`The engine's response has no relation result`);
+    }
+    const columns = result.columns.map((name) => String(name));
+    const builderTypes = new Map((Array.isArray(asObject(json.builder).columns)
+        ? asObject(json.builder).columns
+        : []).map((column) => [
+        String(asObject(column).name),
+        String(asObject(column).type ?? ''),
+    ]));
+    const asNumber = columns.map((name) => {
+        const type = builderTypes.get(name);
+        return type ? resolveCubeType(type).family === TypeFamily.FLOAT : false;
+    });
+    const rows = result.rows.map((row) => {
+        const values = asObject(row).values;
+        if (!Array.isArray(values) || values.length !== columns.length) {
+            throw new V1_CubeUnreadableResultError(`A result row doesn't have one value per column`);
+        }
+        return values.map((value, index) => readCell(value, asNumber[index] ?? false));
+    });
+    const sql = (Array.isArray(json.activities) ? json.activities : [])
+        .map(asObject)
+        .filter((activity) => activity._type === RELATIONAL_ACTIVITY_TYPE)
+        .map((activity) => String(activity.sql));
+    return { columns, rows, sql };
+};
+//# sourceMappingURL=V1_CubeExecutionResultReader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeExecutionResultReader.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeExecutionResultReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAG3E,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,kDAAkD;AAElD,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAQ9C,iFAAiF;AACjF,MAAM,OAAO,4BAA6B,SAAQ,KAAK;CAAG;AAE1D,MAAM,gBAAgB,GAAG,CACvB,KAAc,EACsC,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACb,KAAwC,CAAC,gBAAgB,KAAK,IAAI,CAAC;AAEtE,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAe,EAAE,CAC/C,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IACzD,CAAC,CAAE,KAAqB;IACxB,CAAC,CAAC,EAAE,CAAC;AAET,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,QAAiB,EAAmB,EAAE;IACtE,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACtD,CAAC;IACD,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,4BAA4B,CACpC,mCAAmC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAC3D,CAAC;AACJ,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAAY,EACY,EAAE;IAC1B,IAAI,IAAiB,CAAC;IACtB,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,4BAA4B,CACpC,wCAAyC,KAAe,CAAC,OAAO,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,4BAA4B,CACpC,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;QAC5C,CAAC,CAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAqB;QAC/C,CAAC,CAAC,EAAE,CACL,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAChB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;KACpC,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/D,MAAM,IAAI,4BAA4B,CACpC,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,GAAG,CAAC,QAAQ,CAAC;SACb,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,wBAAwB,CAAC;SACjE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAChC,CAAC,CAAC"}

package/lib/graph-manager/protocol/pure/v1/V1_CubeLambdaSerializer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 type { IR, Origin } from '@finos/legend-cube';
+import { type PlainObject } from '@finos/legend-shared';
+/** The prefix of the source ids Cube stamps, `cube:<nodeId>:<role>` */
+export declare const V1_CUBE_SOURCE_ID_PREFIX = "cube:";
+/** The source id of an origin */
+export declare const V1_buildCubeSourceId: (origin: Origin) => string;
+/**
+ * The origin a source id names, or none when Cube didn't stamp it. A role
+ * never contains `:`, so a node id that does still reads back whole.
+ */
+export declare const V1_parseCubeSourceId: (sourceId: string | undefined) => Origin | undefined;
+/**
+ * The protocol JSON of a lambda Cube emitted (a typing or an execution
+ * lambda), with lossless numbers: write it with `stringifyLosslessJSON`.
+ */
+export declare const V1_serializeCubeLambda: (ir: IR) => PlainObject;
+//# sourceMappingURL=V1_CubeLambdaSerializer.d.ts.map

package/lib/graph-manager/protocol/pure/v1/V1_CubeLambdaSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeLambdaSerializer.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeLambdaSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAgB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAO3E,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAKhD,iCAAiC;AACjC,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MACQ,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,GAAG,SAAS,KAC3B,MAAM,GAAG,SAUX,CAAC;AAqMF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,IAAI,EAAE,KAAG,WAK/C,CAAC"}