@finos/legend-cube-builder 0.0.2 → 0.0.4

package/lib/__test-utils__/CubeExpressionTestUtils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 { Extend, type JsonObject, type Query } from '@finos/legend-cube';
+/** `x | <body>` and the pieces of a body */
+export declare const TEST__expression: {
+    lambda: (body: JsonObject) => JsonObject;
+    /** `$x.<name>` */
+    column: (name: string) => JsonObject;
+    call: (name: string, ...parameters: JsonObject[]) => JsonObject;
+    /** The two operands of `+`, `*`, … */
+    pair: (first: JsonObject, second: JsonObject) => JsonObject;
+    integer: (value: number) => JsonObject;
+};
+/** A new column: its name, its lambda, and the type the engine gives it */
+export type TEST__ExtendColumn = readonly [string, JsonObject, string];
+/**
+ * An Extend of these columns, typed as given for the input Cube infers for
+ * `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the types are the engine's. With an invalid input, untyped.
+ */
+export declare const TEST__typedExtend: (id: string, input: Query, columns: readonly TEST__ExtendColumn[]) => Extend;
+/** `a: x | $x.ORDER_ID + 1` and `b: x | $x.a * 2`, the second using the first, both Integer */
+export declare const TEST__ORDER_ID_EXTEND_COLUMNS: readonly TEST__ExtendColumn[];
+//# sourceMappingURL=CubeExpressionTestUtils.d.ts.map

package/lib/__test-utils__/CubeExpressionTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExpressionTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeExpressionTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,MAAM,EAEN,KAAK,UAAU,EAEf,KAAK,KAAK,EACX,MAAM,oBAAoB,CAAC;AAK5B,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;mBACZ,UAAU,KAAG,UAAU;IAKtC,kBAAkB;mBACH,MAAM,KAAG,UAAU;iBAKrB,MAAM,iBAAiB,UAAU,EAAE,KAAG,UAAU;IAK7D,sCAAsC;kBACxB,UAAU,UAAU,UAAU,KAAG,UAAU;qBAKxC,MAAM,KAAG,UAAU;CAIrC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,MAAM,EACV,OAAO,KAAK,EACZ,SAAS,SAAS,kBAAkB,EAAE,KACrC,MAkBF,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EA2BtE,CAAC"}

package/lib/__test-utils__/CubeExpressionTestUtils.js

@@ -0,0 +1,83 @@
+/**
+ * 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 { buildSchemasAndValidity, Extend, getExtendSignature, PrimitiveType, } from '@finos/legend-cube';
+// Extend columns for tests (PLAN §11.7), written as the engine's JSON, as a
+// column stores it: number literals as their digits
+/** `x | <body>` and the pieces of a body */
+export const TEST__expression = {
+    lambda: (body) => ({
+        _type: 'lambda',
+        parameters: [{ _type: 'var', name: 'x' }],
+        body: [body],
+    }),
+    /** `$x.<name>` */
+    column: (name) => ({
+        _type: 'property',
+        property: name,
+        parameters: [{ _type: 'var', name: 'x' }],
+    }),
+    call: (name, ...parameters) => ({
+        _type: 'func',
+        function: name,
+        parameters,
+    }),
+    /** The two operands of `+`, `*`, … */
+    pair: (first, second) => ({
+        _type: 'collection',
+        multiplicity: { lowerBound: 2, upperBound: 2 },
+        values: [first, second],
+    }),
+    integer: (value) => ({
+        _type: 'integer',
+        value: String(value),
+    }),
+};
+/**
+ * An Extend of these columns, typed as given for the input Cube infers for
+ * `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the types are the engine's. With an invalid input, untyped.
+ */
+export const TEST__typedExtend = (id, input, columns) => {
+    const schema = buildSchemasAndValidity(input).schemas.get(input.selected ?? '');
+    const extendColumns = columns.map(([name, lambda]) => ({
+        name,
+        code: name,
+        lambda,
+    }));
+    // an invalid input, e.g. a table not resolved yet: nothing to type it for
+    if (!schema) {
+        return new Extend(id, extendColumns);
+    }
+    return new Extend(id, extendColumns, {
+        kind: 'typed',
+        signature: getExtendSignature(schema, extendColumns),
+        types: columns.map(([, , type]) => PrimitiveType.get(type)),
+    });
+};
+/** `a: x | $x.ORDER_ID + 1` and `b: x | $x.a * 2`, the second using the first, both Integer */
+export const TEST__ORDER_ID_EXTEND_COLUMNS = [
+    [
+        'a',
+        TEST__expression.lambda(TEST__expression.call('plus', TEST__expression.pair(TEST__expression.column('ORDER_ID'), TEST__expression.integer(1)))),
+        'Integer',
+    ],
+    [
+        'b',
+        TEST__expression.lambda(TEST__expression.call('times', TEST__expression.pair(TEST__expression.column('a'), TEST__expression.integer(2)))),
+        'Integer',
+    ],
+];
+//# sourceMappingURL=CubeExpressionTestUtils.js.map

