@finos/legend-cube-builder 0.0.3 → 0.0.5

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

@@ -0,0 +1,246 @@
+/**
+ * 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 { CubeConnectionDatasourceKind, CubeDirectDatabaseType, } from '../../../CubeConnectionExplorer.js';
+// A direct connection's protocol JSON (PLAN §6.8), read and written as plain
+// JSON. legend-graph's connection serializers are not used: they drop a DuckDB
+// connection's setup SQL and an H2 one's identifier setting, and a saved
+// connection must reach the engine exactly as it was saved. A connection is
+// checked against what Cube supports, and anything else is refused, never
+// dropped, since an imported cube is saved again unchanged
+const CONNECTION_TYPE = 'RelationalDatabaseConnection';
+const H2_DATASOURCE_TYPE = 'h2Local';
+const DUCKDB_DATASOURCE_TYPE = 'duckDB';
+const H2_DEFAULT_AUTHENTICATION_TYPE = 'h2Default';
+const TEST_AUTHENTICATION_TYPE = 'test';
+/** Where the engine records source positions: kept, and ignored when comparing */
+const SOURCE_INFORMATION_KEYS = [
+    'sourceInformation',
+    'elementSourceInformation',
+];
+/** The store the connection is bound to: set only in the model built for each call */
+const ELEMENT_KEY = 'element';
+/** The authentication strategies, as the engine names them, each database allows */
+const AUTHENTICATION_TYPES = {
+    [CubeDirectDatabaseType.H2]: [
+        H2_DEFAULT_AUTHENTICATION_TYPE,
+        TEST_AUTHENTICATION_TYPE,
+    ],
+    [CubeDirectDatabaseType.DUCKDB]: [TEST_AUTHENTICATION_TYPE],
+};
+const isEmptyList = (value) => value === undefined ||
+    value === null ||
+    (Array.isArray(value) && value.length === 0);
+/**
+ * Connection settings Cube doesn't support yet, accepted only at the engine's
+ * default value: each changes how a query runs, in ways Cube doesn't show
+ */
+const UNSUPPORTED_SETTINGS = {
+    localMode: (value) => value === undefined || value === null || value === false,
+    quoteIdentifiers: (value) => value === undefined || value === null || value === false,
+    timeZone: (value) => value === undefined || value === null,
+    queryTimeOutInSeconds: (value) => value === undefined || value === null,
+    queryGenerationConfigs: (value) => isEmptyList(value),
+    // a schema mapper ran a query on another schema with no error
+    postProcessors: (value) => isEmptyList(value),
+    postProcessorWithParameter: (value) => isEmptyList(value),
+};
+const isObject = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const isDatabaseType = (value) => Object.values(CubeDirectDatabaseType).includes(value);
+const isStatementList = (value) => Array.isArray(value) &&
+    value.every((statement) => typeof statement === 'string');
+/** The keys of an object that are neither expected nor source information */
+const unexpectedKeys = (object, expected) => Object.keys(object).filter((key) => !expected.includes(key) && !SOURCE_INFORMATION_KEYS.includes(key));
+const checkDatasource = (databaseType, datasource) => {
+    const problems = [];
+    // a CSV setup is the engine's own SQL generation, which lost rows in tests
+    if (datasource.testDataSetupCsv !== undefined &&
+        datasource.testDataSetupCsv !== null &&
+        datasource.testDataSetupCsv !== '') {
+        problems.push("The connection sets up its data from CSV, which Cube doesn't support: use setup SQL statements");
+    }
+    if (databaseType === CubeDirectDatabaseType.H2) {
+        if (datasource._type !== H2_DATASOURCE_TYPE) {
+            problems.push('An H2 connection must use a local H2 database, created by its setup SQL');
+            return problems;
+        }
+        if (datasource.disableDatabaseToUpper !== undefined &&
+            datasource.disableDatabaseToUpper !== null &&
+            datasource.disableDatabaseToUpper !== false) {
+            problems.push("The connection keeps H2 from upper-casing names, which Cube doesn't support");
+        }
+        if (!isStatementList(datasource.testDataSetupSqls) ||
+            datasource.testDataSetupSqls.length === 0) {
+            // without setup SQL the engine connects to an H2 server that isn't there
+            problems.push('An H2 connection needs at least one setup SQL statement');
+        }
+        unexpectedKeys(datasource, [
+            '_type',
+            'testDataSetupSqls',
+            'testDataSetupCsv',
+            'disableDatabaseToUpper',
+        ]).forEach((key) => problems.push(`The connection's database has a property Cube doesn't know: "${key}"`));
+    }
+    else {
+        if (datasource._type !== DUCKDB_DATASOURCE_TYPE) {
+            problems.push('A DuckDB connection must name a DuckDB database file, or none for an in-memory database');
+            return problems;
+        }
+        if (typeof datasource.path !== 'string') {
+            problems.push('A DuckDB connection must name a database file, or none for an in-memory database');
+        }
+        if (datasource.testDataSetupSqls !== undefined &&
+            !isStatementList(datasource.testDataSetupSqls)) {
+            problems.push("The connection's setup SQL must be a list of statements");
+        }
+        unexpectedKeys(datasource, [
+            '_type',
+            'path',
+            'testDataSetupSqls',
+            'testDataSetupCsv',
+        ]).forEach((key) => problems.push(`The connection's database has a property Cube doesn't know: "${key}"`));
+    }
+    return problems;
+};
+const checkAuthentication = (databaseType, authentication) => {
+    const allowed = AUTHENTICATION_TYPES[databaseType];
+    if (!allowed.includes(authentication._type)) {
+        return [
+            `${databaseType === CubeDirectDatabaseType.H2 ? 'An' : 'A'} ${databaseType} connection's authentication must be ${allowed
+                .map((type) => `"${type}"`)
+                .join(' or ')}`,
+        ];
+    }
+    // these strategies take no settings, so no secret can be saved with them
+    return unexpectedKeys(authentication, ['_type']).map((key) => `The connection's authentication has a property Cube doesn't know: "${key}"`);
+};
+/**
+ * What keeps Cube from using a connection, in words a user can act on: none
+ * when the connection is one Cube supports. Values are never repeated, only
+ * the names of properties, since a property Cube doesn't know could hold a
+ * secret
+ */
+export const V1_checkCubeDirectConnection = (connection) => {
+    if (!isObject(connection) || connection._type !== CONNECTION_TYPE) {
+        return ['The connection is not a relational database connection'];
+    }
+    const { type, databaseType } = connection;
+    if (!isDatabaseType(databaseType)) {
+        return [
+            `Cube connects to H2 and DuckDB databases only, not to "${String(databaseType)}"`,
+        ];
+    }
+    const problems = [];
+    if (type !== databaseType) {
+        problems.push("The connection's type and database type must be the same database");
+    }
+    Object.entries(UNSUPPORTED_SETTINGS).forEach(([key, isDefault]) => {
+        if (!isDefault(connection[key])) {
+            problems.push(`The connection sets "${key}", which Cube doesn't support`);
+        }
+    });
+    unexpectedKeys(connection, [
+        '_type',
+        'type',
+        'databaseType',
+        'datasourceSpecification',
+        'authenticationStrategy',
+        ELEMENT_KEY,
+        ...Object.keys(UNSUPPORTED_SETTINGS),
+    ]).forEach((key) => problems.push(`The connection has a property Cube doesn't know: "${key}"`));
+    if (isObject(connection.datasourceSpecification)) {
+        problems.push(...checkDatasource(databaseType, connection.datasourceSpecification));
+    }
+    else {
+        problems.push("The connection doesn't say how to reach its database");
+    }
+    if (isObject(connection.authenticationStrategy)) {
+        problems.push(...checkAuthentication(databaseType, connection.authenticationStrategy));
+    }
+    else {
+        problems.push("The connection doesn't say how to authenticate");
+    }
+    return problems;
+};
+/**
+ * The connection the form describes, as the engine reads it. It names no
+ * store: each call binds it to the Database built for that call
+ */
+export const V1_buildCubeDirectConnection = (draft) => {
+    const setupSqls = [...draft.setupSqls];
+    return draft.databaseType === CubeDirectDatabaseType.H2
+        ? {
+            _type: CONNECTION_TYPE,
+            type: CubeDirectDatabaseType.H2,
+            databaseType: CubeDirectDatabaseType.H2,
+            datasourceSpecification: {
+                _type: H2_DATASOURCE_TYPE,
+                testDataSetupSqls: setupSqls,
+            },
+            authenticationStrategy: { _type: H2_DEFAULT_AUTHENTICATION_TYPE },
+        }
+        : {
+            _type: CONNECTION_TYPE,
+            type: CubeDirectDatabaseType.DUCKDB,
+            databaseType: CubeDirectDatabaseType.DUCKDB,
+            datasourceSpecification: {
+                _type: DUCKDB_DATASOURCE_TYPE,
+                path: draft.path ?? '',
+                ...(setupSqls.length ? { testDataSetupSqls: setupSqls } : {}),
+            },
+            authenticationStrategy: { _type: TEST_AUTHENTICATION_TYPE },
+        };
+};
+/**
+ * What the page shows of a connection Cube supports (see
+ * `V1_checkCubeDirectConnection`): never its setup SQL
+ */
+export const V1_summarizeCubeDirectConnection = (connection) => {
+    const databaseType = connection.databaseType;
+    const datasource = connection.datasourceSpecification;
+    const authentication = connection.authenticationStrategy;
+    const path = typeof datasource.path === 'string' ? datasource.path : '';
+    const setupSqls = datasource.testDataSetupSqls;
+    return {
+        databaseType,
+        datasourceKind: databaseType === CubeDirectDatabaseType.H2
+            ? CubeConnectionDatasourceKind.LOCAL_H2
+            : path
+                ? CubeConnectionDatasourceKind.DUCKDB_FILE
+                : CubeConnectionDatasourceKind.DUCKDB_IN_MEMORY,
+        path: databaseType === CubeDirectDatabaseType.DUCKDB && path ? path : undefined,
+        setupSqlCount: Array.isArray(setupSqls) ? setupSqls.length : 0,
+        authenticationKind: String(authentication._type),
+    };
+};
+const canonicalValue = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(canonicalValue);
+    }
+    if (isObject(value)) {
+        return Object.fromEntries(Object.keys(value)
+            .filter((key) => key !== ELEMENT_KEY && !SOURCE_INFORMATION_KEYS.includes(key))
+            .sort()
+            .map((key) => [key, canonicalValue(value[key])]));
+    }
+    return value;
+};
+/**
+ * A connection as text that two connections share exactly when they reach the
+ * same database the same way: key order, the bound store and source
+ * positions don't count. Used to compare connections and to key caches
+ */
+export const V1_canonicalCubeDirectConnection = (connection) => JSON.stringify(canonicalValue(connection));
+//# sourceMappingURL=V1_CubeDirectConnection.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * 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 } from '@finos/legend-cube';
+import type { PlainObject } from '@finos/legend-shared';
+import type { CubeDirectConnection } from '../../../CubeConnectionExplorer.js';
+import type { AccessorPath } from '../../../CubeEngine.js';
+import { type V1_CubeExploredTablePath } from './V1_CubeSchemaExploration.js';
+/** A table of the built Database, as read from the connection's database */
+export interface V1_CubeDirectTable {
+    /** As the database stores them */
+    path: V1_CubeExploredTablePath;
+    /** The table's definition, every name quoted, without the columns Cube hides */
+    definition: PlainObject;
+}
+/** The built Database's package and name, which schema exploration takes */
+export declare const V1_CUBE_DIRECT_DATABASE: {
+    package: string;
+    name: string;
+};
+/**
+ * The store accessors of a lambda, each once: found anywhere in it, so a new
+ * kind of IR node needs nothing here
+ */
+export declare const V1_collectCubeStoreAccessors: (ir: IR) => readonly AccessorPath[];
+/**
+ * The model of one call: the tables in a fixed order (by schema, then table),
+ * so the same tables always give the same model
+ */
+export declare const V1_buildCubeDirectModelContext: (connection: CubeDirectConnection, tables: readonly V1_CubeDirectTable[]) => PlainObject;
+//# sourceMappingURL=V1_CubeDirectModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDirectModel.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeDirectModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAM/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,+BAA+B,CAAC;AAQvC,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,gFAAgF;IAChF,UAAU,EAAE,WAAW,CAAC;CACzB;AAUD,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB;aATS,MAAM;UAAQ,MAAM;CASU,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,IAAI,EAAE,KACL,SAAS,YAAY,EAuBvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACzC,YAAY,oBAAoB,EAChC,QAAQ,SAAS,kBAAkB,EAAE,KACpC,WAyDF,CAAC"}

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

