@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/graph-manager/CubeLakehouseRuntime.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The lakehouse runtimes, by the kind the engine's protocol names them
+ * (legend-graph's subtypes of the base lakehouse runtime): a Databricks one
+ * will be another (PLAN §11.12)
+ */
+export declare enum CubeLakehouseRuntimeKind {
+    LAKEHOUSE = "LakehouseRuntime",
+    SINGLE_STORE = "LakehouseSingleStoreRuntime"
+}
+/** The runtime Cube writes for a data product or ingest cube (PLAN §6.8) */
+export declare const CUBE_LAKEHOUSE_RUNTIME_KIND = CubeLakehouseRuntimeKind.LAKEHOUSE;
+/** The database type a lakehouse runtime of the kind runs on; none for a kind Cube doesn't know */
+export declare const getLakehouseDatabaseType: (kind: string) => string | undefined;
+//# sourceMappingURL=CubeLakehouseRuntime.d.ts.map

package/lib/graph-manager/CubeLakehouseRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLakehouseRuntime.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeLakehouseRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,oBAAY,wBAAwB;IAClC,SAAS,qBAAqB;IAC9B,YAAY,gCAAgC;CAC7C;AAED,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,qCAAqC,CAAC;AAa9E,mGAAmG;AACnG,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAC7B,CAAC"}

package/lib/graph-manager/CubeLakehouseRuntime.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The lakehouse runtimes, by the kind the engine's protocol names them
+ * (legend-graph's subtypes of the base lakehouse runtime): a Databricks one
+ * will be another (PLAN §11.12)
+ */
+export var CubeLakehouseRuntimeKind;
+(function (CubeLakehouseRuntimeKind) {
+    CubeLakehouseRuntimeKind["LAKEHOUSE"] = "LakehouseRuntime";
+    CubeLakehouseRuntimeKind["SINGLE_STORE"] = "LakehouseSingleStoreRuntime";
+})(CubeLakehouseRuntimeKind || (CubeLakehouseRuntimeKind = {}));
+/** The runtime Cube writes for a data product or ingest cube (PLAN §6.8) */
+export const CUBE_LAKEHOUSE_RUNTIME_KIND = CubeLakehouseRuntimeKind.LAKEHOUSE;
+/**
+ * The engine's database type each lakehouse runtime routes to (PLAN §11.12):
+ * every `LakehouseRuntime` to Snowflake, for now (user, 2026-10-11); a
+ * SingleStore runtime to SingleStore, the engine's `MemSQL`. The one place to
+ * change when the routing changes or a runtime is added.
+ */
+const LAKEHOUSE_DATABASE_TYPES = new Map([
+    [CubeLakehouseRuntimeKind.LAKEHOUSE, 'Snowflake'],
+    [CubeLakehouseRuntimeKind.SINGLE_STORE, 'MemSQL'],
+]);
+/** The database type a lakehouse runtime of the kind runs on; none for a kind Cube doesn't know */
+export const getLakehouseDatabaseType = (kind) => LAKEHOUSE_DATABASE_TYPES.get(kind);
+//# sourceMappingURL=CubeLakehouseRuntime.js.map

package/lib/graph-manager/CubeLakehouseRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLakehouseRuntime.js","sourceRoot":"","sources":["../../src/graph-manager/CubeLakehouseRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,0DAA8B,CAAA;IAC9B,wEAA4C,CAAA;AAC9C,CAAC,EAHW,wBAAwB,KAAxB,wBAAwB,QAGnC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC,SAAS,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,wBAAwB,GAAgC,IAAI,GAAG,CAAC;IACpE,CAAC,wBAAwB,CAAC,SAAS,EAAE,WAAW,CAAC;IACjD,CAAC,wBAAwB,CAAC,YAAY,EAAE,QAAQ,CAAC;CAClD,CAAC,CAAC;AAEH,mGAAmG;AACnG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC3E,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/lib/graph-manager/CubeProject.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { ModelContext } from '@finos/legend-cube';
+/** The engine's model kind of a project pointer */
+export declare const CUBE_PROJECT_MODEL_TYPE = "pointer";
+/** A published project at one version */
+export interface CubeProjectCoordinates {
+    readonly groupId: string;
+    readonly artifactId: string;
+    readonly versionId: string;
+}
+/** Whether a version can move: a SNAPSHOT, or the depot's `latest` and `HEAD` aliases */
+export declare const isCubeMovingProjectVersion: (versionId: string) => boolean;
+/** The model of a cube on a project's Database */
+export declare const createCubeProjectModel: (project: CubeProjectCoordinates) => ModelContext;
+/** Whether the model is a project pointer, whether or not Cube can run it */
+export declare const isCubeProjectModel: (model: ModelContext) => boolean;
+/**
+ * Why Cube can't run a project model, in words a user can act on; none when
+ * it can. Only released versions are read (user, 2026-10-09): a version that
+ * moves would change a saved cube's tables under it
+ */
+export declare const checkCubeProjectModel: (model: ModelContext) => readonly string[];
+/** The project of a project model Cube can run; undefined for any other model */
+export declare const getCubeProjectCoordinates: (model: ModelContext) => CubeProjectCoordinates | undefined;
+/** The project as people read it: `group:artifact` at its version */
+export declare const formatCubeProject: (project: CubeProjectCoordinates) => string;
+//# sourceMappingURL=CubeProject.d.ts.map

package/lib/graph-manager/CubeProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeProject.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeProject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAGjD,yCAAyC;AACzC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAKD,yFAAyF;AACzF,eAAO,MAAM,0BAA0B,GAAI,WAAW,MAAM,KAAG,OAGzC,CAAC;AAEvB,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,GACjC,SAAS,sBAAsB,KAC9B,YAU4B,CAAC;AAWhC,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,GAAI,OAAO,YAAY,KAAG,OAEX,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,KAClB,SAAS,MAAM,EAkBjB,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,GACpC,OAAO,YAAY,KAClB,sBAAsB,GAAG,SAU3B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,GAAI,SAAS,sBAAsB,KAAG,MACH,CAAC"}

package/lib/graph-manager/CubeProject.js

@@ -0,0 +1,84 @@
+/**
+ * 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.
+ */
+// A cube on a published project's Database (PLAN §6.2.2, §6.3) saves the
+// project at one released version as its model: the engine's alloy pointer,
+// sent to the engine as saved, which fetches the project from its depot. The
+// saved runtime is one of the project's own.
+/** The engine's model kind of a project pointer */
+export const CUBE_PROJECT_MODEL_TYPE = 'pointer';
+const ALLOY_SDLC_TYPE = 'alloy';
+const isNonEmptyString = (value) => typeof value === 'string' && value.length > 0;
+/** Whether a version can move: a SNAPSHOT, or the depot's `latest` and `HEAD` aliases */
+export const isCubeMovingProjectVersion = (versionId) => versionId.endsWith('SNAPSHOT') ||
+    versionId === 'latest' ||
+    versionId === 'HEAD';
+/** The model of a cube on a project's Database */
+export const createCubeProjectModel = (project) => ({
+    _type: CUBE_PROJECT_MODEL_TYPE,
+    sdlcInfo: {
+        _type: ALLOY_SDLC_TYPE,
+        groupId: project.groupId,
+        artifactId: project.artifactId,
+        version: project.versionId,
+        packageableElementPointers: [],
+    },
+});
+const sdlcInfoOf = (model) => {
+    const sdlcInfo = model.sdlcInfo;
+    return sdlcInfo && typeof sdlcInfo === 'object' && !Array.isArray(sdlcInfo)
+        ? sdlcInfo
+        : undefined;
+};
+/** Whether the model is a project pointer, whether or not Cube can run it */
+export const isCubeProjectModel = (model) => model._type === CUBE_PROJECT_MODEL_TYPE &&
+    sdlcInfoOf(model)?._type === ALLOY_SDLC_TYPE;
+/**
+ * Why Cube can't run a project model, in words a user can act on; none when
+ * it can. Only released versions are read (user, 2026-10-09): a version that
+ * moves would change a saved cube's tables under it
+ */
+export const checkCubeProjectModel = (model) => {
+    const sdlcInfo = sdlcInfoOf(model);
+    if (!sdlcInfo) {
+        return [`The cube's project has no coordinates`];
+    }
+    const problems = [];
+    ['groupId', 'artifactId', 'version'].forEach((key) => {
+        if (!isNonEmptyString(sdlcInfo[key])) {
+            problems.push(`The cube's project has no ${key}`);
+        }
+    });
+    const version = sdlcInfo.version;
+    if (isNonEmptyString(version) && isCubeMovingProjectVersion(version)) {
+        problems.push(`Cube reads released versions only, not ${version}: pick a released version`);
+    }
+    return problems;
+};
+/** The project of a project model Cube can run; undefined for any other model */
+export const getCubeProjectCoordinates = (model) => {
+    if (!isCubeProjectModel(model) || checkCubeProjectModel(model).length) {
+        return undefined;
+    }
+    const sdlcInfo = sdlcInfoOf(model);
+    return {
+        groupId: sdlcInfo.groupId,
+        artifactId: sdlcInfo.artifactId,
+        versionId: sdlcInfo.version,
+    };
+};
+/** The project as people read it: `group:artifact` at its version */
+export const formatCubeProject = (project) => `${project.groupId}:${project.artifactId} ${project.versionId}`;
+//# sourceMappingURL=CubeProject.js.map

package/lib/graph-manager/CubeProject.js.map

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

package/lib/graph-manager/CubeProjectCatalog.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { CubeModelOutline } from './CubeEngine.js';
+import type { CubeProjectCoordinates } from './CubeProject.js';
+/** A published project, without a version */
+export interface CubeProjectSummary {
+    readonly groupId: string;
+    readonly artifactId: string;
+}
+export interface CubeProjectCatalog {
+    /** Every published project, by group and artifact */
+    listProjects(): Promise<readonly CubeProjectSummary[]>;
+    /** The project's released versions, newest first: never a SNAPSHOT or an alias */
+    listVersions(project: CubeProjectSummary): Promise<readonly string[]>;
+    /**
+     * The project's own Databases and functions at the version, and the
+     * runtimes of the project and its dependencies; a dependency's Databases
+     * and functions are not offered (user, 2026-10-09, 2026-10-12)
+     */
+    loadOutline(project: CubeProjectCoordinates): Promise<CubeModelOutline>;
+}
+//# sourceMappingURL=CubeProjectCatalog.d.ts.map

package/lib/graph-manager/CubeProjectCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeProjectCatalog.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeProjectCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAK/D,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,YAAY,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IACvD,kFAAkF;IAClF,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACtE;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzE"}

package/lib/graph-manager/CubeProjectCatalog.js

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=CubeProjectCatalog.js.map

package/lib/graph-manager/CubeProjectCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeProjectCatalog.js","sourceRoot":"","sources":["../../src/graph-manager/CubeProjectCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/graph-manager/CubeService.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 { ModelContext } from '@finos/legend-cube';
+export declare const CUBE_SERVICE_MODEL_TYPE = "cubeService";
+export declare const createCubeServiceModel: () => ModelContext;
+export declare const isCubeServiceModel: (model: ModelContext) => boolean;
+//# sourceMappingURL=CubeService.d.ts.map

package/lib/graph-manager/CubeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeService.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,eAAO,MAAM,sBAAsB,QAAO,YACY,CAAC;AAEvD,eAAO,MAAM,kBAAkB,GAAI,OAAO,YAAY,KAAG,OAChB,CAAC"}

package/lib/graph-manager/CubeService.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// A cube on services (PLAN §6.4), in progress: its model only marks it as
+// one, with no runtime. How a service is read, and what it runs on, are
+// still to come
+export const CUBE_SERVICE_MODEL_TYPE = 'cubeService';
+export const createCubeServiceModel = () => ({ _type: CUBE_SERVICE_MODEL_TYPE });
+export const isCubeServiceModel = (model) => model._type === CUBE_SERVICE_MODEL_TYPE;
+//# sourceMappingURL=CubeService.js.map

package/lib/graph-manager/CubeService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeService.js","sourceRoot":"","sources":["../../src/graph-manager/CubeService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,0EAA0E;AAC1E,wEAAwE;AACxE,gBAAgB;AAEhB,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAiB,EAAE,CACvD,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAmB,EAAW,EAAE,CACjE,KAAK,CAAC,KAAK,KAAK,uBAAuB,CAAC"}

package/lib/graph-manager/CubeServiceCatalog.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+/** A deployed service, as the registry lists it */
+export interface CubeServiceSummary {
+    /** The service's name, its element path */
+    readonly name: string;
+    readonly title?: string | undefined;
+    /** Its URL pattern, e.g. `/trades/byDesk`, which the engine's SQL reads it by */
+    readonly pattern: string;
+    readonly documentation: string;
+    /** Who owns it: its owners, or its deployment as `Deployment <id>`; none when the registry doesn't say */
+    readonly owners: readonly string[];
+}
+export interface CubeServiceCatalog {
+    /** Every deployed service, by title, then name */
+    listServices(): Promise<readonly CubeServiceSummary[]>;
+}
+//# sourceMappingURL=CubeServiceCatalog.d.ts.map

package/lib/graph-manager/CubeServiceCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeServiceCatalog.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeServiceCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,YAAY,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;CACxD"}

package/lib/graph-manager/CubeServiceCatalog.js

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=CubeServiceCatalog.js.map

package/lib/graph-manager/CubeServiceCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeServiceCatalog.js","sourceRoot":"","sources":["../../src/graph-manager/CubeServiceCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.d.ts

@@ -13,8 +13,19 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { TracerService } from '@finos/legend-shared';
+import type { DepotServerClient } from '@finos/legend-server-depot';
+import type { LakehouseContractServerClient, LakehouseIngestServerClient, LakehousePlatformServerClient } from '@finos/legend-server-lakehouse';
+import type { MarketplaceServerClient } from '@finos/legend-server-marketplace';
+import type { CubeExpressionCodec, IR } from '@finos/legend-cube';
+import { type PlainObject, type TracerService } from '@finos/legend-shared';
+import type { CubeConnectionExplorer } from '../../CubeConnectionExplorer.js';
+import type { CubeDataProductCatalog, CubeDataProductModelSource, CubeMarketplaceLinkTarget } from '../../CubeDataProductCatalog.js';
 import type { CubeEngine } from '../../CubeEngine.js';
+import type { CubeEngineClientSettings } from '../../CubeEngineClientSettings.js';
+import type { CubeIngestCatalog, CubeIngestDataSet, CubeIngestDefinitionSource } from '../../CubeIngestCatalog.js';
+import type { CubeLakehouseEnvironment } from '../../CubeLakehouseEnvironment.js';
+import type { CubeProjectCatalog } from '../../CubeProjectCatalog.js';
+import type { CubeServiceCatalog } from '../../CubeServiceCatalog.js';
 import { type V1_CubeEngineConfig } from './v1/V1_LegendCubeEngine.js';
 /** The engine client's configuration, as the host gives it (e.g. Legend Query's engine server URL) */
 export type CubeEngineConfig = V1_CubeEngineConfig;
@@ -22,5 +33,103 @@ export type CubeEngineConfig = V1_CubeEngineConfig;
  * The Cube engine of a host (PLAN §3.2): the only place that builds the
  * Legend implementation, so hosts never name a V1_* symbol
  */
-export declare const buildCubeEngine: (config: CubeEngineConfig, tracerService: TracerService) => CubeEngine;
+export declare const buildCubeEngine: (config: CubeEngineConfig, tracerService: TracerService, options?: {
+    /** Data product cubes run only with one */
+    lakehouseEnvironment?: CubeLakehouseEnvironment | undefined;
+    /** The warehouse the viewer last picked, for a data product cube without its own */
+    getRememberedWarehouse?: (() => string | undefined) | undefined;
+    /** Ingest cubes run only with one, built by `buildCubeIngestCatalog` */
+    ingestCatalog?: CubeIngestCatalog | undefined;
+    /** Dev Settings' engine URL and compression, shared by the host's engine clients (PLAN §11.16) */
+    clientSettings?: CubeEngineClientSettings | undefined;
+    /**
+     * The definitions ingest cubes read, for a host whose catalog isn't
+     * built by `buildCubeIngestCatalog`, e.g. Studio's workspace
+     */
+    ingestDefinitionSource?: CubeIngestDefinitionSource | undefined;
+    /**
+     * The model data product cubes read their project from, for a host whose
+     * data products aren't deployed, e.g. Studio's workspace; the project's
+     * deployed version otherwise
+     */
+    dataProductModelSource?: CubeDataProductModelSource | undefined;
+}) => CubeEngine;
+/**
+ * The connection explorer of a host that offers direct connections (PLAN
+ * §6.8), over the same engine as its Cube engine
+ */
+export declare const buildCubeConnectionExplorer: (config: CubeEngineConfig, tracerService: TracerService, clientSettings?: CubeEngineClientSettings) => CubeConnectionExplorer;
+/** What a host gives Cube to read its deployed data products (PLAN §6.8) */
+export interface CubeLakehouseServices {
+    readonly contractServerClient: LakehouseContractServerClient;
+    readonly depotServerClient: DepotServerClient;
+    readonly getAccessToken: () => string | undefined;
+    /** The viewer, whose lakehouse environment data product runs use */
+    readonly getCurrentUser: () => string;
+    /** The environment the host remembers for the viewer, used before their entitlements' first one */
+    readonly getPreferredEnvironment?: (() => string | undefined) | undefined;
+    /** The marketplace's search API: with it, the source dialog searches there, never reading the lakehouse's whole list */
+    readonly marketplaceServerClient?: MarketplaceServerClient | undefined;
+    /** A deployed data product's page in the host's marketplace; none when the host has no marketplace */
+    readonly getMarketplaceLink?: ((target: CubeMarketplaceLinkTarget) => string | undefined) | undefined;
+    /**
+     * The stereotype the host's marketplace marks access point groups open to
+     * everyone with; without it, a group with no contract shows no access
+     */
+    readonly enterpriseStereotype?: {
+        readonly profile: string;
+        readonly value: string;
+    } | undefined;
+    /** The lakehouse platform, whose ingest environments the Ingest tab reads (PLAN §6.7) */
+    readonly platformServerClient?: LakehousePlatformServerClient | undefined;
+    /** A client for the ingest servers the platform names: each call names its server */
+    readonly ingestServerClient?: LakehouseIngestServerClient | undefined;
+}
+/** The deployed data products of a host with a lakehouse and a depot */
+export declare const buildCubeDataProductCatalog: (services: CubeLakehouseServices) => CubeDataProductCatalog;
+/**
+ * The published projects a cube reads Databases from (PLAN §6.3), through
+ * the host's depot. It reads nothing until the source dialog's Project tab
+ * asks
+ */
+export declare const buildCubeProjectCatalog: (depotServerClient: DepotServerClient) => CubeProjectCatalog;
+/**
+ * The services in the engine's registry (PLAN §6.4), read through their own
+ * client, configured as the engine's. The registry isn't in every engine: a
+ * host whose engine has none offers no catalog.
+ */
+export declare const buildCubeServiceCatalog: (config: CubeEngineConfig, tracerService: TracerService, clientSettings?: CubeEngineClientSettings) => CubeServiceCatalog;
+/** The viewer's lakehouse environment, which the engine needs to run data product cubes */
+export declare const buildCubeLakehouseEnvironment: (services: CubeLakehouseServices) => CubeLakehouseEnvironment;
+/**
+ * The deployed ingest definitions of a host with a lakehouse platform (PLAN
+ * §6.7), or none without one. It parses definitions with the engine Cube
+ * uses; pass it to `buildCubeEngine` too, so ingest cubes run
+ */
+export declare const buildCubeIngestCatalog: (config: CubeEngineConfig, tracerService: TracerService, services: CubeLakehouseServices, clientSettings?: CubeEngineClientSettings) => CubeIngestCatalog | undefined;
+/**
+ * A lambda Cube emitted, as protocol JSON for a host to keep, e.g. in a
+ * Studio ingest definition: plain JSON numbers, and none of the source
+ * information Cube stamps on a lambda to place the engine's errors
+ */
+export declare const serializeCubeLambdaForHost: (lambda: IR) => PlainObject;
+/**
+ * The data sets of an ingest definition's content, its protocol JSON, in
+ * order, typed from what it declares; for a host that lists definitions of
+ * its own, e.g. Studio's workspace. Throws when the content can't be read.
+ */
+export declare const readCubeIngestDataSets: (content: PlainObject) => CubeIngestDataSet[];
+/**
+ * The IR of a lambda's protocol JSON, Cube's or the engine's grammar's, for
+ * Import Pure (PLAN §11.18): a host's matview, or a pasted lambda. Throws a
+ * `CubeLambdaReadError` naming what Cube can't read.
+ */
+export declare const readCubeLambdaJson: (json: unknown) => IR;
+/**
+ * How Import Pure stores an expression it reads into a step, and reads one a
+ * step stores (PLAN §11.18): as the Extend and Filter by Expression editors
+ * store the engine's JSON, with no source information and number literals as
+ * their digit strings
+ */
+export declare const CUBE_EXPRESSION_CODEC: CubeExpressionCodec;
 //# sourceMappingURL=CubeEngineBuilder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeEngineBuilder.d.ts","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,gBAAgB,EACxB,eAAe,aAAa,KAC3B,UAA4D,CAAC"}
+{"version":3,"file":"CubeEngineBuilder.d.ts","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"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"}