@finos/legend-cube-builder 0.0.3 → 0.0.4

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

@@ -0,0 +1,167 @@
+/**
+ * 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, type CubeDataProductProject } from './CubeDataProduct.js';
+import type { CubeEngineError, CubeResultValue, NodeId } from './CubeEngine.js';
+/** A deployed data product the catalog lists, at the version it was deployed from */
+export declare class CubeDataProductCandidate {
+    /** The catalog's id for the product, which its links use */
+    readonly id: string;
+    /** The deployment, as text */
+    readonly deploymentId: string;
+    /** The path of its DataProduct element */
+    readonly dataProductPath: string;
+    readonly title: string;
+    readonly description: string | undefined;
+    readonly groupId: string;
+    readonly artifactId: string;
+    /** The version it was deployed from, as the catalog gave it, snapshots included */
+    readonly versionId: string;
+    readonly environmentType: CubeDataProductEnvironmentType;
+    /** The producer's environment, for display */
+    readonly producerEnvironmentName: string | undefined;
+    constructor(fields: {
+        id: string;
+        deploymentId: string;
+        dataProductPath: string;
+        title: string;
+        description?: string | undefined;
+        groupId: string;
+        artifactId: string;
+        versionId: string;
+        environmentType: CubeDataProductEnvironmentType;
+        producerEnvironmentName?: string | undefined;
+    });
+    /** Whether it was deployed from a moving version, whose data may change under a cube */
+    get isSnapshot(): boolean;
+}
+/** An access point of a deployed product, as its artifact describes it */
+export declare class CubeAccessPoint {
+    readonly id: string;
+    readonly title: string | undefined;
+    readonly description: string | undefined;
+    /** Its columns, as the artifact types them; none when it can't be read */
+    readonly schema: Schema | undefined;
+    /** Why it can't be picked, e.g. it takes parameters; none when it can */
+    readonly disabledReason: string | undefined;
+    /** A few rows the artifact holds, by the schema's columns */
+    readonly sampleRows: readonly (readonly CubeResultValue[])[];
+    constructor(fields: {
+        id: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        schema?: Schema | undefined;
+        disabledReason?: string | undefined;
+        sampleRows?: readonly (readonly CubeResultValue[])[];
+    });
+    get isPickable(): boolean;
+}
+export declare class CubeAccessPointGroup {
+    readonly id: string;
+    readonly title: string | undefined;
+    readonly accessPoints: readonly CubeAccessPoint[];
+    /** Open to everyone in the organization, as the host's marketplace marks such groups */
+    readonly isEnterprise: boolean;
+    constructor(fields: {
+        id: string;
+        title?: string | undefined;
+        accessPoints: readonly CubeAccessPoint[];
+        isEnterprise?: boolean | undefined;
+    });
+}
+/**
+ * The viewer's access to an access point group, as the marketplace shows
+ * it: open to everyone, granted, on its way through approval, refused, or
+ * never asked for
+ */
+export declare enum CubeAccessPointGroupAccess {
+    ENTERPRISE = "ENTERPRISE",
+    APPROVED = "APPROVED",
+    SUBMITTED_FOR_APPROVALS = "SUBMITTED_FOR_APPROVALS",
+    PENDING_MANAGER_APPROVAL = "PENDING_MANAGER_APPROVAL",
+    PENDING_DATA_OWNER_APPROVAL = "PENDING_DATA_OWNER_APPROVAL",
+    DENIED = "DENIED",
+    NO_ACCESS = "NO_ACCESS"
+}
+/** A deployed product's access points, by group */
+export declare class CubeDataProductDescription {
+    readonly candidate: CubeDataProductCandidate;
+    readonly groups: readonly CubeAccessPointGroup[];
+    constructor(candidate: CubeDataProductCandidate, groups: readonly CubeAccessPointGroup[]);
+}
+/** Where a saved source's access point is */
+export interface CubeAccessPointLocation {
+    readonly dataProduct: string;
+    readonly accessPointGroup: string;
+    readonly accessPoint: string;
+}
+/** What a marketplace link points at */
+export interface CubeMarketplaceLinkTarget {
+    readonly dataProductId: string;
+    readonly deploymentId: string;
+    readonly environmentType: CubeDataProductEnvironmentType;
+    readonly accessPointGroup?: string | undefined;
+}
+/**
+ * The deployed data products, for the source dialog and for re-checking
+ * saved sources: its own port, beside the `CubeEngine`, so hosts without
+ * data products need neither. Calls fail with a `CubeEngineError`: with no
+ * node for listing and describing, with the node's id for schemas
+ */
+export interface CubeDataProductCatalog {
+    /** The deployment classes the host lists, the default first */
+    readonly environmentTypes: readonly CubeDataProductEnvironmentType[];
+    /**
+     * Whether `search` matches and ranks the text on a server. Otherwise the
+     * text is matched on the client, over the class's whole list
+     */
+    readonly searchesOnServer?: boolean | undefined;
+    /** The most products one server search gives: an answer this long may be cut short */
+    readonly searchLimit?: number | undefined;
+    /**
+     * Whether an answer `search` gave leaves out matches the server has, as
+     * its page says, counting rows the catalog dropped. Without it, an answer
+     * as long as `searchLimit` is taken to be cut short
+     */
+    readonly isCutShort?: ((answer: readonly CubeDataProductCandidate[]) => boolean) | undefined;
+    /**
+     * The deployed products of a class whose title, id or description holds
+     * the text, or, searching on a server, the ones it matches, in its order
+     */
+    search(search: {
+        text: string;
+        environmentType: CubeDataProductEnvironmentType;
+    }, signal?: AbortSignal): Promise<readonly CubeDataProductCandidate[]>;
+    /** A product's access points, read from its artifact at the version it was deployed from */
+    describe(candidate: CubeDataProductCandidate, signal?: AbortSignal): Promise<CubeDataProductDescription>;
+    /**
+     * The schema of each saved source, from the artifact at the cube's
+     * version: one entry per key, failures included. `fresh` reads the
+     * artifact again rather than what this page visit read, e.g. on Refresh
+     */
+    resolveSchemas(project: CubeDataProductProject, sources: ReadonlyMap<NodeId, CubeAccessPointLocation>, options?: {
+        readonly fresh?: boolean | undefined;
+    }): Promise<Map<NodeId, Schema | CubeEngineError>>;
+    /** The product's page in the marketplace, or none when the host has no marketplace */
+    getMarketplaceLink(target: CubeMarketplaceLinkTarget): string | undefined;
+    /**
+     * The viewer's access to each of the product's access point groups, by
+     * group id; a group it can't tell has no entry. Optional: a host without
+     * it shows no access
+     */
+    getAccess?(candidate: CubeDataProductCandidate, signal?: AbortSignal): Promise<ReadonlyMap<string, CubeAccessPointGroupAccess>>;
+}
+//# sourceMappingURL=CubeDataProductCatalog.d.ts.map

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

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

