@finos/legend-cube-builder 0.0.2 → 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":"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"}

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/CubeModelOutlineHelper.d.ts

@@ -22,4 +22,12 @@ import type { CubeModelOutline, CubeOutlineRuntime } from './CubeEngine.js';
  * §6.2.5).
  */
 export declare const getRuntimesForDatabase: (outline: CubeModelOutline, databasePath: string) => CubeOutlineRuntime[];
+/**
+ * The database type a query on these databases runs on with the runtime, for
+ * the operations some databases take another way (PLAN §11.4): the type of
+ * the runtime's connections to them. None when the runtime isn't in the
+ * outline, a database has no typed connection, or the databases' types
+ * differ: the native forms are written then.
+ */
+export declare const getDatabaseType: (outline: CubeModelOutline, runtimePath: string, databasePaths: readonly string[]) => string | undefined;
 //# sourceMappingURL=CubeModelOutlineHelper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeModelOutlineHelper.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,gBAAgB,EACzB,cAAc,MAAM,KACnB,kBAAkB,EAGlB,CAAC"}
+{"version":3,"file":"CubeModelOutlineHelper.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,gBAAgB,EACzB,cAAc,MAAM,KACnB,kBAAkB,EAGlB,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,EACzB,aAAa,MAAM,EACnB,eAAe,SAAS,MAAM,EAAE,KAC/B,MAAM,GAAG,SAaX,CAAC"}

package/lib/graph-manager/CubeModelOutlineHelper.js

@@ -21,4 +21,25 @@
  * §6.2.5).
  */
 export const getRuntimesForDatabase = (outline, databasePath) => outline.runtimes.filter((runtime) => runtime.storePaths.includes(databasePath));
+/**
+ * The database type a query on these databases runs on with the runtime, for
+ * the operations some databases take another way (PLAN §11.4): the type of
+ * the runtime's connections to them. None when the runtime isn't in the
+ * outline, a database has no typed connection, or the databases' types
+ * differ: the native forms are written then.
+ */
+export const getDatabaseType = (outline, runtimePath, databasePaths) => {
+    const runtime = outline.runtimes.find(({ path }) => path === runtimePath);
+    const types = new Set();
+    for (const databasePath of new Set(databasePaths)) {
+        const databaseTypes = (runtime?.connections ?? [])
+            .filter(({ storePath }) => storePath === databasePath)
+            .map(({ databaseType }) => databaseType);
+        if (!databaseTypes.length) {
+            return undefined;
+        }
+        databaseTypes.forEach((databaseType) => types.add(databaseType));
+    }
+    return types.size === 1 ? [...types][0] : undefined;
+};
 //# sourceMappingURL=CubeModelOutlineHelper.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeModelOutlineHelper.js","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAyB,EACzB,YAAoB,EACE,EAAE,CACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC1C,CAAC"}
+{"version":3,"file":"CubeModelOutlineHelper.js","sourceRoot":"","sources":["../../src/graph-manager/CubeModelOutlineHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAyB,EACzB,YAAoB,EACE,EAAE,CACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC1C,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAyB,EACzB,WAAmB,EACnB,aAAgC,EACZ,EAAE;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,YAAY,IAAI,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;aAC/C,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC;aACrD,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,aAAa,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,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 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"}