feat: Files Plugin (#115)

* feat: files plugin with multi-volume support

Adds a new Files plugin for browsing, uploading, downloading, and
previewing files from Databricks Unity Catalog Volumes. Includes
the files connector/client, cache invalidation, security hardening,
and server plugin adjustments for multipart uploads.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Atila Fassina <atila@fassina.eu>

* feat: file browser UI components

Adds React components for browsing files: directory list, file entry,
breadcrumb navigation, preview panel, new folder input, and format
utilities.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Atila Fassina <atila@fassina.eu>

* feat: files plugin dev-playground integration

Adds files plugin to the dev-playground reference app with a file
browser route, updated root layout navigation, and environment
configuration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Atila Fassina <atila@fassina.eu>

* docs: files plugin documentation

Adds files plugin documentation, updates plugin index, configuration
guide, and generated API docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Atila Fassina <atila@fassina.eu>

* chore: adjusting types post-rebase

* chore: refactor API to surface `.asUser(req)`

* chore: simplify default docs

* chore: update docs and fix tests

* chore: update docs

* chore: fix integration tests

* chore: add some timeout tests

* chore: update plugin manifest

* chore: do not rethrow auth errors on Plugin

* chore: add service-princpal back, update tests

* chore: get build to pass

* chore: update the docs

* chore: update docs

* chore: throw if not obo

* chore: update `toPlugin` call

* chore: fix tests to expect an error when SP is used

---------

Signed-off-by: Atila Fassina <atila@fassina.eu>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: atilafassina

CLAUDE.md

@@ -408,8 +408,8 @@ This project uses conventional commits (enforced by commitlint):
 
 ## Important Context
 
-### Current Branch: improve-bundle-size
-This branch focuses on optimizing bundle size through tsdown configuration tuning.
+### Current Branch: plugin/files
+This branch implements the multi-volume files plugin architecture.
 
 ### Key Dependencies
 - `@databricks/sdk-experimental` v0.15.0+ - Databricks services SDK

apps/dev-playground/.env.dist

@@ -6,6 +6,8 @@ NODE_ENV='development'
 OTEL_EXPORTER_OTLP_ENDPOINT='http://localhost:4318'
 OTEL_RESOURCE_ATTRIBUTES='service.sample_attribute=dev'
 OTEL_SERVICE_NAME='dev-playground'
+DATABRICKS_VOLUME_PLAYGROUND=
+DATABRICKS_VOLUME_OTHER=
 DATABRICKS_GENIE_SPACE_ID=
 LAKEBASE_ENDPOINT='' # Run: databricks postgres list-endpoints projects/{project-id}/branches/{branch-id} — use the `name` field from the output
 PGHOST=

apps/dev-playground/app.yaml

@@ -1,3 +1,7 @@
 env:
   - name: DATABRICKS_WAREHOUSE_ID
     valueFrom: sql-warehouse
+  - name: DATABRICKS_VOLUME_PLAYGROUND
+    valueFrom: volume
+  - name: DATABRICKS_VOLUME_OTHER
+    valueFrom: other-volume

apps/dev-playground/client/src/routeTree.gen.ts

@@ -15,6 +15,7 @@ import { Route as SqlHelpersRouteRouteImport } from './routes/sql-helpers.route'
 import { Route as ReconnectRouteRouteImport } from './routes/reconnect.route'
 import { Route as LakebaseRouteRouteImport } from './routes/lakebase.route'
 import { Route as GenieRouteRouteImport } from './routes/genie.route'
+import { Route as FilesRouteRouteImport } from './routes/files.route'
 import { Route as DataVisualizationRouteRouteImport } from './routes/data-visualization.route'
 import { Route as ChartInferenceRouteRouteImport } from './routes/chart-inference.route'
 import { Route as ArrowAnalyticsRouteRouteImport } from './routes/arrow-analytics.route'
@@ -51,6 +52,11 @@ const GenieRouteRoute = GenieRouteRouteImport.update({
   path: '/genie',
   getParentRoute: () => rootRouteImport,
 } as any)
+const FilesRouteRoute = FilesRouteRouteImport.update({
+  id: '/files',
+  path: '/files',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const DataVisualizationRouteRoute = DataVisualizationRouteRouteImport.update({
   id: '/data-visualization',
   path: '/data-visualization',
@@ -83,6 +89,7 @@ export interface FileRoutesByFullPath {
   '/arrow-analytics': typeof ArrowAnalyticsRouteRoute
   '/chart-inference': typeof ChartInferenceRouteRoute
   '/data-visualization': typeof DataVisualizationRouteRoute
+  '/files': typeof FilesRouteRoute
   '/genie': typeof GenieRouteRoute
   '/lakebase': typeof LakebaseRouteRoute
   '/reconnect': typeof ReconnectRouteRoute
@@ -96,6 +103,7 @@ export interface FileRoutesByTo {
   '/arrow-analytics': typeof ArrowAnalyticsRouteRoute
   '/chart-inference': typeof ChartInferenceRouteRoute
   '/data-visualization': typeof DataVisualizationRouteRoute
+  '/files': typeof FilesRouteRoute
   '/genie': typeof GenieRouteRoute
   '/lakebase': typeof LakebaseRouteRoute
   '/reconnect': typeof ReconnectRouteRoute
@@ -110,6 +118,7 @@ export interface FileRoutesById {
   '/arrow-analytics': typeof ArrowAnalyticsRouteRoute
   '/chart-inference': typeof ChartInferenceRouteRoute
   '/data-visualization': typeof DataVisualizationRouteRoute
+  '/files': typeof FilesRouteRoute
   '/genie': typeof GenieRouteRoute
   '/lakebase': typeof LakebaseRouteRoute
   '/reconnect': typeof ReconnectRouteRoute
@@ -125,6 +134,7 @@ export interface FileRouteTypes {
     | '/arrow-analytics'
     | '/chart-inference'
     | '/data-visualization'
+    | '/files'
     | '/genie'
     | '/lakebase'
     | '/reconnect'
@@ -138,6 +148,7 @@ export interface FileRouteTypes {
     | '/arrow-analytics'
     | '/chart-inference'
     | '/data-visualization'
+    | '/files'
     | '/genie'
     | '/lakebase'
     | '/reconnect'
@@ -151,6 +162,7 @@ export interface FileRouteTypes {
     | '/arrow-analytics'
     | '/chart-inference'
     | '/data-visualization'
+    | '/files'
     | '/genie'
     | '/lakebase'
     | '/reconnect'
@@ -165,6 +177,7 @@ export interface RootRouteChildren {
   ArrowAnalyticsRouteRoute: typeof ArrowAnalyticsRouteRoute
   ChartInferenceRouteRoute: typeof ChartInferenceRouteRoute
   DataVisualizationRouteRoute: typeof DataVisualizationRouteRoute
+  FilesRouteRoute: typeof FilesRouteRoute
   GenieRouteRoute: typeof GenieRouteRoute
   LakebaseRouteRoute: typeof LakebaseRouteRoute
   ReconnectRouteRoute: typeof ReconnectRouteRoute
@@ -217,6 +230,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof GenieRouteRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/files': {
+      id: '/files'
+      path: '/files'
+      fullPath: '/files'
+      preLoaderRoute: typeof FilesRouteRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/data-visualization': {
       id: '/data-visualization'
       path: '/data-visualization'
@@ -261,6 +281,7 @@ const rootRouteChildren: RootRouteChildren = {
   ArrowAnalyticsRouteRoute: ArrowAnalyticsRouteRoute,
   ChartInferenceRouteRoute: ChartInferenceRouteRoute,
   DataVisualizationRouteRoute: DataVisualizationRouteRoute,
+  FilesRouteRoute: FilesRouteRoute,
   GenieRouteRoute: GenieRouteRoute,
   LakebaseRouteRoute: LakebaseRouteRoute,
   ReconnectRouteRoute: ReconnectRouteRoute,

apps/dev-playground/client/src/routes/__root.tsx

@@ -96,6 +96,14 @@ function RootComponent() {
                     Chart Inference
                   </Button>
                 </Link>
+                <Link to="/files" className="no-underline">
+                  <Button
+                    variant="ghost"
+                    className="text-foreground hover:text-secondary-foreground"
+                  >
+                    Files
+                  </Button>
+                </Link>
                 <ThemeSelector />
               </div>
             </nav>