package/lib/__test-utils__/CubeExpressionTestUtils.js.map

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

package/lib/__test-utils__/CubeOperationsTestUtils.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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 { Query, type QueryNode, RelationalTableSource, Schema } from '@finos/legend-cube';
+import type { CubeEngine, CubeResult, CubeResultValue } from '../graph-manager/CubeEngine.js';
+/** A table of the Cube Northwind model, not resolved yet */
+export declare const TEST__northwindTable: (id: string, table: string, schema?: string) => RelationalTableSource;
+/** The sources, resolved through the engine as the editor resolves them */
+export declare const TEST__resolveSources: (engine: CubeEngine, sources: readonly RelationalTableSource[]) => Promise<RelationalTableSource[]>;
+/** A chain of nodes, each feeding the next on its first port, captured at the last */
+export declare const TEST__chainOf: (nodes: readonly QueryNode[]) => Query;
+/** Every node of the query is valid */
+export declare const TEST__expectValidQuery: (query: Query) => void;
+/**
+ * Runs the query up to its capture node, with this row limit; with a database
+ * type, written as for that database (on the fixture's H2 all the same, so a
+ * workaround's rows can be checked)
+ */
+export declare const TEST__runQuery: (engine: CubeEngine, query: Query, rowLimit: number, databaseType?: string) => Promise<CubeResult>;
+/** The values of one column of a result */
+export declare const TEST__columnValues: (result: CubeResult, column: string) => CubeResultValue[];
+/** The schema Cube infers for a node of the query, its capture node by default */
+export declare const TEST__inferredSchema: (query: Query, nodeId?: string) => Schema;
+/** A node of a query to type with the engine, under a key of its own */
+export interface TEST__TypingTarget {
+    key: string;
+    query: Query;
+    nodeId: string;
+}
+/**
+ * Every node of the query that can be emitted, keyed `<prefix>/<node id>`, in
+ * the query's node order
+ */
+export declare const TEST__emittableNodes: (prefix: string, query: Query) => TEST__TypingTarget[];
+/** The engine's schema of each target, in one engine call */
+export declare const TEST__engineSchemas: (engine: CubeEngine, targets: readonly TEST__TypingTarget[]) => Promise<Map<string, Schema | Error>>;
+/**
+ * How Cube's schema of a node differs from the engine's, one line per
+ * difference: names, positions and types with their parameters must be the
+ * same. Nullability must be the same too, except on the columns in
+ * `widerNullable`, where the engine misreports it (outer-join padding, the
+ * FULL merged key: PLAN §4.7, §11.5) and Cube must say nullable. With
+ * `oneWay`, Cube may be wider on any column.
+ */
+export declare const TEST__typingDifferences: (key: string, cube: Schema | undefined, engineSchema: Schema | Error | undefined, options?: {
+    widerNullable?: readonly string[] | undefined;
+    oneWay?: boolean | undefined;
+}) => string[];
+/**
+ * The engine types the node as Cube infers it: the same names, in the same
+ * order, of the same types and parameters. Cube's nullability may only be
+ * wider, since the engine misreports it after outer joins (PLAN §4.7).
+ */
+export declare const TEST__expectEngineTyping: (engine: CubeEngine, query: Query, nodeId?: string) => Promise<void>;
+//# sourceMappingURL=CubeOperationsTestUtils.d.ts.map

package/lib/__test-utils__/CubeOperationsTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeOperationsTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeOperationsTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,EACL,KAAK,SAAS,EAEd,qBAAqB,EACrB,MAAM,EACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAUxC,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,GAC/B,IAAI,MAAM,EACV,OAAO,MAAM,EACb,eAAoB,KACnB,qBAKC,CAAC;AAEL,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,UAAU,EAClB,SAAS,SAAS,qBAAqB,EAAE,KACxC,OAAO,CAAC,qBAAqB,EAAE,CAiBjC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,SAAS,EAAE,KAAG,KAczD,CAAC;AAEJ,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,GAAI,OAAO,KAAK,KAAG,IAMrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,UAAU,EAClB,OAAO,KAAK,EACZ,UAAU,MAAM,EAChB,eAAe,MAAM,KACpB,OAAO,CAAC,UAAU,CAUpB,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,UAAU,EAClB,QAAQ,MAAM,KACb,eAAe,EAIjB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,eAA6B,KAC5B,MAOF,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,OAAO,KAAK,KACX,kBAAkB,EAKpB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,UAAU,EAClB,SAAS,SAAS,kBAAkB,EAAE,KACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CASnC,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,MAAM,EACX,MAAM,MAAM,GAAG,SAAS,EACxB,cAAc,MAAM,GAAG,KAAK,GAAG,SAAS,EACxC,UAAS;IACP,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzB,KACL,MAAM,EA6BR,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,UAAU,EAClB,OAAO,KAAK,EACZ,eAA6B,KAC5B,OAAO,CAAC,IAAI,CAYd,CAAC"}

