@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/stores/CubeDataProductRuntimeState.d.ts

@@ -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 { type CubeDataProductProject } from '../graph-manager/CubeDataProduct.js';
+import type { CubeEngineError } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/** What a failed run on a data product cube lacked (PLAN §6.8) */
+export declare enum CubeDataProductRunErrorKind {
+    /** the warehouse it ran on: another one may work */
+    WAREHOUSE = "warehouse",
+    /** access to the data: the marketplace takes requests */
+    ENTITLEMENT = "entitlement"
+}
+/**
+ * What a run's error says it lacked, as Legend Query reads it: the
+ * warehouse first, since a message about both is about the warehouse, then
+ * access to the data; none for any other error. Read from the whole detail,
+ * since the database's words may follow its first line
+ */
+export declare const classifyCubeDataProductRunError: (error: CubeEngineError) => CubeDataProductRunErrorKind | undefined;
+/** A marketplace page where the viewer can ask for access */
+export interface CubeAccessRequestLink {
+    readonly key: string;
+    readonly label: string;
+    readonly url: string;
+}
+/** What a lakehouse cube runs on, as its model saves it: its class and its warehouse */
+type CubeLakehouseSettings = Pick<CubeDataProductProject, 'environmentType' | 'warehouse'>;
+/**
+ * Where a lakehouse cube runs, a data product's (PLAN §6.8, DP-2) or an
+ * ingest one's (§6.7): its deployment class and the warehouse, shown as it
+ * is sent. Editing the warehouse changes the cube's model, as one undo step,
+ * and remembers the warehouse for the viewer's next cubes; it calls no
+ * engine and re-types no source. The project, its version and the
+ * marketplace's links are a data product cube's only.
+ */
+export declare class CubeDataProductRuntimeState {
+    readonly editorState: CubeEditorState;
+    /**
+     * Counts Cube's own writes of the remembered warehouse: user data isn't
+     * observable, so reading it through this lets the page show a new one
+     */
+    private rememberedChanges;
+    constructor(editorState: CubeEditorState);
+    /** The warehouse the viewer last picked, read afresh: another page may have changed it */
+    get rememberedWarehouse(): string | undefined;
+    /** The cube's data product project; none on a cube of tables, or one Cube can't run */
+    get project(): CubeDataProductProject | undefined;
+    /** The cube's class and warehouse; none on a cube of tables, or one Cube can't run */
+    get settings(): CubeLakehouseSettings | undefined;
+    /** The warehouse the next run uses, as the engine picks it, from user data read at run time */
+    get effectiveWarehouse(): string | undefined;
+    get isSnapshot(): boolean;
+    get canEditWarehouse(): boolean;
+    /** What the last run's error says it lacked; none on a cube of tables */
+    get runErrorKind(): CubeDataProductRunErrorKind | undefined;
+    /**
+     * After a run refused for lack of access, where to ask for it: one link
+     * per access point group the failed node reads, each opening that group in
+     * the marketplace; none when the host has no marketplace
+     */
+    get accessRequestLinks(): readonly CubeAccessRequestLink[];
+    /** Remembers the warehouse for the viewer's next cubes */
+    remember(warehouse: string): void;
+    /**
+     * Uses another warehouse for the cube's next runs; gives whether it
+     * changed. An empty
+     * name, the warehouse already used, or a cube that can't be edited changes
+     * nothing
+     */
+    setWarehouse(text: string, options?: {
+        remember?: boolean;
+    }): boolean;
+}
+export {};
+//# sourceMappingURL=CubeDataProductRuntimeState.d.ts.map