@@ -0,0 +1,112 @@
+/**
+ * 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 { CUBE_DIRECT_CONNECTION_PATH, CUBE_DIRECT_DATABASE_PATH, CUBE_DIRECT_RUNTIME_PATH, } from '../../../CubeDirectConnection.js';
+import { V1_quoteCubeName, } from './V1_CubeSchemaExploration.js';
+const splitPath = (path) => {
+    const index = path.lastIndexOf('::');
+    return { package: path.slice(0, index), name: path.slice(index + 2) };
+};
+/** By code point, the same in every locale */
+const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+/** The built Database's package and name, which schema exploration takes */
+export const V1_CUBE_DIRECT_DATABASE = splitPath(CUBE_DIRECT_DATABASE_PATH);
+/**
+ * The store accessors of a lambda, each once: found anywhere in it, so a new
+ * kind of IR node needs nothing here
+ */
+export const V1_collectCubeStoreAccessors = (ir) => {
+    const found = new Map();
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            value.forEach(visit);
+            return;
+        }
+        if (!value || typeof value !== 'object') {
+            return;
+        }
+        const node = value;
+        if (node.k === 'storeAccessor' && Array.isArray(node.path)) {
+            const path = node.path;
+            found.set(JSON.stringify(path), path);
+            return;
+        }
+        if (node.k === 'raw') {
+            return;
+        }
+        Object.values(node).forEach(visit);
+    };
+    visit(ir);
+    return [...found.values()];
+};
+/**
+ * The model of one call: the tables in a fixed order (by schema, then table),
+ * so the same tables always give the same model
+ */
+export const V1_buildCubeDirectModelContext = (connection, tables) => {
+    const schemas = new Map();
+    [...tables]
+        .sort((a, b) => compare(a.path[0], b.path[0]) || compare(a.path[1], b.path[1]))
+        .forEach(({ path: [schema], definition }) => schemas.set(schema, [...(schemas.get(schema) ?? []), definition]));
+    return {
+        _type: 'data',
+        elements: [
+            {
+                _type: 'relational',
+                ...splitPath(CUBE_DIRECT_DATABASE_PATH),
+                includedStores: [],
+                filters: [],
+                joins: [],
+                stereotypes: [],
+                schemas: [...schemas.entries()].map(([schema, definitions]) => ({
+                    name: V1_quoteCubeName(schema),
+                    tables: definitions,
+                    views: [],
+                    tabularFunctions: [],
+                })),
+            },
+            {
+                _type: 'connection',
+                ...splitPath(CUBE_DIRECT_CONNECTION_PATH),
+                // bound to the built Database: the engine needs the store it serves
+                connectionValue: { ...connection, element: CUBE_DIRECT_DATABASE_PATH },
+            },
+            {
+                _type: 'runtime',
+                ...splitPath(CUBE_DIRECT_RUNTIME_PATH),
+                runtimeValue: {
+                    _type: 'engineRuntime',
+                    mappings: [],
+                    connectionStores: [],
+                    connections: [
+                        {
+                            store: { type: 'STORE', path: CUBE_DIRECT_DATABASE_PATH },
+                            storeConnections: [
+                                {
+                                    id: 'connection',
+                                    connection: {
+                                        _type: 'connectionPointer',
+                                        connection: CUBE_DIRECT_CONNECTION_PATH,
+                                    },
+                                },
+                            ],
+                        },
+                    ],
+                },
+            },
+        ],
+    };
+};
+//# sourceMappingURL=V1_CubeDirectModel.js.map

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

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

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