package/lib/__test-utils__/CubeOperationsTestUtils.js

@@ -0,0 +1,138 @@
+/**
+ * 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 { expect } from '@jest/globals';
+import { buildSchemasAndValidity, Connection, createNodeRegistry, Query, QueryEmitter, RelationalTableSource, Schema, } from '@finos/legend-cube';
+import { CUBE_NORTHWIND_DATABASE, CUBE_NORTHWIND_MODEL, CUBE_NORTHWIND_RUNTIME, } from '../stores/fixtures/CubeNorthwindModel.js';
+// Helpers for engine tests of operations on the Cube Northwind fixture,
+// through the engine port only (no V1 classes), so any CubeEngine works
+/** A table of the Cube Northwind model, not resolved yet */
+export const TEST__northwindTable = (id, table, schema = 'NORTHWIND') => new RelationalTableSource(id, {
+    database: CUBE_NORTHWIND_DATABASE,
+    schema,
+    table,
+});
+/** The sources, resolved through the engine as the editor resolves them */
+export const TEST__resolveSources = async (engine, sources) => {
+    const typed = await engine.resolveSchemas(CUBE_NORTHWIND_MODEL, new Map(sources.map((source) => [
+        source.id,
+        [source.database, source.schema, source.table],
+    ])));
+    return sources.map((source) => {
+        const schema = typed.get(source.id);
+        if (!(schema instanceof Schema)) {
+            throw schema ?? new Error(`No schema for ${source.id}`);
+        }
+        return source.withResolution({ kind: 'resolved', schema });
+    });
+};
+/** A chain of nodes, each feeding the next on its first port, captured at the last */
+export const TEST__chainOf = (nodes) => new Query(nodes, nodes
+    .slice(1)
+    .map((node, index) => new Connection(nodes[index].id, node.id, node.ports[0])), nodes.at(-1)?.id);
+/** Every node of the query is valid */
+export const TEST__expectValidQuery = (query) => {
+    const { validity } = buildSchemasAndValidity(query, createNodeRegistry().queryRules);
+    expect([...validity].filter(([, errors]) => errors.length)).toEqual([]);
+};
+/**
+ * Runs the query up to its capture node, with this row limit; with a database
+ * type, written as for that database (on the fixture's H2 all the same, so a
+ * workaround's rows can be checked)
+ */
+export const TEST__runQuery = async (engine, query, rowLimit, databaseType) => {
+    TEST__expectValidQuery(query);
+    return engine.execute(CUBE_NORTHWIND_MODEL, new QueryEmitter(query).emitExecutionLambda({
+        rowLimit,
+        runtime: CUBE_NORTHWIND_RUNTIME,
+        databaseType,
+    }));
+};
+/** The values of one column of a result */
+export const TEST__columnValues = (result, column) => {
+    const index = result.columns.indexOf(column);
+    expect(index).toBeGreaterThanOrEqual(0);
+    return result.rows.map((row) => row[index] ?? null);
+};
+/** The schema Cube infers for a node of the query, its capture node by default */
+export const TEST__inferredSchema = (query, nodeId = query.selected ?? '') => {
+    const schema = buildSchemasAndValidity(query, createNodeRegistry().queryRules).schemas.get(nodeId);
+    expect(schema).toBeDefined();
+    return schema;
+};
+/**
+ * Every node of the query that can be emitted, keyed `<prefix>/<node id>`, in
+ * the query's node order
+ */
+export const TEST__emittableNodes = (prefix, query) => {
+    const emitter = new QueryEmitter(query);
+    return query.nodes
+        .filter((node) => emitter.canEmit(node.id))
+        .map((node) => ({ key: `${prefix}/${node.id}`, query, nodeId: node.id }));
+};
+/** The engine's schema of each target, in one engine call */
+export const TEST__engineSchemas = async (engine, targets) => engine.typeLambdas(CUBE_NORTHWIND_MODEL, new Map(targets.map(({ key, query, nodeId }) => [
+    key,
+    new QueryEmitter(query).emitTypingLambda(nodeId),
+])));
+/**
+ * How Cube's schema of a node differs from the engine's, one line per
+ * difference: names, positions and types with their parameters must be the
+ * same. Nullability must be the same too, except on the columns in
+ * `widerNullable`, where the engine misreports it (outer-join padding, the
+ * FULL merged key: PLAN §4.7, §11.5) and Cube must say nullable. With
+ * `oneWay`, Cube may be wider on any column.
+ */
+export const TEST__typingDifferences = (key, cube, engineSchema, options = {}) => {
+    if (!cube) {
+        return [`${key}: Cube infers no schema`];
+    }
+    if (!(engineSchema instanceof Schema)) {
+        return [`${key}: the engine gives no schema (${engineSchema?.message})`];
+    }
+    const describe = (schema) => schema.columns.map((column) => `${column.name}: ${column.type.fullName}`);
+    if (describe(cube).join() !== describe(engineSchema).join()) {
+        return [
+            `${key}: columns [${describe(cube).join(', ')}], the engine's [${describe(engineSchema).join(', ')}]`,
+        ];
+    }
+    const wider = new Set(options.widerNullable ?? []);
+    return cube.columns.flatMap((column, index) => {
+        const engineNullable = engineSchema.columns[index]?.nullable === true;
+        if (wider.has(column.name)) {
+            return column.nullable
+                ? []
+                : [`${key}: ${column.name} should be nullable`];
+        }
+        return column.nullable === engineNullable ||
+            (options.oneWay && column.nullable)
+            ? []
+            : [
+                `${key}: ${column.name} is ${column.nullable ? '' : 'not '}nullable, the engine's ${engineNullable ? '' : 'not '}nullable`,
+            ];
+    });
+};
+/**
+ * The engine types the node as Cube infers it: the same names, in the same
+ * order, of the same types and parameters. Cube's nullability may only be
+ * wider, since the engine misreports it after outer joins (PLAN §4.7).
+ */
+export const TEST__expectEngineTyping = async (engine, query, nodeId = query.selected ?? '') => {
+    const typed = await TEST__engineSchemas(engine, [
+        { key: nodeId, query, nodeId },
+    ]);
+    expect(TEST__typingDifferences(nodeId, TEST__inferredSchema(query, nodeId), typed.get(nodeId), { oneWay: true })).toEqual([]);
+};
+//# sourceMappingURL=CubeOperationsTestUtils.js.map

