feat: Files Plugin

apps/dev-playground/client/src/appKitTypes.d.ts

@@ -14,46 +14,28 @@ declare module "@databricks/appkit-ui/react" {
           endDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          app_name: string;
-          /** @sqlType STRING */
-          day_of_week: string;
-          /** @sqlType DECIMAL(35,2) */
-          spend: number;
+          ;
         }>;
       };
     apps_list: {
         name: "apps_list";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType STRING */
-          id: string;
-          /** @sqlType STRING */
-          name: string;
-          /** @sqlType STRING */
-          creator: string;
-          /** @sqlType STRING */
-          tags: string;
-          /** @sqlType DECIMAL(38,6) */
-          totalSpend: number;
-          /** @sqlType DATE */
-          createdAt: string;
+          ;
         }>;
       };
     cost_recommendations: {
         name: "cost_recommendations";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType INT */
-          dummy: number;
+          ;
         }>;
       };
     example: {
         name: "example";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType BOOLEAN */
-          "(1 = 1)": boolean;
+          ;
         }>;
       };
     spend_data: {
@@ -73,12 +55,7 @@ declare module "@databricks/appkit-ui/react" {
           creator: SQLStringMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          group_key: string;
-          /** @sqlType TIMESTAMP */
-          aggregation_period: string;
-          /** @sqlType DECIMAL(38,6) */
-          cost_usd: number;
+          ;
         }>;
       };
     spend_summary: {
@@ -92,12 +69,7 @@ declare module "@databricks/appkit-ui/react" {
           startDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType DECIMAL(33,0) */
-          total: number;
-          /** @sqlType DECIMAL(33,0) */
-          average: number;
-          /** @sqlType DECIMAL(33,0) */
-          forecasted: number;
+          ;
         }>;
       };
     sql_helpers_test: {
@@ -117,22 +89,7 @@ declare module "@databricks/appkit-ui/react" {
           binaryParam: SQLStringMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          string_value: string;
-          /** @sqlType STRING */
-          number_value: string;
-          /** @sqlType STRING */
-          boolean_value: string;
-          /** @sqlType STRING */
-          date_value: string;
-          /** @sqlType STRING */
-          timestamp_value: string;
-          /** @sqlType BINARY */
-          binary_value: string;
-          /** @sqlType STRING */
-          binary_hex: string;
-          /** @sqlType INT */
-          binary_length: number;
+          ;
         }>;
       };
     top_contributors: {
@@ -146,10 +103,7 @@ declare module "@databricks/appkit-ui/react" {
           endDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          app_name: string;
-          /** @sqlType DECIMAL(38,6) */
-          total_cost_usd: number;
+          ;
         }>;
       };
     untagged_apps: {
@@ -163,14 +117,7 @@ declare module "@databricks/appkit-ui/react" {
           endDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          app_name: string;
-          /** @sqlType STRING */
-          creator: string;
-          /** @sqlType DECIMAL(38,6) */
-          total_cost_usd: number;
-          /** @sqlType DECIMAL(38,10) */
-          avg_period_cost_usd: number;
+          ;
         }>;
       };
   }

apps/dev-playground/server/index.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { analytics, createApp, server } from "@databricks/appkit";
+import { analytics, createApp, files, server } from "@databricks/appkit";
 import { WorkspaceClient } from "@databricks/sdk-experimental";
 import { lakebaseExamples } from "./lakebase-examples-plugin";
 import { reconnect } from "./reconnect-plugin";
@@ -22,6 +22,7 @@ createApp({
     telemetryExamples(),
     analytics({}),
     lakebaseExamples(),
+    files({ defaultVolume: process.env.DATABRICKS_DEFAULT_VOLUME }),
   ],
   ...(process.env.APPKIT_E2E_TEST && { client: createMockClient() }),
 }).then((appkit) => {

docs/docs/api/appkit/Class.Plugin.md

@@ -345,6 +345,24 @@ BasePlugin.getEndpoints
 
 ***
 
+### getSkipBodyParsingPaths()
+
+```ts
+getSkipBodyParsingPaths(): ReadonlySet<string>;
+```
+
+#### Returns
+
+`ReadonlySet`\<`string`\>
+
+#### Implementation of
+
+```ts
+BasePlugin.getSkipBodyParsingPaths
+```
+
+***
+
 ### injectRoutes()
 
 ```ts

docs/docs/api/appkit/Function.contentTypeFromPath.md

@@ -0,0 +1,24 @@
+# Function: contentTypeFromPath()
+
+```ts
+function contentTypeFromPath(
+   filePath: string, 
+   reported?: string, 
+   customTypes?: Record<string, string>): string;
+```
+
+Resolve the MIME content type for a file path.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `filePath` | `string` | Path to the file (only the extension is inspected). |
+| `reported?` | `string` | Optional MIME type reported by the caller; used as fallback when the extension is unknown. |
+| `customTypes?` | `Record`\<`string`, `string`\> | Optional map of extension → MIME type overrides (e.g. `{ ".csv": "text/csv" }`). |
+
+## Returns
+
+`string`
+
+The resolved MIME content type string.

docs/docs/api/appkit/index.md

@@ -65,6 +65,7 @@ plugin architecture, and React integration.
 | Function | Description |
 | ------ | ------ |
 | [appKitTypesPlugin](Function.appKitTypesPlugin.md) | Vite plugin to generate types for AppKit queries. Calls generateFromEntryPoint under the hood. |
+| [contentTypeFromPath](Function.contentTypeFromPath.md) | Resolve the MIME content type for a file path. |
 | [createApp](Function.createApp.md) | Bootstraps AppKit with the provided configuration. |
 | [createLakebasePool](Function.createLakebasePool.md) | Create a Lakebase pool with appkit's logger integration. Telemetry automatically uses appkit's OpenTelemetry configuration via global registry. |
 | [generateDatabaseCredential](Function.generateDatabaseCredential.md) | Generate OAuth credentials for Postgres database connection using the proper Postgres API. |

docs/docs/api/appkit/typedoc-sidebar.ts

@@ -200,6 +200,11 @@ const typedocSidebar: SidebarsConfig = {
           id: "api/appkit/Function.appKitTypesPlugin",
           label: "appKitTypesPlugin"
         },
+        {
+          type: "doc",
+          id: "api/appkit/Function.contentTypeFromPath",
+          label: "contentTypeFromPath"
+        },
         {
           type: "doc",
           id: "api/appkit/Function.createApp",