@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.js

@@ -13,10 +13,117 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { V1_EngineServerClient } from '@finos/legend-graph';
+import { parseLosslessJSON, stringifyLosslessJSON, } from '@finos/legend-shared';
+import { V1_CubeLakehouseEnvironmentResolver } from './v1/V1_CubeLakehouseEnvironmentResolver.js';
+import { V1_LegendCubeConnectionExplorer } from './v1/V1_LegendCubeConnectionExplorer.js';
+import { V1_LegendCubeDataProductCatalog } from './v1/V1_LegendCubeDataProductCatalog.js';
+import { V1_LegendCubeIngestCatalog } from './v1/V1_LegendCubeIngestCatalog.js';
+import { V1_LegendCubeProjectCatalog } from './v1/V1_LegendCubeProjectCatalog.js';
+import { V1_LegendCubeServiceCatalog } from './v1/V1_LegendCubeServiceCatalog.js';
+import { V1_readCubeIngestDataSets } from './v1/V1_CubeIngestDefinition.js';
+import { V1_serializeCubeLambda } from './v1/V1_CubeLambdaSerializer.js';
+import { V1_readCubeLambda, V1_readCubeValueSpecification, } from './v1/V1_CubeLambdaReader.js';
+import { V1_readCubeExpression } from './v1/V1_CubeExpression.js';
 import { V1_LegendCubeEngine, } from './v1/V1_LegendCubeEngine.js';
 /**
  * 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 const buildCubeEngine = (config, tracerService) => new V1_LegendCubeEngine(config, tracerService);
+export const buildCubeEngine = (config, tracerService, options) => new V1_LegendCubeEngine(config, tracerService, {
+    clientSettings: options?.clientSettings,
+    lakehouseEnvironment: options?.lakehouseEnvironment,
+    getRememberedWarehouse: options?.getRememberedWarehouse,
+    dataProductModels: options?.dataProductModelSource,
+    // the catalog reads the definitions the engine types and runs on
+    ingestDefinitions: options?.ingestDefinitionSource ??
+        (options?.ingestCatalog instanceof V1_LegendCubeIngestCatalog
+            ? options.ingestCatalog
+            : undefined),
+});
+/**
+ * The connection explorer of a host that offers direct connections (PLAN
+ * §6.8), over the same engine as its Cube engine
+ */
+export const buildCubeConnectionExplorer = (config, tracerService, clientSettings) => new V1_LegendCubeConnectionExplorer(config, tracerService, clientSettings);
+/** The deployed data products of a host with a lakehouse and a depot */
+export const buildCubeDataProductCatalog = (services) => new V1_LegendCubeDataProductCatalog(services.contractServerClient, services.depotServerClient, services.getAccessToken, {
+    marketplaceServerClient: services.marketplaceServerClient,
+    marketplaceLink: services.getMarketplaceLink,
+    getCurrentUser: services.getCurrentUser,
+    enterpriseStereotype: services.enterpriseStereotype,
+});
+/**
+ * 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 const buildCubeProjectCatalog = (depotServerClient) => new V1_LegendCubeProjectCatalog(depotServerClient);
+/**
+ * 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 const buildCubeServiceCatalog = (config, tracerService, clientSettings) => {
+    const engineClient = new V1_EngineServerClient(config);
+    // every call throws without one
+    engineClient.setTracerService(tracerService);
+    clientSettings?.register(engineClient);
+    return new V1_LegendCubeServiceCatalog(() => engineClient.getServicesInfo());
+};
+/** The viewer's lakehouse environment, which the engine needs to run data product cubes */
+export const buildCubeLakehouseEnvironment = (services) => new V1_CubeLakehouseEnvironmentResolver(services.contractServerClient, services.getAccessToken, services.getCurrentUser, services.getPreferredEnvironment);
+/**
+ * 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 const buildCubeIngestCatalog = (config, tracerService, services, clientSettings) => {
+    const { platformServerClient, ingestServerClient } = services;
+    if (!platformServerClient || !ingestServerClient) {
+        return undefined;
+    }
+    const engineClient = new V1_EngineServerClient(config);
+    // every call throws without one
+    engineClient.setTracerService(tracerService);
+    clientSettings?.register(engineClient);
+    const environment = new V1_CubeLakehouseEnvironmentResolver(services.contractServerClient, services.getAccessToken, services.getCurrentUser, services.getPreferredEnvironment);
+    return new V1_LegendCubeIngestCatalog(platformServerClient, ingestServerClient, () => environment.resolveBaseEnvironment(), (code) => engineClient.grammarToJSON_model(code), services.getAccessToken);
+};
+/** The JSON without any `sourceInformation`, at any depth */
+const withoutSourceInformation = (json) => Array.isArray(json)
+    ? json.map(withoutSourceInformation)
+    : json !== null && typeof json === 'object'
+        ? Object.fromEntries(Object.entries(json)
+            .filter(([key]) => key !== 'sourceInformation')
+            .map(([key, value]) => [key, withoutSourceInformation(value)]))
+        : json;
+/**
+ * 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 const serializeCubeLambdaForHost = (lambda) => withoutSourceInformation(JSON.parse(stringifyLosslessJSON(V1_serializeCubeLambda(lambda))));
+/**
+ * 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 const readCubeIngestDataSets = (content) => V1_readCubeIngestDataSets(content);
+/**
+ * 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 const readCubeLambdaJson = (json) => V1_readCubeLambda(json);
+/**
+ * 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 const CUBE_EXPRESSION_CODEC = {
+    write: (lambda) => V1_readCubeExpression(parseLosslessJSON(stringifyLosslessJSON(V1_serializeCubeLambda(lambda)))).lambda,
+    read: (json) => V1_readCubeValueSpecification(json),
+};
 //# sourceMappingURL=CubeEngineBuilder.js.map

package/lib/graph-manager/protocol/pure/CubeEngineBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeEngineBuilder.js","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAEL,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAKrC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAwB,EACxB,aAA4B,EAChB,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC"}
+{"version":3,"file":"CubeEngineBuilder.js","sourceRoot":"","sources":["../../../../src/graph-manager/protocol/pure/CubeEngineBuilder.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+/**
+ * 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 CubeAccessPointLocation, type CubeDataProductCandidate, CubeDataProductDescription } from '../../../CubeDataProductCatalog.js';
+/** How many sample rows the preview shows */
+export declare const V1_CUBE_SAMPLE_ROW_LIMIT = 5;
+/** Why an access point can't be picked */
+export declare const V1_CUBE_ACCESS_POINT_REASON: {
+    readonly MODEL_GROUP: "Model access point groups are not supported yet";
+    readonly NOT_LAKEHOUSE: "Only Lakehouse access points can be added for now";
+    readonly PARAMETERS: "It takes parameters, which Cube does not support yet";
+    readonly NOT_DEPLOYED: "It is not in the deployed artifact";
+    readonly NO_DEFINITION: "Cube couldn't read the data product's definition";
+    readonly NO_RELATION: "Its result is not a relation";
+    readonly NO_TYPE: "Its columns are not in the deployed artifact";
+    readonly BAD_MULTIPLICITY: (column: string) => string;
+};
+/** The stereotype a host's marketplace marks groups open to everyone with */
+export interface V1_CubeEnterpriseStereotype {
+    readonly profile: string;
+    readonly value: string;
+}
+/**
+ * A product's access points by group, as its definition lists them. One is
+ * pickable when it is a Lakehouse access point without parameters, outside
+ * a model group, deployed with a relation of columns Cube can read
+ */
+export declare const V1_readCubeDataProductDescription: (candidate: CubeDataProductCandidate, artifact: unknown, definition: unknown, enterpriseStereotype?: V1_CubeEnterpriseStereotype | undefined) => CubeDataProductDescription;
+/** A saved source's schema, from the product's description, or why it has none */
+export declare const V1_findCubeAccessPointSchema: (description: CubeDataProductDescription, location: CubeAccessPointLocation) => Schema | string;
+//# sourceMappingURL=V1_CubeDataProductArtifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductArtifact.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeDataProductArtifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAW5C,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAM1C,0CAA0C;AAC1C,eAAO,MAAM,2BAA2B;;;;;;;;wCAQX,MAAM,KAAG,MAAM;CAElC,CAAC;AA4FX,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAeD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,WAAW,wBAAwB,EACnC,UAAU,OAAO,EACjB,YAAY,OAAO,EACnB,uBAAuB,2BAA2B,GAAG,SAAS,KAC7D,0BA4DF,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,GACvC,aAAa,0BAA0B,EACvC,UAAU,uBAAuB,KAChC,MAAM,GAAG,MAUX,CAAC"}

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

