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

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

@@ -0,0 +1,195 @@
+/**
+ * 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 { parseLosslessJSON } from '@finos/legend-shared';
+// Cube IR → V1 protocol lambda JSON (PLAN §8.3, §8.5), built as plain JSON,
+// never through legend-graph's value-specification classes, whose serializer
+// drops `sourceInformation`. Numbers are lossless number values, so the
+// request body must be written with `stringifyLosslessJSON`.
+/** The prefix of the source ids Cube stamps, `cube:<nodeId>:<role>` */
+export const V1_CUBE_SOURCE_ID_PREFIX = 'cube:';
+/** A JSON number token: what an integer, float or decimal literal must be */
+const NUMBER_TOKEN = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/u;
+/** The source id of an origin */
+export const V1_buildCubeSourceId = (origin) => `${V1_CUBE_SOURCE_ID_PREFIX}${origin.nodeId}:${origin.role}`;
+/**
+ * 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 const V1_parseCubeSourceId = (sourceId) => {
+    if (!sourceId?.startsWith(V1_CUBE_SOURCE_ID_PREFIX)) {
+        return undefined;
+    }
+    const rest = sourceId.slice(V1_CUBE_SOURCE_ID_PREFIX.length);
+    const at = rest.lastIndexOf(':');
+    if (at <= 0 || at === rest.length - 1) {
+        return undefined;
+    }
+    return { nodeId: rest.slice(0, at), role: rest.slice(at + 1) };
+};
+const stamped = (json, origin) => origin
+    ? {
+        ...json,
+        sourceInformation: { sourceId: V1_buildCubeSourceId(origin) },
+    }
+    : json;
+/** A lossless JSON number for a numeric literal's text, written digit for digit */
+const numberToken = (text) => {
+    if (!NUMBER_TOKEN.test(text)) {
+        throw new Error(`"${text}" is not a number Cube can send`);
+    }
+    return parseLosslessJSON(text);
+};
+const serializeLiteral = (value) => {
+    switch (value.kind) {
+        case 'string':
+        case 'boolean':
+        case 'strictDate':
+        case 'dateTime':
+            return { _type: value.kind, value: value.value };
+        case 'integer':
+        case 'float':
+        case 'decimal':
+            return { _type: value.kind, value: numberToken(value.value) };
+        case 'enum':
+            // enumeration values are emitted as `enumValue`, with their enumeration
+            throw new Error(`Can't send the enumeration value "${value.value}" as a literal`);
+        default: {
+            const unknown = value;
+            throw new Error(`Unknown literal ${JSON.stringify(unknown)}`);
+        }
+    }
+};
+/**
+ * The protocol JSON of an IR node. Every protocol node is stamped with the
+ * origin of its IR node, or else of its nearest ancestor that has one.
+ */
+const serialize = (ir, inherited) => {
+    switch (ir.k) {
+        case 'func': {
+            const origin = ir.origin ?? inherited;
+            return stamped({
+                _type: 'func',
+                function: ir.name,
+                parameters: ir.params.map((param) => serialize(param, origin)),
+            }, origin);
+        }
+        case 'property': {
+            const origin = ir.origin ?? inherited;
+            return stamped({
+                _type: 'property',
+                property: ir.name,
+                parameters: [serialize(ir.receiver, origin)],
+            }, origin);
+        }
+        case 'var':
+            return stamped({ _type: 'var', name: ir.name }, inherited);
+        case 'lambda':
+            return stamped({
+                _type: 'lambda',
+                parameters: ir.params.map((name) => stamped({ _type: 'var', name }, inherited)),
+                body: ir.body.map((statement) => serialize(statement, inherited)),
+            }, inherited);
+        case 'literal':
+            return stamped(serializeLiteral(ir.value), ir.origin ?? inherited);
+        case 'collection':
+            return stamped({
+                _type: 'collection',
+                multiplicity: {
+                    lowerBound: ir.values.length,
+                    upperBound: ir.values.length,
+                },
+                values: ir.values.map((value) => serialize(value, inherited)),
+            }, inherited);
+        case 'colSpec':
+            // the engine reports a missing column on the spec's value, which is
+            // also what a column list holds, so the value is stamped too
+            return stamped({
+                _type: 'classInstance',
+                type: 'colSpec',
+                value: stamped({
+                    name: ir.name,
+                    ...(ir.fn1 ? { function1: serialize(ir.fn1, inherited) } : {}),
+                    ...(ir.fn2 ? { function2: serialize(ir.fn2, inherited) } : {}),
+                }, inherited),
+            }, inherited);
+        case 'colSpecArray':
+            return stamped({
+                _type: 'classInstance',
+                type: 'colSpecArray',
+                value: {
+                    colSpecs: ir.specs.map((spec) => {
+                        if (spec.k !== 'colSpec') {
+                            throw new Error(`A column list holds only column specs, not "${spec.k}"`);
+                        }
+                        return serialize(spec, inherited)
+                            .value;
+                    }),
+                },
+            }, inherited);
+        case 'storeAccessor': {
+            const origin = ir.origin ?? inherited;
+            // the engine reports a wrong database, schema or table on the value
+            return stamped({
+                _type: 'classInstance',
+                type: '>',
+                value: stamped({ path: [...ir.path] }, origin),
+            }, origin);
+        }
+        case 'elementPtr':
+            return stamped({ _type: 'packageableElementPtr', fullPath: ir.path }, inherited);
+        case 'genericType':
+            return stamped({
+                _type: 'genericTypeInstance',
+                genericType: {
+                    rawType: { _type: 'packageableType', fullPath: ir.path },
+                    typeArguments: [],
+                    multiplicityArguments: [],
+                    typeVariableValues: (ir.params ?? []).map((param) => stamped({ _type: 'integer', value: numberToken(String(param)) }, inherited)),
+                },
+            }, inherited);
+        case 'enumValue': {
+            const origin = ir.origin ?? inherited;
+            return stamped({
+                _type: 'property',
+                property: ir.value,
+                parameters: [
+                    stamped({ _type: 'packageableElementPtr', fullPath: ir.enumPath }, origin),
+                ],
+            }, origin);
+        }
+        case 'let':
+        case 'block':
+            // window isolation (PLAN §8.6) comes with Partition, in M5
+            throw new Error(`Can't send "${ir.k}" yet`);
+        case 'raw':
+            return ir.json;
+        default: {
+            const unknown = ir;
+            throw new Error(`Unknown IR ${JSON.stringify(unknown)}`);
+        }
+    }
+};
+/**
+ * The protocol JSON of a lambda Cube emitted (a typing or an execution
+ * lambda), with lossless numbers: write it with `stringifyLosslessJSON`.
+ */
+export const V1_serializeCubeLambda = (ir) => {
+    if (ir.k !== 'lambda') {
+        throw new Error(`Only a lambda can be sent, not "${ir.k}"`);
+    }
+    return serialize(ir, undefined);
+};
+//# sourceMappingURL=V1_CubeLambdaSerializer.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * 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 CubeModelOutline } from '../../../CubeEngine.js';
+/** The outline of a parsed model: its Database elements and its readable runtimes, in model order */
+export declare const V1_buildCubeModelOutline: (modelData: PlainObject) => CubeModelOutline;
+//# sourceMappingURL=V1_CubeModelOutlineBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeModelOutlineBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeModelOutlineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAEL,KAAK,gBAAgB,EAMtB,MAAM,wBAAwB,CAAC;AA4LhC,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,GACnC,WAAW,WAAW,KACrB,gBAyBF,CAAC"}

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

