refactor: rename WorkspacePlugin to WorkspaceAdapter (#2330)

apps/web/src/atoms/__tests__/atom.spec.ts

@@ -19,7 +19,7 @@ import type { Page } from '@blocksuite/store';
 import { createStore } from 'jotai';
 import { describe, expect, test } from 'vitest';
 
-import { WorkspacePlugins } from '../../plugins';
+import { WorkspaceAdapters } from '../../plugins';
 import { rootCurrentWorkspaceAtom } from '../root';
 
 describe('currentWorkspace atom', () => {
@@ -45,7 +45,7 @@ describe('currentWorkspace atom', () => {
       const provider = createIndexedDBDownloadProvider(workspace);
       provider.sync();
       await provider.whenReady;
-      const workspaceId = await WorkspacePlugins[
+      const workspaceId = await WorkspaceAdapters[
         WorkspaceFlavour.LOCAL
       ].CRUD.create(workspace);
       store.set(rootWorkspacesMetadataAtom, [

apps/web/src/atoms/index.ts

@@ -12,7 +12,7 @@ import { atom } from 'jotai';
 import { atomWithStorage } from 'jotai/utils';
 
 import type { CreateWorkspaceMode } from '../components/affine/create-workspace-modal';
-import { WorkspacePlugins } from '../plugins';
+import { WorkspaceAdapters } from '../plugins';
 
 const logger = new DebugLogger('web:atoms');
 
@@ -25,7 +25,7 @@ export const currentWorkspaceIdAtom = rootCurrentWorkspaceIdAtom;
 // todo(himself65): move this to the workspace package
 rootWorkspacesMetadataAtom.onMount = setAtom => {
   function createFirst(): RootWorkspaceMetadata[] {
-    const Plugins = Object.values(WorkspacePlugins).sort(
+    const Plugins = Object.values(WorkspaceAdapters).sort(
       (a, b) => a.loadPriority - b.loadPriority
     );
 

apps/web/src/atoms/root.ts

@@ -13,7 +13,7 @@ import { WorkspaceFlavour } from '@affine/workspace/type';
 import { assertExists } from '@blocksuite/store';
 import { atom } from 'jotai';
 
-import { WorkspacePlugins } from '../plugins';
+import { WorkspaceAdapters } from '../plugins';
 import type { AllWorkspace } from '../shared';
 
 const logger = new DebugLogger('web:atoms:root');
@@ -22,7 +22,7 @@ const logger = new DebugLogger('web:atoms:root');
  * Fetch all workspaces from the Plugin CRUD
  */
 export const workspacesAtom = atom<Promise<AllWorkspace[]>>(async get => {
-  const flavours: string[] = Object.values(WorkspacePlugins).map(
+  const flavours: string[] = Object.values(WorkspaceAdapters).map(
     plugin => plugin.flavour
   );
   const jotaiWorkspaces = get(rootWorkspacesMetadataAtom)
@@ -38,7 +38,7 @@ export const workspacesAtom = atom<Promise<AllWorkspace[]>>(async get => {
   const workspaces = await Promise.all(
     jotaiWorkspaces.map(workspace => {
       const plugin =
-        WorkspacePlugins[workspace.flavour as keyof typeof WorkspacePlugins];
+        WorkspaceAdapters[workspace.flavour as keyof typeof WorkspaceAdapters];
       assertExists(plugin);
       const { CRUD } = plugin;
       return CRUD.get(workspace.id).then(workspace => {
@@ -93,7 +93,7 @@ export const rootCurrentWorkspaceAtom = atom<Promise<AllWorkspace>>(
     if (!targetWorkspace) {
       throw new Error(`cannot find the workspace with id ${targetId}.`);
     }
-    const workspace = await WorkspacePlugins[targetWorkspace.flavour].CRUD.get(
+    const workspace = await WorkspaceAdapters[targetWorkspace.flavour].CRUD.get(
       targetWorkspace.id
     );
     if (!workspace) {

apps/web/src/components/affine/workspace-setting-detail/panel/collaboration/index.tsx

@@ -2,7 +2,10 @@ import { Button, IconButton, Menu, MenuItem, Wrapper } from '@affine/component';
 import { config } from '@affine/env';
 import { useAFFiNEI18N } from '@affine/i18n/hooks';
 import { PermissionType } from '@affine/workspace/affine/api';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import {
   DeleteTemporarilyIcon,
@@ -37,7 +40,7 @@ import {
 
 const AffineRemoteCollaborationPanel: React.FC<
   Omit<PanelProps, 'workspace'> & {
-    workspace: AffineWorkspace;
+    workspace: AffineLegacyCloudWorkspace;
   }
 > = ({ workspace }) => {
   const [isInviteModalShow, setIsInviteModalShow] = useState(false);
@@ -214,7 +217,7 @@ const LocalCollaborationPanel: React.FC<
 export const CollaborationPanel: React.FC<PanelProps> = props => {
   switch (props.workspace.flavour) {
     case WorkspaceFlavour.AFFINE: {
-      const workspace = props.workspace as AffineWorkspace;
+      const workspace = props.workspace as AffineLegacyCloudWorkspace;
       return (
         <AffineRemoteCollaborationPanel {...props} workspace={workspace} />
       );

apps/web/src/components/affine/workspace-setting-detail/panel/publish/index.tsx

@@ -7,7 +7,10 @@ import {
 } from '@affine/component';
 import { config } from '@affine/env';
 import { useAFFiNEI18N } from '@affine/i18n/hooks';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import { Box } from '@mui/material';
 import type React from 'react';
@@ -26,7 +29,7 @@ export type PublishPanelProps = WorkspaceSettingDetailProps & {
 };
 
 export type PublishPanelAffineProps = WorkspaceSettingDetailProps & {
-  workspace: AffineWorkspace;
+  workspace: AffineLegacyCloudWorkspace;
 };
 
 const PublishPanelAffine: React.FC<PublishPanelAffineProps> = ({

apps/web/src/components/blocksuite/workspace-header/header-right-items/share-menu.tsx

@@ -1,6 +1,9 @@
 import { ShareMenu } from '@affine/component/share-menu';
 import { config } from '@affine/env';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import type { Page } from '@blocksuite/store';
 import { assertEquals } from '@blocksuite/store';
@@ -19,12 +22,12 @@ import type { BaseHeaderProps } from '../header';
 const AffineHeaderShareMenu: React.FC<BaseHeaderProps> = props => {
   // todo: these hooks should be moved to the top level
   const togglePublish = useToggleWorkspacePublish(
-    props.workspace as AffineWorkspace
+    props.workspace as AffineLegacyCloudWorkspace
   );
   const helper = useRouterHelper(useRouter());
   return (
     <ShareMenu
-      workspace={props.workspace as AffineWorkspace}
+      workspace={props.workspace as AffineLegacyCloudWorkspace}
       currentPage={props.currentPage as Page}
       onEnableAffineCloud={useCallback(async () => {
         throw new Unreachable(

apps/web/src/components/pure/workspace-list-modal/index.tsx

@@ -9,7 +9,10 @@ import {
 import { WorkspaceList } from '@affine/component/workspace-list';
 import { useAFFiNEI18N } from '@affine/i18n/hooks';
 import type { AccessTokenMessage } from '@affine/workspace/affine/login';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import { HelpIcon, ImportIcon, PlusIcon } from '@blocksuite/icons';
 import type { DragEndEvent } from '@dnd-kit/core';
@@ -109,7 +112,7 @@ export const WorkspaceListModal = ({
             items={
               workspaces.filter(
                 ({ flavour }) => flavour !== WorkspaceFlavour.PUBLIC
-              ) as (AffineWorkspace | LocalWorkspace)[]
+              ) as (AffineLegacyCloudWorkspace | LocalWorkspace)[]
             }
             currentWorkspaceId={currentWorkspaceId}
             onClick={onClickWorkspace}

apps/web/src/hooks/affine/use-affine-log-in.ts

@@ -2,12 +2,12 @@ import { WorkspaceFlavour } from '@affine/workspace/type';
 import { useRouter } from 'next/router';
 import { useCallback } from 'react';
 
-import { WorkspacePlugins } from '../../plugins';
+import { WorkspaceAdapters } from '../../plugins';
 
 export function useAffineLogIn() {
   const router = useRouter();
   return useCallback(async () => {
-    await WorkspacePlugins[WorkspaceFlavour.AFFINE].Events[
+    await WorkspaceAdapters[WorkspaceFlavour.AFFINE].Events[
       'workspace:access'
     ]?.();
     // todo: remove reload page requirement

apps/web/src/hooks/affine/use-affine-log-out.ts

@@ -2,12 +2,12 @@ import { WorkspaceFlavour } from '@affine/workspace/type';
 import { useRouter } from 'next/router';
 import { useCallback } from 'react';
 
-import { WorkspacePlugins } from '../../plugins';
+import { WorkspaceAdapters } from '../../plugins';
 
 export function useAffineLogOut() {
   const router = useRouter();
   return useCallback(async () => {
-    await WorkspacePlugins[WorkspaceFlavour.AFFINE].Events[
+    await WorkspaceAdapters[WorkspaceFlavour.AFFINE].Events[
       'workspace:revoke'
     ]?.();
     router.reload();

apps/web/src/hooks/affine/use-toggle-workspace-publish.ts

@@ -1,12 +1,14 @@
 import { rootStore, rootWorkspacesMetadataAtom } from '@affine/workspace/atom';
-import type { AffineWorkspace } from '@affine/workspace/type';
+import type { AffineLegacyCloudWorkspace } from '@affine/workspace/type';
 import { useCallback } from 'react';
 import useSWR from 'swr';
 
 import { QueryKey } from '../../plugins/affine/fetcher';
 import { affineApis } from '../../shared/apis';
 
-export function useToggleWorkspacePublish(workspace: AffineWorkspace) {
+export function useToggleWorkspacePublish(
+  workspace: AffineLegacyCloudWorkspace
+) {
   const { mutate } = useSWR(QueryKey.getWorkspaces);
   return useCallback(
     async (isPublish: boolean) => {

apps/web/src/hooks/use-transform-workspace.ts

@@ -7,7 +7,7 @@ import type { WorkspaceRegistry } from '@affine/workspace/type';
 import { useSetAtom } from 'jotai';
 import { useCallback } from 'react';
 
-import { WorkspacePlugins } from '../plugins';
+import { WorkspaceAdapters } from '../plugins';
 
 /**
  * Transform workspace from one flavour to another
@@ -23,8 +23,8 @@ export function useTransformWorkspace() {
       to: To,
       workspace: WorkspaceRegistry[From]
     ): Promise<string> => {
-      await WorkspacePlugins[from].CRUD.delete(workspace as any);
+      await WorkspaceAdapters[from].CRUD.delete(workspace as any);
-      const newId = await WorkspacePlugins[to].CRUD.create(
+      const newId = await WorkspaceAdapters[to].CRUD.create(
         workspace.blockSuiteWorkspace
       );
       set(workspaces => {

apps/web/src/hooks/use-workspaces.ts

@@ -9,7 +9,7 @@ import { useAtomValue, useSetAtom } from 'jotai';
 import { useCallback, useEffect } from 'react';
 
 import { workspacesAtom } from '../atoms';
-import { WorkspacePlugins } from '../plugins';
+import { WorkspaceAdapters } from '../plugins';
 import { LocalPlugin } from '../plugins/local';
 import type { AllWorkspace } from '../shared';
 
@@ -86,7 +86,7 @@ export function useAppHelper() {
         }
 
         // delete workspace from plugin
-        await WorkspacePlugins[targetWorkspace.flavour].CRUD.delete(
+        await WorkspaceAdapters[targetWorkspace.flavour].CRUD.delete(
           // fixme: type casting
           targetWorkspace as any
         );

apps/web/src/layouts/workspace-layout.tsx

@@ -39,7 +39,7 @@ import { useRouterWithWorkspaceIdDefense } from '../hooks/use-router-with-worksp
 import { useSyncRouterWithCurrentPageId } from '../hooks/use-sync-router-with-current-page-id';
 import { useSyncRouterWithCurrentWorkspaceId } from '../hooks/use-sync-router-with-current-workspace-id';
 import { useWorkspaces } from '../hooks/use-workspaces';
-import { WorkspacePlugins } from '../plugins';
+import { WorkspaceAdapters } from '../plugins';
 import { ModalProvider } from '../providers/modal-provider';
 import { pathGenerator, publicPathGenerator } from '../shared';
 
@@ -100,7 +100,7 @@ export const QuickSearch: FC = () => {
 const logger = new DebugLogger('workspace-layout');
 
 const affineGlobalChannel = createAffineGlobalChannel(
-  WorkspacePlugins[WorkspaceFlavour.AFFINE].CRUD
+  WorkspaceAdapters[WorkspaceFlavour.AFFINE].CRUD
 );
 
 export const AllWorkspaceContext = ({
@@ -170,7 +170,7 @@ export const WorkspaceLayout: FC<PropsWithChildren> =
     useEffect(() => {
       logger.info('mount');
       const controller = new AbortController();
-      const lists = Object.values(WorkspacePlugins)
+      const lists = Object.values(WorkspaceAdapters)
         .sort((a, b) => a.loadPriority - b.loadPriority)
         .map(({ CRUD }) => CRUD.list);
 
@@ -220,7 +220,7 @@ export const WorkspaceLayout: FC<PropsWithChildren> =
     }, [currentWorkspaceId, jotaiWorkspaces]);
 
     const Provider =
-      (meta && WorkspacePlugins[meta.flavour].UI.Provider) ?? DefaultProvider;
+      (meta && WorkspaceAdapters[meta.flavour].UI.Provider) ?? DefaultProvider;
     return (
       <>
         {/* fixme(himself65): don't re-render whole modals */}

apps/web/src/pages/workspace/[workspaceId]/[pageId].tsx

@@ -23,7 +23,7 @@ import { useSyncRecentViewsWithRouter } from '../../../hooks/use-recent-views';
 import { useRouterAndWorkspaceWithPageIdDefense } from '../../../hooks/use-router-and-workspace-with-page-id-defense';
 import { useRouterHelper } from '../../../hooks/use-router-helper';
 import { WorkspaceLayout } from '../../../layouts/workspace-layout';
-import { WorkspacePlugins } from '../../../plugins';
+import { WorkspaceAdapters } from '../../../plugins';
 import type { BlockSuiteWorkspace, NextPageWithLayout } from '../../../shared';
 
 function setEditorFlags(blockSuiteWorkspace: BlockSuiteWorkspace) {
@@ -85,7 +85,8 @@ const WorkspaceDetail: React.FC = () => {
     }
   }, [currentWorkspace]);
   if (currentWorkspace.flavour === WorkspaceFlavour.AFFINE) {
-    const PageDetail = WorkspacePlugins[currentWorkspace.flavour].UI.PageDetail;
+    const PageDetail =
+      WorkspaceAdapters[currentWorkspace.flavour].UI.PageDetail;
     return (
       <PageDetail
         currentWorkspace={currentWorkspace}
@@ -93,7 +94,8 @@ const WorkspaceDetail: React.FC = () => {
       />
     );
   } else if (currentWorkspace.flavour === WorkspaceFlavour.LOCAL) {
-    const PageDetail = WorkspacePlugins[currentWorkspace.flavour].UI.PageDetail;
+    const PageDetail =
+      WorkspaceAdapters[currentWorkspace.flavour].UI.PageDetail;
     return (
       <PageDetail
         currentWorkspace={currentWorkspace}

apps/web/src/pages/workspace/[workspaceId]/all.tsx

@@ -16,7 +16,7 @@ import { useCurrentWorkspace } from '../../../hooks/current/use-current-workspac
 import { useRouterHelper } from '../../../hooks/use-router-helper';
 import { useSyncRouterWithCurrentWorkspaceId } from '../../../hooks/use-sync-router-with-current-workspace-id';
 import { WorkspaceLayout } from '../../../layouts/workspace-layout';
-import { WorkspacePlugins } from '../../../plugins';
+import { WorkspaceAdapters } from '../../../plugins';
 import type { NextPageWithLayout } from '../../../shared';
 
 const AllPage: NextPageWithLayout = () => {
@@ -43,7 +43,7 @@ const AllPage: NextPageWithLayout = () => {
     throw new QueryParamError('workspaceId', router.query.workspaceId);
   }
   if (currentWorkspace.flavour === WorkspaceFlavour.AFFINE) {
-    const PageList = WorkspacePlugins[currentWorkspace.flavour].UI.PageList;
+    const PageList = WorkspaceAdapters[currentWorkspace.flavour].UI.PageList;
     return (
       <>
         <Head>
@@ -65,7 +65,7 @@ const AllPage: NextPageWithLayout = () => {
       </>
     );
   } else if (currentWorkspace.flavour === WorkspaceFlavour.LOCAL) {
-    const PageList = WorkspacePlugins[currentWorkspace.flavour].UI.PageList;
+    const PageList = WorkspaceAdapters[currentWorkspace.flavour].UI.PageList;
     return (
       <>
         <Head>

apps/web/src/pages/workspace/[workspaceId]/setting.tsx

@@ -22,7 +22,7 @@ import { useOnTransformWorkspace } from '../../../hooks/root/use-on-transform-wo
 import { useSyncRouterWithCurrentWorkspaceId } from '../../../hooks/use-sync-router-with-current-workspace-id';
 import { useAppHelper } from '../../../hooks/use-workspaces';
 import { WorkspaceLayout } from '../../../layouts/workspace-layout';
-import { WorkspacePlugins } from '../../../plugins';
+import { WorkspaceAdapters } from '../../../plugins';
 import type { NextPageWithLayout } from '../../../shared';
 import { toast } from '../../../utils';
 
@@ -116,7 +116,7 @@ const SettingPage: NextPageWithLayout = () => {
     return <PageLoading />;
   } else if (currentWorkspace.flavour === WorkspaceFlavour.AFFINE) {
     const Setting =
-      WorkspacePlugins[currentWorkspace.flavour].UI.SettingsDetail;
+      WorkspaceAdapters[currentWorkspace.flavour].UI.SettingsDetail;
     return (
       <>
         <Head>
@@ -142,7 +142,7 @@ const SettingPage: NextPageWithLayout = () => {
     );
   } else if (currentWorkspace.flavour === WorkspaceFlavour.LOCAL) {
     const Setting =
-      WorkspacePlugins[currentWorkspace.flavour].UI.SettingsDetail;
+      WorkspaceAdapters[currentWorkspace.flavour].UI.SettingsDetail;
     return (
       <>
         <Head>

apps/web/src/plugins/affine/fetcher.ts

@@ -1,5 +1,5 @@
 import { rootStore } from '@affine/workspace/atom';
-import type { AffineWorkspace } from '@affine/workspace/type';
+import type { AffineLegacyCloudWorkspace } from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import { createEmptyBlockSuiteWorkspace } from '@affine/workspace/utils';
 import { assertExists } from '@blocksuite/store';
@@ -70,7 +70,7 @@ export const fetcher = async (
               workspaceApis: affineApis,
             }
           );
-          const remWorkspace: AffineWorkspace = {
+          const remWorkspace: AffineLegacyCloudWorkspace = {
             ...workspace,
             flavour: WorkspaceFlavour.AFFINE,
             blockSuiteWorkspace,

apps/web/src/plugins/affine/index.tsx

@@ -11,8 +11,12 @@ import {
   SignMethod,
 } from '@affine/workspace/affine/login';
 import { rootStore, rootWorkspacesMetadataAtom } from '@affine/workspace/atom';
-import type { AffineWorkspace } from '@affine/workspace/type';
+import type { AffineLegacyCloudWorkspace } from '@affine/workspace/type';
-import { LoadPriority, WorkspaceFlavour } from '@affine/workspace/type';
+import {
+  LoadPriority,
+  ReleaseType,
+  WorkspaceFlavour,
+} from '@affine/workspace/type';
 import {
   cleanupWorkspace,
   createEmptyBlockSuiteWorkspace,
@@ -33,7 +37,7 @@ import { useAffineRefreshAuthToken } from '../../hooks/affine/use-affine-refresh
 import { BlockSuiteWorkspace } from '../../shared';
 import { affineApis } from '../../shared/apis';
 import { toast } from '../../utils';
-import type { WorkspacePlugin } from '..';
+import type { WorkspaceAdapter } from '..';
 import { QueryKey } from './fetcher';
 
 const storage = createJSONStorage(() => localStorage);
@@ -46,7 +50,7 @@ const schema = z.object({
 
 const getPersistenceAllWorkspace = () => {
   const items = storage.getItem(AFFINE_STORAGE_KEY, []);
-  const allWorkspaces: AffineWorkspace[] = [];
+  const allWorkspaces: AffineLegacyCloudWorkspace[] = [];
   if (
     Array.isArray(items) &&
     items.every(item => schema.safeParse(item).success)
@@ -60,7 +64,7 @@ const getPersistenceAllWorkspace = () => {
             workspaceApis: affineApis,
           }
         );
-        const affineWorkspace: AffineWorkspace = {
+        const affineWorkspace: AffineLegacyCloudWorkspace = {
           ...item,
           flavour: WorkspaceFlavour.AFFINE,
           blockSuiteWorkspace,
@@ -89,7 +93,8 @@ function AuthContext({ children }: PropsWithChildren): ReactElement {
   return <>{children}</>;
 }
 
-export const AffinePlugin: WorkspacePlugin<WorkspaceFlavour.AFFINE> = {
+export const AffinePlugin: WorkspaceAdapter<WorkspaceFlavour.AFFINE> = {
+  releaseType: ReleaseType.STABLE,
   flavour: WorkspaceFlavour.AFFINE,
   loadPriority: LoadPriority.HIGH,
   Events: {
@@ -178,7 +183,8 @@ export const AffinePlugin: WorkspacePlugin<WorkspaceFlavour.AFFINE> = {
           cleanupWorkspace(WorkspaceFlavour.AFFINE);
           return null;
         }
-        const workspaces: AffineWorkspace[] = await AffinePlugin.CRUD.list();
+        const workspaces: AffineLegacyCloudWorkspace[] =
+          await AffinePlugin.CRUD.list();
         return (
           workspaces.find(workspace => workspace.id === workspaceId) ?? null
         );
@@ -239,7 +245,7 @@ export const AffinePlugin: WorkspacePlugin<WorkspaceFlavour.AFFINE> = {
               storage.setItem(AFFINE_STORAGE_KEY, [...data]);
             }
 
-            const affineWorkspace: AffineWorkspace = {
+            const affineWorkspace: AffineLegacyCloudWorkspace = {
               ...workspace,
               flavour: WorkspaceFlavour.AFFINE,
               blockSuiteWorkspace,

apps/web/src/plugins/index.tsx

@@ -3,12 +3,17 @@ import type {
   WorkspaceCRUD,
   WorkspaceUISchema,
 } from '@affine/workspace/type';
-import { LoadPriority, WorkspaceFlavour } from '@affine/workspace/type';
+import {
+  LoadPriority,
+  ReleaseType,
+  WorkspaceFlavour,
+} from '@affine/workspace/type';
 
 import { AffinePlugin } from './affine';
 import { LocalPlugin } from './local';
 
-export interface WorkspacePlugin<Flavour extends WorkspaceFlavour> {
+export interface WorkspaceAdapter<Flavour extends WorkspaceFlavour> {
+  releaseType: ReleaseType;
   flavour: Flavour;
   // Plugin will be loaded according to the priority
   loadPriority: LoadPriority;
@@ -21,10 +26,32 @@ export interface WorkspacePlugin<Flavour extends WorkspaceFlavour> {
 const unimplemented = () => {
   throw new Error('Not implemented');
 };
-export const WorkspacePlugins = {
+
+export const WorkspaceAdapters = {
   [WorkspaceFlavour.AFFINE]: AffinePlugin,
   [WorkspaceFlavour.LOCAL]: LocalPlugin,
+  [WorkspaceFlavour.AFFINE_CLOUD]: {
+    releaseType: ReleaseType.UNRELEASED,
+    flavour: WorkspaceFlavour.AFFINE_CLOUD,
+    loadPriority: LoadPriority.HIGH,
+    Events: {} as Partial<AppEvents>,
+    // todo: implement this
+    CRUD: {
+      get: unimplemented,
+      list: unimplemented,
+      delete: unimplemented,
+      create: unimplemented,
+    },
+    // todo: implement this
+    UI: {
+      Provider: unimplemented,
+      PageDetail: unimplemented,
+      PageList: unimplemented,
+      SettingsDetail: unimplemented,
+    },
+  },
   [WorkspaceFlavour.PUBLIC]: {
+    releaseType: ReleaseType.UNRELEASED,
     flavour: WorkspaceFlavour.PUBLIC,
     loadPriority: LoadPriority.LOW,
     Events: {} as Partial<AppEvents>,
@@ -44,5 +71,5 @@ export const WorkspacePlugins = {
     },
   },
 } satisfies {
-  [Key in WorkspaceFlavour]: WorkspacePlugin<Key>;
+  [Key in WorkspaceFlavour]: WorkspaceAdapter<Key>;
 };

apps/web/src/plugins/local/index.tsx

@@ -9,7 +9,11 @@ import {
   saveWorkspaceToLocalStorage,
 } from '@affine/workspace/local/crud';
 import { createIndexedDBBackgroundProvider } from '@affine/workspace/providers';
-import { LoadPriority, WorkspaceFlavour } from '@affine/workspace/type';
+import {
+  LoadPriority,
+  ReleaseType,
+  WorkspaceFlavour,
+} from '@affine/workspace/type';
 import { createEmptyBlockSuiteWorkspace } from '@affine/workspace/utils';
 import { nanoid } from '@blocksuite/store';
 import React from 'react';
@@ -18,11 +22,12 @@ import { PageNotFoundError } from '../../components/affine/affine-error-eoundary
 import { WorkspaceSettingDetail } from '../../components/affine/workspace-setting-detail';
 import { BlockSuitePageList } from '../../components/blocksuite/block-suite-page-list';
 import { PageDetailEditor } from '../../components/page-detail-editor';
-import type { WorkspacePlugin } from '..';
+import type { WorkspaceAdapter } from '..';
 
 const logger = new DebugLogger('use-create-first-workspace');
 
-export const LocalPlugin: WorkspacePlugin<WorkspaceFlavour.LOCAL> = {
+export const LocalPlugin: WorkspaceAdapter<WorkspaceFlavour.LOCAL> = {
+  releaseType: ReleaseType.STABLE,
   flavour: WorkspaceFlavour.LOCAL,
   loadPriority: LoadPriority.LOW,
   Events: {

apps/web/src/shared/index.ts

@@ -1,4 +1,7 @@
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import type { AffinePublicWorkspace } from '@affine/workspace/type';
 import type { WorkspaceRegistry } from '@affine/workspace/type';
 import { Workspace as BlockSuiteWorkspace } from '@blocksuite/store';
@@ -8,7 +11,7 @@ import type { ReactElement, ReactNode } from 'react';
 export { BlockSuiteWorkspace };
 
 export type AffineOfficialWorkspace =
-  | AffineWorkspace
+  | AffineLegacyCloudWorkspace
   | LocalWorkspace
   | AffinePublicWorkspace;
 

packages/component/src/components/share-menu/share-menu.tsx

@@ -1,4 +1,7 @@
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { ExportIcon, PublishIcon, ShareIcon } from '@blocksuite/icons';
 import type { Page } from '@blocksuite/store';
 import { useBlockSuiteWorkspacePageIsPublic } from '@toeverything/hooks/use-block-suite-workspace-page-is-public';
@@ -24,8 +27,8 @@ const tabIcons = {
   ShareWorkspace: <PublishIcon />,
 };
 export type ShareMenuProps<
-  Workspace extends AffineWorkspace | LocalWorkspace =
+  Workspace extends AffineLegacyCloudWorkspace | LocalWorkspace =
-    | AffineWorkspace
+    | AffineLegacyCloudWorkspace
     | LocalWorkspace
 > = {
   workspace: Workspace;

packages/component/src/components/share-menu/share-workspace.tsx

@@ -1,5 +1,8 @@
 import { useAFFiNEI18N } from '@affine/i18n/hooks';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import type { FC } from 'react';
 
@@ -26,7 +29,9 @@ const ShareLocalWorkspace: FC<ShareMenuProps<LocalWorkspace>> = props => {
   );
 };
 
-const ShareAffineWorkspace: FC<ShareMenuProps<AffineWorkspace>> = props => {
+const ShareAffineWorkspace: FC<
+  ShareMenuProps<AffineLegacyCloudWorkspace>
+> = props => {
   const isPublicWorkspace = props.workspace.public;
   const t = useAFFiNEI18N();
   return (
@@ -55,7 +60,9 @@ export const ShareWorkspace: FC<ShareMenuProps> = props => {
     );
   } else if (props.workspace.flavour === WorkspaceFlavour.AFFINE) {
     return (
-      <ShareAffineWorkspace {...(props as ShareMenuProps<AffineWorkspace>)} />
+      <ShareAffineWorkspace
+        {...(props as ShareMenuProps<AffineLegacyCloudWorkspace>)}
+      />
     );
   }
   throw new Error('Unreachable');

packages/component/src/components/workspace-avatar/index.tsx

@@ -1,6 +1,6 @@
 import type {
+  AffineLegacyCloudWorkspace,
   AffinePublicWorkspace,
-  AffineWorkspace,
   LocalWorkspace,
 } from '@affine/workspace/type';
 import type { Workspace } from '@blocksuite/store';
@@ -15,7 +15,11 @@ import { avatarImageStyle, avatarStyle } from './index.css';
 
 export type WorkspaceAvatarProps = {
   size?: number;
-  workspace: AffineWorkspace | LocalWorkspace | AffinePublicWorkspace | null;
+  workspace:
+    | AffineLegacyCloudWorkspace
+    | LocalWorkspace
+    | AffinePublicWorkspace
+    | null;
   className?: string;
 };
 

packages/component/src/components/workspace-card/index.tsx

@@ -1,6 +1,9 @@
 import { useAFFiNEI18N } from '@affine/i18n/hooks';
 import { PermissionType } from '@affine/workspace/affine/api';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import { SettingsIcon } from '@blocksuite/icons';
 import { useBlockSuiteWorkspaceName } from '@toeverything/hooks/use-block-suite-workspace-name';
@@ -16,7 +19,7 @@ import {
 } from './styles';
 
 export type WorkspaceTypeProps = {
-  workspace: AffineWorkspace | LocalWorkspace;
+  workspace: AffineLegacyCloudWorkspace | LocalWorkspace;
 };
 
 import {
@@ -78,9 +81,11 @@ const WorkspaceType: FC<WorkspaceTypeProps> = ({ workspace }) => {
 
 export type WorkspaceCardProps = {
   currentWorkspaceId: string | null;
-  workspace: AffineWorkspace | LocalWorkspace;
+  workspace: AffineLegacyCloudWorkspace | LocalWorkspace;
-  onClick: (workspace: AffineWorkspace | LocalWorkspace) => void;
+  onClick: (workspace: AffineLegacyCloudWorkspace | LocalWorkspace) => void;
-  onSettingClick: (workspace: AffineWorkspace | LocalWorkspace) => void;
+  onSettingClick: (
+    workspace: AffineLegacyCloudWorkspace | LocalWorkspace
+  ) => void;
 };
 
 export const WorkspaceCard: FC<WorkspaceCardProps> = ({

packages/component/src/components/workspace-list/index.tsx

@@ -1,4 +1,7 @@
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import type { DragEndEvent } from '@dnd-kit/core';
 import {
   DndContext,
@@ -14,15 +17,17 @@ import { WorkspaceCard } from '../workspace-card';
 export type WorkspaceListProps = {
   disabled?: boolean;
   currentWorkspaceId: string | null;
-  items: (AffineWorkspace | LocalWorkspace)[];
+  items: (AffineLegacyCloudWorkspace | LocalWorkspace)[];
-  onClick: (workspace: AffineWorkspace | LocalWorkspace) => void;
+  onClick: (workspace: AffineLegacyCloudWorkspace | LocalWorkspace) => void;
-  onSettingClick: (workspace: AffineWorkspace | LocalWorkspace) => void;
+  onSettingClick: (
+    workspace: AffineLegacyCloudWorkspace | LocalWorkspace
+  ) => void;
   onDragEnd: (event: DragEndEvent) => void;
 };
 
 const SortableWorkspaceItem: FC<
   Omit<WorkspaceListProps, 'items'> & {
-    item: AffineWorkspace | LocalWorkspace;
+    item: AffineLegacyCloudWorkspace | LocalWorkspace;
   }
 > = props => {
   const { setNodeRef, attributes, listeners, transform } = useSortable({

packages/component/src/stories/share-menu.stories.tsx

@@ -1,5 +1,8 @@
 import { PermissionType, WorkspaceType } from '@affine/workspace/affine/api';
-import type { AffineWorkspace, LocalWorkspace } from '@affine/workspace/type';
+import type {
+  AffineLegacyCloudWorkspace,
+  LocalWorkspace,
+} from '@affine/workspace/type';
 import { WorkspaceFlavour } from '@affine/workspace/type';
 import { createEmptyBlockSuiteWorkspace } from '@affine/workspace/utils';
 import type { Page } from '@blocksuite/store';
@@ -50,7 +53,7 @@ const localWorkspace: LocalWorkspace = {
   providers: [],
 };
 
-const affineWorkspace: AffineWorkspace = {
+const affineWorkspace: AffineLegacyCloudWorkspace = {
   id: 'test-workspace',
   flavour: WorkspaceFlavour.AFFINE,
   blockSuiteWorkspace,

packages/workspace/src/type.ts

@@ -80,13 +80,16 @@ export interface AffineWebSocketProvider extends BackgroundProvider {
 
 export type Provider = BackgroundProvider | NecessaryProvider;
 
-export interface AffineWorkspace extends RemoteWorkspace {
+export interface AffineLegacyCloudWorkspace extends RemoteWorkspace {
   flavour: WorkspaceFlavour.AFFINE;
   // empty
   blockSuiteWorkspace: BlockSuiteWorkspace;
   providers: Provider[];
 }
 
+// todo: update type with nest.js
+export type AffineCloudWorkspace = LocalWorkspace;
+
 export interface LocalWorkspace {
   flavour: WorkspaceFlavour.LOCAL;
   id: string;
@@ -101,6 +104,12 @@ export interface AffinePublicWorkspace {
   providers: Provider[];
 }
 
+export const enum ReleaseType {
+  // if workspace is not released yet, we will not show it in the workspace list
+  UNRELEASED = 'unreleased',
+  STABLE = 'stable',
+}
+
 export const enum LoadPriority {
   HIGH = 1,
   MEDIUM = 2,
@@ -108,7 +117,18 @@ export const enum LoadPriority {
 }
 
 export const enum WorkspaceFlavour {
+  /**
+   * AFFiNE Workspace is the workspace
+   * that hosted on the Legacy AFFiNE Cloud Server.
+   *
+   * @deprecated
+   *  We no longer maintain this kind of workspace, please use AFFiNE-Cloud instead.
+   */
   AFFINE = 'affine',
+  /**
+   * New AFFiNE Cloud Workspace using Nest.js Server.
+   */
+  AFFINE_CLOUD = 'affine-cloud',
   LOCAL = 'local',
   PUBLIC = 'affine-public',
 }
@@ -125,9 +145,11 @@ export type SettingPanel = (typeof settingPanel)[keyof typeof settingPanel];
 
 // built-in workspaces
 export interface WorkspaceRegistry {
-  [WorkspaceFlavour.AFFINE]: AffineWorkspace;
+  [WorkspaceFlavour.AFFINE]: AffineLegacyCloudWorkspace;
   [WorkspaceFlavour.LOCAL]: LocalWorkspace;
   [WorkspaceFlavour.PUBLIC]: AffinePublicWorkspace;
+  // todo: update workspace type to new
+  [WorkspaceFlavour.AFFINE_CLOUD]: AffineCloudWorkspace;
 }
 
 export interface WorkspaceCRUD<Flavour extends keyof WorkspaceRegistry> {