@@ -0,0 +1,192 @@
+/**
+ * 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 { CubeAccessPoint, CubeAccessPointGroup, CubeDataProductDescription, } from '../../../CubeDataProductCatalog.js';
+import { V1_buildCubeSchema } from './V1_CubeRelationTypeAdapter.js';
+// A deployed data product's access points (PLAN §6.8), read from two
+// documents: the product's definition at its deployed version (titles, kinds
+// and parameters) and its deployed artifact (each access point's columns, as
+// the engine typed them when it deployed, and sample rows). Both are read
+// tolerantly: what Cube doesn't know is skipped, and a problem stays on its
+// access point, which is listed but can't be picked. No engine call
+/** How many sample rows the preview shows */
+export const V1_CUBE_SAMPLE_ROW_LIMIT = 5;
+const LAKEHOUSE_ACCESS_POINT_TYPE = 'lakehouseAccessPoint';
+const MODEL_ACCESS_POINT_GROUP_TYPE = 'modelAccessPointGroup';
+const RELATION_TYPE = 'relationType';
+/** Why an access point can't be picked */
+export const V1_CUBE_ACCESS_POINT_REASON = {
+    MODEL_GROUP: 'Model access point groups are not supported yet',
+    NOT_LAKEHOUSE: 'Only Lakehouse access points can be added for now',
+    PARAMETERS: 'It takes parameters, which Cube does not support yet',
+    NOT_DEPLOYED: 'It is not in the deployed artifact',
+    NO_DEFINITION: "Cube couldn't read the data product's definition",
+    NO_RELATION: 'Its result is not a relation',
+    NO_TYPE: 'Its columns are not in the deployed artifact',
+    BAD_MULTIPLICITY: (column) => `Column "${column}" holds more than one value, which Cube can't show`,
+};
+const asObject = (value) => value && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : {};
+const asList = (value) => Array.isArray(value) ? value : [];
+const asString = (value) => typeof value === 'string' && value.length ? value : undefined;
+/** A pair's key: an access point is known by its group and its own id */
+const keyOf = (groupId, accessPointId) => JSON.stringify([groupId, accessPointId]);
+/** The artifact's access point implementations, by group and id */
+const readImplementations = (artifact) => {
+    const implementations = new Map();
+    asList(asObject(artifact).accessPointGroups).forEach((group) => {
+        const groupId = asString(asObject(group).id);
+        if (!groupId) {
+            return;
+        }
+        asList(asObject(group).accessPointImplementations).forEach((value) => {
+            const implementation = asObject(value);
+            const id = asString(implementation.id);
+            if (id) {
+                implementations.set(keyOf(groupId, id), implementation);
+            }
+        });
+    });
+    return implementations;
+};
+/**
+ * An access point's columns, from its implementation's lambdaGenericType:
+ * the first relation type among its type arguments, whatever the outer type
+ * (a relation, or an ingest relation accessor)
+ */
+const readSchema = (implementation) => {
+    const genericType = asObject(implementation.lambdaGenericType);
+    if (!Object.keys(genericType).length) {
+        return { reason: V1_CUBE_ACCESS_POINT_REASON.NO_TYPE };
+    }
+    const relationType = asList(genericType.typeArguments)
+        .map((argument) => asObject(asObject(argument).rawType))
+        .find((rawType) => rawType._type === RELATION_TYPE);
+    if (!relationType) {
+        return { reason: V1_CUBE_ACCESS_POINT_REASON.NO_RELATION };
+    }
+    for (const column of asList(relationType.columns).map(asObject)) {
+        const multiplicity = asObject(column.multiplicity);
+        if (Object.keys(multiplicity).length && multiplicity.upperBound !== 1) {
+            return {
+                reason: V1_CUBE_ACCESS_POINT_REASON.BAD_MULTIPLICITY(String(column.name)),
+            };
+        }
+    }
+    try {
+        return { schema: V1_buildCubeSchema(relationType) };
+    }
+    catch (error) {
+        return { reason: error instanceof Error ? error.message : String(error) };
+    }
+};
+/** Up to the preview's limit of rows, by the schema's columns; the artifact holds them as text */
+const readSampleRows = (implementation, schema) => {
+    const element = asObject(implementation.relationElement);
+    const columns = asList(element.columns).map(String);
+    const positions = schema.columns.map((column) => columns.indexOf(column.name));
+    return asList(element.rows)
+        .slice(0, V1_CUBE_SAMPLE_ROW_LIMIT)
+        .map((row) => {
+        const values = asList(asObject(row).values);
+        return positions.map((position) => {
+            const value = position < 0 ? undefined : values[position];
+            return value === undefined || value === null ? null : String(value);
+        });
+    });
+};
+/** Whether a group's definition carries the host's enterprise stereotype */
+const isEnterpriseGroup = (group, stereotype) => stereotype !== undefined &&
+    asList(group.stereotypes)
+        .map(asObject)
+        .some((each) => each.profile === stereotype.profile && each.value === stereotype.value);
+/**
+ * A product's access points by group, as its definition lists them. One is
+ * pickable when it is a Lakehouse access point without parameters, outside
+ * a model group, deployed with a relation of columns Cube can read
+ */
+export const V1_readCubeDataProductDescription = (candidate, artifact, definition, enterpriseStereotype) => {
+    const implementations = readImplementations(artifact);
+    const hasDefinition = Boolean(asObject(definition).accessPointGroups);
+    // without a definition, the artifact's groups are listed, unpickable
+    const groupsJson = hasDefinition
+        ? asList(asObject(definition).accessPointGroups)
+        : asList(asObject(artifact).accessPointGroups).map((group) => ({
+            ...asObject(group),
+            accessPoints: asList(asObject(group).accessPointImplementations),
+        }));
+    const groups = groupsJson
+        .map(asObject)
+        .filter((group) => asString(group.id))
+        .map((group) => {
+        const groupId = group.id;
+        const isModelGroup = group._type === MODEL_ACCESS_POINT_GROUP_TYPE;
+        return new CubeAccessPointGroup({
+            id: groupId,
+            title: asString(group.title),
+            isEnterprise: isEnterpriseGroup(group, enterpriseStereotype),
+            accessPoints: asList(group.accessPoints)
+                .map(asObject)
+                .filter((point) => asString(point.id))
+                .map((point) => {
+                const id = point.id;
+                const implementation = implementations.get(keyOf(groupId, id));
+                const read = implementation
+                    ? readSchema(implementation)
+                    : undefined;
+                const schema = read && 'schema' in read ? read.schema : undefined;
+                const disabledReason = !hasDefinition
+                    ? V1_CUBE_ACCESS_POINT_REASON.NO_DEFINITION
+                    : isModelGroup
+                        ? V1_CUBE_ACCESS_POINT_REASON.MODEL_GROUP
+                        : point._type !== LAKEHOUSE_ACCESS_POINT_TYPE
+                            ? V1_CUBE_ACCESS_POINT_REASON.NOT_LAKEHOUSE
+                            : asList(asObject(point.func).parameters).length
+                                ? V1_CUBE_ACCESS_POINT_REASON.PARAMETERS
+                                : !implementation
+                                    ? V1_CUBE_ACCESS_POINT_REASON.NOT_DEPLOYED
+                                    : read && 'reason' in read
+                                        ? read.reason
+                                        : undefined;
+                return new CubeAccessPoint({
+                    id,
+                    title: asString(point.title),
+                    description: asString(point.description) ??
+                        asString(implementation?.description),
+                    schema,
+                    disabledReason,
+                    sampleRows: implementation && schema
+                        ? readSampleRows(implementation, schema)
+                        : [],
+                });
+            }),
+        });
+    });
+    return new CubeDataProductDescription(candidate, groups);
+};
+/** A saved source's schema, from the product's description, or why it has none */
+export const V1_findCubeAccessPointSchema = (description, location) => {
+    const accessPoint = description.groups
+        .find((group) => group.id === location.accessPointGroup)
+        ?.accessPoints.find((point) => point.id === location.accessPoint);
+    if (!accessPoint) {
+        return `The data product has no access point "${location.accessPoint}" in group "${location.accessPointGroup}"`;
+    }
+    return accessPoint.isPickable
+        ? accessPoint.schema
+        : (accessPoint.disabledReason ?? V1_CUBE_ACCESS_POINT_REASON.NO_TYPE);
+};
+//# sourceMappingURL=V1_CubeDataProductArtifact.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * 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 { IR } from '@finos/legend-cube';
+import type { PlainObject } from '@finos/legend-shared';
+import { type CubeDataProductProject } from '../../../CubeDataProduct.js';
+/** Whether a lambda reads a data product's access point, anywhere in it */
+export declare const V1_hasCubeDataProductAccessor: (ir: IR) => boolean;
+/**
+ * The model typing runs on: the project alone, with no runtime; the host's
+ * model of it when it has one, e.g. Studio's workspace
+ */
+export declare const V1_buildCubeDataProductTypingContext: (project: CubeDataProductProject, projectModel?: PlainObject | undefined) => PlainObject;
+/**
+ * The model a run runs on: the project (the host's model of it, when it has
+ * one), then a model holding only the lakehouse runtime at Cube's fixed path,
+ * with the viewer's environment and the warehouse, always given
+ */
+export declare const V1_buildCubeDataProductExecutionContext: (project: CubeDataProductProject, environment: string, warehouse: string, projectModel?: PlainObject | undefined) => PlainObject;
+//# sourceMappingURL=V1_CubeDataProductModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductModel.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeDataProductModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,6BAA6B,CAAC;AA0BrC,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,GAAI,IAAI,EAAE,KAAG,OAetD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oCAAoC,GAC/C,SAAS,sBAAsB,EAC/B,eAAe,WAAW,GAAG,SAAS,KACrC,WAAiD,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,GAClD,SAAS,sBAAsB,EAC/B,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,eAAe,WAAW,GAAG,SAAS,KACrC,WAsBD,CAAC"}