@@ -0,0 +1,174 @@
+/**
+ * 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 { getRelationalDisplayName } from '@finos/legend-cube';
+import { CubeTableFlag, } from '../../../CubeEngine.js';
+// The databases and runtimes of a parsed model (`{_type: 'data', elements}`),
+// for the source picker (PLAN §6.2.3-§6.2.6). Read as plain JSON: only names,
+// column types and store paths are needed, and an element's full protocol
+// deserializer needs the graph manager's plugins.
+const DATABASE_TYPE = 'relational';
+const RUNTIME_TYPE = 'runtime';
+const CONNECTION_TYPE = 'connection';
+const CONNECTION_POINTER_TYPE = 'connectionPointer';
+const RELATIONAL_CONNECTION_TYPE = 'RelationalDatabaseConnection';
+/** The only runtime value whose store keys Cube can read; others are hidden */
+const ENGINE_RUNTIME_TYPE = 'engineRuntime';
+/** The flag a column type gives its table, if any (PLAN §6.2.6) */
+const COLUMN_TYPE_FLAGS = {
+    // the engine fails to type the whole table
+    Binary: CubeTableFlag.UNAVAILABLE,
+    Varbinary: CubeTableFlag.UNAVAILABLE,
+    // typed with a length of 1
+    Char: CubeTableFlag.LENGTH_UNKNOWN,
+    // an ARRAY column is parsed as Other; both are typed as a bare String
+    Other: CubeTableFlag.TYPE_UNKNOWN,
+};
+const asObject = (value) => value && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : {};
+const asList = (value) => Array.isArray(value) ? value : [];
+const asString = (value) => typeof value === 'string' ? value : undefined;
+const elementPath = (element) => {
+    const name = asString(element.name) ?? '';
+    const pkg = asString(element.package);
+    return pkg ? `${pkg}::${name}` : name;
+};
+const buildTable = (json) => {
+    const table = asObject(json);
+    const columns = asList(table.columns).map(asObject);
+    const flags = new Set();
+    const untypedColumns = [];
+    columns.forEach((column) => {
+        const flag = COLUMN_TYPE_FLAGS[asString(asObject(column.type)._type) ?? ''];
+        if (flag) {
+            flags.add(flag);
+        }
+        if (flag === CubeTableFlag.TYPE_UNKNOWN) {
+            // unquoted, as the engine names the column in the table's schema
+            untypedColumns.push(getRelationalDisplayName(asString(column.name) ?? ''));
+        }
+    });
+    return {
+        name: asString(table.name) ?? '',
+        isView: false,
+        columnCount: columns.length,
+        flags: Object.values(CubeTableFlag).filter((flag) => flags.has(flag)),
+        untypedColumns,
+    };
+};
+const buildView = (json) => {
+    const view = asObject(json);
+    return {
+        name: asString(view.name) ?? '',
+        isView: true,
+        columnCount: asList(view.columnMappings).length,
+        flags: [],
+        untypedColumns: [],
+    };
+};
+const buildSchema = (json) => {
+    const schema = asObject(json);
+    return {
+        name: asString(schema.name) ?? '',
+        tables: [
+            ...asList(schema.tables).map(buildTable),
+            ...asList(schema.views).map(buildView),
+        ],
+    };
+};
+const buildDatabase = (element) => ({
+    path: elementPath(element),
+    // included stores are not followed (v1)
+    schemas: asList(element.schemas).map(buildSchema),
+});
+/** The database type of a relational connection value: its `type`, else its `databaseType` */
+const getRelationalDatabaseType = (value) => value._type === RELATIONAL_CONNECTION_TYPE
+    ? (asString(value.type) ?? asString(value.databaseType))
+    : undefined;
+/**
+ * The database type of a runtime's connection, embedded or a pointer to a
+ * connection element (`connectionTypes`, by path); none for one that isn't
+ * relational
+ */
+const getConnectionDatabaseType = (json, connectionTypes) => {
+    const connection = asObject(json);
+    if (connection._type === CONNECTION_POINTER_TYPE) {
+        const path = asString(connection.connection);
+        return path === undefined ? undefined : connectionTypes.get(path);
+    }
+    return getRelationalDatabaseType(connection);
+};
+/** The stores a runtime's connections are keyed by, in both syntaxes; none when it can't be read */
+const buildRuntime = (element, connectionTypes) => {
+    const value = asObject(element.runtimeValue);
+    if (value._type !== ENGINE_RUNTIME_TYPE) {
+        return undefined;
+    }
+    const storePaths = [
+        // `connections: [<store>: [...]]`
+        ...asList(value.connections).map((connection) => asString(asObject(asObject(connection).store).path)),
+        // `connectionStores: [<connection>: [<store>, ...]]`
+        ...asList(value.connectionStores).flatMap((connectionStore) => asList(asObject(connectionStore).storePointers).map((pointer) => asString(asObject(pointer).path))),
+    ].filter((path) => path !== undefined);
+    const connections = [];
+    const addConnection = (storePath, databaseType) => {
+        if (storePath !== undefined &&
+            databaseType !== undefined &&
+            !connections.some((connection) => connection.storePath === storePath &&
+                connection.databaseType === databaseType)) {
+            connections.push({ storePath, databaseType });
+        }
+    };
+    asList(value.connections).forEach((json) => {
+        const storeConnections = asObject(json);
+        const storePath = asString(asObject(storeConnections.store).path);
+        asList(storeConnections.storeConnections).forEach((identified) => addConnection(storePath, getConnectionDatabaseType(asObject(identified).connection, connectionTypes)));
+    });
+    asList(value.connectionStores).forEach((json) => {
+        const connectionStore = asObject(json);
+        const databaseType = getConnectionDatabaseType(connectionStore.connectionPointer, connectionTypes);
+        asList(connectionStore.storePointers).forEach((pointer) => addConnection(asString(asObject(pointer).path), databaseType));
+    });
+    return {
+        path: elementPath(element),
+        storePaths: [...new Set(storePaths)],
+        connections,
+    };
+};
+/** The outline of a parsed model: its Database elements and its readable runtimes, in model order */
+export const V1_buildCubeModelOutline = (modelData) => {
+    const elements = asList(modelData.elements).map(asObject);
+    // the database type of each relational connection element, by path
+    const connectionTypes = new Map();
+    elements
+        .filter((element) => element._type === CONNECTION_TYPE)
+        .forEach((element) => {
+        const databaseType = getRelationalDatabaseType(asObject(element.connectionValue));
+        if (databaseType !== undefined) {
+            connectionTypes.set(elementPath(element), databaseType);
+        }
+    });
+    return {
+        databases: elements
+            .filter((element) => element._type === DATABASE_TYPE)
+            .map(buildDatabase),
+        runtimes: elements
+            .filter((element) => element._type === RUNTIME_TYPE)
+            .map((element) => buildRuntime(element, connectionTypes))
+            .filter((runtime) => runtime !== undefined),
+    };
+};
+//# sourceMappingURL=V1_CubeModelOutlineBuilder.js.map

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

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

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