package/lib/graph-manager/CubeDataProductCatalog.js

@@ -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 { isCubeSnapshotVersion, } from './CubeDataProduct.js';
+// The deployed data products a cube can read (PLAN §6.8), in Cube's own
+// terms: what the catalog lists, what a product's deployed artifact says of
+// its access points, and the schemas of saved sources. The host's
+// implementation reads the marketplace or the lakehouse's lists, the depot
+// and the artifacts; nothing here names their wire classes
+/** A deployed data product the catalog lists, at the version it was deployed from */
+export class CubeDataProductCandidate {
+    /** The catalog's id for the product, which its links use */
+    id;
+    /** The deployment, as text */
+    deploymentId;
+    /** The path of its DataProduct element */
+    dataProductPath;
+    title;
+    description;
+    groupId;
+    artifactId;
+    /** The version it was deployed from, as the catalog gave it, snapshots included */
+    versionId;
+    environmentType;
+    /** The producer's environment, for display */
+    producerEnvironmentName;
+    constructor(fields) {
+        this.id = fields.id;
+        this.deploymentId = fields.deploymentId;
+        this.dataProductPath = fields.dataProductPath;
+        this.title = fields.title;
+        this.description = fields.description;
+        this.groupId = fields.groupId;
+        this.artifactId = fields.artifactId;
+        this.versionId = fields.versionId;
+        this.environmentType = fields.environmentType;
+        this.producerEnvironmentName = fields.producerEnvironmentName;
+    }
+    /** Whether it was deployed from a moving version, whose data may change under a cube */
+    get isSnapshot() {
+        return isCubeSnapshotVersion(this.versionId);
+    }
+}
+/** An access point of a deployed product, as its artifact describes it */
+export class CubeAccessPoint {
+    id;
+    title;
+    description;
+    /** Its columns, as the artifact types them; none when it can't be read */
+    schema;
+    /** Why it can't be picked, e.g. it takes parameters; none when it can */
+    disabledReason;
+    /** A few rows the artifact holds, by the schema's columns */
+    sampleRows;
+    constructor(fields) {
+        this.id = fields.id;
+        this.title = fields.title;
+        this.description = fields.description;
+        this.schema = fields.schema;
+        this.disabledReason = fields.disabledReason;
+        this.sampleRows = fields.sampleRows ?? [];
+    }
+    get isPickable() {
+        return this.disabledReason === undefined && this.schema !== undefined;
+    }
+}
+export class CubeAccessPointGroup {
+    id;
+    title;
+    accessPoints;
+    /** Open to everyone in the organization, as the host's marketplace marks such groups */
+    isEnterprise;
+    constructor(fields) {
+        this.id = fields.id;
+        this.title = fields.title;
+        this.accessPoints = fields.accessPoints;
+        this.isEnterprise = fields.isEnterprise ?? false;
+    }
+}
+/**
+ * The viewer's access to an access point group, as the marketplace shows
+ * it: open to everyone, granted, on its way through approval, refused, or
+ * never asked for
+ */
+export var CubeAccessPointGroupAccess;
+(function (CubeAccessPointGroupAccess) {
+    CubeAccessPointGroupAccess["ENTERPRISE"] = "ENTERPRISE";
+    CubeAccessPointGroupAccess["APPROVED"] = "APPROVED";
+    CubeAccessPointGroupAccess["SUBMITTED_FOR_APPROVALS"] = "SUBMITTED_FOR_APPROVALS";
+    CubeAccessPointGroupAccess["PENDING_MANAGER_APPROVAL"] = "PENDING_MANAGER_APPROVAL";
+    CubeAccessPointGroupAccess["PENDING_DATA_OWNER_APPROVAL"] = "PENDING_DATA_OWNER_APPROVAL";
+    CubeAccessPointGroupAccess["DENIED"] = "DENIED";
+    CubeAccessPointGroupAccess["NO_ACCESS"] = "NO_ACCESS";
+})(CubeAccessPointGroupAccess || (CubeAccessPointGroupAccess = {}));
+/** A deployed product's access points, by group */
+export class CubeDataProductDescription {
+    candidate;
+    groups;
+    constructor(candidate, groups) {
+        this.candidate = candidate;
+        this.groups = groups;
+    }
+}
+//# sourceMappingURL=CubeDataProductCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDataProductCatalog.js","sourceRoot":"","sources":["../../src/graph-manager/CubeDataProductCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,wEAAwE;AACxE,4EAA4E;AAC5E,kEAAkE;AAClE,2EAA2E;AAC3E,2DAA2D;AAE3D,qFAAqF;AACrF,MAAM,OAAO,wBAAwB;IACnC,4DAA4D;IACnD,EAAE,CAAS;IACpB,8BAA8B;IACrB,YAAY,CAAS;IAC9B,0CAA0C;IACjC,eAAe,CAAS;IACxB,KAAK,CAAS;IACd,WAAW,CAAqB;IAChC,OAAO,CAAS;IAChB,UAAU,CAAS;IAC5B,mFAAmF;IAC1E,SAAS,CAAS;IAClB,eAAe,CAAiC;IACzD,8CAA8C;IACrC,uBAAuB,CAAqB;IAErD,YAAY,MAWX;QACC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC,uBAAuB,CAAC;IAChE,CAAC;IAED,wFAAwF;IACxF,IAAI,UAAU;QACZ,OAAO,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,eAAe;IACjB,EAAE,CAAS;IACX,KAAK,CAAqB;IAC1B,WAAW,CAAqB;IACzC,0EAA0E;IACjE,MAAM,CAAqB;IACpC,yEAAyE;IAChE,cAAc,CAAqB;IAC5C,6DAA6D;IACpD,UAAU,CAA0C;IAE7D,YAAY,MAOX;QACC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,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,MAAM,OAAO,oBAAoB;IACtB,EAAE,CAAS;IACX,KAAK,CAAqB;IAC1B,YAAY,CAA6B;IAClD,wFAAwF;IAC/E,YAAY,CAAU;IAE/B,YAAY,MAKX;QACC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,0BAQX;AARD,WAAY,0BAA0B;IACpC,uDAAyB,CAAA;IACzB,mDAAqB,CAAA;IACrB,iFAAmD,CAAA;IACnD,mFAAqD,CAAA;IACrD,yFAA2D,CAAA;IAC3D,+CAAiB,CAAA;IACjB,qDAAuB,CAAA;AACzB,CAAC,EARW,0BAA0B,KAA1B,0BAA0B,QAQrC;AAED,mDAAmD;AACnD,MAAM,OAAO,0BAA0B;IAC5B,SAAS,CAA2B;IACpC,MAAM,CAAkC;IAEjD,YACE,SAAmC,EACnC,MAAuC;QAEvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+/**
+ * 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';
+import type { CubeDirectConnection, CubeExploredTable } from './CubeConnectionExplorer.js';
+/** The kind of a direct-connection cube's model: Cube's own, never an engine model kind */
+export declare const CUBE_DIRECT_MODEL_TYPE = "cubeDirectConnection";
+/** The Database every table of a direct-connection cube belongs to */
+export declare const CUBE_DIRECT_DATABASE_PATH = "cube::direct::Database";
+export declare const CUBE_DIRECT_CONNECTION_PATH = "cube::direct::Connection";
+/** The runtime a direct-connection cube runs with */
+export declare const CUBE_DIRECT_RUNTIME_PATH = "cube::direct::Runtime";
+/** The model of a direct-connection cube */
+export declare const createCubeDirectModel: (connection: CubeDirectConnection) => ModelContext;
+/** The connection of a direct-connection cube's model; undefined for any other model */
+export declare const getCubeDirectConnection: (model: ModelContext) => CubeDirectConnection | undefined;
+/**
+ * The coordinates of a table read from the connection's database, every name
+ * quoted as the built Database stores it
+ */
+export declare const getCubeDirectTableCoordinates: (schema: string, table: CubeExploredTable) => {
+    database: string;
+    schema: string;
+    table: string;
+};
+//# sourceMappingURL=CubeDirectConnection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDirectConnection.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeDirectConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAQrC,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,sEAAsE;AACtE,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAClE,eAAO,MAAM,2BAA2B,6BAA6B,CAAC;AACtE,qDAAqD;AACrD,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,GAChC,YAAY,oBAAoB,KAC/B,YAEyE,CAAC;AAE7E,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,GAClC,OAAO,YAAY,KAClB,oBAAoB,GAAG,SAMX,CAAC;AAEhB;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,MAAM,EACd,OAAO,iBAAiB,KACvB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAIlD,CAAC"}