package/lib/__test-utils__/CubeOperationsTestUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeOperationsTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeOperationsTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,kBAAkB,EAClB,KAAK,EAEL,YAAY,EACZ,qBAAqB,EACrB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAElD,wEAAwE;AACxE,wEAAwE;AAExE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,EAAU,EACV,KAAa,EACb,MAAM,GAAG,WAAW,EACG,EAAE,CACzB,IAAI,qBAAqB,CAAC,EAAE,EAAE;IAC5B,QAAQ,EAAE,uBAAuB;IACjC,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEL,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAkB,EAClB,OAAyC,EACP,EAAE;IACpC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,CACvC,oBAAoB,EACpB,IAAI,GAAG,CACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE;QACT,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAU;KACxD,CAAC,CACH,CACF,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,IAAI,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAA2B,EAAS,EAAE,CAClE,IAAI,KAAK,CACP,KAAK,EACL,KAAK;KACF,KAAK,CAAC,CAAC,CAAC;KACR,GAAG,CACF,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,IAAI,UAAU,CACX,KAAK,CAAC,KAAK,CAAe,CAAC,EAAE,EAC9B,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,KAAK,CAAC,CAAC,CAAW,CACxB,CACJ,EACH,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,CAAC;AAEJ,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAY,EAAQ,EAAE;IAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,uBAAuB,CAC1C,KAAK,EACL,kBAAkB,EAAE,CAAC,UAAU,CAChC,CAAC;IACF,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,MAAkB,EAClB,KAAY,EACZ,QAAgB,EAChB,YAAqB,EACA,EAAE;IACvB,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CACnB,oBAAoB,EACpB,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC;QAC1C,QAAQ;QACR,OAAO,EAAE,sBAAsB;QAC/B,YAAY;KACb,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAkB,EAClB,MAAc,EACK,EAAE;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAY,EACZ,MAAM,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,EACrB,EAAE;IACV,MAAM,MAAM,GAAG,uBAAuB,CACpC,KAAK,EACL,kBAAkB,EAAE,CAAC,UAAU,CAChC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,MAAgB,CAAC;AAC1B,CAAC,CAAC;AASF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,KAAY,EACU,EAAE;IACxB,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,KAAK;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,MAAkB,EAClB,OAAsC,EACA,EAAE,CACxC,MAAM,CAAC,WAAW,CAChB,oBAAoB,EACpB,IAAI,GAAG,CACL,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACtC,GAAG;IACH,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC;CACjD,CAAC,CACH,CACF,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,GAAW,EACX,IAAwB,EACxB,YAAwC,EACxC,UAGI,EAAE,EACI,EAAE;IACZ,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,GAAG,yBAAyB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,CAAC,YAAY,YAAY,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,GAAG,iCAAiC,YAAY,EAAE,OAAO,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAY,EAAE,CAC5C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5D,OAAO;YACL,GAAG,GAAG,cAAc,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACtG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;QACtE,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,QAAQ;gBACpB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,KAAK,cAAc;YACvC,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,GAAG,GAAG,KAAK,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,0BAA0B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,UAAU;aAC3H,CAAC;IACR,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,MAAkB,EAClB,KAAY,EACZ,MAAM,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,EACd,EAAE;IACjB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE;QAC9C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;KAC/B,CAAC,CAAC;IACH,MAAM,CACJ,uBAAuB,CACrB,MAAM,EACN,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,EACnC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EACjB,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CACF,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC,CAAC"}

