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

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;AAsCD,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,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.
+ */
+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[];
+//# 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"}

package/lib/graph-manager/CubeModelOutlineHelper.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.
+ */
+/**
+ * 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));
+//# 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"}

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":"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"}

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"}