package/lib/graph-manager/CubeDirectConnection.js

@@ -0,0 +1,48 @@
+/**
+ * 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 direct-connection cube (PLAN §6.8) saves its connection once, as its
+// model, and its tables stay ordinary relational sources of one generated
+// Database. The engine's implementation builds that Database, its connection
+// and its runtime for each call, from the tables the call needs; their paths
+// are fixed, so saved tables and the saved runtime always name them
+/** The kind of a direct-connection cube's model: Cube's own, never an engine model kind */
+export const CUBE_DIRECT_MODEL_TYPE = 'cubeDirectConnection';
+/** The Database every table of a direct-connection cube belongs to */
+export const CUBE_DIRECT_DATABASE_PATH = 'cube::direct::Database';
+export const CUBE_DIRECT_CONNECTION_PATH = 'cube::direct::Connection';
+/** The runtime a direct-connection cube runs with */
+export const CUBE_DIRECT_RUNTIME_PATH = 'cube::direct::Runtime';
+/** The model of a direct-connection cube */
+export const createCubeDirectModel = (connection) => 
+// the connection is protocol JSON, so plain JSON
+({ _type: CUBE_DIRECT_MODEL_TYPE, connection });
+/** The connection of a direct-connection cube's model; undefined for any other model */
+export const getCubeDirectConnection = (model) => model._type === CUBE_DIRECT_MODEL_TYPE &&
+    model.connection &&
+    typeof model.connection === 'object' &&
+    !Array.isArray(model.connection)
+    ? model.connection
+    : undefined;
+/**
+ * The coordinates of a table read from the connection's database, every name
+ * quoted as the built Database stores it
+ */
+export const getCubeDirectTableCoordinates = (schema, table) => ({
+    database: CUBE_DIRECT_DATABASE_PATH,
+    schema: `"${schema}"`,
+    table: table.storedName,
+});
+//# sourceMappingURL=CubeDirectConnection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDirectConnection.js","sourceRoot":"","sources":["../../src/graph-manager/CubeDirectConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,yEAAyE;AACzE,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,oEAAoE;AAEpE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D,sEAAsE;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,0BAA0B,CAAC;AACtE,qDAAqD;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAEhE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,UAAgC,EAClB,EAAE;AAChB,iDAAiD;AACjD,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,CAA4B,CAAC;AAE7E,wFAAwF;AACxF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,KAAmB,EACe,EAAE,CACpC,KAAK,CAAC,KAAK,KAAK,sBAAsB;IACtC,KAAK,CAAC,UAAU;IAChB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;IACpC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;IAC9B,CAAC,CAAE,KAAK,CAAC,UAAmC;IAC5C,CAAC,CAAC,SAAS,CAAC;AAEhB;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,MAAc,EACd,KAAwB,EAC6B,EAAE,CAAC,CAAC;IACzD,QAAQ,EAAE,yBAAyB;IACnC,MAAM,EAAE,IAAI,MAAM,GAAG;IACrB,KAAK,EAAE,KAAK,CAAC,UAAU;CACxB,CAAC,CAAC"}

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IR, ModelContext, Schema } from '@finos/legend-cube';
+import type { IR, JsonObject, ModelContext, Schema } from '@finos/legend-cube';
 /** A query node's id */
 export type NodeId = string;
 /** A table's Database element path, schema name and table name, names as stored (quotes included) */