package/lib/__test-utils__/CubePageTestUtils.d.ts

@@ -30,4 +30,16 @@ export declare const TEST__renderInCubeApplication: (element: React.ReactNode, a
  * tables to be typed again, so nothing changes after the test has ended
  */
 export declare const TEST__importDocument: (editorState: CubeEditorState, document: CubeDocument, readOnly?: boolean) => Promise<void>;
+/** The graph header's 'Add Items' trigger */
+export declare const TEST__getAddItemsTrigger: () => HTMLButtonElement;
+/** Opens 'Add Items' in the graph's header and returns its menu */
+export declare const TEST__openAddItems: () => Promise<HTMLElement>;
+/**
+ * Chooses an item of 'Add Items' by its label, as the menu shows it (e.g.
+ * 'Relational Database Table', 'Data Product (BETA)', 'Filter by Column'),
+ * and waits for the menu to close
+ */
+export declare const TEST__chooseAddItem: (label: string) => Promise<void>;
+/** Closes 'Add Items' without choosing an item, as Escape does */
+export declare const TEST__closeAddItems: () => Promise<void>;
 //# sourceMappingURL=CubePageTestUtils.d.ts.map

package/lib/__test-utils__/CubePageTestUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CubePageTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubePageTestUtils.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAkBpE,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,QAAO,IAQ9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,KAAK,CAAC,SAAS,EACxB,kBAAkB,6BAA6B,EAC/C,aAAa,MAAM,KAClB,OAAO,CAAC,YAAY,CAWtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,eAAe,EAC5B,UAAU,YAAY,EACtB,kBAAgB,KACf,OAAO,CAAC,IAAI,CAOd,CAAC"}
+{"version":3,"file":"CubePageTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubePageTestUtils.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAGL,KAAK,YAAY,EAKlB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAkBpE,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,QAAO,IAQ9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,KAAK,CAAC,SAAS,EACxB,kBAAkB,6BAA6B,EAC/C,aAAa,MAAM,KAClB,OAAO,CAAC,YAAY,CAWtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,eAAe,EAC5B,UAAU,YAAY,EACtB,kBAAgB,KACf,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,QAAO,iBAIzC,CAAC;AAEJ,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,WAAW,CAG9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAIrE,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,IAAI,CAGxD,CAAC"}

package/lib/__test-utils__/CubePageTestUtils.js

@@ -14,9 +14,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { expect } from '@jest/globals';
 import { ApplicationFrameworkProvider, ApplicationStoreProvider, } from '@finos/legend-application';
 import { TEST__BrowserEnvironmentProvider } from '@finos/legend-application/test';
-import { act, render, waitFor, } from '@testing-library/react';
+import { act, fireEvent, render, screen, waitFor, within, } from '@testing-library/react';
+import { LEGEND_CUBE_TEST_ID } from '../__lib__/LegendCubeTesting.js';
 /** React Flow watches the canvas with an IntersectionObserver, which jsdom lacks */
 class TEST__IntersectionObserver {
     observe() {
@@ -65,4 +67,26 @@ export const TEST__importDocument = async (editorState, document, readOnly = fal
         }
     });
 };
+/** The graph header's 'Add Items' trigger */
+export const TEST__getAddItemsTrigger = () => within(screen.getByTestId(LEGEND_CUBE_TEST_ID.GRAPH_REGION)).getByRole('button', { name: 'Add Items' });
+/** Opens 'Add Items' in the graph's header and returns its menu */
+export const TEST__openAddItems = async () => {
+    fireEvent.click(TEST__getAddItemsTrigger());
+    return screen.findByRole('menu');
+};
+/**
+ * Chooses an item of 'Add Items' by its label, as the menu shows it (e.g.
+ * 'Relational Database Table', 'Data Product (BETA)', 'Filter by Column'),
+ * and waits for the menu to close
+ */
+export const TEST__chooseAddItem = async (label) => {
+    const menu = await TEST__openAddItems();
+    fireEvent.click(within(menu).getByRole('menuitem', { name: label }));
+    await waitFor(() => expect(screen.queryByRole('menu')).toBeNull());
+};
+/** Closes 'Add Items' without choosing an item, as Escape does */
+export const TEST__closeAddItems = async () => {
+    fireEvent.keyDown(screen.getByRole('menu'), { key: 'Escape' });
+    await waitFor(() => expect(screen.queryByRole('menu')).toBeNull());
+};
 //# sourceMappingURL=CubePageTestUtils.js.map

