@finos/legend-cube-builder 0.0.3 → 0.0.4

package/lib/graph-manager/protocol/pure/v1/V1_CubeSchemaExploration.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 type { PlainObject } from '@finos/legend-shared';
+import { CubeDirectDatabaseType, type CubeExploredTable } from '../../../CubeConnectionExplorer.js';
+import { CubeEngineError, type CubeEngineErrorKind, type NodeId } from '../../../CubeEngine.js';
+/** What one exploration asks for; names are as the database stores them */
+export type V1_CubeExplorationScope = 
+/** The schema names, to test a connection */
+{
+    kind: 'schemas';
+}
+/** A schema's tables and their columns, for the picker */
+ | {
+    kind: 'tables';
+    schema: string;
+}
+/** Some tables in full, to build the model a query runs on */
+ | {
+    kind: 'columns';
+    tables: readonly V1_CubeExploredTablePath[];
+};
+/** A table's schema and table names, as the database stores them */
+export type V1_CubeExploredTablePath = readonly [schema: string, table: string];
+/** Where the engine puts the Database it builds */
+export interface V1_CubeExploredDatabasePath {
+    package: string;
+    name: string;
+}
+/** A name as the database stores it: the engine quotes some names, and Cube all of them */
+export declare const V1_unquoteCubeName: (name: string) => string;
+/** A name as a Database stores it; Pure can't quote a name holding a quote */
+export declare const V1_quoteCubeName: (name: string) => string;
+/** The request that reads part of a connection's database */
+export declare const V1_buildCubeSchemaExplorationInput: (connection: PlainObject, databaseType: CubeDirectDatabaseType, database: V1_CubeExploredDatabasePath, scope: V1_CubeExplorationScope) => PlainObject;
+/** The schema names a connection's database holds, for the picker */
+export declare const V1_readExploredSchemaNames: (response: unknown) => readonly string[];
+/** A schema's tables, for the picker; views are offered as tables */
+export declare const V1_readExploredTables: (response: unknown, schema: string) => readonly CubeExploredTable[];
+/**
+ * The Database a query runs on, holding exactly the tables asked for that the
+ * database has, and the tables it doesn't have: an answer without a table
+ * never stands for an empty one
+ */
+export declare const V1_buildExploredDatabase: (response: unknown, tables: readonly V1_CubeExploredTablePath[]) => {
+    database: PlainObject;
+    tables: readonly CubeExploredTable[];
+    missing: readonly V1_CubeExploredTablePath[];
+};
+/**
+ * The error of a failed exploration: the engine's message, led by what it
+ * means when the message alone says little. A network failure stays one
+ */
+export declare const V1_toCubeExplorationError: (error: unknown, kind: CubeEngineErrorKind, nodeId?: NodeId) => CubeEngineError;
+//# sourceMappingURL=V1_CubeSchemaExploration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeSchemaExploration.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeSchemaExploration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EAExB,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAehC,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB;AACjC,6CAA6C;AAC3C;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;AACrB,0DAA0D;GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACpC,8DAA8D;GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;CAAE,CAAC;AAErE,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEhF,mDAAmD;AACnD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAGxC,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAAqB,CAAC;AAsCtE,6DAA6D;AAC7D,eAAO,MAAM,kCAAkC,GAC7C,YAAY,WAAW,EACvB,cAAc,sBAAsB,EACpC,UAAU,2BAA2B,EACrC,OAAO,uBAAuB,KAC7B,WAqCF,CAAC;AA2CF,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,GACrC,UAAU,OAAO,KAChB,SAAS,MAAM,EAG8C,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,GAChC,UAAU,OAAO,EACjB,QAAQ,MAAM,KACb,SAAS,iBAAiB,EAO5B,CAAC;AAwBF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,OAAO,EACjB,QAAQ,SAAS,wBAAwB,EAAE,KAC1C;IACD,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAmC9C,CAAC;AAsCF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,OAAO,EACd,MAAM,mBAAmB,EACzB,SAAS,MAAM,KACd,eAgBF,CAAC"}

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

