# mist-automation-programmability/mist_browser_extension architecture

> Architecture diagram of the GitHub repository mist-automation-programmability/mist_browser_extension, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mist-automation-programmability/mist_browser_extension
- Repository: https://github.com/mist-automation-programmability/mist_browser_extension

## Overview

Mist Browser Extension is an Angular browser-extension popup for exploring Juniper Mist APIs and managing sessions and API tokens across supported Mist clouds. Users open the popup, choose API, Accounts, Tools, Settings, or About, then inspect dashboard/API context, manage tokens, or review token information and usage. The runtime combines browser integration, cloud-host resolution, session handling, and API requests. The README documents several capabilities whose detailed implementation was not sampled; those branches are represented at feature level, and links are omitted where source evidence is unavailable.

Main entry points: [`angular/src/app/services/browser.service.ts`](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.service.ts) (Browser service), [`angular/src/app/services/http.browser.api.ts`](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.browser.api.ts) (Credential fallback), [`angular/src/app/pages/account/account.component.ts`](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/account.component.ts) (Account sessions), [`angular/src/app/app.component.ts`](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/app.component.ts) (Popup shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Popup features"]
  node_shell["Popup shell<br/>[app.component.ts]"]
  node_api["API explorer<br/>[api.component.ts]"]
  node_django["Django API tools"]
  node_mistapi["Mist API pages"]
  node_juniperapi["Juniper API pages"]
  node_accounts["Account sessions"]
  node_tokens["Token management"]
  node_orgtokens["Organization tokens"]
  node_tokeninfo["Token information<br/>[info.component.ts]"]
  node_tokenusage["Token usage<br/>[usage.component.ts]"]
  node_settings["Extension settings"]
  node_about["About and updates<br/>[about.component.ts]"]
end

subgraph group_integration["Browser integration"]
  node_browser["Browser service<br/>[browser.service.ts]"]
  node_loader["Session loader"]
  node_theme["Theme service<br/>[theme.service.ts]"]
end

subgraph group_identity["Sessions and access"]
  node_privileges["Privilege filtering"]
  node_hosts["Mist host resolver<br/>[mist.hosts.ts]"]
  node_sessions["Session model<br/>[browser.session.ts]"]
end

subgraph group_requests["API requests"]
  node_http["Credential fallback"]
  node_content["Content-script requests"]
  node_headers["HTTP header cleanup<br/>[http.utils.ts]"]
end

node_user(("Extension user"))
node_platform["Browser extension APIs"]
node_mist["Juniper Mist APIs"]
node_storage[("Browser local storage")]

node_user -->|"opens popup"| node_shell
node_shell -->|"selects API"| node_api
node_shell -->|"selects accounts"| node_accounts
node_shell -->|"selects tools"| node_tokeninfo
node_shell -->|"selects settings"| node_settings
node_shell -->|"selects about"| node_about
node_api -->|"opens API tools"| node_django
node_api -->|"opens API pages"| node_mistapi
node_api -->|"opens API pages"| node_juniperapi
node_accounts -->|"reads sessions"| node_browser
node_accounts -->|"requests account data"| node_http
node_accounts -->|"shows token manager"| node_tokens
node_tokens -->|"loads tokens"| node_http
node_tokens -->|"opens delete action"| node_browser
node_orgtokens -->|"requests org data"| node_http
node_orgtokens -->|"checks access"| node_privileges
node_privileges -->|"requests orgs"| node_http
node_tokeninfo -->|"uses browser context"| node_browser
node_tokeninfo -.->|"requests token data"| node_http
node_tokenusage -->|"uses browser context"| node_browser
node_tokenusage -.->|"requests usage"| node_http
node_settings -->|"configures appearance"| node_theme
node_theme -->|"reads and writes"| node_browser
node_browser -->|"uses extension APIs"| node_platform
node_browser -->|"loads sessions"| node_loader
node_browser -->|"resolves cloud hosts"| node_hosts
node_browser -->|"reads and writes"| node_storage
node_accounts -->|"computes usage"| node_sessions
node_http -->|"falls back to"| node_content
node_http -.->|"sends API requests"| node_mist
node_accounts -->|"fetches self data"| node_mist
node_tokens -->|"manages API tokens"| node_mist
node_accounts -->|"cleans request headers"| node_headers
node_orgtokens -->|"requests organization data"| node_mist

click node_shell "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/app.component.ts"
click node_api "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/api.component.ts"
click node_django "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/django/django.component.ts"
click node_mistapi "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/manage/manage.component.ts"
click node_juniperapi "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/juniper-manage/juniper-manage.component.ts"
click node_accounts "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/account.component.ts"
click node_tokens "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/manage/manage.component.ts"
click node_orgtokens "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/manage_org/manage_org.component.ts"
click node_privileges "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/privileges.service.ts"
click node_tokeninfo "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/tools/token_info/info.component.ts"
click node_tokenusage "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/tools/token_usage/usage.component.ts"
click node_settings "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/settings/settings.component.ts"
click node_about "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/about/about.component.ts"
click node_browser "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.service.ts"
click node_loader "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.loader.context.ts"
click node_hosts "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/mist.hosts.ts"
click node_sessions "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.session.ts"
click node_theme "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/theme.service.ts"
click node_http "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.browser.api.ts"
click node_content "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.content.api.ts"
click node_headers "https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.utils.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_api,node_django,node_mistapi,node_juniperapi,node_accounts,node_tokens,node_orgtokens,node_tokeninfo,node_tokenusage,node_settings,node_about,node_user,node_platform toneBlue
class node_browser,node_loader,node_theme,node_storage toneAmber
class node_privileges,node_hosts,node_sessions,node_mist toneMint
class node_http,node_content,node_headers toneRose
```

## Components

### Popup features

- [Popup shell](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/app.component.ts): `angular/src/app/app.component.ts`
- [API explorer](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/api.component.ts): `angular/src/app/pages/api/api.component.ts`
- [Django API tools](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/django/django.component.ts): `angular/src/app/pages/api/django/django.component.ts`
- [Mist API pages](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/manage/manage.component.ts): `angular/src/app/pages/api/manage/manage.component.ts`
- [Juniper API pages](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/api/juniper-manage/juniper-manage.component.ts): `angular/src/app/pages/api/juniper-manage/juniper-manage.component.ts`
- [Account sessions](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/account.component.ts): `angular/src/app/pages/account/account.component.ts`
- [Token management](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/manage/manage.component.ts): `angular/src/app/pages/account/manage/manage.component.ts`
- [Organization tokens](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/account/manage_org/manage_org.component.ts): `angular/src/app/pages/account/manage_org/manage_org.component.ts`
- [Token information](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/tools/token_info/info.component.ts): `angular/src/app/pages/tools/token_info/info.component.ts`
- [Token usage](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/tools/token_usage/usage.component.ts): `angular/src/app/pages/tools/token_usage/usage.component.ts`
- [Extension settings](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/settings/settings.component.ts): `angular/src/app/pages/settings/settings.component.ts`
- [About and updates](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/pages/about/about.component.ts): `angular/src/app/pages/about/about.component.ts`

### Browser integration

- [Browser service](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.service.ts): `angular/src/app/services/browser.service.ts`
- [Session loader](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.loader.context.ts): `angular/src/app/services/browser.loader.context.ts`
- [Theme service](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/theme.service.ts): `angular/src/app/services/theme.service.ts`

### Sessions and access

- [Privilege filtering](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/privileges.service.ts): `angular/src/app/services/privileges.service.ts`
- [Mist host resolver](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/mist.hosts.ts): `angular/src/app/services/mist.hosts.ts`
- [Session model](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/browser.session.ts): `angular/src/app/services/browser.session.ts`

### API requests

- [Credential fallback](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.browser.api.ts): `angular/src/app/services/http.browser.api.ts`
- [Content-script requests](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.content.api.ts): `angular/src/app/services/http.content.api.ts`
- [HTTP header cleanup](https://github.com/mist-automation-programmability/mist_browser_extension/blob/main/angular/src/app/services/http.utils.ts): `angular/src/app/services/http.utils.ts`

### Other components

- **Extension user**
- **Browser extension APIs**
- **Juniper Mist APIs**
- **Browser local storage**

## Connections

- Extension user → Popup shell: opens popup (evidence: `README.md`)
- Popup shell → API explorer: selects API (evidence: `angular/src/app/app.module.ts`)
- Popup shell → Account sessions: selects accounts (evidence: `angular/src/app/app.module.ts`)
- Popup shell → Token information: selects tools (evidence: `angular/src/app/app.module.ts`)
- Popup shell → Extension settings: selects settings (evidence: `angular/src/app/app.module.ts`)
- Popup shell → About and updates: selects about (evidence: `angular/src/app/app.module.ts`)
- API explorer → Django API tools: opens API tools (evidence: `README.md`)
- API explorer → Mist API pages: opens API pages (evidence: `README.md`)
- API explorer → Juniper API pages: opens API pages (evidence: `angular/src/app/app.module.ts`)
- Account sessions → Browser service: reads sessions (evidence: `angular/src/app/pages/account/account.component.ts`)
- Account sessions → Credential fallback: requests account data (evidence: `angular/src/app/pages/account/account.component.ts`)
- Account sessions → Token management: shows token manager (evidence: `angular/src/app/pages/account/account.component.ts`)
- Token management → Credential fallback: loads tokens (evidence: `angular/src/app/pages/account/manage/manage.component.ts`)
- Token management → Browser service: opens delete action (evidence: `angular/src/app/pages/account/manage/manage.component.ts`)
- Organization tokens → Credential fallback: requests org data (evidence: `angular/src/app/pages/account/manage_org/manage_org.component.ts`)
- Organization tokens → Privilege filtering: checks access (evidence: `angular/src/app/pages/account/manage_org/manage_org.component.ts`)
- Privilege filtering → Credential fallback: requests orgs (evidence: `angular/src/app/services/privileges.service.ts`)
- Token information → Browser service: uses browser context (evidence: `angular/src/app/pages/tools/token_info/info.component.ts`)
- Token information → Credential fallback: requests token data
- Token usage → Browser service: uses browser context (evidence: `angular/src/app/pages/tools/token_usage/usage.component.ts`)
- Token usage → Credential fallback: requests usage
- Extension settings → Theme service: configures appearance (evidence: `angular/src/app/pages/settings/settings.component.ts`)
- Theme service → Browser service: reads and writes (evidence: `angular/src/app/services/theme.service.ts`)
- Browser service → Browser extension APIs: uses extension APIs (evidence: `angular/src/app/services/browser.service.ts`)
- Browser service → Session loader: loads sessions (evidence: `angular/src/app/services/browser.service.ts`)
- Browser service → Mist host resolver: resolves cloud hosts (evidence: `angular/src/app/services/browser.service.ts`)
- Browser service → Browser local storage: reads and writes (evidence: `angular/src/app/services/browser.service.ts`)
- Account sessions → Session model: computes usage (evidence: `angular/src/app/pages/account/account.component.ts`)
- Credential fallback → Content-script requests: falls back to (evidence: `angular/src/app/services/http.browser.api.ts`)
- Credential fallback → Juniper Mist APIs: sends API requests
- Account sessions → Juniper Mist APIs: fetches self data (evidence: `angular/src/app/pages/account/account.component.ts`)
- Token management → Juniper Mist APIs: manages API tokens (evidence: `angular/src/app/pages/account/manage/manage.component.ts`)
- Account sessions → HTTP header cleanup: cleans request headers (evidence: `angular/src/app/pages/account/account.component.ts`)
- Organization tokens → Juniper Mist APIs: requests organization data
