refactor(workspaces): personal workspace provider additions for REST environments

[jamesgeorge007]

Description

This PR ports GraphQL collections & REST environments to the new handles-based architecture.

Closes HFE-525.

Changes

• Adds the following methods under the personal workspace provider corresponding to the abovementioned features.

  getRESTEnvironmentsView(
    workspaceHandle: Handle<Workspace>
  ): Promise<E.Either<never, Handle<RESTEnvironmentsView>>>
  
  createRESTEnvironment(
    workspaceHandle: Handle<Workspace>,
    newEnvironment: Partial<Environment> & { name: string }
  ): Promise<E.Either<unknown, Handle<WorkspaceEnvironment>>>
  duplicateRESTEnvironment(
    environmentHandle: Handle<WorkspaceEnvironment>
  ): Promise<E.Either<unknown, Handle<WorkspaceEnvironment>>>
  updateRESTEnvironment(
    environmentHandle: Handle<WorkspaceEnvironment>,
    updatedEnvironment: Partial<Environment>
  ): Promise<E.Either<unknown, void>>
  removeRESTEnvironment(
    environmentHandle: Handle<WorkspaceEnvironment>
  ): Promise<E.Either<unknown, void>>
  
  importRESTEnvironments(
    workspaceHandle: Handle<Workspace>,
    environments: Environment[]
  ): Promise<E.Either<unknown, void>>
  exportRESTEnvironments(
    workspaceHandle: Handle<Workspace>
  ): Promise<E.Either<unknown, void>>
  exportRESTEnvironment(
    environmentHandle: Handle<WorkspaceEnvironment>
  ): Promise<E.Either<unknown, void>>

• Introduce restEnvironmentState member at the PersonalWorkspaceProviderService level holding the environment store state.

• The getCollectionHandle & getRequestHandle methods are renamed to getRESTCollectionHandle & getRESTRequestHandle respectively.

• Environments-related component updates moving to the provider API methods. Separate components for personal/team workspaces are kept as is for now and events are emitted corresponding to the action performed (create, edit, etc) bound to the respective provider method at the base component level (Environments).

• Introduce the RESTEnvironmentsView type corresponding to the list of environments under a workspace (return type of the getRESTEnvironmentsView method).

• Perform request duplication via the provider method for creating a request.

• Includes a fix for the case when the request from the collection tree and the one open under a tab dissociates when closed and reopened. The corresponding request handle is removed from the issued handles list maintained at the PersonalWorkspaceProvider service level via the new setIssuedHandles method when a tab is closed. A new helper function updateIssuedHandlesForPersonalWorkspace is added under ~/helpers/tab/index.ts abstracting the business logic for use in the REST / page (to be extended to GQL in the future). Also, while invalidating the affected request handles while removing a collection/request, the respective handles are removed from issuedHandles to prevent having unnecessary invalidated handle { type: "invalid", reason: <string> } entries kept throughout.

Checks

• My pull request adheres to the code style of this project
• All the tests have passed

Note to reviewers

The changes aimed at porting GQL collections are reverted for the time being since a few issues were encountered while testing the flows e2e - To be revisited.

REST prefixes are added to certain methods. Dedicated methods will be introduced once GQL collections-related functionality is ported with future-proofing in mind. Although the functionality is almost similar with the store update approach being the difference, they are kept distinct to account for the increase in scope (The current scope of workspace refactor only deals with the store/data source level) that might lead to diverging business logic.