@finos/legend-cube-builder 0.0.3 → 0.0.4

package/lib/graph-manager/CubeIngest.js

@@ -0,0 +1,88 @@
+/**
+ * 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 { CubeDataProductEnvironmentType } from './CubeDataProduct.js';
+// An ingest cube (PLAN §6.7) saves, as its model, what Data Cube's producer
+// source picks before a definition: the class (production or production
+// parallel), the producer deployment and, once picked, the warehouse. Its
+// sources save each definition's URN, path and data set. The engine's
+// implementation builds, for each call, a model of the definitions the call
+// reads, as the ingest server serves them, and for a run a lakehouse runtime
+// at a fixed path, which the saved runtime names
+export const CUBE_INGEST_MODEL_TYPE = 'cubeIngest';
+export const CUBE_INGEST_RUNTIME_PATH = 'cube::ingest::Runtime';
+const ENVIRONMENT_TYPES = Object.values(CubeDataProductEnvironmentType);
+const isNonEmptyString = (value) => typeof value === 'string' && value.length > 0;
+export const createCubeIngestModel = (settings) => ({
+    _type: CUBE_INGEST_MODEL_TYPE,
+    environmentType: settings.environmentType,
+    producerDeploymentId: settings.producerDeploymentId,
+    ...(settings.warehouse !== undefined
+        ? { warehouse: settings.warehouse }
+        : {}),
+});
+export const isCubeIngestModel = (model) => model._type === CUBE_INGEST_MODEL_TYPE;
+/** The same model, running on another warehouse */
+export const withCubeIngestWarehouse = (model, warehouse) => ({ ...model, warehouse });
+/** What's wrong with an ingest model, e.g. one saved by a later Cube: nothing for one Cube can use */
+export const checkCubeIngestModel = (model) => {
+    const problems = [];
+    if (!ENVIRONMENT_TYPES.includes(model.environmentType)) {
+        problems.push(`Cube doesn't know the environment type "${String(model.environmentType)}"`);
+    }
+    if (typeof model.producerDeploymentId !== 'string' ||
+        !/^\d+$/u.test(model.producerDeploymentId)) {
+        problems.push(`The cube's producer deployment must be a deployment id`);
+    }
+    if (model.warehouse !== undefined && !isNonEmptyString(model.warehouse)) {
+        problems.push(`The cube's warehouse must be a name`);
+    }
+    return problems;
+};
+/** An ingest model's settings, when Cube can use it */
+export const getCubeIngestSettings = (model) => isCubeIngestModel(model) && !checkCubeIngestModel(model).length
+    ? {
+        environmentType: model.environmentType,
+        producerDeploymentId: model.producerDeploymentId,
+        warehouse: model.warehouse,
+    }
+    : undefined;
+/** The class a URN's environment segment names */
+const URN_ENVIRONMENT_TYPES = {
+    prod: CubeDataProductEnvironmentType.PRODUCTION,
+    'prod-parallel': CubeDataProductEnvironmentType.PRODUCTION_PARALLEL,
+};
+const SDLC_DEPLOYED_URN = /^urn:lakehouse:(?<environment>[^:]+):ingest:definition:alloy-git:(?<groupId>[^~]+)~(?<artifactId>[^~]+)~(?<definition>.+)$/u;
+/**
+ * A deployed definition's URN, when it was deployed from SDLC
+ * (`urn:lakehouse:<prod|prod-parallel>:ingest:definition:alloy-git:<group>~<artifact>~<path>`);
+ * nothing for an ad hoc one (`rest-api:`), another class, or text that isn't one
+ */
+export const parseCubeIngestUrn = (urn) => {
+    const parts = SDLC_DEPLOYED_URN.exec(urn)?.groups;
+    const environment = parts?.environment;
+    const environmentType = environment && Object.hasOwn(URN_ENVIRONMENT_TYPES, environment)
+        ? URN_ENVIRONMENT_TYPES[environment]
+        : undefined;
+    return parts && environmentType
+        ? {
+            environmentType,
+            groupId: parts.groupId ?? '',
+            artifactId: parts.artifactId ?? '',
+            definition: parts.definition ?? '',
+        }
+        : undefined;
+};
+//# sourceMappingURL=CubeIngest.js.map

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

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

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

