@finos/legend-application-query 13.4.15 → 13.4.17

package/src/components/LegendQueryAppInfo.tsx

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2020-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 {
+  CopyIcon,
+  Dialog,
+  InfoCircleIcon,
+  Modal,
+  ModalBody,
+  ModalHeader,
+  ModalHeaderActions,
+  ModalTitle,
+  TimesIcon,
+} from '@finos/legend-art';
+import { isNonNullable } from '@finos/legend-shared';
+import { useQueryEditorStore } from './QueryEditorStoreProvider.js';
+
+export const LegendQueryInfo: React.FC<{
+  open: boolean;
+  closeModal: () => void;
+}> = (props) => {
+  const { open, closeModal } = props;
+  const editorStore = useQueryEditorStore();
+  const applicationStore = editorStore.applicationStore;
+  const config = applicationStore.config;
+  const copyInfo = (): void => {
+    applicationStore.clipboardService
+      .copyTextToClipboard(
+        [
+          `Environment: ${config.env}`,
+          `Version: ${config.appVersion}`,
+          `Revision: ${config.appVersionCommitId}`,
+          `Build Time: ${config.appVersionBuildTime}`,
+          `Engine Server: ${config.engineServerUrl}`,
+          `Depot Server: ${config.depotServerUrl}`,
+        ]
+          .filter(isNonNullable)
+          .join('\n'),
+      )
+      .then(() =>
+        applicationStore.notificationService.notifySuccess(
+          'Copied application info to clipboard',
+        ),
+      )
+      .catch(applicationStore.alertUnhandledError);
+  };
+
+  const goToReleaseLog = (): void => {
+    closeModal();
+    applicationStore.releaseNotesService.setReleaseLog(true);
+  };
+
+  return (
+    <Dialog onClose={closeModal} open={open}>
+      <Modal
+        darkMode={
+          !applicationStore.layoutService.TEMPORARY__isLightColorThemeEnabled
+        }
+        className="modal--scrollable app__info"
+      >
+        <ModalHeader>
+          <ModalTitle icon={<InfoCircleIcon />} title="About Legend Query" />
+          <ModalHeaderActions>
+            <button
+              className="modal__header__action"
+              tabIndex={-1}
+              onClick={copyInfo}
+              title="Copy application info"
+            >
+              <CopyIcon />
+            </button>
+            <button
+              className="modal__header__action"
+              tabIndex={-1}
+              onClick={closeModal}
+            >
+              <TimesIcon />
+            </button>
+          </ModalHeaderActions>
+        </ModalHeader>
+        <ModalBody>
+          <div className="app__info__entry">
+            <div className="app__info__entry__title">Environment:</div>
+            <div className="app__info__entry__value">{config.env}</div>
+          </div>
+          <div className="app__info__entry">
+            <div className="app__info__entry__title">Version:</div>
+            <div className="app__info__entry__value">{config.appVersion}</div>
+          </div>
+          <div className="app__info__entry">
+            <div className="app__info__entry__title">Revision:</div>
+            <div className="app__info__entry__value">
+              {config.appVersionCommitId}
+            </div>
+          </div>
+          <div className="app__info__entry">
+            <div className="app__info__entry__title">Build Time:</div>
+            <div className="app__info__entry__value">
+              {config.appVersionBuildTime}
+            </div>
+          </div>
+          <div className="app__info__entry">
+            <div
+              onClick={goToReleaseLog}
+              className="app__info__entry__value app__info__entry__value__action"
+            >
+              Details of Released Versions
+            </div>
+          </div>
+          <div className="app__info__group">
+            <div className="app__info__entry">
+              <div className="app__info__entry__title">Engine Server:</div>
+              <div className="app__info__entry__value">
+                <a
+                  href={config.engineServerUrl}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  {config.engineServerUrl}
+                </a>
+              </div>
+            </div>
+            <div className="app__info__entry">
+              <div className="app__info__entry__title">Depot Server:</div>
+              <div className="app__info__entry__value">
+                <a
+                  href={config.depotServerUrl}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  {config.depotServerUrl}
+                </a>
+              </div>
+            </div>
+          </div>
+        </ModalBody>
+      </Modal>
+    </Dialog>
+  );
+};

package/src/components/QueryEditor.tsx

@@ -45,7 +45,7 @@ import {
   SunIcon,
 } from '@finos/legend-art';
 import { observer } from 'mobx-react-lite';
