# over-flowy/typexplorer architecture

> Architecture diagram of the GitHub repository over-flowy/typexplorer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/over-flowy/typexplorer
- Repository: https://github.com/over-flowy/typexplorer

## Overview

##### Project type and purpose
- This is a Burp Suite extension (plugin) written in Python (via Jython).
- Purpose: automate sending a single HTTP request with multiple Content-Type headers (URL-encoded, JSON, XML, etc.), collect all responses, and display them in a split-pane UI for quick vulnerability checks (CSRF, IDOR, ATO).

##### File structure
- Top-level files:
- TypeXplorer.py – the entire extension code (registers with Burp, defines UI, handlers, test-case generator).
- README.md – describes installation, usage, features.
- assets/ – UI screenshots (for documentation), possibly other static resources.
- No separate frontend/backend folders since it is a single-file plugin loaded into Burp.
- No build scripts – runtime is handled by Burp + Jython.

##### README for additional insights
- The extension plugs into Burp’s context menu (“Send to TypeXplorer”).
- It keeps an internal list of endpoints; each endpoint, when selected, can be deleted or re-triggered.
- UI is a two-pane Swing interface (request list on one side, response details on the other).
- Uses Jython standalone JAR to run inside Burp.

##### Final recommendations
- UI layer is shown as a separate concern but within the same process.
- Avoid over-partitioning; focus on the extension’s five or six core modules rather than dozens of tiny functions.

## Diagram (Mermaid)

```mermaid
graph TD
    %% Host and runtime environment
    subgraph "Host Environment" 
        BS["Burp Suite"]:::host
        JY["Jython VM"]:::host
    end

    BS -->|"embeds"| JY

    %% Extension Components
    subgraph "TypeXplorer Extension" 
        CML["Context-Menu Listener\n(IContextMenuFactory)"]:::extension
        RQ["Request Queue / Endpoint List\n(Data Model)"]:::extension
        TG["Test-Case Generator\n(multiple Content-Types)"]:::extension
        HS["HTTP Sender\n(IHttpRequestResponse API)"]:::extension
        UI["UI Layer\n(Swing split-pane via ITab)"]:::extension
    end

    JY -->|"loads plugin"| CML
    CML -->|"adds request to"| RQ
    RQ -->|"triggers on select/run"| TG
    TG -->|"builds N variations"| HS
    HS -->|"HTTP requests"| TS["Target Web Server"]:::external
    TS -->|"HTTP responses"| HS
    HS -->|"returns responses"| UI
    UI -->|"delete/remove entry"| RQ

    %% Documentation
    DOC["Extension Documentation\n(README.md)"]:::docs
    AS["Assets / Screenshots\ndirectory"]:::docs

    %% Relationships to docs
    CML -.-> DOC
    UI -.-> AS

    %% Click Events
    click CML "https://github.com/over-flowy/typexplorer/blob/main/TypeXplorer.py"
    click RQ "https://github.com/over-flowy/typexplorer/blob/main/TypeXplorer.py"
    click TG "https://github.com/over-flowy/typexplorer/blob/main/TypeXplorer.py"
    click HS "https://github.com/over-flowy/typexplorer/blob/main/TypeXplorer.py"
    click UI "https://github.com/over-flowy/typexplorer/blob/main/TypeXplorer.py"
    click DOC "https://github.com/over-flowy/typexplorer/blob/main/README.md"
    click AS "https://github.com/over-flowy/typexplorer/tree/main/assets/"

    %% Style Definitions
    classDef host fill:#f0f8ff,stroke:#333,stroke-width:1px
    classDef extension fill:#e6ffe6,stroke:#2e8b57,stroke-width:1px
    classDef external fill:#fff0f0,stroke:#b22222,stroke-width:1px
    classDef docs fill:#ffffe0,stroke:#daa520,stroke-width:1px
```