@@ -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.
+ */
+import { Schema } from '@finos/legend-cube';
+import type { PlainObject } from '@finos/legend-shared';
+/**
+ * The schema of a relation type: one column per relation column, in order,
+ * typed by its path and parameters (an unknown type is opaque) and nullable
+ * when it may be empty
+ */
+export declare const V1_buildCubeSchema: (json: PlainObject) => Schema;
+//# sourceMappingURL=V1_CubeRelationTypeAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeRelationTypeAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeRelationTypeAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAM3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAOxD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,WAAW,KAAG,MAuBtD,CAAC"}

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

@@ -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 { resolveCubeType, Schema, SchemaColumn } from '@finos/legend-cube';
+import { V1_CInteger, V1_PackageableType, V1_relationTypeModelSchema, } from '@finos/legend-graph';
+import { deserialize } from 'serializr';
+// The engine's relation type → a Cube schema (PLAN §6.2.6), read through
+// legend-graph's protocol schema. Its graph-manager wrappers are bypassed:
+// they drop type parameters (D8).
+/**
+ * The schema of a relation type: one column per relation column, in order,
+ * typed by its path and parameters (an unknown type is opaque) and nullable
+ * when it may be empty
+ */
+export const V1_buildCubeSchema = (json) => {
+    const relationType = deserialize(V1_relationTypeModelSchema, json);
+    return new Schema(relationType.columns.map((column) => {
+        const { rawType, typeVariableValues } = column.genericType;
+        if (!(rawType instanceof V1_PackageableType)) {
+            throw new Error(`Column "${column.name}" has a type Cube can't read`);
+        }
+        const params = typeVariableValues.map((value) => {
+            if (!(value instanceof V1_CInteger)) {
+                throw new Error(`Column "${column.name}" has a type parameter Cube can't read`);
+            }
+            return value.value;
+        });
+        return new SchemaColumn(column.name, resolveCubeType(rawType.fullPath, params), column.multiplicity.lowerBound === 0);
+    }));
+};
+//# sourceMappingURL=V1_CubeRelationTypeAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeRelationTypeAdapter.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeRelationTypeAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,yEAAyE;AACzE,2EAA2E;AAC3E,kCAAkC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAiB,EAAU,EAAE;IAC9D,MAAM,YAAY,GAAG,WAAW,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,IAAI,MAAM,CACf,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC3D,IAAI,CAAC,CAAC,OAAO,YAAY,kBAAkB,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,8BAA8B,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9C,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,CAAC,IAAI,wCAAwC,CAC/D,CAAC;YACJ,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,YAAY,CACrB,MAAM,CAAC,IAAI,EACX,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EACzC,MAAM,CAAC,YAAY,CAAC,UAAU,KAAK,CAAC,CACrC,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

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