package/lib/graph-manager/protocol/pure/v1/V1_CubeDataProductModel.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 { CUBE_DATA_PRODUCT_RUNTIME_PATH, } from '../../../CubeDataProduct.js';
+import { CUBE_LAKEHOUSE_RUNTIME_KIND } from '../../../CubeLakehouseRuntime.js';
+// The models a data product cube's engine calls run on (PLAN §6.8), built for
+// each call and never saved: the project at its saved version, and for a run
+// a lakehouse runtime at Cube's fixed path, whose environment and warehouse
+// are resolved for the viewer
+const splitPath = (path) => {
+    const index = path.lastIndexOf('::');
+    return { package: path.slice(0, index), name: path.slice(index + 2) };
+};
+/** The project at the version its data products were deployed from: never a moving alias */
+const pointerOf = (project) => ({
+    _type: 'pointer',
+    sdlcInfo: {
+        _type: 'alloy',
+        baseVersion: 'latest',
+        version: project.versionId,
+        packageableElementPointers: [],
+        groupId: project.groupId,
+        artifactId: project.artifactId,
+    },
+});
+/** Whether a lambda reads a data product's access point, anywhere in it */
+export const V1_hasCubeDataProductAccessor = (ir) => {
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            return value.some(visit);
+        }
+        if (!value || typeof value !== 'object') {
+            return false;
+        }
+        const node = value;
+        if (node.k === 'dataProductAccessor') {
+            return true;
+        }
+        return node.k !== 'raw' && Object.values(node).some(visit);
+    };
+    return visit(ir);
+};
+/**
+ * The model typing runs on: the project alone, with no runtime; the host's
+ * model of it when it has one, e.g. Studio's workspace
+ */
+export const V1_buildCubeDataProductTypingContext = (project, projectModel) => projectModel ?? pointerOf(project);
+/**
+ * The model a run runs on: the project (the host's model of it, when it has
+ * one), then a model holding only the lakehouse runtime at Cube's fixed path,
+ * with the viewer's environment and the warehouse, always given
+ */
+export const V1_buildCubeDataProductExecutionContext = (project, environment, warehouse, projectModel) => ({
+    _type: 'combination',
+    contexts: [
+        projectModel ?? pointerOf(project),
+        {
+            _type: 'data',
+            elements: [
+                {
+                    _type: 'runtime',
+                    ...splitPath(CUBE_DATA_PRODUCT_RUNTIME_PATH),
+                    runtimeValue: {
+                        _type: CUBE_LAKEHOUSE_RUNTIME_KIND,
+                        connectionStores: [],
+                        connections: [],
+                        mappings: [],
+                        environment,
+                        warehouse,
+                    },
+                },
+            ],
+        },
+    ],
+});
+//# sourceMappingURL=V1_CubeDataProductModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductModel.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeDataProductModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EACL,8BAA8B,GAE/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,8BAA8B;AAE9B,MAAM,SAAS,GAAG,CAAC,IAAY,EAAqC,EAAE;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,SAAS,GAAG,CAAC,OAA+B,EAAe,EAAE,CAAC,CAAC;IACnE,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE;QACR,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,OAAO,CAAC,SAAS;QAC1B,0BAA0B,EAAE,EAAE;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B;CACF,CAAC,CAAC;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,EAAM,EAAW,EAAE;IAC/D,MAAM,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,KAAoB,CAAC;QAClC,IAAI,IAAI,CAAC,CAAC,KAAK,qBAAqB,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAClD,OAA+B,EAC/B,YAAsC,EACzB,EAAE,CAAC,YAAY,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,CACrD,OAA+B,EAC/B,WAAmB,EACnB,SAAiB,EACjB,YAAsC,EACzB,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE;QACR,YAAY,IAAI,SAAS,CAAC,OAAO,CAAC;QAClC;YACE,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,SAAS;oBAChB,GAAG,SAAS,CAAC,8BAA8B,CAAC;oBAC5C,YAAY,EAAE;wBACZ,KAAK,EAAE,2BAA2B;wBAClC,gBAAgB,EAAE,EAAE;wBACpB,WAAW,EAAE,EAAE;wBACf,QAAQ,EAAE,EAAE;wBACZ,WAAW;wBACX,SAAS;qBACV;iBACF;aACF;SACF;KACF;CACF,CAAC,CAAC"}