@@ -0,0 +1,116 @@
+/**
+ * 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 { CubeDataProductEnvironmentType } from './CubeDataProduct.js';
+import type { CubeEngineError, NodeId } from './CubeEngine.js';
+/** A data set of a deployed ingest definition, as the definition declares it */
+export declare class CubeIngestDataSet {
+    readonly name: string;
+    /** Its columns: the declared ones, then the milestoning ones of its write mode; none when they can't be read */
+    readonly schema: Schema | undefined;
+    /** Why it can't be picked, e.g. it is a materialized view; none when it can */
+    readonly disabledReason: string | undefined;
+    readonly primaryKey: readonly string[];
+    constructor(fields: {
+        name: string;
+        schema?: Schema | undefined;
+        disabledReason?: string | undefined;
+        primaryKey?: readonly string[];
+    });
+    get isPickable(): boolean;
+}
+/** The viewer's ingest environment for a class: shown in the Ingest tab, never saved */
+export declare class CubeIngestEnvironment {
+    readonly environmentType: CubeDataProductEnvironmentType;
+    /** The environment's name, as the platform lists it */
+    readonly name: string;
+    /** The environment a run's lakehouse runtime names */
+    readonly runtimeEnvironment: string;
+    constructor(fields: {
+        environmentType: CubeDataProductEnvironmentType;
+        name: string;
+        runtimeEnvironment: string;
+    });
+}
+/** A producer deployment of the viewer's ingest environment */
+export declare class CubeIngestProducer {
+    /** Its deployment id, as text */
+    readonly deploymentId: string;
+    readonly urn: string;
+    constructor(fields: {
+        deploymentId: string;
+        urn: string;
+    });
+}
+/** A definition a producer deployment deployed from SDLC */
+export declare class CubeIngestDefinitionCandidate {
+    readonly urn: string;
+    /** The IngestDefinition element's path */
+    readonly definition: string;
+    readonly groupId: string;
+    readonly artifactId: string;
+    constructor(fields: {
+        urn: string;
+        definition: string;
+        groupId: string;
+        artifactId: string;
+    });
+    /** The definition's element name: the last segment of its path */
+    get name(): string;
+}
+/** A producer deployment's definitions: those Cube reads, and how many it left out */
+export interface CubeIngestDefinitionList {
+    readonly candidates: readonly CubeIngestDefinitionCandidate[];
+    /** Definitions not deployed from SDLC, or deployed to another class */
+    readonly droppedCount: number;
+}
+/** Where a saved ingest source's data set is */
+export interface CubeIngestDataSetLocation {
+    readonly ingestDefinitionUrn: string;
+    readonly ingestDefinition: string;
+    readonly dataSet: string;
+}
+/**
+ * The deployed ingest definitions, for the source dialog and for re-checking
+ * saved sources: its own port, so hosts without them need none. Calls fail
+ * with a `CubeEngineError`: with no node for listing and describing, with
+ * the node's id for schemas
+ */
+export interface CubeIngestCatalog {
+    /** The classes the host lists, the default first */
+    readonly environmentTypes: readonly CubeDataProductEnvironmentType[];
+    /** The viewer's ingest environment for a class */
+    resolveEnvironment(environmentType: CubeDataProductEnvironmentType): Promise<CubeIngestEnvironment>;
+    /** The producer deployments of the viewer's ingest environment for a class */
+    listProducers(environmentType: CubeDataProductEnvironmentType): Promise<readonly CubeIngestProducer[]>;
+    /** A producer deployment's SDLC-deployed definitions of the class */
+    listDefinitions(environmentType: CubeDataProductEnvironmentType, producerDeploymentId: string): Promise<CubeIngestDefinitionList>;
+    /**
+     * A definition's data sets, typed from what it declares. `fresh` reads the
+     * definition again rather than what this page visit read
+     */
+    describe(urn: string, environmentType: CubeDataProductEnvironmentType, options?: {
+        readonly fresh?: boolean | undefined;
+    }): Promise<readonly CubeIngestDataSet[]>;
+    /**
+     * The schema of each saved source, from its definition as deployed: one
+     * entry per key, failures included. `fresh` reads the definitions again
+     */
+    resolveSchemas(environmentType: CubeDataProductEnvironmentType, sources: ReadonlyMap<NodeId, CubeIngestDataSetLocation>, options?: {
+        readonly fresh?: boolean | undefined;
+    }): Promise<Map<NodeId, Schema | CubeEngineError>>;
+}
+//# sourceMappingURL=CubeIngestCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeIngestCatalog.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeIngestCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAO/D,gFAAgF;AAChF,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gHAAgH;IAChH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE3B,MAAM,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAChC;IAOD,IAAI,UAAU,IAAI,OAAO,CAExB;CACF;AAED,wFAAwF;AACxF,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAExB,MAAM,EAAE;QAClB,eAAe,EAAE,8BAA8B,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC;QACb,kBAAkB,EAAE,MAAM,CAAC;KAC5B;CAKF;AAED,+DAA+D;AAC/D,qBAAa,kBAAkB;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAI1D;AAED,4DAA4D;AAC5D,qBAAa,6BAA6B;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB;IAOD,kEAAkE;IAClE,IAAI,IAAI,IAAI,MAAM,CAGjB;CACF;AAED,sFAAsF;AACtF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC9D,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAErE,kDAAkD;IAClD,kBAAkB,CAChB,eAAe,EAAE,8BAA8B,GAC9C,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElC,8EAA8E;IAC9E,aAAa,CACX,eAAe,EAAE,8BAA8B,GAC9C,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IAE1C,qEAAqE;IACrE,eAAe,CACb,eAAe,EAAE,8BAA8B,EAC/C,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAErC;;;OAGG;IACH,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,8BAA8B,EAC/C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GACjD,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;IAEzC;;;OAGG;IACH,cAAc,CACZ,eAAe,EAAE,8BAA8B,EAC/C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,EACvD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GACjD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;CACnD"}

