feat(integrations): one-step install for workspace-scoped providers

apps/client/src/features/integration/components/connection-row.tsx

@@ -19,6 +19,7 @@ export default function ConnectionRow({
   isDisconnecting,
 }: ConnectionRowProps) {
   const { t } = useTranslation();
+  const isWorkspaceScoped = definition.oauth?.connectionScope === 'workspace';
 
   return (
     <Box
@@ -42,6 +43,21 @@ export default function ConnectionRow({
         </Group>
 
         <Group gap="sm" wrap="nowrap" style={{ flexShrink: 0 }}>
+          {isWorkspaceScoped ? (
+            <>
+              {connection ? (
+                <Text size="xs" c="green">
+                  {t("Linked")}
+                  {connection.providerUserId && ` as @${connection.providerUserId}`}
+                </Text>
+              ) : (
+                <Text size="xs" c="dimmed">
+                  {t("Use")} <code>/docmost help</code> {t("in")} {definition.name} {t("to link your account.")}
+                </Text>
+              )}
+            </>
+          ) : (
+            <>
               {connection ? (
                 <>
                   <Text size="xs" c="green">
@@ -67,6 +83,8 @@ export default function ConnectionRow({
                   {t("Connect")}
                 </Button>
               )}
+            </>
+          )}
         </Group>
       </Group>
     </Box>

apps/client/src/features/integration/pages/integrations.tsx

@@ -14,6 +14,7 @@ import {
   useUpdateIntegrationSettings,
 } from "../queries/integration-query";
 import { Integration } from "../types/integration.types";
+import { getOAuthAuthorizeUrl } from "../services/integration-service";
 
 export default function Integrations() {
   const { t } = useTranslation();
@@ -28,10 +29,21 @@ export default function Integrations() {
   const [configuring, setConfiguring] = useState<Integration | null>(null);
 
   const handleInstall = useCallback(
-    (type: string) => {
+    async (type: string) => {
-      installMutation.mutate({ type });
+      const definition = available?.find((d) => d.type === type);
+      try {
+        const integration = await installMutation.mutateAsync({ type });
+        if (definition?.oauth?.connectionScope === 'workspace') {
+          const { authorizationUrl } = await getOAuthAuthorizeUrl({
+            integrationId: integration.id,
+          });
+          window.location.href = authorizationUrl;
+        }
+      } catch (err) {
+        // installMutation's onError already shows a notification
+      }
     },
-    [installMutation],
+    [installMutation, available],
   );
 
   const handleUninstall = useCallback(

apps/client/src/features/integration/types/integration.types.ts

@@ -1,11 +1,19 @@
 export type IntegrationCapability = "oauth" | "unfurl" | "actions" | "webhooks";
 
+export type OAuthConfig = {
+  authUrl: string;
+  tokenUrl: string;
+  scopes: string[];
+  connectionScope?: 'workspace' | 'user';
+};
+
 export type IntegrationDefinition = {
   type: string;
   name: string;
   description: string;
   icon: string;
   capabilities: IntegrationCapability[];
+  oauth?: OAuthConfig;
 };
 
 export type Integration = {