@@ -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.
+ */
+import { type IR, type ModelContext, type Schema } from '@finos/legend-cube';
+import { V1_EngineServerClient } from '@finos/legend-graph';
+import { type TracerService } from '@finos/legend-shared';
+import { type AccessorPath, type CubeEngine, CubeEngineError, type CubeModelOutline, type CubeResult, type NodeId } from '../../../CubeEngine.js';
+/** The engine client's configuration, as the host gives it (legend-graph doesn't export its type) */
+export type V1_CubeEngineConfig = ConstructorParameters<typeof V1_EngineServerClient>[0];
+/** The message for a model of a kind this version can't run (PLAN §8.7) */
+export declare const V1_unsupportedModelMessage: (type: string) => string;
+/**
+ * The Legend engine behind the Cube engine port (PLAN §8.7). It sends the
+ * cube's saved model context as it is, lambdas as protocol JSON with lossless
+ * numbers, and reads every response itself: the graph manager's wrappers drop
+ * type parameters and read numbers lossily (D8).
+ */
+export declare class V1_LegendCubeEngine implements CubeEngine {
+    readonly client: V1_EngineServerClient;
+    constructor(config: V1_CubeEngineConfig, tracerService: TracerService);
+    /** The model's Pure text, or an unsupported-model error for any other kind */
+    private textOf;
+    loadModel(model: ModelContext): Promise<CubeModelOutline>;
+    resolveSchemas(model: ModelContext, accessors: ReadonlyMap<NodeId, AccessorPath>): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    typeLambdas(model: ModelContext, lambdas: ReadonlyMap<NodeId, IR>): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    /** Types every lambda in one batch call: one entry per key, whatever fails */
+    private typeAll;
+    execute(model: ModelContext, executionLambda: IR, options?: {
+        abortController?: AbortController | undefined;
+    }): Promise<CubeResult>;
+    renderPure(lambdaIR: IR): Promise<string>;
+}
+//# sourceMappingURL=V1_LegendCubeEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_LegendCubeEngine.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_LegendCubeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,EAAE,EAEP,KAAK,YAAY,EACjB,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAkB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,eAAe,EAEf,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAahC,qGAAqG;AACrG,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CACrD,OAAO,qBAAqB,CAC7B,CAAC,CAAC,CAAC,CAAC;AAiBL,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,KAAG,MACD,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;gBAE3B,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa;IAMrE,8EAA8E;IAC9E,OAAO,CAAC,MAAM;IAWR,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW/D,cAAc,CACZ,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,GAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC;IAejD,WAAW,CACT,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,GAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC;IAIjD,8EAA8E;YAChE,OAAO;IA0Ef,OAAO,CACX,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,EAAE,EACnB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,GAC1D,OAAO,CAAC,UAAU,CAAC;IA8ChB,UAAU,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAchD"}