package/lib/graph-manager/CubeIngestCatalog.js

@@ -0,0 +1,80 @@
+/**
+ * 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 deployed ingest definitions of a host's lakehouse (PLAN §6.7), as Data
+// Cube's producer source lists them: the viewer's ingest environment for a
+// class, its producer deployments, a deployment's SDLC-deployed definitions,
+// and a definition's data sets
+/** A data set of a deployed ingest definition, as the definition declares it */
+export class CubeIngestDataSet {
+    name;
+    /** Its columns: the declared ones, then the milestoning ones of its write mode; none when they can't be read */
+    schema;
+    /** Why it can't be picked, e.g. it is a materialized view; none when it can */
+    disabledReason;
+    primaryKey;
+    constructor(fields) {
+        this.name = fields.name;
+        this.schema = fields.schema;
+        this.disabledReason = fields.disabledReason;
+        this.primaryKey = fields.primaryKey ?? [];
+    }
+    get isPickable() {
+        return this.disabledReason === undefined && this.schema !== undefined;
+    }
+}
+/** The viewer's ingest environment for a class: shown in the Ingest tab, never saved */
+export class CubeIngestEnvironment {
+    environmentType;
+    /** The environment's name, as the platform lists it */
+    name;
+    /** The environment a run's lakehouse runtime names */
+    runtimeEnvironment;
+    constructor(fields) {
+        this.environmentType = fields.environmentType;
+        this.name = fields.name;
+        this.runtimeEnvironment = fields.runtimeEnvironment;
+    }
+}
+/** A producer deployment of the viewer's ingest environment */
+export class CubeIngestProducer {
+    /** Its deployment id, as text */
+    deploymentId;
+    urn;
+    constructor(fields) {
+        this.deploymentId = fields.deploymentId;
+        this.urn = fields.urn;
+    }
+}
+/** A definition a producer deployment deployed from SDLC */
+export class CubeIngestDefinitionCandidate {
+    urn;
+    /** The IngestDefinition element's path */
+    definition;
+    groupId;
+    artifactId;
+    constructor(fields) {
+        this.urn = fields.urn;
+        this.definition = fields.definition;
+        this.groupId = fields.groupId;
+        this.artifactId = fields.artifactId;
+    }
+    /** The definition's element name: the last segment of its path */
+    get name() {
+        const index = this.definition.lastIndexOf('::');
+        return index < 0 ? this.definition : this.definition.slice(index + 2);
+    }
+}
+//# sourceMappingURL=CubeIngestCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeIngestCatalog.js","sourceRoot":"","sources":["../../src/graph-manager/CubeIngestCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,+BAA+B;AAE/B,gFAAgF;AAChF,MAAM,OAAO,iBAAiB;IACnB,IAAI,CAAS;IACtB,gHAAgH;IACvG,MAAM,CAAqB;IACpC,+EAA+E;IACtE,cAAc,CAAqB;IACnC,UAAU,CAAoB;IAEvC,YAAY,MAKX;QACC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACxE,CAAC;CACF;AAED,wFAAwF;AACxF,MAAM,OAAO,qBAAqB;IACvB,eAAe,CAAiC;IACzD,uDAAuD;IAC9C,IAAI,CAAS;IACtB,sDAAsD;IAC7C,kBAAkB,CAAS;IAEpC,YAAY,MAIX;QACC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACtD,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,OAAO,kBAAkB;IAC7B,iCAAiC;IACxB,YAAY,CAAS;IACrB,GAAG,CAAS;IAErB,YAAY,MAA6C;QACvD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACxB,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,6BAA6B;IAC/B,GAAG,CAAS;IACrB,0CAA0C;IACjC,UAAU,CAAS;IACnB,OAAO,CAAS;IAChB,UAAU,CAAS;IAE5B,YAAY,MAKX;QACC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACtC,CAAC;IAED,kEAAkE;IAClE,IAAI,IAAI;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACxE,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+/**
+ * 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 { CubeDataProductProject } from './CubeDataProduct.js';
+/**
+ * The viewer's lakehouse environment (PLAN §6.8), which a data product run
+ * names in its lakehouse runtime: its own port, so hosts without a lakehouse
+ * need none. Fails with a `CubeEngineError` when the viewer has none
+ */
+export interface CubeLakehouseEnvironment {
+    /** The viewer's environment for the project's class, e.g. `env`, or `env-pp` for production-parallel */
+    resolveEnvironment(project: CubeDataProductProject): Promise<string>;
+}
+//# sourceMappingURL=CubeLakehouseEnvironment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLakehouseEnvironment.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeLakehouseEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,wGAAwG;IACxG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE"}

package/lib/graph-manager/CubeLakehouseEnvironment.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=CubeLakehouseEnvironment.js.map

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

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

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 at the version, and the runtimes of the
+     * project and its dependencies; a dependency's Databases are not offered
+     * (user, 2026-10-09)
+     */
+    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/protocol/pure/CubeEngineBuilder.d.ts

@@ -13,8 +13,16 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+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 { TracerService } from '@finos/legend-shared';
+import type { CubeConnectionExplorer } from '../../CubeConnectionExplorer.js';
+import type { CubeDataProductCatalog, CubeMarketplaceLinkTarget } from '../../CubeDataProductCatalog.js';
 import type { CubeEngine } from '../../CubeEngine.js';
+import type { CubeIngestCatalog } from '../../CubeIngestCatalog.js';
+import type { CubeLakehouseEnvironment } from '../../CubeLakehouseEnvironment.js';
+import type { CubeProjectCatalog } from '../../CubeProjectCatalog.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 +30,59 @@ 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;
+}) => 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) => 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 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) => CubeIngestCatalog | undefined;
 //# 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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"}