@@ -85,6 +85,28 @@ export declare enum CubeEngineErrorKind {
     /** the engine couldn't be reached, or answered with no readable error */
     NETWORK = "network"
 }
+/**
+ * Where in a text the engine places a problem: the source id the text was
+ * parsed under, and its 1-based first and last lines and columns, the last
+ * column included (an Extend column's expression, PLAN §11.7)
+ */
+export interface CubeSourceLocation {
+    readonly sourceId: string;
+    readonly startLine: number;
+    readonly startColumn: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+}
+/**
+ * An expression's text as the engine's JSON (PLAN §11.7), its number
+ * literals as their digit strings: as a column stores it, with no source
+ * information, and as the engine located it in the text, so a later error
+ * can point into the text
+ */
+export interface CubeParsedExpression {
+    readonly lambda: JsonObject;
+    readonly located: JsonObject;
+}
 /**
  * An engine failure, placed on the node it concerns: the node a stamp in the
  * error points to, else the source being typed or the node being run.
@@ -98,7 +120,9 @@ export declare class CubeEngineError extends Error {
     readonly firstLine: string;
     /** The engine's whole message, without its Java trace, shown in the panel */
     readonly detail: string;
-    constructor(kind: CubeEngineErrorKind, detail: string, nodeId?: NodeId, role?: string);
+    /** Where in a text the error is, when the text was parsed with its locations */
+    readonly location: CubeSourceLocation | undefined;
+    constructor(kind: CubeEngineErrorKind, detail: string, nodeId?: NodeId, role?: string, location?: CubeSourceLocation);
 }
 /** A value of a result cell: Integer and Decimal values as their exact text, Float values as numbers (PLAN §8.7) */
 export type CubeResultValue = string | number | boolean | null;