package/lib/__test-utils__/CubePageTestUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubePageTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubePageTestUtils.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAElF,OAAO,EACL,GAAG,EAEH,MAAM,EACN,OAAO,GACR,MAAM,wBAAwB,CAAC;AAGhC,oFAAoF;AACpF,MAAM,0BAA0B;IAC9B,OAAO;QACL,sCAAsC;IACxC,CAAC;IACD,SAAS;QACP,2BAA2B;IAC7B,CAAC;IACD,UAAU;QACR,2BAA2B;IAC7B,CAAC;IACD,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAS,EAAE;IACpD,IAAI,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,sBAAsB,EAAE;YACpD,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,0BAA0B;SAClC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,EAChD,OAAwB,EACxB,gBAA+C,EAC/C,WAAmB,EACI,EAAE;IACzB,2BAA2B,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,MAAM,CACzB,KAAC,wBAAwB,IAAC,KAAK,EAAE,gBAAgB,YAC/C,KAAC,gCAAgC,IAAC,cAAc,EAAE,CAAC,GAAG,CAAC,YACrD,KAAC,4BAA4B,cAAE,OAAO,GAAgC,GACrC,GACV,CAC5B,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,WAA4B,EAC5B,QAAsB,EACtB,QAAQ,GAAG,KAAK,EACD,EAAE;IACjB,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,CAAC,GAAG,EAAE;QACjB,IAAI,WAAW,CAAC,kBAAkB,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"CubePageTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubePageTestUtils.tsx"],"names":[],"mappings":"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"}

package/lib/__test-utils__/CubeTestApplication.d.ts

@@ -16,15 +16,19 @@
 import { type GenericLegendApplicationStore, type LegendApplicationPlugin, LegendApplicationPluginManager } from '@finos/legend-application';
 import type { CubeHost } from '../stores/CubeHost.js';
 import { type FakeCubeEngine, type FakeCubeEngineAnswers } from './FakeCubeEngine.js';
+import { type FakeCubeConnectionExplorer } from './FakeCubeConnectionExplorer.js';
+import { type FakeCubeDataProductCatalog } from './FakeCubeDataProductCatalog.js';
 export declare class TEST__LegendCubePluginManager extends LegendApplicationPluginManager<LegendApplicationPlugin> {
     private constructor();
     static create(): TEST__LegendCubePluginManager;
 }
 /** A fresh application store: build one per test, since it initializes once */
 export declare const TEST__createCubeApplicationStore: (plugins?: LegendApplicationPlugin[]) => GenericLegendApplicationStore;
-/** A host over a fake engine, with the bundled models */
+/** A host over fakes of the engine, the connection explorer and the data product catalog, with the bundled models */
 export declare const TEST__createCubeHost: (answers?: FakeCubeEngineAnswers, applicationStore?: GenericLegendApplicationStore) => {
     host: CubeHost;
     fake: FakeCubeEngine;
+    connections: FakeCubeConnectionExplorer;
+    dataProducts: FakeCubeDataProductCatalog;
 };
 //# sourceMappingURL=CubeTestApplication.d.ts.map

package/lib/__test-utils__/CubeTestApplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CubeTestApplication.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeTestApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,6BAA6B,EAElC,KAAK,uBAAuB,EAC5B,8BAA8B,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAK7B,qBAAa,6BAA8B,SAAQ,8BAA8B,CAAC,uBAAuB,CAAC;IACxG,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,6BAA6B;CAG/C;AAQD,+EAA+E;AAC/E,eAAO,MAAM,gCAAgC,GAC3C,UAAS,uBAAuB,EAAO,KACtC,6BAWF,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,GAC/B,UAAU,qBAAqB,EAC/B,gDAAqD,KACpD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAUxC,CAAC"}
+{"version":3,"file":"CubeTestApplication.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeTestApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,6BAA6B,EAElC,KAAK,uBAAuB,EAC5B,8BAA8B,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,iCAAiC,CAAC;AAKzC,qBAAa,6BAA8B,SAAQ,8BAA8B,CAAC,uBAAuB,CAAC;IACxG,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,6BAA6B;CAG/C;AAQD,+EAA+E;AAC/E,eAAO,MAAM,gCAAgC,GAC3C,UAAS,uBAAuB,EAAO,KACtC,6BAWF,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,qBAAqB,EAC/B,gDAAqD,KACpD;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,0BAA0B,CAAC;IACxC,YAAY,EAAE,0BAA0B,CAAC;CAiB1C,CAAC"}

package/lib/__test-utils__/CubeTestApplication.js

@@ -17,6 +17,8 @@ import { ApplicationStore, LegendApplicationConfig, LegendApplicationPluginManag
 import { TEST__getApplicationVersionData } from '@finos/legend-application/test';
 import { LocalModelCatalog } from '../stores/LocalModelCatalog.js';
 import { createFakeCubeEngine, } from './FakeCubeEngine.js';
+import { createFakeCubeConnectionExplorer, } from './FakeCubeConnectionExplorer.js';
+import { createFakeCubeDataProductCatalog, } from './FakeCubeDataProductCatalog.js';
 // A bare Legend application for Cube's jsdom tests, as the data-space viewer's
 // tests build theirs: the builder may not use the query builder's test helpers
 export class TEST__LegendCubePluginManager extends LegendApplicationPluginManager {
@@ -42,16 +44,22 @@ export const TEST__createCubeApplicationStore = (plugins = []) => {
         baseAddress: '/',
     }), pluginManager);
 };