package/lib/stores/CubeDataProductRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDataProductRuntimeState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeDataProductRuntimeState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,OAAO,EACL,KAAK,sBAAsB,EAK5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAUtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,kEAAkE;AAClE,oBAAY,2BAA2B;IACrC,oDAAoD;IACpD,SAAS,cAAc;IACvB,yDAAyD;IACzD,WAAW,gBAAgB;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,GAC1C,OAAO,eAAe,KACrB,2BAA2B,GAAG,SAKhB,CAAC;AAElB,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wFAAwF;AACxF,KAAK,qBAAqB,GAAG,IAAI,CAC/B,sBAAsB,EACtB,iBAAiB,GAAG,WAAW,CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,2BAA2B;IACtC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAK;gBAElB,WAAW,EAAE,eAAe;IAexC,0FAA0F;IAC1F,IAAI,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAM5C;IAED,uFAAuF;IACvF,IAAI,OAAO,IAAI,sBAAsB,GAAG,SAAS,CAGhD;IAED,sFAAsF;IACtF,IAAI,QAAQ,IAAI,qBAAqB,GAAG,SAAS,CAKhD;IAED,+FAA+F;IAC/F,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAK3C;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,yEAAyE;IACzE,IAAI,YAAY,IAAI,2BAA2B,GAAG,SAAS,CAK1D;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,SAAS,qBAAqB,EAAE,CAqDzD;IAED,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;CAwBtE"}

package/lib/stores/CubeDataProductRuntimeState.js

