From 914dc27a8f7f5255cae1624fc930d23621d52221 Mon Sep 17 00:00:00 2001
From: Bill Yang <45103519+goldflag@users.noreply.github.com>
Date: Tue, 4 Jun 2024 17:58:01 -0700
Subject: [PATCH] Add Dropbox connector (#956)

* start dropbox connector

* add wip ui

* polish ui

* Fix some ci

* ignore types

* addressed, fixed, and tested all comments

* ran prettier

* ran mypy fixes

---------

Co-authored-by: Bill Yang <bill@Bills-MacBook-Pro.local>
Co-authored-by: hagen-danswer <hagen@danswer.ai>
---
 backend/danswer/configs/constants.py          |   1 +
 .../danswer/connectors/dropbox/__init__.py    |   0
 .../danswer/connectors/dropbox/connector.py   | 151 +++++++++++++
 backend/danswer/connectors/factory.py         |   2 +
 backend/requirements/default.txt              |   1 +
 web/public/Dropbox.png                        | Bin 0 -> 43377 bytes
 web/src/app/admin/connectors/dropbox/page.tsx | 209 ++++++++++++++++++
 web/src/components/icons/icons.tsx            |  13 ++
 web/src/lib/sources.ts                        |   6 +
 web/src/lib/types.ts                          |   8 +
 10 files changed, 391 insertions(+)
 create mode 100644 backend/danswer/connectors/dropbox/__init__.py
 create mode 100644 backend/danswer/connectors/dropbox/connector.py
 create mode 100644 web/public/Dropbox.png
 create mode 100644 web/src/app/admin/connectors/dropbox/page.tsx

diff --git a/backend/danswer/configs/constants.py b/backend/danswer/configs/constants.py
index 641738a4c..58a782541 100644
--- a/backend/danswer/configs/constants.py
+++ b/backend/danswer/configs/constants.py
@@ -93,6 +93,7 @@ class DocumentSource(str, Enum):
     GOOGLE_SITES = "google_sites"
     ZENDESK = "zendesk"
     LOOPIO = "loopio"
+    DROPBOX = "dropbox"
     SHAREPOINT = "sharepoint"
     TEAMS = "teams"
     DISCOURSE = "discourse"
diff --git a/backend/danswer/connectors/dropbox/__init__.py b/backend/danswer/connectors/dropbox/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/backend/danswer/connectors/dropbox/connector.py b/backend/danswer/connectors/dropbox/connector.py
new file mode 100644
index 000000000..2fd39948a
--- /dev/null
+++ b/backend/danswer/connectors/dropbox/connector.py
@@ -0,0 +1,151 @@
+from datetime import timezone
+from io import BytesIO
+from typing import Any
+
+from dropbox import Dropbox  # type: ignore
+from dropbox.exceptions import ApiError  # type:ignore
+from dropbox.files import FileMetadata  # type:ignore
+from dropbox.files import FolderMetadata  # type:ignore
+
+from danswer.configs.app_configs import INDEX_BATCH_SIZE
+from danswer.configs.constants import DocumentSource
+from danswer.connectors.interfaces import GenerateDocumentsOutput
+from danswer.connectors.interfaces import LoadConnector
+from danswer.connectors.interfaces import PollConnector
+from danswer.connectors.interfaces import SecondsSinceUnixEpoch
+from danswer.connectors.models import ConnectorMissingCredentialError
+from danswer.connectors.models import Document
+from danswer.connectors.models import Section
+from danswer.file_processing.extract_file_text import extract_file_text
+from danswer.utils.logger import setup_logger
+
+
+logger = setup_logger()
+
+
+class DropboxConnector(LoadConnector, PollConnector):
+    def __init__(self, batch_size: int = INDEX_BATCH_SIZE) -> None:
+        self.batch_size = batch_size
+        self.dropbox_client: Dropbox | None = None
+
+    def load_credentials(self, credentials: dict[str, Any]) -> dict[str, Any] | None:
+        self.dropbox_client = Dropbox(credentials["dropbox_access_token"])
+        return None
+
+    def _download_file(self, path: str) -> bytes:
+        """Download a single file from Dropbox."""
+        if self.dropbox_client is None:
+            raise ConnectorMissingCredentialError("Dropbox")
+        _, resp = self.dropbox_client.files_download(path)
+        return resp.content
+
+    def _get_shared_link(self, path: str) -> str:
+        """Create a shared link for a file in Dropbox."""
+        if self.dropbox_client is None:
+            raise ConnectorMissingCredentialError("Dropbox")
+
+        try:
+            # Check if a shared link already exists
+            shared_links = self.dropbox_client.sharing_list_shared_links(path=path)
+            if shared_links.links:
+                return shared_links.links[0].url
+
+            link_metadata = (
+                self.dropbox_client.sharing_create_shared_link_with_settings(path)
+            )
+            return link_metadata.url
+        except ApiError as err:
+            logger.exception(f"Failed to create a shared link for {path}: {err}")
+            return ""
+
+    def _yield_files_recursive(
+        self,
+        path: str,
+        start: SecondsSinceUnixEpoch | None,
+        end: SecondsSinceUnixEpoch | None,
+    ) -> GenerateDocumentsOutput:
+        """Yield files in batches from a specified Dropbox folder, including subfolders."""
+        if self.dropbox_client is None:
+            raise ConnectorMissingCredentialError("Dropbox")
+
+        result = self.dropbox_client.files_list_folder(
+            path,
+            limit=self.batch_size,
+            recursive=False,
+            include_non_downloadable_files=False,
+        )
+
+        while True:
+            batch: list[Document] = []
+            for entry in result.entries:
+                if isinstance(entry, FileMetadata):
+                    modified_time = entry.client_modified
+                    if modified_time.tzinfo is None:
+                        # If no timezone info, assume it is UTC
+                        modified_time = modified_time.replace(tzinfo=timezone.utc)
+                    else:
+                        # If not in UTC, translate it
+                        modified_time = modified_time.astimezone(timezone.utc)
+
+                    time_as_seconds = int(modified_time.timestamp())
+                    if start and time_as_seconds < start:
+                        continue
+                    if end and time_as_seconds > end:
+                        continue
+
+                    downloaded_file = self._download_file(entry.path_display)
+                    link = self._get_shared_link(entry.path_display)
+                    try:
+                        text = extract_file_text(entry.name, BytesIO(downloaded_file))
+                        batch.append(
+                            Document(
+                                id=f"doc:{entry.id}",
+                                sections=[Section(link=link, text=text)],
+                                source=DocumentSource.DROPBOX,
+                                semantic_identifier=entry.name,
+                                doc_updated_at=modified_time,
+                                metadata={"type": "article"},
+                            )
+                        )
+                    except Exception as e:
+                        logger.exception(
+                            f"Error decoding file {entry.path_display} as utf-8 error occurred: {e}"
+                        )
+
+                elif isinstance(entry, FolderMetadata):
+                    yield from self._yield_files_recursive(entry.path_lower, start, end)
+
+            if batch:
+                yield batch
+
+            if not result.has_more:
+                break
+
+            result = self.dropbox_client.files_list_folder_continue(result.cursor)
+
+    def load_from_state(self) -> GenerateDocumentsOutput:
+        return self.poll_source(None, None)
+
+    def poll_source(
+        self, start: SecondsSinceUnixEpoch | None, end: SecondsSinceUnixEpoch | None
+    ) -> GenerateDocumentsOutput:
+        if self.dropbox_client is None:
+            raise ConnectorMissingCredentialError("Dropbox")
+
+        for batch in self._yield_files_recursive("", start, end):
+            yield batch
+
+        return None
+
+
+if __name__ == "__main__":
+    import os
+
+    connector = DropboxConnector()
+    connector.load_credentials(
+        {
+            "dropbox_access_token": os.environ["DROPBOX_ACCESS_TOKEN"],
+        }
+    )
+    document_batches = connector.load_from_state()
+    print(next(document_batches))
diff --git a/backend/danswer/connectors/factory.py b/backend/danswer/connectors/factory.py
index cb0d41b8a..37ecd8f59 100644
--- a/backend/danswer/connectors/factory.py
+++ b/backend/danswer/connectors/factory.py
@@ -8,6 +8,7 @@ from danswer.connectors.confluence.connector import ConfluenceConnector
 from danswer.connectors.danswer_jira.connector import JiraConnector
 from danswer.connectors.discourse.connector import DiscourseConnector
 from danswer.connectors.document360.connector import Document360Connector
+from danswer.connectors.dropbox.connector import DropboxConnector
 from danswer.connectors.file.connector import LocalFileConnector
 from danswer.connectors.github.connector import GithubConnector
 from danswer.connectors.gitlab.connector import GitlabConnector
@@ -74,6 +75,7 @@ def identify_connector_class(
         DocumentSource.GOOGLE_SITES: GoogleSitesConnector,
         DocumentSource.ZENDESK: ZendeskConnector,
         DocumentSource.LOOPIO: LoopioConnector,
+        DocumentSource.DROPBOX: DropboxConnector,
         DocumentSource.SHAREPOINT: SharepointConnector,
         DocumentSource.TEAMS: TeamsConnector,
         DocumentSource.DISCOURSE: DiscourseConnector,
diff --git a/backend/requirements/default.txt b/backend/requirements/default.txt
index 6052624ad..e25f02b7a 100644
--- a/backend/requirements/default.txt
+++ b/backend/requirements/default.txt
@@ -69,3 +69,4 @@ uvicorn==0.21.1
 zulip==0.8.2
 hubspot-api-client==8.1.0
 zenpy==2.0.41
+dropbox==11.36.2
diff --git a/web/public/Dropbox.png b/web/public/Dropbox.png
new file mode 100644
index 0000000000000000000000000000000000000000..cd83e09eb6622919b416e635d611c43893a07a4f
GIT binary patch
literal 43377
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
b9L%k+yZ^JmtZXO-La20JO+H)J#P@#yOj*IJ

literal 0
HcmV?d00001

diff --git a/web/src/app/admin/connectors/dropbox/page.tsx b/web/src/app/admin/connectors/dropbox/page.tsx
new file mode 100644
index 000000000..a42c8d141
--- /dev/null
+++ b/web/src/app/admin/connectors/dropbox/page.tsx
@@ -0,0 +1,209 @@
+"use client";
+
+import { AdminPageTitle } from "@/components/admin/Title";
+import { HealthCheckBanner } from "@/components/health/healthcheck";
+import { DropboxIcon } from "@/components/icons/icons";
+import { LoadingAnimation } from "@/components/Loading";
+import { ConnectorForm } from "@/components/admin/connectors/ConnectorForm";
+import { CredentialForm } from "@/components/admin/connectors/CredentialForm";
+import { TextFormField } from "@/components/admin/connectors/Field";
+import { usePopup } from "@/components/admin/connectors/Popup";
+import { ConnectorsTable } from "@/components/admin/connectors/table/ConnectorsTable";
+import { TrashIcon } from "@/components/icons/icons";
+import { adminDeleteCredential, linkCredential } from "@/lib/credential";
+import { fetcher } from "@/lib/fetcher";
+import { usePublicCredentials } from "@/lib/hooks";
+import {
+  ConnectorIndexingStatus,
+  Credential,
+  DropboxConfig,
+  DropboxCredentialJson,
+} from "@/lib/types";
+import { Card, Text, Title } from "@tremor/react";
+import useSWR, { useSWRConfig } from "swr";
+import * as Yup from "yup";
+
+const Main = () => {
+  const { popup, setPopup } = usePopup();
+
+  const { mutate } = useSWRConfig();
+  const {
+    data: connectorIndexingStatuses,
+    isLoading: isConnectorIndexingStatusesLoading,
+    error: isConnectorIndexingStatusesError,
+  } = useSWR<ConnectorIndexingStatus<any, any>[]>(
+    "/api/manage/admin/connector/indexing-status",
+    fetcher
+  );
+  const {
+    data: credentialsData,
+    isLoading: isCredentialsLoading,
+    error: isCredentialsError,
+    refreshCredentials,
+  } = usePublicCredentials();
+
+  if (
+    (!connectorIndexingStatuses && isConnectorIndexingStatusesLoading) ||
+    (!credentialsData && isCredentialsLoading)
+  ) {
+    return <LoadingAnimation text="Loading" />;
+  }
+
+  if (isConnectorIndexingStatusesError || !connectorIndexingStatuses) {
+    return <div>Failed to load connectors</div>;
+  }
+
+  if (isCredentialsError || !credentialsData) {
+    return <div>Failed to load credentials</div>;
+  }
+
+  const dropboxConnectorIndexingStatuses: ConnectorIndexingStatus<
+    DropboxConfig,
+    DropboxCredentialJson
+  >[] = connectorIndexingStatuses.filter(
+    (connectorIndexingStatus) =>
+      connectorIndexingStatus.connector.source === "dropbox"
+  );
+  const dropboxCredential: Credential<DropboxCredentialJson> | undefined =
+    credentialsData.find(
+      (credential) => credential.credential_json?.dropbox_access_token
+    );
+
+  return (
+    <>
+      {popup}
+      <Title className="mb-2 mt-6 ml-auto mr-auto">
+        Provide your API details
+      </Title>
+
+      {dropboxCredential ? (
+        <>
+          <div className="flex mb-1 text-sm">
+            <p className="my-auto">Existing API Token: </p>
+            <p className="ml-1 italic my-auto max-w-md">
+              {dropboxCredential.credential_json?.dropbox_access_token}
+            </p>
+            <button
+              className="ml-1 hover:bg-hover rounded p-1"
+              onClick={async () => {
+                if (dropboxConnectorIndexingStatuses.length > 0) {
+                  setPopup({
+                    type: "error",
+                    message:
+                      "Must delete all connectors before deleting credentials",
+                  });
+                  return;
+                }
+                await adminDeleteCredential(dropboxCredential.id);
+                refreshCredentials();
+              }}
+            >
+              <TrashIcon />
+            </button>
+          </div>
+        </>
+      ) : (
+        <>
+          <Text>
+            See the Dropbox connector{" "}
+            <a
+              className="text-blue-500"
+              href="https://docs.danswer.dev/connectors/dropbox/overview"
+            >
+              setup guide
+            </a>{" "}
+            on the Danswer docs to obtain a Dropbox token.
+          </Text>
+          <Card className="mt-4 mb-4">
+            <CredentialForm<DropboxCredentialJson>
+              formBody={
+                <>
+                  <TextFormField
+                    name="dropbox_access_token"
+                    label="Dropbox API Token:"
+                    type="password"
+                  />
+                </>
+              }
+              validationSchema={Yup.object().shape({
+                dropbox_access_token: Yup.string().required(
+                  "Please enter your Dropbox API token"
+                ),
+              })}
+              initialValues={{
+                dropbox_access_token: "",
+              }}
+              onSubmit={(isSuccess) => {
+                if (isSuccess) {
+                  refreshCredentials();
+                  mutate("/api/manage/admin/connector/indexing-status");
+                }
+              }}
+            />
+          </Card>
+        </>
+      )}
+
+      {dropboxConnectorIndexingStatuses.length > 0 && (
+        <>
+          <Title className="mb-2 mt-6 ml-auto mr-auto">
+            Dropbox indexing status
+          </Title>
+          <Text className="mb-2">
+            The latest article changes are fetched every 10 minutes.
+          </Text>
+          <div className="mb-2">
+            <ConnectorsTable<DropboxConfig, DropboxCredentialJson>
+              connectorIndexingStatuses={dropboxConnectorIndexingStatuses}
+              liveCredential={dropboxCredential}
+              onCredentialLink={async (connectorId) => {
+                if (dropboxCredential) {
+                  await linkCredential(connectorId, dropboxCredential.id);
+                  mutate("/api/manage/admin/connector/indexing-status");
+                }
+              }}
+              onUpdate={() =>
+                mutate("/api/manage/admin/connector/indexing-status")
+              }
+            />
+          </div>
+        </>
+      )}
+
+      {dropboxCredential && dropboxConnectorIndexingStatuses.length === 0 && (
+        <>
+          <Card className="mt-4">
+            <h2 className="font-bold mb-3">Create Connection</h2>
+            <p className="text-sm mb-4">
+              Press connect below to start the connection to your Dropbox
+              instance.
+            </p>
+            <ConnectorForm<DropboxConfig>
+              nameBuilder={(values) => `Dropbox`}
+              ccPairNameBuilder={(values) => `Dropbox`}
+              source="dropbox"
+              inputType="poll"
+              formBody={<></>}
+              validationSchema={Yup.object().shape({})}
+              initialValues={{}}
+              refreshFreq={10 * 60} // 10 minutes
+              credentialId={dropboxCredential.id}
+            />
+          </Card>
+        </>
+      )}
+    </>
+  );
+};
+
+export default function Page() {
+  return (
+    <div className="mx-auto container">
+      <div className="mb-4">
+        <HealthCheckBanner />
+      </div>
+      <AdminPageTitle icon={<DropboxIcon size={32} />} title="Dropbox" />
+      <Main />
+    </div>
+  );
+}
diff --git a/web/src/components/icons/icons.tsx b/web/src/components/icons/icons.tsx
index 8cbec72c4..04d003a59 100644
--- a/web/src/components/icons/icons.tsx
+++ b/web/src/components/icons/icons.tsx
@@ -51,6 +51,7 @@ import hubSpotIcon from "../../../public/HubSpot.png";
 import document360Icon from "../../../public/Document360.png";
 import googleSitesIcon from "../../../public/GoogleSites.png";
 import zendeskIcon from "../../../public/Zendesk.svg";
+import dropboxIcon from "../../../public/Dropbox.png";
 import sharepointIcon from "../../../public/Sharepoint.png";
 import teamsIcon from "../../../public/Teams.png";
 import mediawikiIcon from "../../../public/MediaWiki.svg";
@@ -617,6 +618,18 @@ export const ZendeskIcon = ({
   </div>
 );
 
+export const DropboxIcon = ({
+  size = 16,
+  className = defaultTailwindCSS,
+}: IconProps) => (
+  <div
+    style={{ width: `${size}px`, height: `${size}px` }}
+    className={`w-[${size}px] h-[${size}px] ` + className}
+  >
+    <Image src={dropboxIcon} alt="Logo" width="96" height="96" />
+  </div>
+);
+
 export const DiscourseIcon = ({
   size = 16,
   className = defaultTailwindCSS,
diff --git a/web/src/lib/sources.ts b/web/src/lib/sources.ts
index 303108394..597f45f4d 100644
--- a/web/src/lib/sources.ts
+++ b/web/src/lib/sources.ts
@@ -4,6 +4,7 @@ import {
   ConfluenceIcon,
   DiscourseIcon,
   Document360Icon,
+  DropboxIcon,
   FileIcon,
   GithubIcon,
   GitlabIcon,
@@ -154,6 +155,11 @@ const SOURCE_METADATA_MAP: SourceMap = {
     displayName: "Loopio",
     category: SourceCategory.AppConnection,
   },
+  dropbox: {
+    icon: DropboxIcon,
+    displayName: "Dropbox",
+    category: SourceCategory.AppConnection,
+  },
   sharepoint: {
     icon: SharepointIcon,
     displayName: "Sharepoint",
diff --git a/web/src/lib/types.ts b/web/src/lib/types.ts
index 55cfe700c..f20173d1d 100644
--- a/web/src/lib/types.ts
+++ b/web/src/lib/types.ts
@@ -42,6 +42,7 @@ export type ValidSources =
   | "file"
   | "google_sites"
   | "loopio"
+  | "dropbox"
   | "sharepoint"
   | "teams"
   | "zendesk"
@@ -191,6 +192,8 @@ export interface GoogleSitesConfig {
 
 export interface ZendeskConfig {}
 
+export interface DropboxConfig {}
+
 export interface MediaWikiBaseConfig {
   connector_name: string;
   language_code: string;
@@ -198,6 +201,7 @@ export interface MediaWikiBaseConfig {
   pages?: string[];
   recurse_depth?: number;
 }
+
 export interface MediaWikiConfig extends MediaWikiBaseConfig {
   hostname: string;
 }
@@ -362,6 +366,10 @@ export interface ZendeskCredentialJson {
   zendesk_token: string;
 }
 
+export interface DropboxCredentialJson {
+  dropbox_access_token: string;
+}
+
 export interface SharepointCredentialJson {
   sp_client_id: string;
   sp_client_secret: string;