-/** A host over a fake engine, with the bundled models */
+/** A host over fakes of the engine, the connection explorer and the data product catalog, with the bundled models */
 export const TEST__createCubeHost = (answers, applicationStore = TEST__createCubeApplicationStore()) => {
     const fake = createFakeCubeEngine(answers);
+    const connections = createFakeCubeConnectionExplorer();
+    const dataProducts = createFakeCubeDataProductCatalog();
     return {
         host: {
             applicationStore,
             engine: fake.engine,
             modelCatalog: new LocalModelCatalog(fake.engine),
+            connectionExplorer: connections.explorer,
+            dataProductCatalog: dataProducts.catalog,
         },
         fake,
+        connections,
+        dataProducts,
     };
 };
 //# sourceMappingURL=CubeTestApplication.js.map

package/lib/__test-utils__/CubeTestApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeTestApplication.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeTestApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,gBAAgB,EAEhB,uBAAuB,EAEvB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EACL,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E;AAC/E,+EAA+E;AAE/E,MAAM,OAAO,6BAA8B,SAAQ,8BAAuD;IACxG;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAE,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,iCAAkC,SAAQ,uBAAuB;IAC5D,+BAA+B;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAAqC,EAAE,EACR,EAAE;IACjC,MAAM,aAAa,GAAG,6BAA6B,CAAC,MAAM,EAAE,CAAC;IAC7D,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5C,OAAO,IAAI,gBAAgB,CACzB,IAAI,iCAAiC,CAAC;QACpC,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAC5C,WAAW,EAAE,+BAA+B,EAAE;QAC9C,WAAW,EAAE,GAAG;KACjB,CAAC,EACF,aAAa,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA+B,EAC/B,gBAAgB,GAAG,gCAAgC,EAAE,EACX,EAAE;IAC5C,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE;YACJ,gBAAgB;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;SACjD;QACD,IAAI;KACL,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"CubeTestApplication.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeTestApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,gBAAgB,EAEhB,uBAAuB,EAEvB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EACL,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gCAAgC,GAEjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,GAEjC,MAAM,iCAAiC,CAAC;AAEzC,+EAA+E;AAC/E,+EAA+E;AAE/E,MAAM,OAAO,6BAA8B,SAAQ,8BAAuD;IACxG;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAE,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,iCAAkC,SAAQ,uBAAuB;IAC5D,+BAA+B;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAAqC,EAAE,EACR,EAAE;IACjC,MAAM,aAAa,GAAG,6BAA6B,CAAC,MAAM,EAAE,CAAC;IAC7D,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5C,OAAO,IAAI,gBAAgB,CACzB,IAAI,iCAAiC,CAAC;QACpC,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAC5C,WAAW,EAAE,+BAA+B,EAAE;QAC9C,WAAW,EAAE,GAAG;KACjB,CAAC,EACF,aAAa,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,qHAAqH;AACrH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA+B,EAC/B,gBAAgB,GAAG,gCAAgC,EAAE,EAMrD,EAAE;IACF,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,gCAAgC,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,gCAAgC,EAAE,CAAC;IACxD,OAAO;QACL,IAAI,EAAE;YACJ,gBAAgB;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;YAChD,kBAAkB,EAAE,WAAW,CAAC,QAAQ;YACxC,kBAAkB,EAAE,YAAY,CAAC,OAAO;SACzC;QACD,IAAI;QACJ,WAAW;QACX,YAAY;KACb,CAAC;AACJ,CAAC,CAAC"}

package/lib/__test-utils__/FakeCubeConnectionExplorer.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 { jest } from '@jest/globals';
+import { type CubeConnectionExplorer, type CubeExploredTable } from '../graph-manager/CubeConnectionExplorer.js';
+/** A schema of two tables, one with a column Cube hides */
+export declare const FAKE_DIRECT_TABLES: readonly CubeExploredTable[];
+export interface FakeCubeConnectionExplorerAnswers {
+    /** keyed by schema name; a schema not in it gets a compile error */
+    readonly tables?: ReadonlyMap<string, readonly CubeExploredTable[]>;
+}
+export interface FakeCubeConnectionExplorer {
+    readonly explorer: CubeConnectionExplorer;
+    readonly buildConnection: jest.Mock<CubeConnectionExplorer['buildConnection']>;
+    readonly describeConnection: jest.Mock<CubeConnectionExplorer['describeConnection']>;
+    readonly listSchemas: jest.Mock<CubeConnectionExplorer['listSchemas']>;
+    readonly listTables: jest.Mock<CubeConnectionExplorer['listTables']>;
+}
+/** A fresh fake: build one per test, since jest.fn keeps its calls across tests */
+export declare const createFakeCubeConnectionExplorer: (answers?: FakeCubeConnectionExplorerAnswers) => FakeCubeConnectionExplorer;
+//# sourceMappingURL=FakeCubeConnectionExplorer.d.ts.map