@@ -1 +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"}
+{"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,EAEnB,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAuEhC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,EAChB,gBAAgB,MAAM,GAAG,SAAS,EAClC,MAAM,mBAAmB,KACxB,eAAe,GAAG,SAepB,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

@@ -21,6 +21,26 @@ import { V1_parseCubeSourceId } from './V1_CubeLambdaSerializer.js';
 // 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 message when it can't fetch a pointer's project, e.g. a depot
+ * that is down or a version it doesn't have: HTML, with the URL it tried
+ */
+const DEPOT_FAILURE = /unable to load information from the Pure SDLC(?: using: <a href='(?<url>[^']*)')?/u;
+/** Where the source information says the error is, when it gives every line and column */
+const readLocation = (sourceInformation) => {
+    const { sourceId, startLine, startColumn, endLine, endColumn } = sourceInformation;
+    const lines = [startLine, startColumn, endLine, endColumn];
+    return typeof sourceId === 'string' &&
+        lines.every((value) => Number.isInteger(Number(value)) && Number(value) > 0)
+        ? {
+            sourceId,
+            startLine: Number(startLine),
+            startColumn: Number(startColumn),
+            endLine: Number(endLine),
+            endColumn: Number(endColumn),
+        }
+        : undefined;
+};
 /** The engine's error payload: `{message, errorType?, sourceInformation?, trace?}` */
 const readPayload = (payload) => {
     if (!payload || typeof payload !== 'object') {
@@ -30,13 +50,19 @@ const readPayload = (payload) => {
     if (typeof message !== 'string' || !message.trim()) {
         return undefined;
     }
-    const sourceId = sourceInformation && typeof sourceInformation === 'object'
-        ? sourceInformation.sourceId
+    const depotFailure = DEPOT_FAILURE.exec(message);
+    const located = sourceInformation && typeof sourceInformation === 'object'
+        ? sourceInformation
         : undefined;
+    const sourceId = located?.sourceId;
+    const location = located ? readLocation(located) : undefined;
     return {
-        message,
+        message: depotFailure
+            ? `The engine couldn't load the cube's project from its depot${depotFailure.groups?.url ? ` (${depotFailure.groups.url})` : ''}: check that the version is published and the depot can be reached`
+            : message,
         ...(typeof errorType === 'string' ? { errorType } : {}),
         ...(typeof sourceId === 'string' ? { sourceId } : {}),
+        ...(location ? { location } : {}),
     };
 };
 /**
@@ -51,7 +77,7 @@ export const V1_buildCubeEngineError = (payload, fallbackNodeId, kind) => {
     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);
+        : kind, read.message, origin?.nodeId ?? fallbackNodeId, origin?.role, read.location);
 };
 /**
  * The error of a failed engine call: the engine's own message when it sent

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

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

@@ -0,0 +1,23 @@
+/**
+ * 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 { CubeParsedExpression } from '../../../CubeEngine.js';
+/**
+ * An expression as the engine's lossless JSON gives it: located, as parsed,
+ * and as a column stores it, without source information. Anything but an
+ * object is the engine's mistake.
+ */
+export declare const V1_readCubeExpression: (json: unknown) => CubeParsedExpression;
+//# sourceMappingURL=V1_CubeExpression.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeExpression.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeExpression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqDnE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,OAAO,KAAG,oBASrD,CAAC"}

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

@@ -0,0 +1,68 @@
+/**
+ * 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 { isJsonObject, } from '@finos/legend-cube';
+// An Extend column's expression (PLAN §11.7) as the engine parses it, read
+// losslessly: number literals keep their digits as strings, as Cube keeps
+// literal values (PLAN §4.9), and the serializer writes them back as numbers.
+const NUMBER_LITERAL_TYPES = [
+    'integer',
+    'float',
+    'decimal',
+];
+const isLosslessNumber = (value) => typeof value === 'object' &&
+    value !== null &&
+    value.isLosslessNumber === true;
+/** The JSON with every lossless number a JS number, but a number literal's value its digit string */
+const read = (json, inLiteral) => {
+    if (isLosslessNumber(json)) {
+        return inLiteral ? json.value : Number(json.value);
+    }
+    if (Array.isArray(json)) {
+        return json.map((item) => read(item, false));
+    }
+    if (typeof json === 'object' && json !== null) {
+        const literal = NUMBER_LITERAL_TYPES.includes(json._type);
+        return Object.fromEntries(Object.entries(json).map(([key, value]) => [
+            key,
+            read(value, literal && key === 'value'),
+        ]));
+    }
+    return json;
+};
+/** The JSON without any source information, at every depth */
+const withoutSourceInformation = (json) => Array.isArray(json)
+    ? json.map(withoutSourceInformation)
+    : isJsonObject(json)
+        ? Object.fromEntries(Object.entries(json)
+            .filter(([key]) => key !== 'sourceInformation')
+            .map(([key, value]) => [key, withoutSourceInformation(value)]))
+        : json;
+/**
+ * An expression as the engine's lossless JSON gives it: located, as parsed,
+ * and as a column stores it, without source information. Anything but an
+ * object is the engine's mistake.
+ */
+export const V1_readCubeExpression = (json) => {
+    const located = read(json, false);
+    if (!isJsonObject(located)) {
+        throw new Error(`The engine parsed the expression as no object`);
+    }
+    return {
+        located,
+        lambda: withoutSourceInformation(located),
+    };
+};
+//# sourceMappingURL=V1_CubeExpression.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeExpression.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeExpression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAG5B,2EAA2E;AAC3E,0EAA0E;AAC1E,8EAA8E;AAE9E,MAAM,oBAAoB,GAAuB;IAC/C,SAAS;IACT,OAAO;IACP,SAAS;CACV,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,KAAc,EACsC,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACb,KAAwC,CAAC,gBAAgB,KAAK,IAAI,CAAC;AAEtE,qGAAqG;AACrG,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,SAAkB,EAAa,EAAE;IAC5D,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAC1C,IAA4B,CAAC,KAAK,CACpC,CAAC;QACF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACzC,GAAG;YACH,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,KAAK,OAAO,CAAC;SACxC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,IAAiB,CAAC;AAC3B,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,wBAAwB,GAAG,CAAC,IAAe,EAAa,EAAE,CAC9D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;IACjB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACpC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;aACjB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,mBAAmB,CAAC;aAC9C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CACjE;QACH,CAAC,CAAC,IAAI,CAAC;AAEb;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAa,EAAwB,EAAE;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO;QACL,OAAO;QACP,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAe;KACxD,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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 { PlainObject } from '@finos/legend-shared';
+import type { CubeOutlineFunction } from '../../../CubeEngine.js';
+export declare const V1_CUBE_FUNCTION_PROBLEM: {
+    readonly PARAMETER_TYPE: (name: string, type: string) => string;
+    readonly PARAMETER_MULTIPLICITY: (name: string, multiplicity: string) => string;
+    readonly RUNTIME_NOT_AN_ELEMENT: "It reads through a runtime given by an expression, which Cube can't tell";
+    readonly TWO_RUNTIMES: (runtimes: readonly string[]) => string;
+};
+/**
+ * The model's functions that return a relation, `[1]`, in model order: those
+ * of `listed`, with the runtimes read through every function of `all` (a
+ * project's own functions, and its dependencies' too)
+ */
+export declare const V1_buildCubeFunctionOutlines: (listed: readonly PlainObject[], all?: readonly PlainObject[]) => CubeOutlineFunction[];
+//# sourceMappingURL=V1_CubeFunctionOutlineBuilder.d.ts.map