@@ -0,0 +1,190 @@
+/**
+ * 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 { DataProductAccessPointSource } from '@finos/legend-cube';
+import { isExecutionEntitlementError, isExecutionWarehouseError, } from '@finos/legend-graph';
+import { action, computed, makeObservable, observable } from 'mobx';
+import { getCubeRequestAccessLabel } from '../__lib__/LegendCubeDataProductLabels.js';
+import { getCubeDataProductProject, getEffectiveCubeWarehouse, isCubeSnapshotVersion, withCubeDataProductWarehouse, } from '../graph-manager/CubeDataProduct.js';
+import { getCubeIngestSettings, isCubeIngestModel, withCubeIngestWarehouse, } from '../graph-manager/CubeIngest.js';
+import { getCubeRememberedWarehouse, rememberCubeWarehouse, } from './CubeDataProductWarehouse.js';
+/** What a failed run on a data product cube lacked (PLAN §6.8) */
+export var CubeDataProductRunErrorKind;
+(function (CubeDataProductRunErrorKind) {
+    /** the warehouse it ran on: another one may work */
+    CubeDataProductRunErrorKind["WAREHOUSE"] = "warehouse";
+    /** access to the data: the marketplace takes requests */
+    CubeDataProductRunErrorKind["ENTITLEMENT"] = "entitlement";
+})(CubeDataProductRunErrorKind || (CubeDataProductRunErrorKind = {}));
+/**
+ * What a run's error says it lacked, as Legend Query reads it: the
+ * warehouse first, since a message about both is about the warehouse, then
+ * access to the data; none for any other error. Read from the whole detail,
+ * since the database's words may follow its first line
+ */
+export const classifyCubeDataProductRunError = (error) => isExecutionWarehouseError(error.detail)
+    ? CubeDataProductRunErrorKind.WAREHOUSE
+    : isExecutionEntitlementError(error.detail)
+        ? CubeDataProductRunErrorKind.ENTITLEMENT
+        : undefined;
+/**
+ * Where a lakehouse cube runs, a data product's (PLAN §6.8, DP-2) or an
+ * ingest one's (§6.7): its deployment class and the warehouse, shown as it
+ * is sent. Editing the warehouse changes the cube's model, as one undo step,
+ * and remembers the warehouse for the viewer's next cubes; it calls no
+ * engine and re-types no source. The project, its version and the
+ * marketplace's links are a data product cube's only.
+ */
+export class CubeDataProductRuntimeState {
+    editorState;
+    /**
+     * Counts Cube's own writes of the remembered warehouse: user data isn't
+     * observable, so reading it through this lets the page show a new one
+     */
+    rememberedChanges = 0;
+    constructor(editorState) {
+        makeObservable(this, {
+            rememberedChanges: observable,
+            project: computed,
+            settings: computed,
+            isSnapshot: computed,
+            canEditWarehouse: computed,
+            runErrorKind: computed,
+            accessRequestLinks: computed,
+            remember: action,
+            setWarehouse: action,
+        });
+        this.editorState = editorState;
+    }
+    /** The warehouse the viewer last picked, read afresh: another page may have changed it */
+    get rememberedWarehouse() {
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+        this.rememberedChanges;
+        return getCubeRememberedWarehouse(this.editorState.host.applicationStore.userDataService);
+    }
+    /** The cube's data product project; none on a cube of tables, or one Cube can't run */
+    get project() {
+        const model = this.editorState.document.context?.model;
+        return model ? getCubeDataProductProject(model) : undefined;
+    }
+    /** The cube's class and warehouse; none on a cube of tables, or one Cube can't run */
+    get settings() {
+        const model = this.editorState.document.context?.model;
+        return model
+            ? (getCubeDataProductProject(model) ?? getCubeIngestSettings(model))
+            : undefined;
+    }
+    /** The warehouse the next run uses, as the engine picks it, from user data read at run time */
+    get effectiveWarehouse() {
+        const { settings } = this;
+        return settings
+            ? getEffectiveCubeWarehouse(settings, this.rememberedWarehouse)
+            : undefined;
+    }
+    get isSnapshot() {
+        return this.project ? isCubeSnapshotVersion(this.project.versionId) : false;
+    }
+    get canEditWarehouse() {
+        return !this.editorState.readOnly && this.settings !== undefined;
+    }
+    /** What the last run's error says it lacked; none on a cube of tables */
+    get runErrorKind() {
+        const { error } = this.editorState.execution;
+        return this.settings && error
+            ? classifyCubeDataProductRunError(error)
+            : undefined;
+    }
+    /**
+     * After a run refused for lack of access, where to ask for it: one link
+     * per access point group the failed node reads, each opening that group in
+     * the marketplace; none when the host has no marketplace
+     */
+    get accessRequestLinks() {
+        const { project } = this;
+        const { error } = this.editorState.execution;
+        const catalog = this.editorState.host.dataProductCatalog;
+        const { query } = this.editorState.document;
+        const failed = error?.nodeId ?? query.selected;
+        if (this.runErrorKind !== CubeDataProductRunErrorKind.ENTITLEMENT ||
+            !project ||
+            !catalog ||
+            failed === undefined) {
+            return [];
+        }
+        const groups = new Map();
+        query.nodes.forEach((node) => {
+            if (node instanceof DataProductAccessPointSource &&
+                (node.id === failed || query.isUpstreamOf(node.id, failed))) {
+                groups.set(JSON.stringify([
+                    node.dataProductId,
+                    node.deploymentId,
+                    node.accessPointGroup,
+                ]), node);
+            }
+        });
+        const several = groups.size > 1;
+        return [...groups].flatMap(([key, node]) => {
+            const url = catalog.getMarketplaceLink({
+                dataProductId: node.dataProductId,
+                deploymentId: node.deploymentId,
+                environmentType: project.environmentType,
+                accessPointGroup: node.accessPointGroup,
+            });
+            return url
+                ? [
+                    {
+                        key,
+                        label: several
+                            ? getCubeRequestAccessLabel(node.accessPointGroup, node.dataProductName)
+                            : getCubeRequestAccessLabel(undefined, undefined),
+                        url,
+                    },
+                ]
+                : [];
+        });
+    }
+    /** Remembers the warehouse for the viewer's next cubes */
+    remember(warehouse) {
+        rememberCubeWarehouse(this.editorState.host.applicationStore.userDataService, warehouse);
+        this.rememberedChanges++;
+    }
+    /**
+     * Uses another warehouse for the cube's next runs; gives whether it
+     * changed. An empty
+     * name, the warehouse already used, or a cube that can't be edited changes
+     * nothing
+     */
+    setWarehouse(text, options) {
+        const warehouse = text.trim();
+        const { context } = this.editorState.document;
+        if (!this.canEditWarehouse ||
+            !context ||
+            !warehouse.length ||
+            warehouse === this.effectiveWarehouse) {
+            return false;
+        }
+        this.editorState.applyDocument(this.editorState.document.withContext({
+            ...context,
+            model: isCubeIngestModel(context.model)
+                ? withCubeIngestWarehouse(context.model, warehouse)
+                : withCubeDataProductWarehouse(context.model, warehouse),
+        }));
+        if (options?.remember !== false) {
+            this.remember(warehouse);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=CubeDataProductRuntimeState.js.map

package/lib/stores/CubeDataProductRuntimeState.js.map

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

package/lib/stores/CubeDataProductWarehouse.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 { UserDataService } from '@finos/legend-application';
+export declare const getCubeRememberedWarehouse: (userDataService: UserDataService) => string | undefined;
+export declare const rememberCubeWarehouse: (userDataService: UserDataService, warehouse: string) => void;
+//# sourceMappingURL=CubeDataProductWarehouse.d.ts.map

package/lib/stores/CubeDataProductWarehouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDataProductWarehouse.d.ts","sourceRoot":"","sources":["../../src/stores/CubeDataProductWarehouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMjE,eAAO,MAAM,0BAA0B,GACrC,iBAAiB,eAAe,KAC/B,MAAM,GAAG,SAMX,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,eAAe,EAChC,WAAW,MAAM,KAChB,IAIA,CAAC"}

package/lib/stores/CubeDataProductWarehouse.js

@@ -0,0 +1,25 @@
+/**
+ * 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 { LEGEND_CUBE_USER_DATA_KEY } from '../__lib__/LegendCubeLabels.js';
+// The warehouse the viewer last picked for a data product cube (PLAN §6.8,
+// DP-2): a cube without its own runs on it, and a new cube starts on it
+export const getCubeRememberedWarehouse = (userDataService) => {
+    const warehouse = userDataService.getStringValue(LEGEND_CUBE_USER_DATA_KEY.DATA_PRODUCT_WAREHOUSE);
+    // an empty value is none
+    return warehouse?.length ? warehouse : undefined;
+};
+export const rememberCubeWarehouse = (userDataService, warehouse) => userDataService.persistValue(LEGEND_CUBE_USER_DATA_KEY.DATA_PRODUCT_WAREHOUSE, warehouse);
+//# sourceMappingURL=CubeDataProductWarehouse.js.map

package/lib/stores/CubeDataProductWarehouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDataProductWarehouse.js","sourceRoot":"","sources":["../../src/stores/CubeDataProductWarehouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,2EAA2E;AAC3E,wEAAwE;AAExE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,eAAgC,EACZ,EAAE;IACtB,MAAM,SAAS,GAAG,eAAe,CAAC,cAAc,CAC9C,yBAAyB,CAAC,sBAAsB,CACjD,CAAC;IACF,yBAAyB;IACzB,OAAO,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,eAAgC,EAChC,SAAiB,EACX,EAAE,CACR,eAAe,CAAC,YAAY,CAC1B,yBAAyB,CAAC,sBAAsB,EAChD,SAAS,CACV,CAAC"}

package/lib/stores/CubeDevSettingsState.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 { CubeHost } from './CubeHost.js';
+/**
+ * The page's Dev Settings, opened from the menu at the top left as Legend
+ * Query's editor opens its own (PLAN §11.16): the engine's URL, and whether
+ * Cube's engine clients compress their requests (uncompressed, the browser's
+ * Network tab shows each request's JSON). Compression is kept for the user,
+ * on by default; the URL lasts while the application runs, as Query's does.
+ * Both change every engine client of Cube's host, from the next request.
+ */
+export declare class CubeDevSettingsState {
+    private readonly host;
+    private readonly settings;
+    isOpen: boolean;
+    requestCompression: boolean;
+    /** The engine URL as typed: it is used once it is a URL */
+    baseUrlText: string;
+    constructor(host: CubeHost);
+    /** Whether the host lets Dev Settings change its engine clients */
+    get isAvailable(): boolean;
+    /** The URL the host configured */
+    get defaultBaseUrl(): string | undefined;
+    /** Why the typed engine URL isn't used, if it isn't */
+    get baseUrlError(): string | undefined;
+    open(): void;
+    close(): void;
+    setRequestCompression(compressed: boolean): void;
+    /** Takes the typed engine URL, and uses it once it is a URL */
+    setBaseUrlText(text: string): void;
+    /** Goes back to the engine URL the host configured */
+    resetBaseUrl(): void;
+}
+//# sourceMappingURL=CubeDevSettingsState.d.ts.map

package/lib/stores/CubeDevSettingsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDevSettingsState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeDevSettingsState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,MAAM,UAAS;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;gBAER,IAAI,EAAE,QAAQ;IA2B1B,mEAAmE;IACnE,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,kCAAkC;IAClC,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,uDAAuD;IACvD,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;IAIb,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAYhD,+DAA+D;IAC/D,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlC,sDAAsD;IACtD,YAAY,IAAI,IAAI;CAOrB"}

package/lib/stores/CubeDevSettingsState.js

@@ -0,0 +1,99 @@
+/**
+ * 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 { isValidUrl } from '@finos/legend-shared';
+import { action, computed, makeObservable, observable } from 'mobx';
+import { LEGEND_CUBE_USER_DATA_KEY } from '../__lib__/LegendCubeLabels.js';
+/**
+ * The page's Dev Settings, opened from the menu at the top left as Legend
+ * Query's editor opens its own (PLAN §11.16): the engine's URL, and whether
+ * Cube's engine clients compress their requests (uncompressed, the browser's
+ * Network tab shows each request's JSON). Compression is kept for the user,
+ * on by default; the URL lasts while the application runs, as Query's does.
+ * Both change every engine client of Cube's host, from the next request.
+ */
+export class CubeDevSettingsState {
+    host;
+    settings;
+    isOpen = false;
+    requestCompression;
+    /** The engine URL as typed: it is used once it is a URL */
+    baseUrlText;
+    constructor(host) {
+        makeObservable(this, {
+            host: false,
+            settings: false,
+            isOpen: observable,
+            requestCompression: observable,
+            baseUrlText: observable,
+            baseUrlError: computed,
+            open: action,
+            close: action,
+            setRequestCompression: action,
+            setBaseUrlText: action,
+            resetBaseUrl: action,
+        });
+        this.host = host;
+        this.settings = host.engineClientSettings;
+        const uncompressed = host.applicationStore.userDataService.getBooleanValue(LEGEND_CUBE_USER_DATA_KEY.UNCOMPRESSED_REQUESTS) ?? false;
+        if (uncompressed) {
+            this.settings?.setRequestCompression(false);
+        }
+        this.requestCompression = this.settings?.requestCompression ?? true;
+        this.baseUrlText = this.settings?.baseUrl ?? '';
+    }
+    /** Whether the host lets Dev Settings change its engine clients */
+    get isAvailable() {
+        return this.settings !== undefined;
+    }
+    /** The URL the host configured */
+    get defaultBaseUrl() {
+        return this.settings?.defaultBaseUrl;
+    }
+    /** Why the typed engine URL isn't used, if it isn't */
+    get baseUrlError() {
+        return isValidUrl(this.baseUrlText) ? undefined : 'Invalid URL';
+    }
+    open() {
+        this.isOpen = true;
+    }
+    close() {
+        this.isOpen = false;
+    }
+    setRequestCompression(compressed) {
+        if (!this.settings) {
+            return;
+        }
+        this.requestCompression = compressed;
+        this.settings.setRequestCompression(compressed);
+        this.host.applicationStore.userDataService.persistValue(LEGEND_CUBE_USER_DATA_KEY.UNCOMPRESSED_REQUESTS, !compressed);
+    }
+    /** Takes the typed engine URL, and uses it once it is a URL */
+    setBaseUrlText(text) {
+        this.baseUrlText = text;
+        if (this.settings && isValidUrl(text)) {
+            this.settings.setBaseUrl(text);
+        }
+    }
+    /** Goes back to the engine URL the host configured */
+    resetBaseUrl() {
+        if (!this.settings) {
+            return;
+        }
+        this.settings.setBaseUrl(this.settings.defaultBaseUrl);
+        this.baseUrlText = this.settings.defaultBaseUrl ?? '';
+    }
+}
+//# sourceMappingURL=CubeDevSettingsState.js.map

package/lib/stores/CubeDevSettingsState.js.map

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