@@ -0,0 +1,238 @@
+/**
+ * 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 { CubeDirectDatabaseType, } from '../../../CubeConnectionExplorer.js';
+import { CubeEngineError, CubeTableFlag, } from '../../../CubeEngine.js';
+import { V1_toCubeEngineError } from './V1_CubeEngineErrors.js';
+const ANY = '%';
+/** Table functions are never read; this pattern only fills the request */
+const FUNCTION_PATTERN = '_%';
+const OTHER_TYPE = 'Other';
+const CHAR_TYPE = 'Char';
+/** Schemas of the database itself, matched in any case */
+const SYSTEM_SCHEMAS = ['information_schema', 'pg_catalog'];
+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 : '';
+/** A name as the database stores it: the engine quotes some names, and Cube all of them */
+export const V1_unquoteCubeName = (name) => name.length >= 2 && name.startsWith('"') && name.endsWith('"')
+    ? name.slice(1, -1)
+    : name;
+/** A name as a Database stores it; Pure can't quote a name holding a quote */
+export const V1_quoteCubeName = (name) => `"${name}"`;
+/**
+ * A name as the database stores it, from the engine's answer: the engine
+ * quotes only a name holding a space or a colon (SchemaExportation's
+ * escapeString), so other quotes are the name's own
+ */
+const readEngineName = (name) => name.length >= 2 &&
+    name.startsWith('"') &&
+    name.endsWith('"') &&
+    /[ :]/u.test(name.slice(1, -1))
+    ? name.slice(1, -1)
+    : name;
+/**
+ * A name Cube can use: Pure can't write one holding a double quote, and the
+ * engine reads a backslash in a name as its pattern escape
+ */
+const isWritable = (name) => !name.includes('"') && !name.includes('\\');
+const isSystemSchema = (name) => SYSTEM_SCHEMAS.includes(name.toLowerCase());
+/**
+ * The pattern that finds a name. H2 upper-cases a pattern, so a name that
+ * isn't all upper case is found through '%' and picked out by Cube; DuckDB
+ * matches the name as it is (local evidence `sources-v2/db-direct/`)
+ */
+const patternFor = (databaseType, name) => databaseType === CubeDirectDatabaseType.H2 && name !== name.toUpperCase()
+    ? ANY
+    : name;
+/** The request that reads part of a connection's database */
+export const V1_buildCubeSchemaExplorationInput = (connection, databaseType, database, scope) => {
+    const pattern = (schema, table) => ({
+        schemaPattern: schema,
+        tablePattern: table,
+        functionPattern: FUNCTION_PATTERN,
+    });
+    const config = scope.kind === 'schemas'
+        ? {
+            enrichTables: false,
+            enrichColumns: false,
+            enrichPrimaryKeys: false,
+            patterns: [pattern(ANY, ANY)],
+        }
+        : scope.kind === 'tables'
+            ? {
+                enrichTables: true,
+                enrichColumns: true,
+                enrichPrimaryKeys: false,
+                patterns: [pattern(patternFor(databaseType, scope.schema), ANY)],
+            }
+            : {
+                enrichTables: true,
+                enrichColumns: true,
+                enrichPrimaryKeys: true,
+                patterns: scope.tables.map(([schema, table]) => pattern(patternFor(databaseType, schema), patternFor(databaseType, table))),
+            };
+    return {
+        connection,
+        targetDatabase: { package: database.package, name: database.name },
+        config: { ...config, enrichTableFunctions: false },
+    };
+};
+/** The schemas of the one Database the engine returns */
+const schemasOf = (response) => asList(asObject(asList(asObject(response).elements)[0]).schemas).map(asObject);
+/** The tables of a schema, by name as the database stores them */
+const tablesOf = (schema) => new Map(asList(schema.tables)
+    .map(asObject)
+    .map((table) => [readEngineName(asString(table.name)), table]));
+/** A schema of the answer, by name as the database stores it */
+const findSchema = (response, name) => schemasOf(response).find((schema) => readEngineName(asString(schema.name)) === name);
+const isHidden = (column) => asString(asObject(column.type)._type) === OTHER_TYPE ||
+    !isWritable(readEngineName(asString(column.name)));
+const describeTable = (name, table) => {
+    const columns = asList(table.columns).map(asObject);
+    const kept = columns.filter((column) => !isHidden(column));
+    return {
+        name,
+        storedName: V1_quoteCubeName(name),
+        columnCount: kept.length,
+        hiddenColumnCount: columns.length - kept.length,
+        // the engine types a CHAR(n) column with a length of 1
+        flags: kept.some((column) => asString(asObject(column.type)._type) === CHAR_TYPE)
+            ? [CubeTableFlag.LENGTH_UNKNOWN]
+            : [],
+    };
+};
+/** The schema names a connection's database holds, for the picker */
+export const V1_readExploredSchemaNames = (response) => schemasOf(response)
+    .map((schema) => readEngineName(asString(schema.name)))
+    .filter((name) => isWritable(name) && !isSystemSchema(name));
+/** A schema's tables, for the picker; views are offered as tables */
+export const V1_readExploredTables = (response, schema) => {
+    const found = findSchema(response, schema);
+    return found
+        ? Array.from(tablesOf(found).entries())
+            .filter(([name]) => isWritable(name))
+            .map(([name, table]) => describeTable(name, table))
+        : [];
+};
+/** A table of the Database Cube builds: every name quoted, usable columns only */
+const buildTable = (name, table) => {
+    const columns = asList(table.columns)
+        .map(asObject)
+        .filter((column) => !isHidden(column));
+    const columnNames = new Set(columns.map((column) => readEngineName(asString(column.name))));
+    return {
+        ...table,
+        name: V1_quoteCubeName(name),
+        columns: columns.map((column) => ({
+            ...column,
+            name: V1_quoteCubeName(readEngineName(asString(column.name))),
+        })),
+        primaryKey: asList(table.primaryKey)
+            .map((key) => readEngineName(asString(key)))
+            .filter((key) => columnNames.has(key))
+            .map(V1_quoteCubeName),
+    };
+};
+/**
+ * The Database a query runs on, holding exactly the tables asked for that the
+ * database has, and the tables it doesn't have: an answer without a table
+ * never stands for an empty one
+ */
+export const V1_buildExploredDatabase = (response, tables) => {
+    const element = asObject(asList(asObject(response).elements)[0]);
+    const schemas = new Map();
+    const explored = [];
+    const missing = [];
+    tables.forEach(([schemaName, tableName]) => {
+        const schema = findSchema(response, schemaName);
+        const table = schema ? tablesOf(schema).get(tableName) : undefined;
+        if (!table || !isWritable(schemaName) || !isWritable(tableName)) {
+            missing.push([schemaName, tableName]);
+            return;
+        }
+        const built = schemas.get(schemaName) ?? [];
+        if (!built.some((existing) => existing.name === V1_quoteCubeName(tableName))) {
+            built.push(buildTable(tableName, table));
+            explored.push(describeTable(tableName, table));
+        }
+        schemas.set(schemaName, built);
+    });
+    return {
+        database: {
+            ...element,
+            schemas: Array.from(schemas.entries()).map(([name, builtTables]) => ({
+                name: V1_quoteCubeName(name),
+                tables: builtTables,
+                views: [],
+                tabularFunctions: [],
+            })),
+        },
+        tables: explored,
+        missing,
+    };
+};
+/**
+ * What a failed exploration's engine message means, for the errors whose
+ * message alone says little (a bare `NullPointerException: `, a Java class
+ * name): matched on the message's first line
+ */
+const EXPLORATION_FAILURES = [
+    [
+        /InvalidTypeIdException/u,
+        "The engine doesn't know this kind of connection or authentication",
+    ],
+    [
+        /UnrecognizedPropertyException/u,
+        "The engine doesn't recognize a property of the connection",
+    ],
+    [
+        /NullPointerException/u,
+        "The engine couldn't open the connection: its authentication may be missing or unresolved",
+    ],
+    [
+        /ConnectException|Connection refused/u,
+        "The engine couldn't reach the database",
+    ],
+    [
+        /Maximum number of tables/u,
+        'The database has too many tables to read at once',
+    ],
+    [
+        /must not end with escape character|LIKE ESCAPE/u,
+        "A schema or table name ends with a backslash, which Cube can't read",
+    ],
+    [
+        /SQLException|SQL statement|Parser Error/u,
+        "The database refused a statement: check the connection's setup SQL",
+    ],
+];
+/**
+ * The error of a failed exploration: the engine's message, led by what it
+ * means when the message alone says little. A network failure stays one
+ */
+export const V1_toCubeExplorationError = (error, kind, nodeId) => {
+    const engineError = V1_toCubeEngineError(error, nodeId, kind);
+    if (engineError.kind !== kind) {
+        return engineError;
+    }
+    const meaning = EXPLORATION_FAILURES.find(([pattern]) => pattern.test(engineError.firstLine))?.[1];
+    return meaning
+        ? new CubeEngineError(kind, `${meaning}\n${engineError.detail}`, engineError.nodeId, engineError.role)
+        : engineError;
+};
+//# sourceMappingURL=V1_CubeSchemaExploration.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { V1_EngineServerClient } from '@finos/legend-graph';
+import type { TracerService } from '@finos/legend-shared';
+import type { CubeConnectionDescription, CubeConnectionDraft, CubeConnectionExplorer, CubeDirectConnection, CubeExploredTable } from '../../../CubeConnectionExplorer.js';
+import type { V1_CubeEngineConfig } from './V1_LegendCubeEngine.js';
+/**
+ * The Legend implementation of the connection explorer (PLAN §6.8): the
+ * engine's schema exploration, with its own client. Connections are checked
+ * first, so one Cube can't use never reaches the engine
+ */
+export declare class V1_LegendCubeConnectionExplorer implements CubeConnectionExplorer {
+    readonly client: V1_EngineServerClient;
+    constructor(config: V1_CubeEngineConfig, tracerService: TracerService);
+    buildConnection(draft: CubeConnectionDraft): CubeDirectConnection;
+    describeConnection(connection: CubeDirectConnection): CubeConnectionDescription;
+    listSchemas(connection: CubeDirectConnection): Promise<readonly string[]>;
+    listTables(connection: CubeDirectConnection, schema: string): Promise<readonly CubeExploredTable[]>;
+    private explore;
+}
+//# sourceMappingURL=V1_LegendCubeConnectionExplorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_LegendCubeConnectionExplorer.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_LegendCubeConnectionExplorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EAEpB,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAc5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAKpE;;;;GAIG;AACH,qBAAa,+BAAgC,YAAW,sBAAsB;IAC5E,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;gBAE3B,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa;IAKrE,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB;IAIjE,kBAAkB,CAChB,UAAU,EAAE,oBAAoB,GAC/B,yBAAyB;IAUtB,WAAW,CACf,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAMvB,UAAU,CACd,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;YAO1B,OAAO;CAwBtB"}

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

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { V1_EngineServerClient } from '@finos/legend-graph';
+import { CubeEngineError, CubeEngineErrorKind } from '../../../CubeEngine.js';
+import { V1_buildCubeDirectConnection, V1_checkCubeDirectConnection, V1_summarizeCubeDirectConnection, } from './V1_CubeDirectConnection.js';
+import { V1_buildCubeSchemaExplorationInput, V1_readExploredSchemaNames, V1_readExploredTables, V1_toCubeExplorationError, } from './V1_CubeSchemaExploration.js';
+/** Where the engine puts the Database it reads for the picker: never saved */
+const EXPLORED_DATABASE = { package: 'cube::explored', name: 'Database' };
+/**
+ * The Legend implementation of the connection explorer (PLAN §6.8): the
+ * engine's schema exploration, with its own client. Connections are checked
+ * first, so one Cube can't use never reaches the engine
+ */
+export class V1_LegendCubeConnectionExplorer {
+    client;
+    constructor(config, tracerService) {
+        this.client = new V1_EngineServerClient(config);
+        this.client.setTracerService(tracerService);
+    }
+    buildConnection(draft) {
+        return V1_buildCubeDirectConnection(draft);
+    }
+    describeConnection(connection) {
+        const problems = V1_checkCubeDirectConnection(connection);
+        return problems.length
+            ? { supported: false, problems }
+            : {
+                supported: true,
+                summary: V1_summarizeCubeDirectConnection(connection),
+            };
+    }
+    async listSchemas(connection) {
+        return V1_readExploredSchemaNames(await this.explore(connection, { kind: 'schemas' }));
+    }
+    async listTables(connection, schema) {
+        return V1_readExploredTables(await this.explore(connection, { kind: 'tables', schema }), schema);
+    }
+    async explore(connection, scope) {
+        const problems = V1_checkCubeDirectConnection(connection);
+        if (problems.length) {
+            throw new CubeEngineError(CubeEngineErrorKind.COMPILE, problems.join('\n'));
+        }
+        try {
+            return await this.client.buildDatabase(V1_buildCubeSchemaExplorationInput(connection, connection.databaseType, EXPLORED_DATABASE, scope));
+        }
+        catch (error) {
+            throw V1_toCubeExplorationError(error, CubeEngineErrorKind.COMPILE);
+        }
+    }
+}
+//# sourceMappingURL=V1_LegendCubeConnectionExplorer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_LegendCubeConnectionExplorer.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_LegendCubeConnectionExplorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAU5D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,kCAAkC,EAClC,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAGvC,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAE1E;;;;GAIG;AACH,MAAM,OAAO,+BAA+B;IACjC,MAAM,CAAwB;IAEvC,YAAY,MAA2B,EAAE,aAA4B;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,eAAe,CAAC,KAA0B;QACxC,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB,CAChB,UAAgC;QAEhC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,MAAM;YACpB,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YAChC,CAAC,CAAC;gBACE,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,gCAAgC,CAAC,UAAU,CAAC;aACtD,CAAC;IACR,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAgC;QAEhC,OAAO,0BAA0B,CAC/B,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,UAAgC,EAChC,MAAc;QAEd,OAAO,qBAAqB,CAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAC1D,MAAM,CACP,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,UAAgC,EAChC,KAA8B;QAE9B,MAAM,QAAQ,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,OAAO,EAC3B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACpB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CACpC,kCAAkC,CAChC,UAAU,EACV,UAAU,CAAC,YAAsC,EACjD,iBAAiB,EACjB,KAAK,CACN,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,104 @@
+/**
+ * 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 { Schema } from '@finos/legend-cube';
+import { type DepotServerClient } from '@finos/legend-server-depot';
+import type { LakehouseContractServerClient } from '@finos/legend-server-lakehouse';
+import { type MarketplaceServerClient } from '@finos/legend-server-marketplace';
+import { type CubeDataProductProject, CubeDataProductEnvironmentType } from '../../../CubeDataProduct.js';
+import { CubeAccessPointGroupAccess, type CubeAccessPointLocation, type CubeDataProductCatalog, type CubeMarketplaceLinkTarget, CubeDataProductCandidate, type CubeDataProductDescription } from '../../../CubeDataProductCatalog.js';
+import { CubeEngineError, type NodeId } from '../../../CubeEngine.js';
+import { type V1_CubeEnterpriseStereotype } from './V1_CubeDataProductArtifact.js';
+export declare const V1_CUBE_DATA_PRODUCT_LIST_ERROR: {
+    readonly UNREADABLE_PAGE: "The lakehouse's answer isn't a page of data products";
+    readonly NO_CURSOR: "The lakehouse said more data products follow, but not where the next page starts";
+    readonly REPEATED_CURSOR: "The lakehouse sent the same page of data products twice";
+    readonly TOO_MANY_PAGES: "The lakehouse's data product list runs past 50 pages";
+};
+export declare const V1_CUBE_DATA_PRODUCT_SEARCH_ERROR: {
+    readonly UNREADABLE_PAGE: "The marketplace's answer isn't a page of search results";
+};
+/** What a host can add to the catalog: each part turns on what it serves */
+export interface V1_CubeDataProductCatalogOptions {
+    /** The marketplace's search API; with it, searches run there */
+    readonly marketplaceServerClient?: MarketplaceServerClient | undefined;
+    /** Builds a product's marketplace page, as the host's marketplace names it */
+    readonly marketplaceLink?: ((target: CubeMarketplaceLinkTarget) => string | undefined) | undefined;
+    /** The viewer, whose contracts give their access to each group */
+    readonly getCurrentUser?: (() => string) | undefined;
+    /** The stereotype the host's marketplace marks groups open to everyone with */
+    readonly enterpriseStereotype?: V1_CubeEnterpriseStereotype | undefined;
+}
+export declare class V1_LegendCubeDataProductCatalog implements CubeDataProductCatalog {
+    readonly environmentTypes: CubeDataProductEnvironmentType[];
+    private readonly contractServerClient;
+    private readonly depotServerClient;
+    private readonly getAccessToken;
+    private readonly options;
+    /** Each class's list, read once per page visit */
+    private readonly lists;
+    /** Each product's description, by its project, version and path */
+    private readonly descriptions;
+    /** The search answers whose page leaves out matches */
+    private readonly cutShortAnswers;
+    constructor(contractServerClient: LakehouseContractServerClient, depotServerClient: DepotServerClient, getAccessToken: () => string | undefined, options?: V1_CubeDataProductCatalogOptions);
+    get searchesOnServer(): boolean;
+    get searchLimit(): number | undefined;
+    isCutShort(answer: readonly CubeDataProductCandidate[]): boolean;
+    /**
+     * The class's lite rows, page by page along the lakehouse's cursor. Stops
+     * with an error on a page that isn't one, on a missing or repeated cursor,
+     * or past the page cap, and between pages once the search is dropped.
+     */
+    private readLiteRows;
+    /**
+     * The class's list, read once per page visit. A list whose search is
+     * dropped while it pages is forgotten at once, so the next search reads it
+     * again rather than waiting on the stopped one.
+     */
+    private listOf;
+    /** The class's list, along its pages; a stopped one fails with why it was stopped */
+    private readList;
+    /**
+     * The products the marketplace matches, in its order: the first page of a
+     * full text search in the class. A failed search fails; it never falls
+     * back to the lakehouse's list
+     */
+    private searchMarketplace;
+    search(search: {
+        text: string;
+        environmentType: CubeDataProductEnvironmentType;
+    }, signal?: AbortSignal): Promise<readonly CubeDataProductCandidate[]>;
+    /** The product's deployed artifact: the generation file at its path */
+    private readArtifact;
+    /** The product's definition at the deployed version */
+    private readDefinition;
+    describe(candidate: CubeDataProductCandidate): Promise<CubeDataProductDescription>;
+    resolveSchemas(project: CubeDataProductProject, sources: ReadonlyMap<NodeId, CubeAccessPointLocation>, options?: {
+        readonly fresh?: boolean | undefined;
+    }): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    /** The product's page in the host's marketplace, as the host builds it; none without one */
+    getMarketplaceLink(target: CubeMarketplaceLinkTarget): string | undefined;
+    /**
+     * The viewer's access to each of the product's groups, as the marketplace
+     * shows it, from the viewer's contracts, read afresh each time: a group
+     * marked open to everyone needs none; otherwise the contract for that
+     * group of this deployment furthest along approval. A group with no
+     * contract has no access only when the host marks open groups, since it
+     * might be one otherwise
+     */
+    getAccess(candidate: CubeDataProductCandidate, signal?: AbortSignal): Promise<ReadonlyMap<string, CubeAccessPointGroupAccess>>;
+}
+//# sourceMappingURL=V1_LegendCubeDataProductCatalog.d.ts.map

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

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