package/lib/graph-manager/protocol/pure/v1/V1_CubeDirectConnection.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 { PlainObject } from '@finos/legend-shared';
+import { type CubeConnectionDraft, type CubeConnectionSummary } from '../../../CubeConnectionExplorer.js';
+/**
+ * What keeps Cube from using a connection, in words a user can act on: none
+ * when the connection is one Cube supports. Values are never repeated, only
+ * the names of properties, since a property Cube doesn't know could hold a
+ * secret
+ */
+export declare const V1_checkCubeDirectConnection: (connection: unknown) => readonly string[];
+/**
+ * The connection the form describes, as the engine reads it. It names no
+ * store: each call binds it to the Database built for that call
+ */
+export declare const V1_buildCubeDirectConnection: (draft: CubeConnectionDraft) => PlainObject;
+/**
+ * What the page shows of a connection Cube supports (see
+ * `V1_checkCubeDirectConnection`): never its setup SQL
+ */
+export declare const V1_summarizeCubeDirectConnection: (connection: PlainObject) => CubeConnectionSummary;
+/**
+ * A connection as text that two connections share exactly when they reach the
+ * same database the same way: key order, the bound store and source
+ * positions don't count. Used to compare connections and to key caches
+ */
+export declare const V1_canonicalCubeDirectConnection: (connection: PlainObject) => string;
+//# sourceMappingURL=V1_CubeDirectConnection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDirectConnection.d.ts","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_CubeDirectConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AA+K5C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,OAAO,KAClB,SAAS,MAAM,EA+CjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,mBAAmB,KACzB,WAwBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,WAAW,KACtB,qBAmBF,CAAC;AAoBF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,WAAW,KACtB,MAAoD,CAAC"}