✨ Cloud authentication, basic status bar and project linking/unlinking

.vscode-test.mjs

@@ -22,6 +22,7 @@ export default defineConfig({
       "**/core/filesystem.js",
       "**/core/index.js",
       "**/telemetry/types.js",
+      "**/cloud/types.js",
       // VSCode-dependent files (require mocking, not unit testable)
       "**/extension.js",
       "**/appDiscovery.js",

README.md

@@ -30,6 +30,7 @@ CodeLens links appear above HTTP client calls like `client.get('/items')`, letti
 |---------|-------------|---------|
 | `fastapi.entryPoint` | Path to the main FastAPI application file (e.g., `src/main.py`). If not set, the extension searches common locations: `main.py`, `app/main.py`, `api/main.py`, `src/main.py`, `backend/app/main.py`. | `""` (auto-detect) |
 | `fastapi.codeLens.enabled` | Show CodeLens links above test client calls (e.g., `client.get('/items')`) to navigate to the corresponding route definition. | `true` |
+| `fastapi.cloud.enabled` | Enable FastAPI Cloud integration (status bar, deploy commands). | `true` |
 | `fastapi.telemetry.enabled` | Send anonymous usage data to help improve the extension. See [TELEMETRY.md](TELEMETRY.md) for details on what is collected. | `true` |
 
 **Note:** Currently the extension discovers one FastAPI app per workspace folder. If you have multiple apps, use separate workspace folders or configure `fastapi.entryPoint` to point to your primary app.

esbuild.js

@@ -94,6 +94,8 @@ async function main() {
           "posthog-node",
           "util",
           "child_process",
+          "node:util",
+          "node:child_process",
         ],
       })
 

package.json