@@ -124,5 +148,16 @@ export interface CubeEngine {
     }): Promise<CubeResult>;
     /** The Pure text of a lambda, for display only: never parsed back */
     renderPure(lambda: IR): Promise<string>;
+    /**
+     * An Extend column's expression as the engine's JSON (PLAN §11.7), located
+     * under the source id; rejects with a `CubeEngineError` placed in the text
+     */
+    parseExpression(code: string, sourceId: string): Promise<CubeParsedExpression>;
+    /**
+     * Plans an execution lambda for its runtime's database, as a run would,
+     * without running it: some expressions type, then fail when planned (PLAN
+     * §11.7). Rejects with a `CubeEngineError`
+     */
+    planLambda(model: ModelContext, lambda: IR): Promise<void>;
 }
 //# sourceMappingURL=CubeEngine.d.ts.map

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

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

package/lib/graph-manager/CubeEngine.js

@@ -47,7 +47,9 @@ export class CubeEngineError extends Error {
     firstLine;
     /** The engine's whole message, without its Java trace, shown in the panel */
     detail;
-    constructor(kind, detail, nodeId, role) {
+    /** Where in a text the error is, when the text was parsed with its locations */
+    location;
+    constructor(kind, detail, nodeId, role, location) {
         const firstLine = detail.split('\n', 1)[0]?.trim() ?? '';
         super(firstLine);
         this.name = 'CubeEngineError';
@@ -56,6 +58,7 @@ export class CubeEngineError extends Error {
         this.firstLine = firstLine;
         this.nodeId = nodeId;
         this.role = role;
+        this.location = location;
     }
 }
 //# sourceMappingURL=CubeEngine.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeEngine.js","sourceRoot":"","sources":["../../src/graph-manager/CubeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,mFAAmF;AACnF,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,uDAAuD;IACvD,4CAA2B,CAAA;IAC3B,iDAAiD;IACjD,iDAAgC,CAAA;IAChC,uDAAuD;IACvD,6CAA4B,CAAA;AAC9B,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAoDD,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,uEAAuE;IACvE,0CAAmB,CAAA;IACnB,kEAAkE;IAClE,8CAAuB,CAAA;IACvB,2DAA2D;IAC3D,6DAAsC,CAAA;IACtC,yEAAyE;IACzE,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAsB;IAC1B,MAAM,CAAqB;IACpC,mFAAmF;IAC1E,IAAI,CAAqB;IAClC,gEAAgE;IACvD,SAAS,CAAS;IAC3B,6EAA6E;IACpE,MAAM,CAAS;IAExB,YACE,IAAyB,EACzB,MAAc,EACd,MAAe,EACf,IAAa;QAEb,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzD,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"CubeEngine.js","sourceRoot":"","sources":["../../src/graph-manager/CubeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,mFAAmF;AACnF,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,uDAAuD;IACvD,4CAA2B,CAAA;IAC3B,iDAAiD;IACjD,iDAAgC,CAAA;IAChC,uDAAuD;IACvD,6CAA4B,CAAA;AAC9B,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAoDD,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,uEAAuE;IACvE,0CAAmB,CAAA;IACnB,kEAAkE;IAClE,8CAAuB,CAAA;IACvB,2DAA2D;IAC3D,6DAAsC,CAAA;IACtC,yEAAyE;IACzE,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AA0BD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAsB;IAC1B,MAAM,CAAqB;IACpC,mFAAmF;IAC1E,IAAI,CAAqB;IAClC,gEAAgE;IACvD,SAAS,CAAS;IAC3B,6EAA6E;IACpE,MAAM,CAAS;IACxB,gFAAgF;IACvE,QAAQ,CAAiC;IAElD,YACE,IAAyB,EACzB,MAAc,EACd,MAAe,EACf,IAAa,EACb,QAA6B;QAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzD,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,50 @@
+/**
+ * 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';
+import { CubeDataProductEnvironmentType } from './CubeDataProduct.js';
+export declare const CUBE_INGEST_MODEL_TYPE = "cubeIngest";
+export declare const CUBE_INGEST_RUNTIME_PATH = "cube::ingest::Runtime";
+/** What an ingest cube runs on, as its model saves it */
+export interface CubeIngestSettings {
+    readonly environmentType: CubeDataProductEnvironmentType;
+    /** The producer deployment whose definitions the cube reads, as text */
+    readonly producerDeploymentId: string;
+    /** The warehouse the cube runs on; none until one is picked */
+    readonly warehouse?: string | undefined;
+}
+export declare const createCubeIngestModel: (settings: CubeIngestSettings) => ModelContext;
+export declare const isCubeIngestModel: (model: ModelContext) => boolean;
+/** The same model, running on another warehouse */
+export declare const withCubeIngestWarehouse: (model: ModelContext, warehouse: string) => ModelContext;
+/** What's wrong with an ingest model, e.g. one saved by a later Cube: nothing for one Cube can use */
+export declare const checkCubeIngestModel: (model: ModelContext) => readonly string[];
+/** An ingest model's settings, when Cube can use it */
+export declare const getCubeIngestSettings: (model: ModelContext) => CubeIngestSettings | undefined;
+/** What an SDLC-deployed definition's URN names: its class, its project and its path */
+export interface CubeIngestUrn {
+    readonly environmentType: CubeDataProductEnvironmentType;
+    readonly groupId: string;
+    readonly artifactId: string;
+    /** The IngestDefinition element's path */
+    readonly definition: string;
+}
+/**
+ * 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 declare const parseCubeIngestUrn: (urn: string) => CubeIngestUrn | undefined;
+//# sourceMappingURL=CubeIngest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeIngest.d.ts","sourceRoot":"","sources":["../../src/graph-manager/CubeIngest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAUtE,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,wEAAwE;IACxE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AASD,eAAO,MAAM,qBAAqB,GAChC,UAAU,kBAAkB,KAC3B,YAQiB,CAAC;AAErB,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,KAAG,OAChB,CAAC;AAEzC,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,GAClC,OAAO,YAAY,EACnB,WAAW,MAAM,KAChB,YAAyC,CAAC;AAE7C,sGAAsG;AACtG,eAAO,MAAM,oBAAoB,GAC/B,OAAO,YAAY,KAClB,SAAS,MAAM,EAiBjB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,KAClB,kBAAkB,GAAG,SAQT,CAAC;AAUhB,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAKD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,aAAa,GAAG,SAehE,CAAC"}