package/lib/__test-utils__/FakeCubeConnectionExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeCubeConnectionExplorer.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/FakeCubeConnectionExplorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACvB,MAAM,4CAA4C,CAAC;AAUpD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,EAAE,SAAS,iBAAiB,EAe1D,CAAC;AAEF,MAAM,WAAW,iCAAiC;IAChD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CACjC,sBAAsB,CAAC,iBAAiB,CAAC,CAC1C,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CACpC,sBAAsB,CAAC,oBAAoB,CAAC,CAC7C,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;CACtE;AAED,mFAAmF;AACnF,eAAO,MAAM,gCAAgC,GAC3C,UAAS,iCAAsC,KAC9C,0BAwCF,CAAC"}

package/lib/__test-utils__/FakeCubeConnectionExplorer.js

@@ -0,0 +1,67 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { jest } from '@jest/globals';
+import { CubeConnectionDatasourceKind, CubeDirectDatabaseType, } from '../graph-manager/CubeConnectionExplorer.js';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+// A connection explorer for jsdom tests: canned answers, no network. Each
+// method is a jest.fn, so tests can read its calls or change its answer. Any
+// connection is supported and summarized as an in-memory H2 database.
+/** A schema of two tables, one with a column Cube hides */
+export const FAKE_DIRECT_TABLES = [
+    {
+        name: 'ORDERS',
+        storedName: '"ORDERS"',
+        columnCount: 3,
+        hiddenColumnCount: 1,
+        flags: [],
+    },
+    {
+        name: 'ORDER.LINES',
+        storedName: '"ORDER.LINES"',
+        columnCount: 2,
+        hiddenColumnCount: 0,
+        flags: [],
+    },
+];
+/** A fresh fake: build one per test, since jest.fn keeps its calls across tests */
+export const createFakeCubeConnectionExplorer = (answers = {}) => {
+    const tables = answers.tables ?? new Map([['CUBE_DIRECT', FAKE_DIRECT_TABLES]]);
+    const buildConnection = jest.fn((draft) => ({ _type: 'fake', ...draft }));
+    const describeConnection = jest.fn(() => ({
+        supported: true,
+        summary: {
+            databaseType: CubeDirectDatabaseType.H2,
+            datasourceKind: CubeConnectionDatasourceKind.LOCAL_H2,
+            setupSqlCount: 1,
+            authenticationKind: 'h2Default',
+        },
+    }));
+    const listSchemas = jest.fn(async () => Promise.resolve([...tables.keys()]));
+    const listTables = jest.fn(async (_connection, schema) => {
+        const found = tables.get(schema);
+        return found
+            ? Promise.resolve(found)
+            : Promise.reject(new CubeEngineError(CubeEngineErrorKind.COMPILE, `The schema "${schema}" can't be found`));
+    });
+    return {
+        explorer: { buildConnection, describeConnection, listSchemas, listTables },
+        buildConnection,
+        describeConnection,
+        listSchemas,
+        listTables,
+    };
+};
+//# sourceMappingURL=FakeCubeConnectionExplorer.js.map

package/lib/__test-utils__/FakeCubeConnectionExplorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeCubeConnectionExplorer.js","sourceRoot":"","sources":["../../src/__test-utils__/FakeCubeConnectionExplorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,4BAA4B,EAE5B,sBAAsB,GAEvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAExC,0EAA0E;AAC1E,6EAA6E;AAC7E,sEAAsE;AAEtE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,KAAK,EAAE,EAAE;KACV;IACD;QACE,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,eAAe;QAC3B,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,KAAK,EAAE,EAAE;KACV;CACF,CAAC;AAmBF,mFAAmF;AACnF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAA6C,EAAE,EACnB,EAAE;IAC9B,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,IAAI,CAAC,EAAE,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CACzC,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAEhC,GAAG,EAAE,CAAC,CAAC;QACP,SAAS,EAAE,IAAI;QACf,OAAO,EAAE;YACP,YAAY,EAAE,sBAAsB,CAAC,EAAE;YACvC,cAAc,EAAE,4BAA4B,CAAC,QAAQ;YACrD,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,WAAW;SAChC;KACF,CAAC,CAAC,CAAC;IACJ,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAwC,KAAK,IAAI,EAAE,CAC5E,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CACpC,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CACxB,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,KAAK;YACV,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,OAAO,CAAC,MAAM,CACZ,IAAI,eAAe,CACjB,mBAAmB,CAAC,OAAO,EAC3B,eAAe,MAAM,kBAAkB,CACxC,CACF,CAAC;IACR,CAAC,CACF,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE;QAC1E,eAAe;QACf,kBAAkB;QAClB,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC,CAAC"}