@@ -19,7 +19,8 @@
   "main": "./dist/extension.js",
   "browser": "./dist/web/extension.js",
   "activationEvents": [
-    "workspaceContains:**/*.py"
+    "workspaceContains:**/*.py",
+    "workspaceContains:.fastapicloud/cloud.json"
   ],
   "categories": [
     "Other"
@@ -31,6 +32,12 @@
     }
   },
   "contributes": {
+    "authentication": [
+      {
+        "id": "fastapi-vscode",
+        "label": "FastAPI Cloud"
+      }
+    ],
     "commands": [
       {
         "command": "fastapi-vscode.refreshEndpoints",
@@ -64,6 +71,26 @@
         "title": "Search Endpoints...",
         "category": "FastAPI",
         "icon": "$(search)"
+      },
+      {
+        "command": "fastapi-vscode.linkApp",
+        "title": "Link Project",
+        "category": "FastAPI Cloud"
+      },
+      {
+        "command": "fastapi-vscode.unlinkApp",
+        "title": "Unlink Project",
+        "category": "FastAPI Cloud"
+      },
+      {
+        "command": "fastapi-vscode.signIn",
+        "title": "Sign In",
+        "category": "FastAPI Cloud"
+      },
+      {
+        "command": "fastapi-vscode.signOut",
+        "title": "Sign Out",
+        "category": "FastAPI Cloud"
       }
     ],
     "keybindings": [
@@ -82,6 +109,22 @@
         {
           "command": "fastapi-vscode.goToRouter",
           "when": "false"
+        },
+        {
+          "command": "fastapi-vscode.linkApp",
+          "when": "config.fastapi.cloud.enabled"
+        },
+        {
+          "command": "fastapi-vscode.unlinkApp",
+          "when": "config.fastapi.cloud.enabled"
+        },
+        {
+          "command": "fastapi-vscode.signIn",
+          "when": "config.fastapi.cloud.enabled"
+        },
+        {
+          "command": "fastapi-vscode.signOut",
+          "when": "config.fastapi.cloud.enabled"
         }
       ],
       "view/title": [
@@ -209,6 +252,12 @@
           "scope": "resource",
           "description": "Show CodeLens links above test client calls (e.g., client.get('/items')) to navigate to the corresponding route definition."
         },
+        "fastapi.cloud.enabled": {
+          "type": "boolean",
+          "default": true,
+          "scope": "window",
+          "description": "Enable FastAPI Cloud integration (status bar, link/unlink commands)."
+        },
         "fastapi.telemetry.enabled": {
           "type": "boolean",
           "default": true,
@@ -234,6 +283,7 @@
     "@biomejs/biome": "^2.3.11",
     "@types/bun": "latest",
     "@types/mocha": "^10.0.10",
+    "@types/sinon": "^21.0.0",
     "@types/vscode": "^1.85.0",
     "@vscode/test-cli": "^0.0.12",
     "@vscode/test-electron": "^2.5.2",
@@ -242,6 +292,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "path-browserify": "^1.0.1",
+    "sinon": "^21.0.1",
     "typescript": "^5.0.0"
   },
   "dependencies": {
@@ -250,7 +301,7 @@
     "web-tree-sitter": "^0.26.3"
   },
   "lint-staged": {
-    "*.{ts,js,json}": [
+    "**/*.{ts,js,json}": [
       "biome check --write"
     ]
   }

src/appDiscovery.ts

@@ -12,9 +12,9 @@ import { buildRouterGraph } from "./core/routerResolver"
 import { routerNodeToAppDefinition } from "./core/transformer"
 import { collectRoutes, countRouters } from "./core/treeUtils"
 import type { AppDefinition } from "./core/types"
-import { vscodeFileSystem } from "./providers/vscodeFileSystem"
 import { log } from "./utils/logger"
 import { createTimer, trackEntrypointDetected } from "./utils/telemetry"
+import { vscodeFileSystem } from "./vscode/vscodeFileSystem"
 
 export type { EntryPoint }
 

src/cloud/api.ts

@@ -0,0 +1,218 @@
+import * as vscode from "vscode"
+import { getExtensionVersion } from "../extension"
+import { AUTH_PROVIDER_ID } from "./auth"
+import type {
+  App,
+  Deployment,
+  ListResponse,
+  Team,
+  UploadInfo,
+  User,
+} from "./types"
+
+export const BASE_URL = "https://api.fastapicloud.com/api/v1"
+export const DASHBOARD_URL = "https://dashboard.fastapicloud.com"
+
+function getUserAgentHeaders(): Record<string, string> {
+  if (vscode.env.uiKind === vscode.UIKind.Web) return {}
+  return { "User-Agent": `fastapi-vscode/${getExtensionVersion()}` }
+}
+
+export class ApiService {
+  static getDashboardUrl(teamSlug: string, appSlug: string): string {
+    return `${DASHBOARD_URL}/${teamSlug}/apps/${appSlug}/general`
+  }
+
+  private async request<T>(
+    endpoint: string,
+    options: RequestInit = {},
+  ): Promise<T> {
+    const session = await vscode.authentication.getSession(
+      AUTH_PROVIDER_ID,
+      [],
+      { silent: true },
+    )
+    if (!session) {
+      throw new Error("Not authenticated")
+    }
+    const token = session.accessToken
+
+    const response = await fetch(`${BASE_URL}${endpoint}`, {
+      ...options,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+        ...getUserAgentHeaders(),
+        ...options.headers,
+      },
+    })
+
+    if (!response.ok) {
+      throw new Error(
+        `API request failed: ${options.method || "GET"} ${endpoint} returned ${response.status}`,
+      )
+    }
+
+    return response.json() as Promise<T>
+  }
+
+  static async getUser(token: string): Promise<User | null> {
+    try {
+      const response = await fetch(`${BASE_URL}/users/me`, {
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "Content-Type": "application/json",
+          ...getUserAgentHeaders(),
+        },
+      })
+      if (!response.ok) return null
+      return (await response.json()) as User
+    } catch {
+      return null
+    }
+  }
+
+  async getTeams(): Promise<Team[]> {
+    const data = await this.request<ListResponse<Team>>("/teams")
+    return data.data
+  }
+
+  async getTeam(teamId: string): Promise<Team> {
+    return this.request<Team>(`/teams/${teamId}/`)
+  }
+
+  async getApps(teamId: string): Promise<App[]> {
+    const data = await this.request<ListResponse<App>>(
+      `/apps/?team_id=${teamId}`,
+    )
+    return data.data
+  }
+
+  async getApp(appId: string): Promise<App> {
+    return this.request<App>(`/apps/${appId}`)
+  }
+
+  async createApp(teamId: string, name: string): Promise<App> {
+    return this.request<App>("/apps/", {
+      method: "POST",
+      body: JSON.stringify({ team_id: teamId, name }),
+    })
+  }
+
+  async createDeployment(appId: string): Promise<Deployment> {
+    return this.request<Deployment>(`/apps/${appId}/deployments/`, {
+      method: "POST",
+    })
+  }
+
+  async getUploadUrl(deploymentId: string): Promise<UploadInfo> {
+    return this.request<UploadInfo>(`/deployments/${deploymentId}/upload`, {
+      method: "POST",
+    })
+  }
+
+  async completeUpload(deploymentId: string): Promise<void> {
+    await this.request<void>(`/deployments/${deploymentId}/upload-complete`, {
+      method: "POST",
+    })
+  }
+
+  async getDeployment(
+    appId: string,
+    deploymentId: string,
+  ): Promise<Deployment> {
+    return this.request<Deployment>(
+      `/apps/${appId}/deployments/${deploymentId}/`,
+    )
+  }
+
+  static async requestDeviceCode(clientId: string): Promise<{
+    device_code: string
+    user_code: string
+    verification_uri: string
+    verification_uri_complete?: string
+    expires_in?: number
+    interval?: number
+  }> {
+    const response = await fetch(`${BASE_URL}/login/device/authorization`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded",
+        ...getUserAgentHeaders(),
+      },
+      body: new URLSearchParams({ client_id: clientId }).toString(),
+    })
+
+    if (!response.ok) {
+      throw new Error(
+        `Device code request failed: ${response.status} ${response.statusText}`,
+      )
+    }
+
+    const data = (await response.json()) as {
+      device_code?: string
+      user_code?: string
+      verification_uri?: string
+      verification_uri_complete?: string
+      expires_in?: number
+      interval?: number
+    }
+
+    if (!data.device_code || !data.user_code || !data.verification_uri) {
+      throw new Error("Invalid response from device code endpoint")
+    }
+    return {
+      device_code: data.device_code,
+      user_code: data.user_code,
+      verification_uri: data.verification_uri,
+      verification_uri_complete: data.verification_uri_complete ?? "",
+      expires_in: data.expires_in,
+      interval: data.interval,
+    }
+  }
+
+  static async pollDeviceToken(
+    clientId: string,
+    deviceCode: string,
+    intervalMs = 5000,
+    signal?: AbortSignal,
+  ): Promise<string> {
+    while (true) {
+      if (signal?.aborted) {
+        throw new Error("Sign-in cancelled")
+      }
+
+      const response = await fetch(`${BASE_URL}/login/device/token`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded",
+          ...getUserAgentHeaders(),
+        },
+        body: new URLSearchParams({
+          client_id: clientId,
+          device_code: deviceCode,
+          grant_type: "urn:ietf:params:oauth:grant-type:device_code",
+        }).toString(),
+        signal,
+      })
+
+      const data = (await response.json()) as {
+        access_token?: string
+        error?: string
+      }
+
+      if (response.ok && data.access_token) {
+        return data.access_token
+      }
+      if (data.error === "authorization_pending") {
+        await new Promise((resolve) => setTimeout(resolve, intervalMs))
+      } else if (data.error === "expired_token") {
+        throw new Error("Device code has expired")
+      } else {
+        throw new Error(
+          `Device token request failed: ${data.error || response.statusText}`,
+        )
+      }
+    }
+  }
+}