-import { Fragment, useEffect, useMemo, useRef, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import {
   type MappingQueryCreatorPathParams,
   type ExistingQueryEditorPathParams,
@@ -58,6 +58,8 @@ import {
 import { ExistingQueryEditorStore } from '../stores/QueryEditorStore.js';
 import {
   LEGEND_APPLICATION_COLOR_THEME,
+  ReleaseLogManager,
+  ReleaseNotesManager,
   useApplicationStore,
 } from '@finos/legend-application';
 import { useParams } from '@finos/legend-application/browser';
@@ -76,10 +78,7 @@ import {
   type QueryBuilderState,
 } from '@finos/legend-query-builder';
 
-import {
-  compareSemVerVersions,
-  generateGAVCoordinates,
-} from '@finos/legend-storage';
+import { generateGAVCoordinates } from '@finos/legend-storage';
 import {
   type Query,
   QueryDataSpaceExecutionContext,
@@ -88,7 +87,8 @@ import {
 import { LATEST_VERSION_ALIAS } from '@finos/legend-server-depot';
 import { buildVersionOption, type VersionOption } from './QuerySetup.js';
 import { QueryEditorExistingQueryVersionRevertModal } from './QueryEdtiorExistingQueryVersionRevertModal.js';
-import { debounce } from '@finos/legend-shared';
+import { debounce, compareSemVerVersions } from '@finos/legend-shared';
+import { LegendQueryInfo } from './LegendQueryAppInfo.js';
 
 const CreateQueryDialog = observer(() => {
   const editorStore = useQueryEditorStore();
@@ -588,8 +588,6 @@ export const QueryEditor = observer(() => {
         generateQuerySetupRoute(),
       ),
     );
-  const goToReleaseLog = (): void =>
-    applicationStore.releaseNotesService.setReleaseLog(true);
   // settings
   // NOTE: this is temporary until we find a better home for these settings in query builder
   const engineConfig =
@@ -612,6 +610,7 @@ export const QueryEditor = observer(() => {
     flowResult(editorStore.initialize()).catch(
       applicationStore.alertUnhandledError,
     );
+    applicationStore.releaseNotesService.updateViewedVersion();
   }, [editorStore, applicationStore]);
 
   return (
@@ -631,9 +630,6 @@ export const QueryEditor = observer(() => {
                   <MenuContentItem onClick={goToQuerySetup}>
                     Back to query setup
                   </MenuContentItem>
-                  <MenuContentItem onClick={goToReleaseLog}>
-                    Legend Query Release Log
-                  </MenuContentItem>
                   <MenuContentItem
                     disabled={!appDocUrl}
                     onClick={goToDocumentation}
@@ -724,6 +720,12 @@ export const QueryEditor = observer(() => {
         />
       )}
       {editorStore.queryCreatorState.showCreateModal && <CreateQueryDialog />}
+      {editorStore.showAppInfo && (
+        <LegendQueryInfo
+          open={editorStore.showAppInfo}
+          closeModal={() => editorStore.setShowAppInfo(false)}
+        />
+      )}
       {isExistingQuery &&
         editorStore.updateState.showQueryInfo &&
         editorStore.query && (
@@ -732,6 +734,8 @@ export const QueryEditor = observer(() => {
             query={editorStore.query}
           />
         )}
+      <ReleaseLogManager />
+      <ReleaseNotesManager />
     </div>
   );
 });

package/src/components/QueryEdtiorExistingQueryVersionRevertModal.tsx

@@ -23,7 +23,7 @@ import {
   ModalFooterButton,
 } from '@finos/legend-art';
 import { LATEST_VERSION_ALIAS } from '@finos/legend-server-depot';
-import { compareSemVerVersions } from '@finos/legend-storage';
+import { compareSemVerVersions } from '@finos/legend-shared';
 import { flowResult } from 'mobx';
 import { observer } from 'mobx-react-lite';
 import { useState, useEffect } from 'react';

package/src/components/data-space/DataSpaceQuerySetup.tsx

@@ -95,7 +95,7 @@ const DataSpaceQuerySetupSetupPanelContent = observer(
       queryBuilderState.showAdvancedSearchPanel();
 
     useEffect(() => {
-      flowResult(queryBuilderState.loadDataSpaces()).catch(
+      flowResult(queryBuilderState.initializeDataSpaceSetup()).catch(
         applicationStore.alertUnhandledError,
       );
     }, [queryBuilderState, applicationStore]);

package/src/stores/QueryEditorStore.ts

@@ -123,6 +123,7 @@ import {
   retrieveAnalyticsResultCache,
 } from '@finos/legend-extension-dsl-data-space/graph';
 import { generateDataSpaceQueryCreatorRoute } from '../__lib__/DSL_DataSpace_LegendQueryNavigation.js';
+import { hasDataSpaceInfoBeenVisited } from '../__lib__/LegendQueryUserDataSpaceHelper.js';
 
 export const createViewProjectHandler =
   (applicationStore: LegendQueryApplicationStore) =>
@@ -314,6 +315,7 @@ export abstract class QueryEditorStore {
   queryCreatorState: QueryCreatorState;
   existingQueryName: string | undefined;
   showRegisterServiceModal = false;
+  showAppInfo = false;
 
   constructor(
     applicationStore: LegendQueryApplicationStore,
@@ -324,10 +326,12 @@ export abstract class QueryEditorStore {
       queryLoaderState: observable,
       existingQueryName: observable,
       showRegisterServiceModal: observable,
+      showAppInfo: observable,
       queryBuilderState: observable,
       isPerformingBlockingAction: computed,
       setExistingQueryName: action,
       setShowRegisterServiceModal: action,
+      setShowAppInfo: action,
       initialize: flow,
       buildGraph: flow,
       searchExistingQueryName: flow,
@@ -405,6 +409,10 @@ export abstract class QueryEditorStore {
     this.existingQueryName = val;
   }
 
+  setShowAppInfo(val: boolean): void {
+    this.showAppInfo = val;
+  }
+
   setShowRegisterServiceModal(val: boolean): void {
     this.showRegisterServiceModal = val;
   }
@@ -534,10 +542,15 @@ export abstract class QueryEditorStore {
         error,
       );
       this.applicationStore.notificationService.notifyError(error);
+      this.onInitializeFailure();
       this.initState.fail();
     }
   }
 
+  onInitializeFailure(): void {
+    // Do Nothing
+  }
+
   *searchExistingQueryName(searchText: string): GeneratorFn<void> {
     const isValidSearchString =
       searchText.length >= DEFAULT_TYPEAHEAD_SEARCH_MINIMUM_SEARCH_LENGTH;
@@ -1234,6 +1247,10 @@ export class ExistingQueryEditorStore extends QueryEditorStore {
           versionId: projectInfo.versionId,
           dataSpace: dataSpace.path,
         };
+        const visitedDataSpaces =
+          LegendQueryUserDataHelper.getRecentlyVisitedDataSpaces(
+            this.applicationStore.userDataService,
+          );
         const dataSpaceQueryBuilderState = new DataSpaceQueryBuilderState(
           this.applicationStore,
           this.graphManagerState,
@@ -1313,6 +1330,8 @@ export class ExistingQueryEditorStore extends QueryEditorStore {
           projectInfo,
           this.applicationStore.config.options.queryBuilderConfig,
           sourceInfo,
+          (dataSpaceInfo: DataSpaceInfo) =>
+            hasDataSpaceInfoBeenVisited(dataSpaceInfo, visitedDataSpaces),
         );
         const mappingModelCoverageAnalysisResult =
           dataSpaceAnalysisResult?.executionContextsIndex.get(

package/src/stores/data-space/DataSpaceQueryCreatorStore.ts

@@ -29,8 +29,11 @@ import {
   LATEST_VERSION_ALIAS,
 } from '@finos/legend-server-depot';
 import {
+  LogEvent,
+  assertErrorThrown,
   guaranteeNonNullable,
   guaranteeType,
+  returnUndefOnError,
   uuid,
 } from '@finos/legend-shared';
 import {
@@ -59,6 +62,13 @@ import {
   type DataSpaceInfo,
 } from '@finos/legend-extension-dsl-data-space/application';
 import { generateDataSpaceQueryCreatorRoute } from '../../__lib__/DSL_DataSpace_LegendQueryNavigation.js';
+import { LegendQueryUserDataHelper } from '../../__lib__/LegendQueryUserDataHelper.js';
+import {
+  createVisitedDataSpaceId,
+  hasDataSpaceInfoBeenVisited,
+  createSimpleVisitedDataspace,
+} from '../../__lib__/LegendQueryUserDataSpaceHelper.js';
+import { LEGEND_QUERY_APP_EVENT } from '../../__lib__/LegendQueryEvent.js';
 
 export class DataSpaceQueryCreatorStore extends QueryEditorStore {
   readonly groupId: string;
@@ -144,6 +154,10 @@ export class DataSpaceQueryCreatorStore extends QueryEditorStore {
       versionId: projectInfo.versionId,
       dataSpace: dataSpace.path,
     };
+    const visitedDataSpaces =
+      LegendQueryUserDataHelper.getRecentlyVisitedDataSpaces(
+        this.applicationStore.userDataService,
+      );
     const queryBuilderState = new DataSpaceQueryBuilderState(
       this.applicationStore,
       this.graphManagerState,
@@ -193,6 +207,15 @@ export class DataSpaceQueryCreatorStore extends QueryEditorStore {
             queryBuilderState.class?.path,
           ),
         );
+        returnUndefOnError(() =>
+          LegendQueryUserDataHelper.updateVisitedDataSpaceExecContext(
+            this.applicationStore.userDataService,
+            this.groupId,
+            this.artifactId,
+            dataSpace.path,
+            ec.name,
+          ),
+        );
       },
       (runtimeValue: Runtime) => {
         const runtimePointer = guaranteeType(runtimeValue, RuntimePointer);
@@ -235,6 +258,8 @@ export class DataSpaceQueryCreatorStore extends QueryEditorStore {
       projectInfo,
       this.applicationStore.config.options.queryBuilderConfig,
       sourceInfo,
+      (dataSpaceInfo: DataSpaceInfo) =>
+        hasDataSpaceInfoBeenVisited(dataSpaceInfo, visitedDataSpaces),
     );
     queryBuilderState.setExecutionContext(executionContext);
     queryBuilderState.propagateExecutionContextChange(executionContext);
@@ -257,9 +282,32 @@ export class DataSpaceQueryCreatorStore extends QueryEditorStore {
       );
     }
 
+    // add to visited dataspaces
+    this.addVisitedDataSpace(executionContext.name);
     return queryBuilderState;
   }
 
+  addVisitedDataSpace(execName: string | undefined): void {
+    try {
+      LegendQueryUserDataHelper.addVisitedDatspace(
+        this.applicationStore.userDataService,
+        createSimpleVisitedDataspace(
+          this.groupId,
+          this.artifactId,
+          this.versionId,
+          this.dataSpacePath,
+          execName,
+        ),
+      );
+    } catch (error) {
+      assertErrorThrown(error);
+      this.applicationStore.logService.warn(
+        LogEvent.create(LEGEND_QUERY_APP_EVENT.LOCAL_STORAGE_PERSIST_ERROR),
+        error.message,
+      );
+    }
+  }
+
   getPersistConfiguration(
     lambda: RawLambda,
     options?: { update?: boolean | undefined },
@@ -283,4 +331,15 @@ export class DataSpaceQueryCreatorStore extends QueryEditorStore {
       },
     };
   }
+
+  override onInitializeFailure(): void {
+    LegendQueryUserDataHelper.removeRecentlyViewedDataSpace(
+      this.applicationStore.userDataService,
+      createVisitedDataSpaceId(
+        this.groupId,
+        this.artifactId,
+        this.dataSpacePath,
+      ),
+    );
+  }
 }

package/src/stores/data-space/DataSpaceQuerySetupState.ts

@@ -22,13 +22,13 @@ import {
 } from '@finos/legend-server-depot';
 import type { GraphManagerState, RawLambda } from '@finos/legend-graph';
 import { type GenericLegendApplicationStore } from '@finos/legend-application';
-import { action, flow, makeObservable, observable } from 'mobx';
+import { action, flow, flowResult, makeObservable, observable } from 'mobx';
 import {
   type QueryBuilderConfig,
   QueryBuilderState,
   QueryBuilderDataBrowserWorkflow,
 } from '@finos/legend-query-builder';
-import type { ProjectGAVCoordinates } from '@finos/legend-storage';
+import type { Entity, ProjectGAVCoordinates } from '@finos/legend-storage';
 import {
   ActionState,
   assertErrorThrown,
@@ -51,7 +51,13 @@ import {
 import { generateDataSpaceQueryCreatorRoute } from '../../__lib__/DSL_DataSpace_LegendQueryNavigation.js';
 import { renderDataSpaceQuerySetupSetupPanelContent } from '../../components/data-space/DataSpaceQuerySetup.js';
 import { DataSpaceAdvancedSearchState } from '@finos/legend-extension-dsl-data-space/application-query';
+import type { VisitedDataspace } from '../../__lib__/LegendQueryUserDataSpaceHelper.js';
+import { LegendQueryUserDataHelper } from '../../__lib__/LegendQueryUserDataHelper.js';
 
+type DataSpaceVisitedEntity = {
+  visited: VisitedDataspace;
+  entity: Entity;
+};
 export class DataSpaceQuerySetupState extends QueryBuilderState {
   editorStore: QueryEditorStore;
   readonly depotServerClient: DepotServerClient;
@@ -107,7 +113,9 @@ export class DataSpaceQuerySetupState extends QueryBuilderState {
       advancedSearchState: observable,
       showAdvancedSearchPanel: action,
       hideAdvancedSearchPanel: action,
-      loadDataSpaces: flow,
+      initializeDataSpaceSetup: flow,
+      redirectIfPossible: flow,
+      hyrdateVisitedDataSpace: flow,
     });
 
     this.editorStore = editorStore;
@@ -144,9 +152,29 @@ export class DataSpaceQuerySetupState extends QueryBuilderState {
     this.advancedSearchState = undefined;
   }
 
-  *loadDataSpaces(): GeneratorFn<void> {
+  *initializeDataSpaceSetup(): GeneratorFn<void> {
     this.loadDataSpacesState.inProgress();
     try {
+      const hydrated = (yield flowResult(this.redirectIfPossible())) as
+        | DataSpaceVisitedEntity
+        | undefined;
+      if (hydrated) {
+        this.applicationStore.navigationService.navigator.goToLocation(
+          generateDataSpaceQueryCreatorRoute(
+            guaranteeNonNullable(hydrated.visited.groupId),
+            guaranteeNonNullable(hydrated.visited.artifactId),
+            hydrated.visited.versionId ?? LATEST_VERSION_ALIAS,
+            hydrated.visited.path,
+            hydrated.visited.execContext ??
+              (hydrated.entity.content.defaultExecutionContext as string),
+            undefined,
+            undefined,
+          ),
+        );
+        this.loadDataSpacesState.complete();
+        return;
+      }
+
       this.dataSpaces = (
         (yield this.depotServerClient.getEntitiesByClassifier(
           DATA_SPACE_ELEMENT_CLASSIFIER_PATH,
@@ -162,6 +190,66 @@ export class DataSpaceQuerySetupState extends QueryBuilderState {
       this.applicationStore.notificationService.notifyError(error);
     }
   }
+
+  *redirectIfPossible(): GeneratorFn<DataSpaceVisitedEntity | undefined> {
+    const visitedQueries =
+      LegendQueryUserDataHelper.getRecentlyVisitedDataSpaces(
+        this.applicationStore.userDataService,
+      );
+    let redirect: DataSpaceVisitedEntity | undefined = undefined;
+    for (let i = 0; i < visitedQueries.length; i++) {
+      const visited = visitedQueries[i];
+      if (visited) {
+        const hydrated = (yield flowResult(
+          this.hyrdateVisitedDataSpace(visited),
+        )) as DataSpaceVisitedEntity | undefined;
+        if (hydrated) {
+          redirect = hydrated;
+          break;
+        }
+      }
+    }
+    return redirect;
+  }
+
+  *hyrdateVisitedDataSpace(
+    visited: VisitedDataspace,
+  ): GeneratorFn<DataSpaceVisitedEntity | undefined> {
+    try {
+      const entity = (yield this.depotServerClient.getVersionEntity(
+        visited.groupId,
+        visited.artifactId,
+        visited.versionId ?? LATEST_VERSION_ALIAS,
+        visited.path,
+      )) as Entity;
+      const content = entity.content as {
+        executionContexts: { name: string }[];
+      };
+      if (visited.execContext) {
+        const found = content.executionContexts.find(
+          (e) => e.name === visited.execContext,
+        );
+        if (!found) {
+          visited.execContext = undefined;
+          return {
+            visited,
+            entity,
+          };
+        }
+      }
+      return {
+        visited,
+        entity,
+      };
+    } catch (error) {
+      assertErrorThrown(error);
+      LegendQueryUserDataHelper.removeRecentlyViewedDataSpace(
+        this.applicationStore.userDataService,
+        visited.id,
+      );
+    }
+    return undefined;
+  }
 }
 
 export class DataSpaceQuerySetupStore extends QueryEditorStore {

package/tsconfig.json

@@ -57,6 +57,7 @@
     "./src/__lib__/LegendQueryNavigation.ts",
     "./src/__lib__/LegendQueryTelemetryHelper.ts",
     "./src/__lib__/LegendQueryUserDataHelper.ts",
+    "./src/__lib__/LegendQueryUserDataSpaceHelper.ts",
     "./src/application/Core_LegendQuery_LegendApplicationPlugin.ts",
     "./src/application/LegendQueryApplicationConfig.ts",
     "./src/application/LegendQueryPluginManager.ts",
@@ -79,6 +80,7 @@
     "./src/components/Core_LegendQueryApplicationPlugin.tsx",
     "./src/components/CreateMappingQuerySetup.tsx",
     "./src/components/EditExistingQuerySetup.tsx",
+    "./src/components/LegendQueryAppInfo.tsx",
     "./src/components/LegendQueryFrameworkProvider.tsx",
     "./src/components/LegendQueryWebApplication.tsx",
     "./src/components/LoadProjectServiceQuerySetup.tsx",